تتيح لك واجهة برمجة التطبيقات "فواصل إعلانية" في ميزة "إدراج الإعلانات الديناميكية" إنشاء بيانات استهداف الإعلانات وتوقيت الفواصل الإعلانية القادمة في أحداث البث المباشر وإدارتها.
باستخدام DAI Ad Break API، يمكنك إجراء ما يلي:
- تحسين معدّل الإعلانات المنشورة أثناء ذروة الزيارات: امنح خدمات "إدراج الإعلانات الديناميكية" (DAI) وقتًا أطول لاختيار الإعلانات الأعلى ربحًا لأحداث البث المباشر. ننصحك باستخدام DAI Ad Break API عندما تتضمّن أحداث البث المباشر عددًا كبيرًا من المستخدمين المتزامنين أو علامات إعلانات ديناميكية أو إعلانات ذات وقت استجابة طويل.
- التحكّم الكامل في فواصل الإعلانات: يمكنك إنشاء فواصل الإعلانات وتعديلها وحذفها مسبقًا، ما يوفّر مرونة أكبر من الإشارات إلى الإعلانات في ملف البيان، كما يوفّر معدّل تعبئة أعلى لعرض الإعلانات المتتالية مقارنةً باتّخاذ القرارات في الوقت الفعلي.
- تقديم تجربة مشاهدة بدون انقطاع: قلِّل أخطاء التشغيل المرتبطة بالإعلانات، مثل حزم الإعلانات غير المكتملة أو المكتملة بشكل مفرط، من خلال تقديم معلومات دقيقة عن فواصل الإعلانات.
يوضّح هذا الدليل طرق DAI Ad Break API ويشرح دورة حياة فواصل الإعلانات في مسارَي "الخدمة الكاملة" و"عرض الإعلانات المتسلسلة" في "إعلانات البث المباشر".
التعرّف على طرق DAI Ad Break API
تتيح واجهة برمجة التطبيقات الطرق القياسية التالية لإدارة موارد AdBreak:
-
Create: تحدّد هذه السمة كيانAdBreakجديدًا لكيانLiveStreamEvent. يمكنك اختياريًا ضبط السمةexpectedStartTimeلتحديد موعد لبدء قرار عرض الإعلان خلال 60 ثانية قبل بدء فاصل الإعلان. Get: تسترد هذه السمة تفاصيل عنصرAdBreakمعيّن، بما في ذلك حالة الفاصل الإعلاني والبيانات الوصفية المتعلقة بالتوقيت.List: تعرض هذه الطريقة قائمة بكياناتAdBreakتم إنشاؤها سابقًا باستخدام واجهة برمجة التطبيقات لكيانLiveStreamEventمعيّن، ويتم ترتيبها بترتيب زمني عكسي. يُرجى العِلم أنّ واجهة برمجة التطبيقات لا تعرض الفواصل الإعلانية المحدّدة في ملف بيان بث المحتوى فقط.Update: تعدّل هذه السمة كيانAdBreakحالي قبل بدء عملية اتّخاذ قرار عرض الإعلان.-
Delete: لإلغاء قرار الإعلان الخاص بعنصرAdBreakتم إنشاؤه سابقًا.
التعرّف على دورة حياة فواصل الإعلانات
تتضمّن جهة AdBreak الحالات التالية:
-
BREAK_STATE_UNSPECIFIED: الحالة التلقائية -
BREAK_STATE_SCHEDULED: تم إنشاء الفاصل الإعلاني بنجاح وتمت جدولة عرضه لاتّخاذ قرار بشأن الإعلان. -
BREAK_STATE_DECISIONED: بدأت خدمات "الإعلانات الديناميكية أثناء البث" عملية اختيار الإعلانات للفاصل الإعلاني. لا يمكنك تعديل فاصل الإعلانات، ولكن يمكنك إلغاؤه مع احتمال حدوث آثار سلبية على خوادم الإعلانات.
BREAK_STATE_COMPLETE: تم عرض الفاصل الإعلاني للمستخدمين.
يوضّح الرسم البياني التالي المخطط الزمني لكيان AdBreak، بدءًا من إنشائه وحتى اكتماله.
يمكنك إنشاء عنصر AdBreak قبل بدء الفاصل الإعلاني بمدة تتراوح بين دقيقة واحدة و300 دقيقة.
- تجنَّب إنشاء فاصل إعلاني قبل أقل من دقيقة واحدة من وقت البدء المتوقّع للفاصل، لأنّ خدمة "إعلانات الفيديو الديناميكية من Google" قد لا يتوفّر لها الوقت الكافي لاتّخاذ قرارات بشأن الإعلانات، ما يؤدي إلى انخفاض معدّل الإعلانات المنشورة.
- تجنَّب إنشاء فاصل إعلاني قبل أكثر من 6 ساعات من وقت بدء الفاصل الإعلاني المتوقّع، لأنّ خوادم الإعلانات قد تبطل الإعلانات المطلوبة.
تتناول الأقسام التالية عمليات الانتقال بين حالات فواصل الإعلانات في مسارات "الخدمة الكاملة" و"عرض الإعلانات المتسلسلة" في DAI.
فهم مسار الإعلانات الديناميكية أثناء البث التي تقدّمها خدمة كاملة
تتولّى خدمة "إدراج الإعلانات الديناميكي" الكاملة من Google إدارة كلّ من بيان المحتوى وحزم الإعلانات.
لتوجيه الإعلانات المخصّصة، استخدِم واجهة برمجة التطبيقات الخاصة بالفاصل الإعلاني في "الإعلانات الديناميكية داخل الفيديو" لإنشاء عنصر AdBreak قبل علامة الإعلان المقابلة في بيان البث المباشر للمحتوى.
- يسمح هذا الوقت المسبق لخدمات "الإعلانات الديناميكية أثناء البث" من Google باستخدام بيانات
AdBreakلاتّخاذ قرار بشأن الإعلان. - عندما يرصد نظام "إعلانات الفيديو الديناميكية من Google" علامة الإعلان في ملف البيان، يستخدم النظام قرارات الإعلان مع بيانات العنصر
AdBreakويغيّر حالة العنصر إلىBREAK_STATE_COMPLETE.
التعرّف على مسار عرض الإعلانات الضخمة
في هذا المسار، يمكنك إدارة بيان البث المباشر للمحتوى أو استخدام خدمة تابعة لجهة خارجية للتلاعب بالبيان من أجل رصد علامات الإعلانات في البيان.
يجب استدعاء واجهة برمجة التطبيقات "فواصل إعلانية في إدراج الإعلان الديناميكي" قبل وقت البدء المتوقّع للفاصل الإعلاني، وذلك لإنشاء عنصر AdBreak قبل الوقت الذي تحتاج فيه إلى طلب مقاطع مجموعة الإعلانات المتسلسلة أو بيان الإعلان.
عندما يرصد برنامج دمج الفيديوهات علامة الإعلان في ملف البيان وينشئ طلبات لقطعة إعلان مع معرّف فاصل إعلاني، تستخدم ميزة "الإعلانات الديناميكية أثناء عرض الفيديو" من Google بيانات AdBreak التي تتضمّن المعرّف نفسه لاتّخاذ قرارات بشأن الإعلانات.
بعد أن يطلب العميل وسائط إعلانية، ينتقل عنصر AdBreak الذي أنشأته من خلال واجهة برمجة التطبيقات إلى الحالة BREAK_STATE_COMPLETE.
تقديم طلبك الأول
لإعداد إمكانية الوصول إلى واجهة برمجة التطبيقات وإرسال طلبك الأول، يُرجى الاطّلاع على استخدام واجهة برمجة التطبيقات "فواصل إعلانية في DAI".