سیگنال های ایمن

سیگنال های امن داده های رمزگذاری شده ای هستند که در دستگاه مشتری جمع آوری شده و با پیشنهاد دهندگان منتخب به اشتراک گذاشته می شوند. این راهنما نحوه جمع‌آوری و ارسال سیگنال‌های ایمن به Google Ad Manager را با استفاده از IMA SDK به شما نشان می‌دهد.

API سیگنال های امن به نسخه 3.29.0 یا بالاتر IMA SDK برای Android نیاز دارد.

برای انتخاب سیگنال‌ها و مناقصه‌دهندگان و فعال کردن اشتراک‌گذاری ایمن سیگنال، به اشتراک‌گذاری سیگنال‌های ایمن با پیشنهاد دهندگان مراجعه کنید.

از یک ارائه دهنده سیگنال شخص ثالث استفاده کنید

برای استفاده از سیگنال‌های ایمن، باید یک کلاس آداپتور جمع‌آوری سیگنال در برنامه خود مستقر کنید تا سیگنال‌ها را جمع‌آوری کند، آن‌ها را رمزگذاری کند و به IMA SDK ارسال کند.

دستورالعمل‌های ارائه‌دهنده شخص ثالث خود را دنبال کنید تا با آن‌ها یک حساب راه‌اندازی کنید، وابستگی‌های ساخت اضافه کنید و آداپتور سیگنال‌های امن آن‌ها را در برنامه خود راه‌اندازی کنید.

IMA SDK برای Android به طور خودکار هر آداپتور سیگنال های ایمن را بدون هیچ تغییر اضافی در کد شما مقداردهی اولیه می کند.

در اینجا مثالی از نحوه اضافه کردن یک آداپتور سیگنال امن به پروژه خود آورده شده است:

ارسال داده های سفارشی

توجه: سیگنال های ایمن با داده های سفارشی یک ویژگی بتا محدود است و ممکن است در شبکه شما در دسترس نباشد. برای درخواست دسترسی به این ویژگی، با مدیر حساب خود تماس بگیرید.

علاوه بر استفاده از یک ارائه دهنده سیگنال شخص ثالث، می توانید سیگنال ها را با داده های سفارشی جمع آوری، رمزگذاری و ارسال کنید. قبل از اینکه بتوانید سیگنال‌های ایمن با داده‌های سفارشی ارسال کنید، باید سیگنال‌های سفارشی را در Ad Manager روشن کنید.

برای هر درخواست تبلیغ، یک شی SecureSignals حاوی داده های سفارشی کدگذاری شده شما، به عنوان یک رشته ایجاد کنید. سپس، با فراخوانی adsRequest.setSecureSignals() شی SecureSignals به درخواست تبلیغ خود اضافه کنید.

در اینجا یک مثال جاوا آمده است:

app/src/main/java/com/example/project name/MainActivity.java

...
private void requestAds(String adTagUrl) {
  // Create the ads request.
  AdsRequest request = sdkFactory.createAdsRequest();
  request.setAdTagUrl(adTagUrl);
  request.setContentProgressProvider(
      () -> {
        if (videoPlayer.getDuration() <= 0) {
          return VideoProgressUpdate.VIDEO_TIME_NOT_READY;
        }
        return new VideoProgressUpdate(
            videoPlayer.getCurrentPosition(), videoPlayer.getDuration());
      });
  
  SecureSignals signal = SecureSignals.create("My encoded signal string");
  request.setSecureSignals(signal);
  
  // Request the ad. After the ad is loaded, onAdsManagerLoaded() will be called.
  adsLoader.requestAds(request);
}
...