يجب أن يتضمّن كل طلب لشريحة أو بيان باستخدام ميزة "عرض الإعلانات أثناء البث" رمزًا مميزًا موقّعًا باستخدام HMAC للمصادقة، وذلك كحلّ احتياطي لإشعارات فواصل الإعلانات المبكرة.
يمكن احتساب هذا الرمز المميّز مرة واحدة لكل فاصل إعلاني ومشاركته في جميع جلسات البث.
جمع مَعلمات الرمز المميّز
اجمع المعلومات التالية من الفاصل الإعلاني الحالي لملء نص الرمز المميّز.
| مَعلمات الرمز المميّز | ||
|---|---|---|
ad_break_id
|
مطلوبة إذا لم يتم تقديم المَعلمة pod_id.
|
تمثّل هذه السمة معرّف السلسلة لفاصل الإعلانات. |
custom_asset_key
|
مطلوبة إذا لم يتم تقديم المَعلمة event.
|
مفتاح مادة عرض البث المباشر المخصّص، من "مدير إعلانات Google" |
cust_params
|
اختياري | مَعلمات الاستهداف المخصّصة لفاصل الإعلانات |
event
|
مطلوبة إذا لم يتم تقديم المَعلمة custom_asset_key.
|
مفتاح عنصر البث المباشر الذي تم إنشاؤه بواسطة "مدير إعلانات Google" |
exp
|
مطلوب | الطابع الزمني لانتهاء صلاحية الرمز المميز بالثواني. |
network_code
|
مطلوبة في حال توفير المَعلمة custom_asset_key.
|
رمز شبكة "مدير الإعلانات 360" لهذه الشبكة |
pod_id
|
مطلوبة إذا لم يتم تقديم المَعلمة ad_break_id.
|
المعرّف الرقمي لفاصل الإعلانات. |
pd
|
مطلوب، باستثناء الأحداث التي تم تفعيل فواصل إعلانية فيها بدون مدة. | تمثّل هذه السمة مدة الفاصل الإعلاني بالمللي ثانية. |
scte35
|
اختياري | إشارة SCTE-35 المرمّزة باستخدام Base64 للفاصل الإعلاني. |
إنشاء سلسلة الرموز المميزة
أدرِج كل معلَمة بالترتيب الأبجدي، بالتنسيق 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
في ما يلي مثال يتم فيه تضمين المَعلمات الاختيارية غير المستخدَمة كسلاسل فارغة.
سلسلة الرموز المميزة
cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=
المفتاح السري
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
توقيع HMAC
ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
الرمز المميّز الموقّع
cust_params=~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~pod_id=5~scte35=~hmac=ea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
الرمز المميز الموقّع والمشفّر بنظام عناوين URL:
cust_params%3D~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~pod_id%3D5~scte35%3D~hmac%3Dea1081cc1ab83cacd1e64073fc19e64616b2571249232917dc9f539cafb4b94e
مثال 2
في ما يلي مثال على حذف المتغيرات الاختيارية غير المملوءة بالكامل.
سلسلة الرموز المميزة
custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~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
مثال 3
في ما يلي مثال على استخدام السمة ad_break_id.
سلسلة الرموز المميزة
ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000
المفتاح السري
A7490591290583E4B93189DEE7E287C299FC686872ABC7ADC9F9F536443505F
توقيع HMAC
327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29
الرمز المميّز الموقّع
ad_break_id=adbreak1~custom_asset_key=iYdOkYZdQ1KFULXSN0Gi7g~exp=1489680000~network_code=6062~pd=180000~hmac=327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29
رمز مميز موقّع بترميز عنوان URL
ad_break_id%3Dadbreak1~custom_asset_key%3DiYdOkYZdQ1KFULXSN0Gi7g~exp%3D1489680000~network_code%3D6062~pd%3D180000~hmac%3D327b23b80d032b0fa4c41b64a5e44fa7733af5bdbf173b7d89135aef05ae6d29