بدء استخدام الإشارات الآمنة

اختيار النظام الأساسي: HTML5 Android iOS tvOS

الإشارات الآمنة هي بيانات مرمّزة يتم جمعها على جهاز العميل ومشاركتها مع مقدّمي عروض أسعار محدّدين. يوضّح لك هذا الدليل كيفية جمع الإشارات الآمنة وإرسالها إلى "إدارة إعلانات Google" باستخدام حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK).

تتطلّب واجهة برمجة التطبيقات Secure Signals الإصدار 4.8.2 أو إصدارًا أحدث من حزمة تطوير البرامج (SDK) للإعلانات التفاعلية لنظام التشغيل tvOS.

لاختيار الإشارات ومقدّمي عروض الأسعار وتفعيل مشاركة الإشارات الآمنة، يُرجى الاطّلاع على مقالة مشاركة الإشارات الآمنة مع مقدّمي عروض الأسعار.

استخدام مقدّم إشارات خارجي

لاستخدام الإشارات الآمنة، عليك نشر فئة محوِّل لجمع الإشارات في تطبيقك من أجل جمع الإشارات وترميزها وإرسالها إلى حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK).

اتّبِع تعليمات مقدّم الخدمة الخارجي لإعداد حساب لديه، وتضمين أُطر العمل، وإعداد محوّل الإشارات الآمنة في تطبيقك.

تعمل حزمة IMA SDK لنظام التشغيل tvOS تلقائيًا على إعداد كل محوّل إشارات آمنة، بدون أي تغييرات إضافية على الرمز البرمجي.

في ما يلي مثال على كيفية إضافة محوّل إشارات آمنة إلى مشروعك:

إرسال بيانات مخصّصة

بالإضافة إلى استخدام مقدّم إشارات خارجي، يمكنك أيضًا جمع الإشارات وترميزها وإرسالها مع بيانات مخصّصة. قبل أن تتمكّن من إرسال إشارات آمنة باستخدام بيانات مخصّصة، عليك تفعيل الإشارات المخصّصة في "إدارة إعلانات Google".

لكل طلب عرض إعلان، اتّبِع الخطوات التالية:

1. أنشئ عنصر IMASecureSignals يحتوي على بياناتك المخصّصة المرمّزة كسلسلة.
2. أضِف عنصر IMASecureSignals إلى طلب عرض الإعلان من خلال ضبط سمة IMAAdsRequest.secureSignals:

Objective-C

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];
}
...

Swift

BasicExample/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)
}
...