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