الإشارات الآمنة

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

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

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

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

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

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

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

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

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

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

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

لكلّ طلب إعلان، أنشئ عنصرًا من النوع SecureSignals يحتوي على بياناتك المخصّصة المشفّرة بصفتها سلسلة. بعد ذلك، أضِف العنصر SecureSignals إلى طلب إعلانك من خلال الاتصال بالرقم adsRequest.setSecureSignals().

إليك مثال على جافا:

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