عرض إعلان مقابل مكافأة
يوضّح هذا المثال استخدام مكتبة "علامة ناشر Google" (GPT) ل طلب إعلان يضم مكافأة وعرضه. تتيح أشكال الإعلانات التي تضم مكافآت لمستخدمي التطبيقات وصفحات الويب تلقّي مكافآت مقابل مشاهدة الإعلانات. اطّلِع على مزيد من المعلومات عن الإعلانات التي تضم مكافآت في مركز مساعدة "مدير إعلانات Google".
يمكنك استخدام أحداث GPT التالية لعرض الإعلانات التي تضم مكافآت والتفاعل معها:
| الحدث | يتم تشغيله عند... |
|---|---|
| RewardedSlotClosedEvent | تم إغلاق خانة إعلان مقابل مكافأة. |
| RewardedSlotGrantedEvent | تم منح مكافأة مقابل مشاهدة إعلان. |
| RewardedSlotReadyEvent | تكون خانة إعلان مقابل مكافأة جاهزة للعرض. |
لأغراض هذا المثال، يتم استخدام مربّع حوار مشروط بسيط لطلب من المستخدم مشاهدة الإعلان الذي يضم مكافأة وعرض المكافأة عند اكتمال العرض. في الواقع، يتحمّل الناشر مسؤولية تنفيذ واجهته الخاصة لتنفيذ هذه المهام.
ملاحظات الاستخدام
لضمان تقديم تجربة مثالية للمستخدم، لا يتم طلب الإعلانات التي تضم مكافآت إلا على الصفحات التي تتيح استخدام هذا التنسيق بشكلٍ سليم. ولهذا السبب، قد يعرض
defineOutOfPageSlot()القيمةnull، لذا عليك التحقّق من هذه الحالة لمحاولة تجنُّب إجراء أي عمل غير ضروري. لا تتوفّر الإعلانات التي تضم مكافأة حاليًا إلا على الصفحات المحسّنة للأجهزة الجوّالة التي تكون فيها ميزة التكبير/التصغير محايدة. ويعني ذلك عادةً أنّ الناشر لديه<meta name="viewport" content="width=device-width, initial-scale=1">أو ما شابه ذلك في<head>الصفحة.تُنشئ "الإعلانات مقابل مكافأة" خانة إعلان خاصة بها. وعلى عكس أنواع الإعلانات الأخرى، ليس من الضروري تحديد
<div>للإعلانات التي تضم مكافآت. تنشئ الإعلانات التي تضم مكافآت تلقائيًا حاوية خاصة بها وتُدرجها في الصفحة عند ملء مساحة إعلان.