יצירת הגדרה לאירוע בשידור חי

כדי לשלב את Ad Manager, צריך ליצור הגדרה של שידור חי לאירוע שידור חי מסוים. ‫Video Stitcher API רושם את ההגדרה הזו ב-Ad Manager.

יצירת לוח

לפני שיוצרים את ההגדרה של השידור החי, צריך ליצור לוח. ממשק Video Stitcher API מוסיף סרטון בשקופית חוסמת שמוגדר כברירת מחדל כשאי אפשר להוסיף מודעות. צריך לרשום את הסרטון בשקופית החוסמת באמצעות Video Stitcher API כדי לציין את השקופית שבה יש להשתמש כשאין מודעות. סרטון הלוח יכול להיות כל קובץ MP4 עם טראק אודיו אחד לפחות.

יש שתי אפשרויות ליצירת הלוח הזה. אתם יכולים ליצור לוח ברירת מחדל לרשת בחשבון Ad Manager או ליצור לוחות באמצעות Video Stitcher API.

יצירת לוח מודעות ב-Ad Manager

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

יצירת לוח באמצעות Video Stitcher API

כדי ליצור סלייט באמצעות Video Stitcher API, משתמשים ב-method‏ projects.locations.slates.create.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_NUMBER: מספר הפרויקט שלכם. הוא מופיע בשדה מספר הפרויקט בדף הגדרות IAM. Google Cloud
• ‫LOCATION: המיקום שבו רוצים ליצור את המסך. צריך להשתמש באחד מהאזורים הנתמכים.
  הצגת מיקומים
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• ‫SLATE_ID: מזהה שמוגדר על ידי המשתמש עבור הלוח. המזהה יכול לכלול רק אותיות קטנות, מספרים ומקפים. התו הראשון חייב להיות אות, התו האחרון חייב להיות אות או מספר, והמזהה כולו יכול לכלול עד 63 תווים.
• ‫SLATE_URL: ה-URI הציבורי של סרטון MP4 עם לפחות טראק אודיו אחד (סרטון לאימון המודל)
• ‫NETWORK_CODE: המזהה המספרי של רשת Ad Manager. אפשר למצוא אותו ב הגדרות הגלובליות של חשבון בעל התוכן הדיגיטלי.
  חשוב: כדי להשתמש בלוח עם Google Ad Manager ‏ (GAM), צריך לכלול את האובייקט gamSlate.

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json. כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:

cat > request.json << 'EOF'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
EOF

לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/slates?slateId=SLATE_ID"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

שומרים את גוף הבקשה בקובץ בשם request.json. כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:

@'
{
  "uri": "SLATE_URL",
  "gamSlate": {
    "networkCode": "NETWORK_CODE"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/slates?slateId=SLATE_ID" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "verb": "create"
  },
  "done": false
}

הפקודה הזו יוצרת פעולה ממושכת (LRO) שאפשר להריץ עליה שאילתה כדי לעקוב אחרי ההתקדמות. מעתיקים את OPERATION_ID שמוחזר, שהוא החלק האחרון בשדה name, כדי להשתמש בו בקטע הבא.

בדיקת התוצאה

כדי לבדוק אם נוצר סלייט, משתמשים בשיטה projects.locations.operations.get. אם התשובה מכילה את הערך "done: false", חוזרים על הפקודה עד שהתשובה מכילה את הערך "done: true".

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_NUMBER: מספר הפרויקט שלכם. הוא מופיע בשדה מספר הפרויקט בדף הגדרות IAM. Google Cloud
• ‫LOCATION: מיקום הנתונים. צריך להשתמש באחד מהאזורים הנתמכים
  הצגת מיקומים
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• ‫OPERATION_ID: המזהה של הפעולה

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "endTime": END_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.Slate",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
    "uri": "SLATE_URL",
    "gamSlate": {
      "networkCode": "NETWORK_CODE"
      "gamSlateId": "GAM_SLATE_ID"
    }
  }
}

יצירת ההגדרה הפעילה

כדי ליצור את ההגדרה, משתמשים בשיטה projects.locations.liveConfigs.create. במאמרי העזרה בנושא הגדרות בזמן אמת מפורטים שדות אופציונליים (כמו כותרות בהתאמה אישית).

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_NUMBER: מספר הפרויקט שלכם. הוא מופיע בשדה מספר הפרויקט בדף הגדרות IAM. Google Cloud
• ‫LOCATION: המיקום שבו רוצים ליצור את התצורה הפעילה. צריך להשתמש באחד מהאזורים הנתמכים.
  הצגת מיקומים
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• ‫LIVE_CONFIG_ID: מזהה מוגדר על ידי המשתמש עבור ההגדרה הפעילה. המזהה יכול לכלול רק אותיות קטנות, מספרים ומקפים. התו הראשון חייב להיות אות, התו האחרון חייב להיות אות או מספר, והמזהה כולו יכול לכלול עד 63 תווים.
• ‫SOURCE_LIVESTREAM_URI: כתובת ה-URL של המקור למניפסט של הסרטון בשידור חי. הסרטון צריך להיות נגיש ל-Video Stitcher API. כתובת ה-URL צריכה להיות נגישה לכולם, או שאם חתימת כתובת ה-URL מופעלת ב-CDN,צריך לספק ל-Video Stitcher API מפתח CDN רשום. אם יצרתם שידור חי לבדיקה באמצעות Live Stream API, זהו ה-URI לקובץ main.m3u8 או main.mpd בקטגוריה של Cloud Storage.
• AD_TAG_URI

  כתובת ה-URL של מטא-נתונים של מודעות שנשלפים משרתי מודעות. בשילוב עם Ad Manager, חובה להשתמש בתג מודעה תקף של וידאו בשידור חי ב-Ad Manager. כדי לקבל תג מודעה תקין, פועלים לפי השלבים במאמר בנושא יצירת תגי מודעות לווידאו ולאודיו עם השינויים הבאים:
  • כדי להציג תנועה בזמן אמת, מפעילים את האפשרות 'תנועה בזמן אמת'.
  • בקטע Player SDK type (סוג ה-SDK של הנגן), בוחרים באפשרות Google IMA SDK (IMA SDK של Google).
  • מוסיפים את הפרמטר ad_rule=0 לתג (לדוגמה, מוסיפים &ad_rule=0 בסוף).
• ‫SLATE_ID: המזהה של הלוח לשימוש בהיעדר מודעות משולבות
  הערה: אם יצרתם לוח ברירת מחדל לרשת באמצעות Ad Manager, צריך להסיר את השדה defaultSlate מהבקשה כדי להשתמש בלוח ברירת המחדל לרשת.
• ‫NETWORK_CODE: המזהה המספרי של רשת Ad Manager שלכם. אפשר למצוא אותו ב Global settings (הגדרות גלובליות) בחשבון בעל התוכן הדיגיטלי.
• ‫AD_TRACKING: התנהגות המעקב אחרי ביצועים של מודעות בשידור. בשילובים של IMA SDK, משתמשים ב-CLIENT. למעקב אחר מודעות בצד השרת, צריך להשתמש ב-SERVER. אפשר גם לשנות את הערך הזה מאוחר יותר לכל סשן בנפרד.

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‏Curl (Linux,‏ macOS או Cloud Shell)

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

שומרים את גוף הבקשה בקובץ בשם request.json. כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:

cat > request.json << 'EOF'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
EOF

לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "x-goog-user-project: PROJECT_NUMBER" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID"

‎PowerShell (Windows)

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

שומרים את גוף הבקשה בקובץ בשם request.json. כדי ליצור או להחליף את הקובץ הזה בספרייה הנוכחית, מריצים את הפקודה הבאה בטרמינל:

@'
{
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
  },
  "adTracking": "AD_TRACKING"
}
'@  | Out-File -FilePath request.json -Encoding utf8

לאחר מכן מבצעים את הפקודה הבאה כדי לשלוח את בקשת ה-REST:

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "PROJECT_NUMBER" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs?liveConfigId=LIVE_CONFIG_ID" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.common.OperationMetadata",
    "createTime": CREATE_TIME,
    "target": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
    "verb": "create"
  },
  "done": false
}

‫Video Stitcher API רושם את ההגדרה באופן אסינכרוני בחשבון Ad Manager. הפעולה הזו עשויה להימשך כמה דקות.

הפקודה הזו יוצרת פעולה ממושכת (LRO) שאפשר להריץ עליה שאילתה כדי לעקוב אחרי ההתקדמות. מידע נוסף זמין במאמר בנושא בדיקת התוצאה.

קבלת ההגדרה

כדי לקבל את ההגדרה, משתמשים בשיטה projects.locations.liveConfigs.get.

לפני שמשתמשים בנתוני הבקשה, צריך להחליף את הנתונים הבאים:

• ‫PROJECT_NUMBER: מספר הפרויקט שלכם. הוא מופיע בשדה מספר הפרויקט בדף הגדרות IAM. Google Cloud
• ‫LOCATION: המיקום של ההגדרה הפעילה. צריך להשתמש באחד מהאזורים הנתמכים.
  הצגת מיקומים
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• ‫LIVE_CONFIG_ID: המזהה שהוגדר על ידי המשתמש עבור התצורה הפעילה

כדי לשלוח את הבקשה צריך להרחיב אחת מהאפשרויות הבאות:

‫Curl (Linux,‏ macOS או Cloud Shell)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login, או באמצעות Cloud Shell שמחבר אתכם אוטומטית ל-CLI של gcloud. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID"

‎PowerShell (Windows)

הערה: הפקודה הבאה מבוססת על ההנחה שנכנסתם ל-CLI של gcloud באמצעות חשבון המשתמש שלכם, על ידי הרצת gcloud init או gcloud auth login. כדי לבדוק איזה חשבון פעיל, אפשר להריץ את הפקודה gcloud auth list.

מריצים את הפקודה הבאה:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://videostitcher.googleapis.com/v1/projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID" | Select-Object -Expand Content

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

{
  "name": "projects/PROJECT_NUMBER/locations/LOCATION/liveConfigs/LIVE_CONFIG_ID",
  "sourceUri": "SOURCE_LIVESTREAM_URI",
  "adTagUri": "AD_TAG_URI",
  "gamLiveConfig": {
    "networkCode": "NETWORK_CODE",
    "assetKey": "ASSET_KEY",
    "customAssetKey": "PROJECT_NUMBER-LOCATION-LIVE_CONFIG_ID"
  },
  "state": "READY",
  "adTracking": "CLIENT",
  "defaultSlate": "projects/PROJECT_NUMBER/locations/LOCATION/slates/SLATE_ID",
  "stitchingPolicy": "CUT_CURRENT"
}

מאתרים את השדה customAssetKey ומעתיקים את הערך שמוחזר CUSTOM_ASSET_KEY. בשלב הבא, תשלחו את הערכים האלה אל Interactive Media Ads (IMA) SDK.