يجب أن يتضمن كل طلب شريحة يتم إجراؤه باستخدام عرض لوحة إعادة توجيه الشريحة الرمز المميز المُوقَّع على بروتوكول 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