Parameter für Werbeunterbrechungen verwenden

Mit der Ad Break API können Sie die Parameter des Anzeigen-Tags mithilfe von Parametern für Werbeunterbrechungen festlegen. Dadurch wird die Genauigkeit der Anzeigenausrichtung und die Integration mit Ad-Servern verbessert.

Parameter für Anzeigen-Tags überschreiben

Wenn Sie die Anzeigen-Tag-Parameter des Google DAI-Streams überschreiben möchten, legen Sie das Feld breakParams.adTagParams der Werbeunterbrechung fest. Weitere Informationen finden Sie unter Targeting-Parameter an einen Stream übertragen und Alle Parameter für VAST-Anzeigen-Tags.

Das folgende Beispiel zeigt ein DAI-Stream-Anzeigen-Tag mit dem Abfrageparameter mridx (Mid-Roll-Nummer):

https://pubads.g.doubleclick.net/gampad/live/ads?mridx=3&…

Mit der folgenden Beispielanfrage wird eine Werbeunterbrechung erstellt, die den Targeting-Wert mridx überschreibt:

curl -X POST "https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer OAUTH_TOKEN" \
  -d '{
    "expectedDuration": "30s",
    "expectedStartTime": "2025-06-03T15:00:00Z",
    "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
    "customParams": "param1=value1&param2=value2",
    "podTemplateName": "podtemplate",
    "breakParams": {
      "adTagParams": [{"key": "mridx", "value": "7"}]
    }
  }'

Ersetzen Sie Folgendes:

NETWORK_CODE: Ihr Google Ad Manager-Netzwerkcode. Weitere Informationen zum Ad Manager-Netzwerkcode
ASSET_KEY: Der Asset-Schlüssel Ihres Livestream-Events. Weitere Informationen finden Sie unter URL für linearen Livestream und Assetschlüssel finden.
OAUTH_TOKEN: Ihr Zugriffstoken. Weitere Informationen finden Sie unter Mit OAuth 2.0 authentifizieren.

Anzeigen-Tag mit Makros für die dynamische Anzeigenbereitstellung erweitern

Die dynamische Anzeigenbereitstellung von Google unterstützt Makros für Anzeigen-Tags im %%DAI_PATTERN:MACRO_NAME%%-Format. Der Makroname muss im Format UPPER_CASE angegeben sein und darf nur Großbuchstaben, Ziffern und Unterstriche enthalten.

Sie können diese Makros in das Anzeigen-Tag des Google DAI-Streams oder in die DAI-Streamanfrage einfügen, um die Makros mit den Werten in Ihrem Feld breakParams.macros festzulegen.

Das folgende Beispiel zeigt das Anzeigen-Tag eines Google DAI-Streams mit einem BREAK_TYPE-Makro:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%DAI_PATTERN:BREAK_TYPE%%&…

Mit der folgenden Anfrage wird eine Werbeunterbrechung aktualisiert und der Makrowert BREAK_TYPE festgelegt:

curl -X PATCH 'https://admanagervideo.googleapis.com/v1/adBreak/networks/NETWORK_CODE/assets/ASSET_KEY/adBreaks/AD_BREAK_ID' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer OAUTH_TOKEN' \
  -d '{
  "name": "networks/…/assets/…/adBreaks/bcc402a6-9880-4b8b-8e4a-a8cd3688f854",
  "expectedDuration": "30s",
  "expectedStartTime": "2025-06-03T15:10:00Z",
  "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
  "customParams": "param1=value1&param2=value2",
  "podTemplateName": "podtemplate"
  "breakState": "BREAK_STATE_SCHEDULED",
  "breakParams": {
    "macros": [{"key": "BREAK_TYPE", "value": "national"}]
  }
}'

Ersetzen Sie AD_BREAK_ID durch Ihre Pausen-ID.

Google DAI löst das Anzeigen-Tag mit dem Makro so auf:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&…

Anzeigen-Tag mit SCTE-35-Makros erweitern

Beim Einrichten Ihres Google DAI-Livestream-Ereignisses können Sie SCTE-35-Makros im Master-Anzeigentag platzieren.

Wenn das Livestream-Event beginnt, können Sie SCTE-35-Daten in das Inhaltsmanifest einfügen oder die DAI Ad Break API mit den SCTE-35-Daten aufrufen, die im Parameter scte35CueOut enthalten sind. Google DAI verwendet die decodierten Daten, um die SCTE-35-Makros im Anzeigen-Tag zu füllen.

Im folgenden Beispiel wird das Makro %%TIME_SIGNAL_UPID_RAW%% verwendet:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/%%TIME_SIGNAL_UPID_RAW%%&…

Im folgenden Beispiel werden JSON-Daten verwendet, um SCTE-35-Zeitachsendaten zu veranschaulichen:

{
  "splice_info_section": {
    …
    "splice_command": {
      "command_name": "time_signal",
      "splice_time": {
        "time_specified_flag": 1,
        "pts_time": "123456789"
      }
    },
    "splice_descriptors": [
      {
        …
        "segmentation_upid": {
          "raw_hex": "0x6E6174696F6E616C", // UTF8 value: national
          …
        }
      }
    ]
  }
}

Google DAI löst das Anzeigen-Tag mit dem Makro SCTE-35 so auf:

https://pubads.g.doubleclick.net/gampad/live/ads?iu=/21775744923/external/single_ad_samples/national&…