أوضاع تشغيل حِزم تطوير البرامج (SDK)
يمكن أن تعمل حزمة SDK في وضع واحد أو أكثر، اعتمادًا على استجابة الإعلان التي تتلقّاها من الإعلان. الخادم.
- إعلان واحد
- إعلان يمكن تشغيله في أي وقت عند استخدام
start
إلىIMAAdsManager
. بدون إعداد خاص ضروريًا لتشغيل إعلان واحد. - مجموعة الإعلانات المتسلسلة
- العديد من الإعلانات التي يتم تشغيلها مرة أخرى عند إرسال رسالة
start
إلىIMAAdsManager
. لا يلزم إجراء تهيئة خاصة تشغيل مجموعة إعلانات متسلسلة واحدة - قواعد الإعلانات
- قائمة تشغيل تضم فواصل إعلانية تمت جدولتها في أوقات معيّنة مقابل
المحتوى. يتم تجاهل رسالة
start
في وضع قواعد الإعلانات. هناك عبارة عن عدة فواصل إعلانية مجدولة ضمن قائمة تشغيل واحدة (على سبيل المثال، إعلان ما قبل التشغيل، إعلان أثناء التشغيل أو ما بعد التشغيل). لمزيد من التفاصيل حول عملية التنفيذ، يمكنك الاطّلاع على قسم قواعد الإعلان أدناه.
قواعد الإعلانات
إعلانات الوسائط التفاعلية لنظام التشغيل iOS تدعم حزمة 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:
- نفِّذ واجهة
IMAContentPlayhead
. - تنفيذ
currentTime
لعرض الوقت الحالي من مشغّل الفيديو. - تغيير طلب إعداد
IMAAdsManager
إلى استخدامinitializeWithContentPlayhead:self
.
- نفِّذ واجهة
- IMAAdsManagerDelegate تُستخدم لإيقاف المحتوى مؤقتًا واستئناف تشغيله أثناء تشغيل الفواصل الإعلانية.
ملاحظة: عند انتهاء تشغيل المحتوى أو
توقف المستخدم عن التشغيل، احرص على الاتصال بـ contentComplete
على IMAAdsLoader
لإرسال إشارة إلى حزمة تطوير البرامج (SDK) بأنّ المحتوى
انتهى التشغيل. بعد ذلك، تعرِض حزمة تطوير البرامج (SDK) فاصل الإعلانات بعد التشغيل، في حال تمّت جدولة أحد الفواصل الإعلانية.
يزيد الحدث "ALL_ADS_COMPLETED
" عند ضبط قيمة كل الفواصل الإعلانية.
التي تم لعبها. بالإضافة إلى ذلك، لاحظ أن تتبع المحتوى يبدأ عند
جهاز initializeWithContentPlayhead:adsRenderingSettings
الخاص بـ "IMAAdsManager
"
وينبغي عليك دائمًا استدعاء الدالة initializeWithContentPlayhead:adsRenderingSettings
قبل تشغيل المحتوى.