قواعد الإعلانات

أوضاع تشغيل حزمة تطوير البرامج (SDK)

يمكن أن تعمل حزمة تطوير البرامج (SDK) في وضع واحد أو أكثر، استنادًا إلى استجابة الإعلان التي تتلقّاها من خادم الإعلانات.

إعلان واحد
إعلان يمكن تشغيله في أي وقت عند إرسال رسالة start إلى IMAAdsManager. ولا يلزم إجراء أي إعداد خاص لعرض إعلان واحد.
مجموعة إعلانات متسلسلة
يتم تشغيل العديد من الإعلانات بشكل متتالٍ عند إرسال رسالة start إلى IMAAdsManager. ولا يلزم إجراء أي إعداد خاص لتشغيل مجموعة إعلانات متسلسلة واحدة.
قواعد الإعلانات
قائمة تشغيل تتضمّن فواصل إعلانية تمّت جدولتها في أوقات محدّدة مع محتوى معيّن يتم تجاهل رسالة start في وضع قواعد الإعلانات. يمكن ضبط عدة فواصل إعلانية ضمن قائمة تشغيل واحدة (على سبيل المثال، إعلان ما قبل التشغيل وأثناء التشغيل وما بعد التشغيل). لمزيد من تفاصيل التنفيذ، راجِع قسم قواعد الإعلانات أدناه.

قواعد الإعلانات

تتوافق حزمة تطوير البرامج (SDK) لإعلانات الوسائط التفاعلية لنظام التشغيل iOS مع قوائم تشغيل الإعلانات المبرمجة بالكامل. تعمل هذه الميزة على إدراج فواصل إعلانية في المحتوى على النحو المحدّد في مدير إعلانات Google عند عرض إعلاناتك. تعمل هذه الميزة أيضًا على تبسيط رمز مشغّل الفيديو بشكل كبير لإتاحة الفواصل الإعلانية، بما في ذلك إعلانات ما قبل التشغيل وأثناء التشغيل وما بعد التشغيل.

  • عند عرض الإعلانات في "مدير إعلانات Google"، يمكن تحديد قواعد مختلفة للإعلانات، مثل "تشغيل الفاصل الإعلاني دائمًا في بداية المحتوى" أو "تشغيل فاصل إعلاني مدته دقيقة واحدة كل 30 دقيقة من المحتوى".
  • عند طلب عرض الإعلانات، يمكن لخادم الإعلانات عرض قائمة تشغيل إعلانات. تعالج حزمة تطوير البرامج (SDK) قائمة التشغيل وتحدّد تلقائيًا الفواصل الإعلانية التي تم تحديدها.
  • عند إعداد AdsManager، يتم تمرير الكائن IMAContentPlayhead من خلال طلب initializeWithContentPlayhead:adsRenderingSettings:. إذا كنت تستخدم AVPlayer لعرض المحتوى الخاص بك، يتم إرسال مثيل IMAAVPlayerContentPlayhead إلى حزمة تطوير البرامج (SDK) عند إنشاء adDisplayContainer. يُستخدَم هذا العنصر لتتبُّع مستوى تقدّم تشغيل المحتوى، بحيث يتم إدراج الفواصل الإعلانية تلقائيًا في الأوقات المحدّدة في "مدير الإعلانات".

    باستخدام AVPlayer:

    IMAContentPlayhead *contentPlayhead =
    [[IMAAVPlayerContentPlayhead alloc] initWithAVPlayer:self.contentAVPlayer];
IMAAdsRequest *request = [[IMAAdsRequest alloc] initWithAdTagUrl:adTagUrl
                                              adDisplayContainer:adDisplayContainer
                                                 contentPlayhead:contentPlayhead
                                                     userContext:nil];

    بدون AVPlayer:

    1. تنفيذ واجهة IMAContentPlayhead.
    2. نفِّذ currentTime لعرض الوقت الحالي لمشغّل الفيديو.
    3. عليك تغيير طلب إعداد IMAAdsManager لاستخدام initializeWithContentPlayhead:self.
  • تُستخدَم السمة IMAAdsManagerDelegate لإيقاف المحتوى مؤقتًا واستئنافه أثناء تشغيل الفواصل الإعلانية.

ملاحظة: عند انتهاء تشغيل المحتوى أو إيقاف المستخدم للتشغيل، احرص على طلب المساعدة من contentComplete على IMAAdsLoader لإرسال إشارة إلى حزمة تطوير البرامج (SDK) بأنّ المحتوى قد انتهى. وبعد ذلك، تشغّل حزمة تطوير البرامج (SDK) فاصل الإعلانات ما بعد التشغيل، إذا تمت جدولة أحد الإعلانات. يزداد الحدث "ALL_ADS_COMPLETED" عند تشغيل كلّ الفواصل الإعلانية. بالإضافة إلى ذلك، يبدأ تتبُّع المحتوى عند استدعاء طريقة initializeWithContentPlayhead:adsRenderingSettings الخاصة بـ IMAAdsManager، ويجب دائمًا طلب الرمز initializeWithContentPlayhead:adsRenderingSettings قبل تشغيل المحتوى.