تتيح لك واجهة برمجة التطبيقات "إدراج الإعلانات الديناميكي" (DAI) لفواصل الإعلانات إنشاء بيانات استهداف الإعلانات وتوقيت فواصل الإعلانات القادمة في أحداث البث المباشر وإدارتها.
باستخدام DAI Ad Break API، يمكنك إجراء ما يلي:
- تحسين معدّل عرض الإعلانات خلال ذروة عدد الزيارات: امنح خدمات "إعلانات الفيديو الديناميكية" المزيد من الوقت لاختيار الإعلانات التي تحقّق أعلى عائد لأحداثك المباشرة. ننصحك باستخدام واجهة برمجة التطبيقات DAI Ad Break API عندما تتضمّن أحداث البث المباشر عددًا كبيرًا من المستخدمين المتزامنين، أو علامات فواصل إعلانية ديناميكية، أو إعلانات ذات وقت استجابة طويل.
- التحكّم الكامل في فواصل الإعلانات: يمكنك إنشاء فواصل إعلانات وتعديلها وحذفها مسبقًا، ما يوفّر مرونة أكبر من الإشارات الإعلانية في ملف البيان ومعدّل تعبئة أعلى لعرض الإعلانات المتتالية مقارنةً باتّخاذ القرارات في الوقت المناسب.
- تقديم تجربة مشاهدة بدون انقطاع: يمكنك تقليل أخطاء التشغيل المرتبطة بالإعلانات، مثل حزم الإعلانات غير المكتملة أو المكتملة بشكل مفرط، من خلال تقديم معلومات دقيقة عن فواصل الإعلانات.
يوضّح هذا الدليل طرق DAI Ad Break API ويشرح دورة حياة فواصل الإعلانات في DAI Full Service وعمليات عرض الإعلانات المتتالية.
التعرّف على طرق 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 ساعات من وقت البدء المتوقّع للفاصل، لأنّ خوادم الإعلانات قد تبطل الإعلانات المطلوبة.
تغطّي الأقسام التالية حالات الانتقال في فواصل الإعلانات ضمن مسارات "الخدمة الكاملة" و"عرض الإعلانات المتسلسلة" في "الإعلانات الديناميكية أثناء البث".
فهم مسار إدراج الإعلان الديناميكي الذي تقدّمه خدمة كاملة
تتولّى خدمة "إدراج الإعلانات الديناميكي" المتكاملة من Google إدارة كلّ من بيان المحتوى ومجموعات الإعلانات المتسلسلة.
لتوجيه الإعلانات المخصّصة، استخدِم واجهة برمجة التطبيقات الخاصة بالفاصل الإعلاني في "الإعلانات الديناميكية أثناء البث" لإنشاء عنصر AdBreak
قبل علامة الإعلان المقابلة في بيان بث المحتوى المباشر.
- يسمح وقت التنفيذ هذا لخدمات "الإعلانات الديناميكية أثناء البث" من Google باستخدام بيانات
AdBreakلاتّخاذ قرار بشأن الإعلان. - عندما ترصد ميزة "الإعلانات الديناميكية المدرَجة" من Google علامة الإعلان في ملف البيان، يستخدم النظام قرارات الإعلان مع بيانات العنصر
AdBreakويغيّر حالة العنصر إلىBREAK_STATE_COMPLETE.
فهم عملية عرض الإعلانات ضمن Pods
في هذا المسار، يمكنك إدارة بيان البث المباشر للمحتوى أو استخدام خدمة تابعة لجهة خارجية لمعالجة البيان من أجل رصد علامات الإعلانات في البيان.
يجب طلب واجهة برمجة التطبيقات "فواصل إعلانية في DAI" قبل وقت البدء المتوقّع للفاصل الإعلاني من أجل إنشاء عنصر AdBreak قبل الوقت الذي تحتاج فيه إلى طلب مقاطع مجموعة الإعلانات أو بيان الإعلان.
عندما يرصد برنامج دمج الفيديوهات علامة الإعلان في ملف البيان ويُرسل طلبات لقطعة إعلان مع معرّف فاصل إعلاني، تستخدم ميزة "إدراج إعلان ديناميكي" من Google بيانات AdBreak التي تتضمّن المعرّف نفسه لاتّخاذ قرارات بشأن الإعلانات.
بعد أن يطلب العميل وسائط إعلانية، تنتقل حالة الكيان AdBreak الذي أنشأته من خلال واجهة برمجة التطبيقات إلى الحالة BREAK_STATE_COMPLETE.
تقديم طلبك الأول
لإعداد إمكانية الوصول إلى واجهة برمجة التطبيقات وتقديم طلبك الأول، راجِع مقالة استخدام واجهة برمجة التطبيقات "فواصل إعلانية في DAI".