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

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

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

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

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

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

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

    باستخدام 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 قبل تشغيل المحتوى.