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