نظرة عامة على واجهة برمجة تطبيقات DAI Pod لعرض

يتيح لك عرض مجموعة الإعلانات إمكانية تنفيذ ميزة إدراج الإعلانات من جهة الخادم مع "إعلانات Google" بدون إرسال المحتوى الخاص بك إلى خوادم إدراج الإعلانات الديناميكية (DAI) في Google. يمكنك التعاون مع الشريك التقني للفيديو حاليًا لمعالجة البيان أو تنفيذ خادم معالجة البيان الخاص بك باستخدام واجهة برمجة تطبيقات DAI Pod Serving API (بث مباشر أو فيديو عند الطلب).

يمكنك استخدام حزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية (IMA) من أجل تطوير تطبيقات العميل للويب والأنظمة الأساسية للأجهزة الجوّالة التي تتفاعل بسلاسة مع واجهة برمجة تطبيقات عرض DAI Pod. لضبط حزمة تطوير البرامج لإدراج إعلان ديناميكي لإعلانات الوسائط التفاعلية مع واجهة برمجة تطبيقات عرض DAI Pod، يمكنك الرجوع إلى الدليل الخاص بالأنظمة الأساسية لتطبيق العميل (Android وChromecast وHTML5 وiOS وRoku وtvOS) لتنسيق البث المباشر أو البث عند الطلب.

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

مكوّنات عرض لوحة DAI المتسلسلة

يتألف تطبيق واجهة برمجة التطبيقات DAI Pod Serving API من ثلاثة مكوّنات رئيسية:

"مدير إعلانات Google" هو خدمة مستضافة تنشئ جلسات بث المستخدمين وتديرها وتختار الإعلانات لعرضها وترميزها كشرائح بث وعرضها لمشغّل فيديو العميل عند الطلب.

في أحداث البث المباشر، يتم إدراج الإعلانات في الوقت الفعلي عندما يطلب مشغّل فيديو العميل مقاطع معيّنة ويتم عرضها على المشغّل كعمليات إعادة توجيه لعناوين URL لشرائح الوسائط هذه.

في أحداث البث المباشر المتوفرة عند الطلب، يتم اختيار الإعلانات قبل بدء التشغيل وإرسالها إلى أداة معالجة البيانات كمجموعة من بيانات البث المقابلة لكل مجموعة إعلانات متسلسلة.

أداة معالجة البيان

أداة معالجة البيان هو خادم يتلقى معرّف جلسة البث من مشغّل فيديو العميل، ويستخدمه لربط الإعلانات بمجموعة البث هذه وتضمين تلك الإعلانات في بيان البث.

بالنسبة إلى أحداث البث المباشر وفق بروتوكول HTTP (HLS)، لا يتواصل معالج البيانات مباشرةً مع "مدير إعلانات Google". بدلاً من ذلك، يتم وضع شرائح وسائط الإعلانات في بيان البث مع عناوين URL في "مدير إعلانات Google" لكي يتمكّن مشغّل فيديو العميل من طلب ملفات شرائح الوسائط الإعلانية.

بالنسبة إلى أحداث بث الفيديوهات عند الطلب، يتواصل معالج البيانات مباشرةً مع "مدير الإعلانات" لطلب الإعلانات، ويتلقى مجموعة من بيانات البث لدمجها مع بث المحتوى. يتم بعد ذلك إرسال البيان المجمّع إلى مشغّل فيديو العميل لتشغيله.

مشغّل فيديو العميل

مشغّل فيديو العميل هو التطبيق أو الموقع الإلكتروني الذي يشغّل في النهاية بث الفيديو الذي يحتوي على إعلانات. وقبل إجراء ذلك، تطلب الأداة معرّف مصدر بيانات من "مدير إعلانات Google" ثم تُمرِّر هذا المعرّف إلى أداة معالجة البيان لتلقّي بيان البث لتشغيله. كما أنها مسؤولة أيضًا عن مشاهدة البيانات الوصفية أثناء عرض الفيديو وبدء أحداث تتبع الإعلانات.

عرض البث المباشر مقابل عرض إعلانات الفيديو المتسلسلة

في حال إلقاء نظرة سريعة، قد يبدو عرض البث المباشر ولوحات الفيديوهات عند الطلب متشابهَين إلى حدّ كبير. ومع ذلك، هناك العديد من الاختلافات المهمة بين عمليتَي سير العمل.

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

من المهم مراعاة هذه الاختلافات أثناء عرض الإعلانات المتسلسلة المباشرة أو الفيديوهات عند الطلب.