إدراج إعلانات في بث مباشر باستخدام Pod Serving API

لتنفيذ ميزة "إدراج الإعلانات من جهة الخادم" (SSAI) مع البث المباشر وفق بروتوكول HLS أو DASH، استخدِم Pod Serving API لطلب حِزم إعلانية متكيّفة مع معدل نقل البيانات. للاطّلاع على الدقة ومعدلات نقل البيانات المتوافقة، يُرجى الانتقال إلى تنسيقات الفيديو والصوت وتحويل الترميز.

تتناول هذه الصفحة كيفية استخدام Pod Serving API للبث المباشر.

المتطلبات الأساسية

قبل المتابعة، يجب أن يتوفّر لديك ما يلي:

• اضبط حدث بث مباشر باستخدام نوع "إدراج الإعلانات الديناميكي" (DAI) إعادة توجيه عرض الإعلانات ضمن البودكاست. اختَر أحد الخيارَين التاليَين:

  • إعداد بث مباشر باستخدام ميزة "إدراج الإعلانات الديناميكي"
  • اختَر مكتبة برامج خاصة بواجهة SOAP API، ثم استدعِ طريقة LiveStreamEventService.createLiveStreamEvents باستخدام عنصر LiveStreamEvent ونوع dynamicAdInsertionType المضبوط على POD_SERVING_REDIRECT enum. للاطّلاع على جميع مكتبات البرامج، يُرجى الرجوع إلى مكتبات البرامج ونموذج الرمز.

• تطبيق عميل يعمل في متصفّح ويب أو جهاز جوّال أو تلفزيون لتحميل البث ومعالجة الأحداث، مثل التشغيل أو الإيقاف المؤقت أو النقر أو اللمس

• أداة معالجة لبيان البيانات للتعامل مع طلبات البث من تطبيق العميل ملاحظة مهمة: بالنسبة إلى خدمة بيان البيانات، ننصحك باستخدام مسار العرض المتقدّم.

• حساب على "مدير إعلانات Google" تم تفعيل ميزة "الإعلانات الديناميكية المدرَجة" فيه

مسار العرض الأساسي

لبث المحتوى، اختَر بروتوكول البث واتّبِع الخطوات التالية:

HLS

1. لتسجيل جلسة، أرسِل طلب بث من مشغّل الفيديو إلى "مدير إعلانات Google".

2. ابدأ في طلب البيانات الوصفية للإعلانات لمعرفة أحداث الإعلانات القادمة.

3. اطلب بيان البث المباشر من أداة معالجة البيانات.

4. اختياري: إرسال إشعار بفاصل إعلاني مبكر إلى "مدير إعلانات Google" ملاحظة مهمة: ننصحك باتّباع هذه الخطوة لتحسين معدّل التعبئة.

5. عندما يرصد معالج ملف البيان علامة فاصل إعلاني، أنشئ عناوين URL لشرائح الإعلانات وادمجها في ملف البيان.

   • أثناء فاصل إعلاني، يطلب مشغّل الفيديو الخاص بالعميل مقطعًا إعلانيًا ويتبع عنوان URL لإعادة توجيه المقطع لتنزيل ملف المقطع الإعلاني.

6. استخرِج معرّفات أحداث الإعلانات من علامات ID3 للعثور على إشعارات التحقّق من الوسائط وإرسالها إلى Google.

DASH

1. اتّبِع جميع الخطوات في علامة التبويب HLS.

2. اطلب نموذجًا لفترة DASH مرة واحدة وخزِّنه مؤقتًا. تنشئ هذه الطريقة الفترات الزمنية لجميع الفواصل الإعلانية في الجلسة.

مسار العرض المتقدّم

لبث المحتوى، اختَر بروتوكول بث:

HLS

1. لتسجيل جلسة، عليك إرسال طلب بث من مشغّل الفيديو الخاص بالعميل إلى "مدير إعلانات Google".

2. ابدأ في طلب البيانات الوصفية للإعلانات لمعرفة أحداث الإعلانات القادمة.

3. اطلب بيان البث المباشر من أداة معالجة البيانات.

4. اختياري: إرسال إشعار بفاصل إعلاني مبكر إلى "إدارة إعلانات Google" لتحسين معدّل التعبئة

5. إرسال طلب بيانات وصف توقيت حزمة الإعلانات (ATM) إلى "مدير إعلانات Google"

6. استرداد وقت عرض حزمة الإعلانات ولوحة الإعلانات بدقة لإنشاء عناوين URL الخاصة بمقطع الإعلان

7. دمج عناوين URL لشرائح الإعلانات في البيان

8. عندما يرصد معالج ملف البيان علامة فاصل إعلاني، أنشئ عناوين URL لشرائح الإعلانات وادمجها في ملف البيان.

   • أثناء فاصل إعلاني، يطلب مشغّل الفيديو الخاص بالعميل مقطعًا إعلانيًا ويتبع عنوان URL لإعادة توجيه المقطع لتنزيل ملف المقطع الإعلاني.

9. استخرِج معرّفات أحداث الإعلانات من علامات ID3 للعثور على إشعارات التحقّق من الوسائط وإرسالها إلى Google.

DASH

1. اتّبِع جميع الخطوات في علامة التبويب HLS.

2. استخدِم ردود بيانات Ad pod Timing Metadata (ATM) للحقول الإضافية المطلوبة من أجل إنشاء فترات DASH.

تعليمات مفصّلة

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