یک نشانه HMAC امضا شده ایجاد کنید

هر درخواست بخش که با استفاده از سرویس غلاف تغییر مسیر بخش انجام می‌شود، اگر از اعلان‌های زودهنگام وقفه‌های تبلیغاتی استفاده نمی‌کند، باید یک نشانه با امضای 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