תחילת העבודה עם SGAI

התכונה 'הוספת מודעה מודרכת' (SGAI) מספקת מניפסט של רצף מודעות שמוכן ליצור תפרים במכשירים של הלקוחות. אם הפעלתם DAI להצגת Pod ב-Google רשת Ad Manager, יש לך גישה לשימוש ב-SGAI. אם אתם לא משתמשים בתכונה 'הצגת Pod' הטמעת מודעות דינמיות מופעלת. צריך לפנות למנהל החשבון.

ב-SGAI, משתמשים בנקודות הקצה של Podserving API כדי ליצור שידור אחזור המטא-נתונים של המודעה והמניפסטים של רצף המודעות.

אם יש לכם שרת לטיפול במניפסטים, אפשר ליצור את רצף המודעות כתובות URL במניפסט ומוסיפים סמנים של מודעות שנושאים את פרטי המניפסט של רצף המודעות בזרם התוכן שלך, בהתאם למפרט המועדף עליך.

לחלופין, אפשר לתזמן הפסקה למודעה באמצעות מנגנון אחר מאשר הסמנים של המודעה במניפסט של השידור. במקרים כאלה, האפליקציה יכולה להאזין לאירועים אחרים, למשל, אינטראקציה של משתמש עם מקור הנתונים, האפליקציה עצמה, או התראה. אחרי האירועים האלה, האפליקציה יכולה ליצור את המודעה כתובות URL של מניפסט Pod ולבקש לנגן להתחיל לטעון את המניפסט של רצף המודעות.

דרישות מוקדמות

לפני שממשיכים, חשוב לוודא שהתנאים הבאים מתקיימים:

• הצגת ה-DAI Pod הופעלה ברשת Google Ad Manager.
• אירוע בשידור חי מסוג מניפסט להצגת Pod. כדי ליצור את האירוע, לראות איך מגדירים שידור חי להטמעת מודעות דינמיות (DAI)

יישום ההמלצות

לפני שמתחילים ליצור את כתובת ה-URL של המניפסט של רצף המודעות, מומלץ קוראים לפונקציה ממשק API של התראה מוקדמת על הפסקה למודעה (EABN) כדי לציין את משך הזמן הצפוי, פרטי הטירגוט ופרטים נוספים הפרמטרים של כל הפסקה למודעה.

כדי להפעיל את המסלול לסביבת הייצור או לבדיקה, צריך לקרוא ל-EABN API, במיוחד אם המודעה יש קמפיינים פרוגרמטיים כלשהם. מידע נוסף זמין במאמר הבא: תכונות והנחיות לתוכנית פרוגרמטית ישירה.

שליחת בקשת הרשמה לשידור

כשמשתמש מתחיל שידור תוכן באפליקציה של נגן הווידאו, נוצר שידור בקשת הרשמה עם פרמטרים של טירגוט ליצירת סשן סטרימינג ב-Ad Manager. פרטים על הגשת בקשה לרישום מקור נתונים זמינים במאמר method:stream. לאחר מכן מקבלים נתונים של תגובות מהבקשה.

הדוגמאות הבאות הן בקשות רישום לשידור:

טקסט פשוט HTTP

• בקשה:

authority: dai.google.com
method: POST
path: /ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream
scheme: https
content-type: application/x-www-form-urlencoded

cust_params=customID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2

• תשובה:

{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

קונכייה

• שורת הפקודה:

curl \
-H "Host: dai.google.com" \
-H "content-type: application/x-www-form-urlencoded" \
  --data-binary "cust_params=channelID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2" \
  --compressed "https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream"

• פלט:

{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

JavaScript

• באמצעות Fetch API:

const response = await fetch("https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream", {
  "headers": {
    "content-type": "application/x-www-form-urlencoded",
  },
  "body": "cust_params=channelID%3D1543216789%26anotherKey%3Dvalue1%2Cvalue2",
  "method": "POST",
});

  const stream = await response.json();
  console.log(stream);

• יומן המסוף:

{
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "polling_frequency": 10,
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "manifest_format": "hls"
}

סקר למטא-נתונים של הפסקות למודעות

אחרי ששולחים בקשת הרשמה לשידור, מבצעים סקר למטא-נתונים של המודעה. שפת תרגום הסקר, הגדרת טיימר באמצעות ה-polling_frequence בתשובה שמשודרת בשידור, שלב ההרשמה לקריאה למודעה מטא-נתונים. בכל סקר עשויה להופיע רשימה חלקית של מודעות עם מטא-נתונים, להפוך לזמינים.

יצירת כתובת ה-URL למניפסט של רצף המודעות

בונים כתובת URL עבור משאב pod של Pod serving API. לאחר מכן, מעבירים את כתובת ה-URL לנגן וידאו כדי להתחיל טוען את רצף המודעות.

הדוגמה הבאה ממחישה את המבנה של כתובת ה-URL של המניפסט של רצף המודעות:

https://dai.google.com/linear/pods/v1/hls/network/51636543/custom_asset/pod_serving_hls_manifest_mp4/pod/101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000

הערה: הפרמטרים של ההפסקות למודעות, למשל pod_id, duration, cust_params ו-scte35 חייב להיות זהה לכל הלקוחות שצופים באותו שידור חי, ואילו מזהה מקור הנתונים הוא ייחודי לכל לקוח. אם בוחרים ליצור את כתובת ה-URL של המניפסט של רצף המודעות בצד השרת ולהוסיף את כתובות ה-URL שנוצרו במניפסט של השידור, צריך לפעול לפי הכלי לשינוי המניפסט תיעוד השרת על שליחת מזהה מקור הנתונים מהלקוחות ויצירת פרמטרים אחרים של הפסקות למודעות.

אפשר לחשב את הפרמטרים של כתובת ה-URL במניפסט של רצף המודעות על סמך ההפסקה למודעה מידע שאוחזר מנגן הווידאו או מהתראה בחיבור לשרת. עבור הדרישות של הפרמטרים האלה. שיטה: מניפסט של Pod.

השמעת המניפסט של רצף המודעות

באפליקציית הלקוח של נגן הווידאו, מתחילים את הפעלת התוכן בסטרימינג באמצעות בנגן הווידאו ולפעול בהתאם למסמכי התיעוד של נגן הווידאו כדי לצפות הפעלה ותזמון הצגת מודעות, אם רלוונטי.

אם אתם יוצרים את כתובות ה-URL של המניפסט של רצף המודעות ומטמיעים אותן במניפסט בצד השרת, לצפות באירועים הקרובים של ההפסקות למודעות בנגן הווידאו, ולוודא להירשם לאירועי id3 בכל הפעלה של הפסקה למודעות. אם מתזמנים את הצגת המודעה יש להפסיק אירועים מצד הלקוח, להירשם לאירועי id3 בעת היצירה.

דיווח על חשיפות ואירועי מודעות

כשנגן וידאו מפעיל את רצף המודעות ומוצא מטא-נתונים מתוזמנים מסוג id3, הוא מקשיב לאירועי מודעות שמפעיל נגן הווידאו ומעבד אותם כדי לשלוח פינגים לאימות מדיה.

חשוב: אין לעכב את הפינג לכתובת ה-URL לאימות במדיה. אנחנו ממליצים לך לעשות פינג באופן מיידי ולא יותר מדקה.