يوضِّح هذا الدليل كيفية دمج أشكال إعلانات مدمجة مع المحتوى مخصّصة مع القياس المفتوح.
المتطلبات الأساسية
- حزمة "SDK لإعلانات Google على الأجهزة الجوّالة"، الإصدار 18.1.1 أو إصدار أحدث
- اطّلِع على فتح القياس باستخدام حزمة تطوير البرامج (SDK) لإعلانات الأجهزة الجوّالة.
- دمج أشكال الإعلانات المدمجة مع المحتوى
- ضبط موفِّر إمكانية العرض وتخصيصه للعنصر.
- أدخِل اسم الشريك عند إنشاء تنسيق مخصّص في واجهة مستخدم "مدير الإعلانات".
الدمج
إذا كنت تخطّط لاستخدام القياس المفتوح مع أشكال الإعلانات المدمجة مع المحتوى المخصّصة التي لا تحتوي على مادة عرض فيديو، ستكون مسؤولاً عن استدعاء واجهات Open Measurement API بنفسك. لا يتوفّر القياس المفتوح لأشكال الإعلانات المدمجة مع المحتوى المخصّصة من النوع الشبكة الإعلانية إلا في الإصدار 18.1.1 والإصدارات الأحدث من حزمة تطوير البرامج (SDK) لإعلانات الأجهزة الجوّالة.
إذا كنت تستخدِم أشكال إعلانات مدمجة مع المحتوى مخصّصة مع مادة عرض فيديو، لن تحتاج إلى اتّباع هذا الدليل، لأنّ حزمة "SDK لإعلانات الأجهزة الجوّالة" تعمل على تتبُّع إمكانية عرض مادة عرض الفيديو نيابةً عنك.
لنلقِ نظرة الآن على كيفية استخدام القياس المفتوح مع NativeCustomTemplateAd
. بوجهٍ عام، يجب تنبيه حزمة تطوير البرامج (SDK) لعرض الإعلانات على الأجهزة الجوّالة عندما تريد بدء قياس إمكانية العرض وتسجيل مشاهدة إعلانك المخصّصة.
تحميل إعلان
يكون تحميل الإعلان مماثلاً سواء كنت تستخدم القياس المفتوح أم لا. في ما يلي طريقة توضّح كيفية طلب NativeCustomTemplateAd
:
public void loadAd() {
AdLoader adLoader = new AdLoader.Builder(context, "YOUR-AD-UNIT-ID")
.forCustomTemplateAd("YOUR-TEMPLATE-ID",
new NativeCustomTemplateAd.OnCustomTemplateAdLoadedListener() {
@Override
public void onCustomTemplateAdLoaded(NativeCustomTemplateAd ad) {
// Register your view and begin open measurement.
// We will define this method below.
MyActivity.this.registerOpenMeasurementAndShowAd(ad);
}
},
new NativeCustomTemplateAd.OnCustomClickListener() {
@Override
public void onCustomClick(NativeCustomTemplateAd ad, String s) {
// Handle the click action
}
})
.withAdListener( ... )
.withNativeAdOptions( ... )
.build();
}
تسجيل طريقة العرض وبدء القياس
لتفعيل القياس المفتوح على NativeCustomTemplateAd
، سجِّل عرض الإعلان المخصّص باستخدام العنصر DisplayOpenMeasurement
المرتبط بالعنصر NativeCustomTemplateAd
. يوفّر الكائن DisplayOpenMeasurement
طريقة
setView()
لتسجيل عرض الحاوية باستخدام القياس المفتوح.
عليك أيضًا إعلام حزمة تطوير البرامج (SDK) صراحةً ببدء قياس إعلانك. ولإجراء ذلك، عليك استدعاء الإجراء start()
في الكائن DisplayOpenMeasurement
في NativeCustomTemplateAd
. ويجب استدعاء الطريقة start()
من سلسلة التعليمات الرئيسية، ولن يكون لعمليات الاستدعاء اللاحقة أي تأثير.
إليك كيف تبدو علامة التبويب هذه:
public void registerOpenMeasurementAndShowAd(NativeCustomTemplateAd ad) {
...
// Show ad
...
displayCustomTemplateAd(ad)
// Begin Open Measurement
// The FrameLayout that will contain your native custom ad
FrameLayout customTemplateAdFrame = (FrameLayout) findViewById(R.id.custom_ad_frame);
ad.getDisplayOpenMeasurement().setView(customTemplateAdFrame);
ad.getDisplayOpenMeasurement().start();
}
تجدر الإشارة إلى أنّه يجب عرض إعلانك قبل تسجيل طريقة العرض. عرض إعلانك مغطى بأشكال الإعلانات المخصّصة المدمجة المدمجة.
التنسيق customTemplateAdFrame
هو حاوية الإعلان من أجل
NativeCustomTemplateAd
ويجب أن يحتوي على جميع مواد العرض داخل المربّع المحيط بطريقة العرض.
الحصول على شهادة الاعتماد من مكتب الإعلانات التفاعلية (IAB)
بعد إصدار تطبيقك، ستبدأ في تلقّي بيانات القياس. ومع ذلك، لن يتم اعتماد بياناتك إلى أن تُكمل عملية اعتماد مكتب الإعلانات التفاعلية (IAB).