الإشارات الآمنة هي بيانات مشفّرة يتم جمعها على جهاز العميل ومشاركتها مع مقدّمي عروض أسعار محدّدين. يوضّح لك هذا الدليل كيفية جمع الإشارات الآمنة وإرسالها إلى "إدارة إعلانات Google" باستخدام حزمة تطوير البرامج للإعلانات التفاعلية.
تتطلّب واجهة برمجة التطبيقات "الإشارات الآمنة" الإصدار 3.29.0 أو إصدارًا أحدث من حزمة تطوير البرامج للإعلانات التفاعلية لنظام التشغيل Android.
لاختيار الإشارات ومقدّمي عروض الأسعار وتفعيل مشاركة الإشارات الآمنة، اطّلِع على مقالة مشاركة الإشارات الآمنة مع مقدّمي عروض الأسعار.
استخدام مقدّم إشارات تابع لجهة خارجية
لاستخدام الإشارات الآمنة، يجب تفعيل فئة محوّل مجمّع الإشارات في تطبيقك لجمع الإشارات وترميزها ونقلها إلى حزمة تطوير البرامج للإعلانات التفاعلية.
اتّبِع تعليمات موفّر الخدمة التابع لجهة خارجية لإعداد حساب معه، وإضافة تبعيات الإصدار، وإعداد أداة ربط الإشارات الآمنة في تطبيقك.
تعمل حزمة تطوير البرامج للإعلانات التفاعلية (IMA SDK) لنظام التشغيل Android تلقائيًا على إعداد كل مهايئ للإشارات الآمنة، بدون إجراء أي تغييرات إضافية على الرمز البرمجي.
في ما يلي مثال على كيفية إضافة محوّل إشارات آمنة إلى مشروعك:
إرسال بيانات مخصّصة
بالإضافة إلى استخدام موفّر إشارات تابع لجهة خارجية، يمكنك أيضًا جمع الإشارات وتشفيرها وإرسالها باستخدام بيانات مخصّصة. قبل أن تتمكّن من إرسال إشارات آمنة باستخدام بيانات مخصّصة، عليك تفعيل الإشارات المخصّصة في "إدارة إعلانات Google".
لكل طلب عرض إعلان، اتّبِع الخطوات التالية:
- أنشئ عنصر
SecureSignalsيحتوي على بياناتك المخصّصة المرمّزة كسلسلة. - أضِف الكائن
SecureSignalsإلى طلب عرض الإعلان من خلال استدعاء الطريقةadsRequest.setSecureSignals():
private void setSecureSignals(AdsRequest adsRequest, String secureSignalsString) {
SecureSignals signal = SecureSignals.create(secureSignalsString);
adsRequest.setSecureSignals(signal);
}