إعداد قوائم تشغيل إعلانية تلقائيًا

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

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

إعلان واحد

إعلان يمكن تشغيله في أي وقت عند إرسال الرسالة start إلى IMAAdsManager لا يلزم إجراء أي عملية تهيئة خاصة لتشغيل إعلان واحد.

مجموعة إعلانات متسلسلة

إعلانات متعدّدة يتم تشغيلها بالتسلسل عند إرسال الرسالة start إلى IMAAdsManager. لا يلزم إجراء أي عملية تهيئة خاصة لتشغيل حزمة إعلانية واحدة.

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

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

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

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

• عند عرض الإعلانات في "مدير إعلانات 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 قبل تشغيل المحتوى.