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