Wenn Sie die Video Stitcher API für Ihr Projekt aktivieren möchten, wenden Sie sich an Ihren Kundenbetreuer oder an den Vertrieb, um weitere Informationen zu erhalten.

Diese Seite wurde von der Cloud Translation API übersetzt.

Konfiguration für eine VOD-Sitzung erstellen

Für die Ad Manager-Integration müssen Sie ein Anzeigen-Tag für die VOD-Sitzung erstellen.

Je nach Zielplattform musst du möglicherweise auch eine VOD-Konfiguration erstellen. Die Video Stitcher API registriert diese Konfiguration bei Ad Manager.

Anzeigen-Tag in Ad Manager erstellen

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

Fügen Sie einen neuen Anzeigenblock hinzu.
Anzeigenregeln aktivieren
Erstellen Sie eine neue Anzeigenregel. In diesem Schritt sehen Sie in Ad Manager den Bereich Targeting > Inventar. Wählen Sie den neuen Anzeigenblock aus dem vorherigen Schritt aus.
Erstellen Sie ein gültiges Anzeigen-Tag. Führen Sie dazu die Schritte unter Video- und Audioanzeigen-Tags generieren aus und beachten Sie dabei die folgenden Änderungen:
- Wählen Sie für den Player SDK-Typ 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ür ein 30-minütiges VOD-Asset beispielsweise musst du am Ende &vid_d=1800 einfügen.
- Ändern Sie den Parameter output=vast in output=xml_vmap1. Die VMAP-Spezifikation (Video Multiple Ad Playlist) ist der einzige unterstützte Ausgabetyp.

Zielplattform auswählen

Wählen Sie aus den folgenden Optionen die Zielplattform für Endnutzer aus:

Sie müssen eine VOD-Konfiguration erstellen. Fahren Sie mit den Schritten auf dieser Seite fort.

VOD-Konfiguration erstellen

Verwenden Sie zum Erstellen der Konfiguration die Methode projects.locations.vodConfigs.create.

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

PROJECT_NUMBER: Ihre Google Cloud-Projektnummer; diese befindet sich auf der Seite IAM-Einstellungen im Feld Projektnummer
LOCATION: der Standort, an dem die VOD-Konfiguration erstellt werden soll. 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
VOD_CONFIG_ID: eine benutzerdefinierte Kennung für die VOD-Konfiguration. Diese ID darf nur Kleinbuchstaben, Ziffern und Bindestriche enthalten. Das erste Zeichen muss ein Buchstabe und das letzte Zeichen ein Buchstabe oder eine Zahl sein. Die gesamte ID darf maximal 63 Zeichen lang sein.
VOD_URI: URI des zu kombinierenden Mediums. Dieser URI muss entweder auf eine MPD-Datei (MPEG-DASH) oder auf eine HLS-Manifestdatei (M3U8) verweisen. Verwenden Sie einen öffentlichen oder einen nicht signierten URI, für den Sie einen CDN-Schlüssel registriert haben.
Hinweis:Sie können die Transcoder API verwenden, um diese Manifestdateien zu erstellen. Weitere Informationen finden Sie unter Jobs basierend auf Voreinstellungen erstellen. Du musst die Manifestdateien öffentlich machen, damit die Video Stitcher API darauf zugreifen kann.
AD_TAG_URI: (Fügen Sie diesen Wert in den Block für JSON-Code anfordern unten ein.) Die URL für von Ad-Servern abgerufene Anzeigenmetadaten. Für die Ad Manager-Integration muss dies ein gültiges Videoanzeigen-Tag von Ad Manager sein. Führen Sie die im vorherigen Abschnitt Anzeigen-Tag in Ad Manager erstellen beschriebenen Schritte aus, um ein gültiges Anzeigen-Tag abzurufen.
NETWORK_CODE: die numerische Kennung Ihres Ad Manager-Netzwerks; Sie finden sie in den globalen Einstellungen des Publisher-Kontos.

JSON-Text anfordern:

{
  "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: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in der gcloud-Befehlszeile angemeldet haben. Dazu führen Sie gcloud init oder gcloud auth login aus oder verwenden Cloud Shell, wo Sie automatisch in der gcloud-Befehlszeile angemeldet werden. 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: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in 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
}

Dieser Befehl erstellt einen Vorgang mit langer Ausführungszeit, den Sie abfragen können, um den Fortschritt zu verfolgen. Kopieren Sie die zurückgegebene OPERATION_ID, die der letzte Teil des Felds name ist, und verwenden Sie sie im nächsten Abschnitt.

Ergebnis prüfen

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

Bevor Sie die Anfragedaten verwenden, ersetzen Sie die folgenden Werte:

PROJECT_NUMBER: Ihre Google Cloud-Projektnummer. Diese befindet sich auf der Seite IAM-Einstellungen im Feld Projektnummer.
LOCATION: der 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 ID für den Vorgang

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

curl (Linux, macOS oder Cloud Shell)

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: Beim folgenden Befehl wird davon ausgegangen, dass Sie sich mit Ihrem Nutzerkonto in 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.

Zurück

CDN-Schlüssel für Media CDN einrichten

Weiter

Damit Ihre Clientanwendung mit Google Ad Manager funktioniert