إدراج الإعلانات باستخدام إعادة توجيه الأقسام

يغطّي هذا الدليل عملية ضبط أداة معالجة ملف البيان لطلب مقاطع إعلانات أو مقاطع لوحات إعلانية باستخدام طريقة pod segment الخاصة بالإعلانات.

اختَر بروتوكول بث:

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

قبل المتابعة، يجب إعداد حدث بث مباشر لنوع إعادة التوجيه إلى عرض الإعلانات ضمن حزمة في "إدراج الإعلانات الديناميكي" (DAI) وملفات الترميز. لإعداد حدث بث مباشر، اختَر إحدى الطرق التالية:

بعد إعداد حدث البث المباشر، استرجِع ملفات الترميز الخاصة بالحدث من واجهة مستخدم "مدير الإعلانات" أو واجهة برمجة التطبيقات من خلال طلب البيانات من طريقة DaiEncodingProfileService.getDaiEncodingProfilesByStatement.

استرداد مجموعة بث المحتوى

عندما يختار المستخدم حدث بث مباشر، يرسل تطبيق العميل طلب بث إلى "مدير إعلانات Google". في ردّ البث، يستخرج التطبيق رقم تعريف جلسة Google DAI والبيانات الوصفية لتضمينها في طلب بيان البث.

يمرِّر المثال التالي رقم تعريف جلسة Google DAI إلى أداة معالجة ملفات البيان:

https://MANIFEST_MANIPULATOR_URL/manifest.m3u8?DAI_stream_ID=SESSION_ID&network_code=NETWORK_CODE&DAI_custom_asset_key=CUSTOM_ASSET_KEY

عند معالجة طلب تشغيل محتوى الفيديو، يتم تخزين معرّف جلسة Google DAI وCUSTOM_ASSET_KEY من الطلب للتحضير لدمج الإعلانات.

تحديد فواصل الإعلانات وإدراج فواصل

أثناء معالجة كل بيان متغير، حدِّد العلامتَين EXT-X-CUE-IN وEXT-X-CUE-OUT في البث، للإشارة إلى بداية فاصل إعلاني ونهايته.

استبدِل علامتَي EXT-X-CUE-IN وEXT-X-CUE-OUT بعناصر EXT-X-DISCONTINUITY ليتمكّن مشغّل الفيديو على الجهاز من التبديل بين المحتوى والإعلانات.

يستبدل ملف البيان التالي العلامتَين EXT-X-CUE-IN وEXT-X-CUE-OUT:

#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:0

#EXTINF:5.000,
contentorigin.com/1.ts
#EXTINF:5.000,
contentorigin.com/2.ts
#EXT-X-CUE-OUT:15.000
#EXTINF:5.000,
contentorigin.com/3.ts
#EXTINF:5.000,
contentorigin.com/4.ts
#EXTINF:5.000,
contentorigin.com/5.ts
#EXT-X-CUE-IN
#EXTINF:5.000,
contentorigin.com/6.ts
#EXTINF:5.000,
contentorigin.com/7.mp4
#EXTINF:5.000,
contentorigin.com/8.mp4

يوضّح المثال التالي ملف بيان تم استبداله:

#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:0

#EXTINF:5.000,
contentorigin.com/1.ts
#EXTINF:5.000,
contentorigin.com/2.ts
#EXTINF:5.000,
#EXT-X-DISCONTINUITY
{... Insert ad segments here ...}
#EXT-X-DISCONTINUITY
#EXTINF:5.000,
contentorigin.com/6.mp4
#EXTINF:5.000,
contentorigin.com/7.mp4
#EXTINF:5.000,
contentorigin.com/8.mp4

لا يتم تشفير شرائح إعلانات "إدراج الإعلان الديناميكي" من Google. إذا كان المحتوى مشفّرًا، عليك إزالة التشفير من خلال إدراج العنصر EXT-X-KEY:METHOD=NONE قبل أول مقطع إعلاني في كل فاصل إعلاني. في نهاية فاصل الإعلانات، أضِف التشفير مرة أخرى من خلال إدراج EXT-X-KEY مناسب.

تتبُّع وقت البدء والمدة والفهرس للفاصل الإعلاني القادم

إنشاء عناوين URL لشرائح الإعلانات

استبدِل كل جزء من المحتوى بين علامتَي EXT-X-DISCONTINUITY بعنوان URL يشير إلى طريقة جزء مجموعة إعلانات متسلسلة.

يجمع المثال التالي جزءًا من مجموعة إعلانات متسلسلة. يُرجى العِلم أنّ شرائح الإعلانات تستخدِم فهرسًا يبدأ من الصفر:

https://dai.google.com/linear/pods/v1/seg/network/NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/0.ts?sd=AD_SEGMENT_DURATION&pd=AD_BREAK_DURATION&stream_id=SESSION_ID&auth-token=HMAC

يُدرج المثال التالي شرائح مجموعة الإعلانات المتسلسلة في ملف البيان:

#EXTM3U
#EXT-X-VERSION:6
#EXT-X-TARGETDURATION:6
#EXT-X-MEDIA-SEQUENCE:0

#EXTINF:5.00,
contentorigin.com/1.ts
#EXTINF:5.00,
contentorigin.com/2.ts
#EXT-X-DISCONTINUITY
#EXTINF:5.00,
https://dai.google.com/linear/pods/v1/seg/network/
NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/0.ts?sd=5000&so=0&pd=15000&stream_id=SESSION_ID
#EXTINF:5.00,
https://dai.google.com/linear/pods/v1/seg/network/
NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/1.ts?sd=5000&so=5000&pd=15000&stream_id=SESSION_ID
#EXTINF:5.00,
https://dai.google.com/linear/pods/v1/seg/network/
NETWORK_CODE/custom_asset/CUSTOM_ASSET_KEY/ad_break_id/AD_BREAK_ID/profile/ENCODING_PROFILE/2.ts?sd=5000&so=10000&pd=15000&stream_id=SESSION_ID
#EXT-X-DISCONTINUITY
#EXTINF:5.00,
contentorigin.com/6.mp4
#EXTINF:5.00,
contentorigin.com/7.mp4
#EXTINF:5.00,
contentorigin.com/8.mp4

اختياري: جدولة فاصل إعلاني

لتحسين معدل التعبئة، أرسِل إشعارًا مبكرًا بفاصل إعلاني (EABN) يتضمّن مدة مجموعة الإعلانات المتسلسلة، ومعلَمات الاستهداف المخصّصة، وبيانات إشارة SCTE-35. لمزيد من التفاصيل، يُرجى الاطّلاع على إرسال إشعارات بشأن فواصل إعلانية مبكرة.