כל בקשה לפלח שנוצרת באמצעות רצף של הפניות לכתובות URL אחרות צריכה לכלול אסימון בחתימה 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, כאשר כל צמד של שם-ערך מופרד בתו טילדה (~).
אפשר להשאיר פרמטרים אופציונליים בלי ערך עם מחרוזת ריקה עבור הערך, או להסיר אותם לגמרי.
פורמט מחרוזת אסימון
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