כל בקשת מקטע שנשלחת באמצעות הצגת pod של מקטעים להפניה מחדש חייבת לכלול אסימון בחתימה 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