هر بخش یا درخواست مانیفست که با استفاده از سرویس پاد انجام می‌شود، باید شامل یک توکن امضا شده توسط HMAC برای احراز هویت باشد، به عنوان جایگزینی برای اعلان‌های اولیه تبلیغات .
این توکن می‌تواند یک بار در هر پخش آگهی محاسبه شود و در تمام جلسات پخش به اشتراک گذاشته شود.
پارامترهای توکن را جمع‌آوری کنید
اطلاعات زیر را از متن تبلیغ فعلی جمع‌آوری کنید تا در بدنه توکن قرار دهید.
| پارامترهای توکن | ||
|---|---|---|
ad_break_id | اگر پارامتر pod_id ارائه نشده باشد، الزامی است. | شناسه رشته‌ای برای نمایش تبلیغ. |
custom_asset_key | اگر پارامتر event ارائه نشده باشد، الزامی است. | کلید دارایی پخش زنده سفارشی، از Google Ad Manager. |
cust_params | اختیاری | پارامترهای هدف‌گذاری سفارشی برای نمایش تبلیغ. |
event | اگر پارامتر custom_asset_key ارائه نشده باشد، الزامی است. | کلید دارایی پخش زنده، تولید شده توسط Google Ad Manager. |
exp | مورد نیاز | زمان انقضای این توکن بر حسب ثانیه. |
network_code | در صورت ارائه پارامتر custom_asset_key الزامی است. | کد شبکه Ad Manager 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 Ad Manager است.
رشته توکن امضا
پس از تولید، امضای HMAC را به رشته توکن در قالب زیر اضافه کنید
~hmac={HMAC signature}
رشته توکن رمزگذاری شده با URL
این توکن به عنوان یک پارامتر URL ارسال می‌شود، بنابراین برای امنیت باید به صورت URL-encoded باشد.
مثال ۱
در اینجا مثالی آورده شده است که پارامترهای اختیاری استفاده نشده به عنوان رشته‌های خالی گنجانده شده‌اند.
رشته توکن
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
مثال ۲
در اینجا مثالی آورده شده است که در آن متغیرهای اختیاری بدون جمعیت به طور کامل حذف شده‌اند.
رشته توکن
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
مثال ۳
در اینجا مثالی با 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