هر درخواست بخش که با استفاده از سرویس غلاف تغییر مسیر بخش انجام می‌شود، اگر از اعلان‌های زودهنگام وقفه‌های تبلیغاتی استفاده نمی‌کند، باید یک نشانه با امضای HMAC برای احراز هویت داشته باشد.
این نشانه را می توان یک بار در هر وقفه تبلیغاتی محاسبه کرد و در تمام جلسات جریان به اشتراک گذاشت.
پارامترهای نشانه را جمع آوری کنید
برای پر کردن بدنه نشانه، اطلاعات زیر را از وقفه تبلیغاتی فعلی جمع آوری کنید.
| پارامترهای توکن | ||
|---|---|---|
custom_asset_key | مورد نیاز | کلید دارایی پخش مستقیم سفارشی، از Google Ad Manager. |
cust_params | اختیاری | پارامترهای هدف گذاری سفارشی cust_params ببینید. |
exp | مورد نیاز | مهر زمانی انقضا برای این نشانه در چند ثانیه. |
network_code | مورد نیاز | کد شبکه Ad Manager 360 برای این شبکه. |
pod_id | مورد نیاز | شناسه وقفه تبلیغاتی باید یک عدد صحیح باشد که از 1 شروع می شود و برای هر وقفه تبلیغاتی یک عدد افزایش می یابد.این مقدار باید برای همه کاربرانی که یک وقفه تبلیغاتی را در رویداد فعلی مشاهده می‌کنند یکسان باشد. |
pd | الزامی است، به جز رویدادهایی که وقفه‌های تبلیغاتی بدون مدت فعال هستند. | مدت زمان وقفه تبلیغاتی بر حسب میلی ثانیه. در بالا به عنوان ad_pod_duration اشاره شده است. | scte35 | اختیاری | سیگنال SCTE-35 با کد Base64. این مسئولیت مشتری است که از صحت سیگنال اطمینان حاصل کند. در صورت نادرست بودن، پیامی به هدر HTTP X-Ad-Manager-Dai-Warning در پاسخ ارسال می شود و سیگنال همچنان برای ایجاد یک وقفه تبلیغاتی منتشر می شود. برای اطلاعات بیشتر در مورد نحوه استفاده DAI از سیگنال SCTE-35 به نشانگرهای تبلیغاتی پشتیبانی شده مراجعه کنید. |
رشته توکن ایجاد کنید
هر پارامتر را به ترتیب حروف الفبا، با فرمت name=value ، با هر جفت نام-مقدار با یک کاراکتر tilde ( ~ ) از هم جدا کنید.
پارامترهای اختیاری بدون مقدار را می توان با یک رشته خالی برای مقدار در جای خود رها کرد یا به طور کامل حذف کرد.
قالب رشته توکن
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 Ad Manager مرتبط است.
رشته رمز را امضا کنید
پس از تولید، امضای 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