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

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

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

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

استخدام مقدّم إشارة تابع لجهة خارجية

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

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

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

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

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

ملاحظة: إنّ الإشارات الآمنة المستندة إلى بيانات مخصّصة هي ميزة تجريبية محدودة وقد لا تكون متاحة في شبكتك. يُرجى التواصل مع مدير حسابك لطلب الوصول إلى هذه الميزة.

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

لكلّ طلب إعلان، أنشئ عنصرًا من النوع IMASecureSignals يحتوي على بياناتك المخصّصة المشفّرة كسلسلة. بعد ذلك، أضِف عنصر IMASecureSignals إلى طلب إعلانك من خلال استدعاء سمة IMAAdsRequest.secureSignals.

في ما يلي أمثلة في Objective-C وSwift:

Objective-CSwift

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

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