الإشارات الآمنة هي بيانات مشفّرة يتم جمعها على جهاز العميل ومشاركتها مع مقدّمي عروض أسعار محدّدين. يوضّح لك هذا الدليل كيفية جمع الإشارات الآمنة وإرسالها إلى "مدير إعلانات Google" باستخدام حزمة IMA SDK.
تتطلّب واجهة برمجة التطبيقات "الإشارات الآمنة" الإصدار 3.29.0 أو إصدارًا أحدث من حزمة IMA SDK لنظام التشغيل Android.
لاختيار الإشارات وعروض الأسعار وتفعيل مشاركة الإشارات الآمنة، اطّلِع على مقالة مشاركة الإشارات الآمنة مع مقدّمي عروض الأسعار.
استخدام مقدّم إشارات تابع لجهة خارجية
لاستخدام الإشارات الآمنة، يجب نشر فئة محوّل مجمّع الإشارات في تطبيقك لجمع الإشارات وتشفيرها وتمريرها إلى حزمة تطوير البرامج (SDK) الخاصة بـ IMA.
اتّبِع تعليمات موفّر الخدمة التابع لجهة خارجية لإعداد حساب معه، إضافة تبعيات الإصدار، وإعداد أداة ربط الإشارات الآمنة في تطبيقك.
تعمل حزمة IMA SDK لنظام التشغيل 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);
}
...