(SSAI) للبث المباشر باستخدام واجهة برمجة التطبيقات Google Dynamic Ad Insertion (DAI) Pod serving.
يجب أن يتضمّن كل طلب مقطع يتم إجراؤه باستخدام عرض حزمة إعادة توجيه المقاطع رمزًا مميزًا موقّعًا باستخدام HMAC للمصادقة، وذلك في حال عدم استخدام إشعارات فواصل إعلانية مبكرة.
يمكن احتساب هذا الرمز المميّز مرة واحدة لكل فاصل إعلاني ومشاركته في جميع جلسات البث.
جمع مَعلمات الرمز المميّز
اجمع المعلومات التالية من الفاصل الإعلاني الحالي لملء نص الرمز المميّز.
| مَعلمات الرمز المميّز | ||
|---|---|---|
custom_asset_key
|
مطلوب | مفتاح مادة عرض البث المباشر المخصّص، من "مدير إعلانات Google" |
cust_params
|
اختياري | مَعلمات الاستهداف المخصّص يمكنك الاطّلاع على cust_params.
|
exp
|
مطلوب | الطابع الزمني لانتهاء صلاحية الرمز المميز بالثواني. |
network_code
|
مطلوب | رمز شبكة "مدير الإعلانات 360" لهذه الشبكة |
pod_id
|
مطلوب | تمثّل هذه السمة معرّف فاصل الإعلانات. يجب أن يكون عددًا صحيحًا يبدأ من
1 ويزيد بمقدار واحد لكل فاصل إعلاني.
يجب أن تكون هذه القيمة هي نفسها لدى جميع المستخدمين الذين يشاهدون فاصل الإعلان نفسه في الحدث الحالي. |
pd
|
مطلوب، باستثناء الأحداث التي تم تفعيل فواصل إعلانية بدون مدة فيها. | تمثّل هذه السمة مدة الفاصل الإعلاني بالمللي ثانية. يُشار إليه أعلاه باسم
ad_pod_duration.
|
scte35
|
اختياري | إشارة SCTE-35 مرمّزة باستخدام Base64 يتحمّل العميل مسؤولية التأكّد من صحة الإشارة. إذا كانت القيمة غير صحيحة، يتم إرسال رسالة إلى عنوان HTTP X-Ad-Manager-Dai-Warning في الرد، ويستمر نشر الإشارة لإنشاء فاصل إعلاني. اطّلِع على علامات الإعلانات المتوافقة لمزيد من المعلومات حول كيفية استخدام خدمة "إعلانات البث المباشر" لإشارة SCTE-35.
|
إنشاء سلسلة الرموز المميزة
أدرِج كل معلَمة بالترتيب الأبجدي، بالتنسيق name=value، مع فصل كل زوج من الاسم والقيمة بعلامة المد (~).
يمكن ترك المَعلمات الاختيارية بدون قيمة في مكانها مع سلسلة فارغة للقيمة، أو إزالتها بالكامل.
تنسيق سلسلة الرمز المميّز
custom_asset_key={custom_asset_key}~exp={expiration}~network_code={network_code}~pd={pod_duration}~pod_id={ad_pod_index}~scte35={scte35_message}
إنشاء توقيع HMAC
توقيع HMAC هو تجزئة SHA-256 لسلسلة الرمز المميز بتنسيق HEX. المفتاح السري هو مفتاح مصادقة HMAC المرتبط بحدث البث المباشر في "مدير إعلانات Google".
سلسلة الرمز المميّز للتوقيع
بعد إنشائه، ألحِق توقيع HMAC بسلسلة الرموز المميّزة بالتنسيق التالي:
~hmac={HMAC signature}
تشفير سلسلة الرمز المميز باستخدام ترميز عنوان URL
يتم تمرير هذا الرمز المميّز كمَعلمة عنوان URL، لذا يجب ترميزه كعنوان URL لضمان الأمان.
مثال 1
في ما يلي مثال يتم فيه تضمين المَعلمات الاختيارية غير المستخدَمة كسلاسل فارغة.
سلسلة الرمز المميز
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=
المفتاح السري
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
توقيع HMAC
86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
الرمز المميّز الموقّع
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~cust_params=~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
الرمز المميز الموقّع والمشفّر بنظام عناوين URL:
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~cust_params%3D~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3D86d7e5f8c96fe4c83141d764df376ae14a0e2066f2e6b2ccfb9e1e2d3c869a88
مثال 2
في ما يلي مثال على حذف المتغيرات الاختيارية غير المملوءة بالكامل.
سلسلة الرمز المميز
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g3~exp=1489680000~network_code=6062~pd=180000~pod_id=5
المفتاح السري
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
توقيع HMAC
6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
الرمز المميّز الموقّع
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~hmac=6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9
رمز مميز موقّع بترميز عنوان URL
custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~hmac%3D6a8c44c72e4718ff63ad2284edf2a8b9e319600b430349d31195c99b505858c9