با سیگنال های امن شروع کنید

پلتفرم مورد نظر را انتخاب کنید: HTML5 اندروید iOS tvOS

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

رابط برنامه‌نویسی کاربردی سیگنال‌های امن (secure signals API) به نسخه ۴.۸.۲ یا بالاتر از IMA SDK برای tvOS نیاز دارد.

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

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

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

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

کیت توسعه نرم‌افزار IMA برای tvOS به طور خودکار هر آداپتور سیگنال امن را بدون هیچ تغییر اضافی در کد شما، مقداردهی اولیه می‌کند.

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

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

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

برای هر درخواست تبلیغ، موارد زیر را انجام دهید:

1. یک شیء IMASecureSignals ایجاد کنید که شامل داده‌های سفارشی کدگذاری شده شما به صورت رشته باشد.
2. با تنظیم ویژگی IMAAdsRequest.secureSignals ، شیء IMASecureSignals را به درخواست تبلیغ خود اضافه کنید:

هدف-سی

BasicExample/ViewController.m

...
- (void)requestAds {
  // Create an ad display container for ad rendering.
  IMAAdDisplayContainer *adDisplayContainer =
      [[IMAAdDisplayContainer alloc] initWithAdContainer:self.videoView
                                          viewController:self
                                          companionSlots:nil];
  // Create an ad request with our ad tag, display container, and optional user context.
  IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:kTestAppAdTagUrl
                                                adDisplayContainer:adDisplayContainer
                                                   contentPlayhead:self.contentPlayhead
                                                       userContext:nil];
  
  IMASecureSignals *signals =
      [[IMASecureSignals alloc] initWithCustomData:@"My encoded signal string"];
  request.secureSignals = signals;
  
  [self.adsLoader requestAdsWithRequest:request];
}
...

سویفت

مثال پایه/ViewController.swift

...
private func requestAds() {
  // Create ad display container for ad rendering.
  let adDisplayContainer = IMAAdDisplayContainer(
    adContainer: videoView, viewController: self, companionSlots: nil)
  // Create an ad request with our ad tag, display container, and optional user context.
  let request = IMAAdsRequest(
    adTagUrl: ViewController.testAppAdTagURL,
    adDisplayContainer: adDisplayContainer,
    contentPlayhead: contentPlayhead,
    userContext: nil)
  
  let signals = IMASecureSignals(customData: "My encoded signal string")
  request.secureSignals = signals
  
  adsLoader.requestAds(with: request)
}
...