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