Konfiguration für eine VOD-Sitzung erstellen

Für die Ad Manager-Integration musst du ein Anzeigen-Tag für die VOD-Sitzung erstellen. Außerdem musst du eine VOD-Konfiguration erstellen. Die Video Stitcher API registriert diese Konfiguration in Ad Manager.

Anzeigen-Tag in Ad Manager erstellen

Führen Sie in Ihrem Ad Manager-Konto die folgenden Schritte aus:

1. Fügen Sie einen neuen Anzeigenblock hinzu.
2. Aktivieren Sie Anzeigenregeln.

3. Erstellen Sie eine neue Anzeigenregel. Suchen Sie in Ad Manager den Bereich Targeting > Inventar. Wählen Sie den neuen Anzeigenblock aus dem vorherigen Schritt aus.

4. Erstellen Sie ein gültiges Anzeigen-Tag. Folgen Sie dazu der Anleitung unter Tags für Video- und Audioanzeigen erstellen, mit folgenden Änderungen:

   • Wähle als Art des Player SDK Google IMA SDK aus.
   • Fügen Sie dem Tag den Parameter ad_rule=1 hinzu (z. B. &ad_rule=1 am Ende).
   • Füge dem Tag den Parameter vid_d=vod-asset-duration-in-secs hinzu. Füge beispielsweise für ein 30-minütiges VOD-Asset &vid_d=1800 ans Ende an.
   • Ändern Sie den Parameter output=vast in output=xml_vmap1. Die VMAP-Spezifikation (Video Multiple Ad Playlist) ist der einzige unterstützte Ausgabetyp.

VOD-Konfiguration erstellen

Hinweis: Erstelle keine VOD-Konfiguration, wenn deine Zielplattform das IMA SDK auf Chromecast ist. Überspringen Sie den folgenden Schritt.

Verwenden Sie zum Erstellen der Konfiguration die Methode projects.locations.vodConfigs.create. Optionale Felder wie benutzerdefinierte Header findest du in der Referenzdokumentation zur VOD-Konfiguration.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.
• LOCATION: Speicherort, an dem die VOD-Konfiguration erstellt werden soll. Verwende eine der unterstützten Regionen.
  Standorte anzeigen
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• VOD_CONFIG_ID: eine benutzerdefinierte Kennung für die VOD-Konfiguration. Die ID darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten. Das erste Zeichen muss ein Buchstabe, das letzte Zeichen ein Buchstabe oder eine Ziffer sein. Die gesamte ID darf maximal 63 Zeichen lang sein.
• VOD_URI: Der URI der zu zusammenfügenden Medien. Dieser URI muss entweder auf eine MPEG-DASH-Manifestdatei (MPD) oder eine HLS-Manifestdatei (M3U8) verweisen. Verwenden Sie einen öffentlichen URI oder einen nicht signierten URI, für den Sie einen CDN-Schlüssel registriert haben.
  Hinweis:Du kannst diese Manifestdateien mit der Transcoder API erstellen. Weitere Informationen findest du unter VOD-Quelldateien erstellen. Du musst die Manifestdateien öffentlich zugänglich machen, damit die Video Stitcher API darauf zugreifen kann.
• AD_TAG_URI

  : URL für Anzeigenmetadaten, die von Ad-Servern abgerufen werden. Bei der Ad Manager-Integration muss dies ein gültiges Ad Manager-Videoanzeigen-Tag sein. Wenn Sie ein gültiges Anzeigen-Tag benötigen, folgen Sie der Anleitung im vorherigen Abschnitt Anzeigen-Tag in Ad Manager erstellen.
• NETWORK_CODE: Die numerische Kennung für Ihr Ad Manager-Netzwerk. Sie finden sie in den globalen Einstellungen des Publisher-Kontos.

JSON-Text der Anfrage:

{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

cat > request.json << 'EOF'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}
EOF

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

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/vodConfigs?vodConfigId=VOD_CONFIG_ID"

PowerShell (Windows)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Speichern Sie den Anfragetext in einer Datei mit dem Namen request.json. Führen Sie folgenden Befehl im Terminal aus, um diese Datei im aktuellen Verzeichnis zu erstellen oder zu überschreiben:

@'
{
  "sourceUri": "VOD_URI",
  "adTagUri": "AD_TAG_URI",
  "gamVodConfig": {
    "networkCode": "NETWORK_CODE"
  }
}
'@  | Out-File -FilePath request.json -Encoding utf8

Führen Sie dann folgenden Befehl aus, um Ihre REST-Anfrage zu senden:

$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/vodConfigs?vodConfigId=VOD_CONFIG_ID" | Select-Object -Expand Content

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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/vodConfigs/VOD_CONFIG_ID",
    "verb": "create",
    "cancelRequested": false,
    "apiVersion": "v1"
  },
  "done": false
}

Mit diesem Befehl wird ein Vorgang mit langer Ausführungszeit erstellt, den Sie abfragen können, um den Fortschritt zu verfolgen. Kopieren Sie den zurückgegebenen OPERATION_ID, der der letzte Teil des Felds name ist, und verwenden Sie ihn im nächsten Abschnitt.

Ergebnis prüfen

Verwende die Methode projects.locations.operations.get, um zu prüfen, ob die VOD-Konfiguration erstellt wurde. Wenn die Antwort "done: false" enthält, wiederholen Sie den Befehl, bis die Antwort "done: true" enthält.

Ersetzen Sie diese Werte in den folgenden Anfragedaten:

• PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Sie finden sie auf der Seite IAM-Einstellungen im Feld Projektnummer.
• LOCATION: Speicherort der Daten; verwenden Sie eine der unterstützten Regionen.
  Standorte anzeigen
  • us-central1
  • us-east1
  • us-west1
  • asia-east1
  • asia-south1
  • asia-southeast1
  • europe-west1
  • southamerica-east1
• OPERATION_ID: die Kennzeichnung für den Vorgang

Wenn Sie die Anfrage senden möchten, maximieren Sie eine der folgenden Optionen:

curl (Linux, macOS oder Cloud Shell)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu haben Sie gcloud init oder gcloud auth login ausgeführt oder die Cloud Shell genutzt, die Sie automatisch bei der gcloud-Befehlszeile anmeldet. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

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)

Hinweis: Der folgende Befehl setzt voraus, dass Sie sich mit Ihrem Nutzerkonto bei der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus. Um herauszufinden, welches Konto gerade aktiv ist, führen Sie gcloud auth list aus.

Führen Sie folgenden Befehl aus:

$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

Sie sollten in etwa folgende JSON-Antwort erhalten:

{
  "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/vodConfigs/VOD_CONFIG_ID",
    "verb": "create"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.video.stitcher.v1.VodConfig",
    "name": "projects/PROJECT_NUMBER/locations/LOCATION/vodConfigs/VOD_CONFIG_ID",
    "sourceUri": "VOD_URI",
    "adTagUri": "AD_TAG_URI",
    "gamVodConfig": {
      "networkCode": "NETWORK_CODE"
    },
    "state": "READY"
  }
}

Prüfen Sie, ob der Status auf READY gesetzt ist. Ist dies nicht der Fall, warten Sie einige Sekunden und senden Sie die Anfrage noch einmal.

Weitere Informationen zu VOD-Konfigurationen findest du unter VOD-Konfiguration erstellen und verwalten.