כל בקשה לפלח או למניפסט שמתבצעת באמצעות הצגת מודעות בבלוקים חייבת לכלול אסימון חתום באמצעות 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 כדי לשמור על הבטיחות.
דוגמה 1
בדוגמה הבאה, פרמטרים אופציונליים שלא נעשה בהם שימוש נכללים כמחרוזות ריקות.
מחרוזת טוקן
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
דוגמה 2
בדוגמה הבאה, המשתנים האופציונליים שלא הוזנו מושמטים לחלוטין.
מחרוזת טוקן
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
דוגמה 3
הנה דוגמה עם 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