Używanie parametrów przerwy na reklamę

Interfejs Ad Break API umożliwia ustawianie parametrów tagu reklamy za pomocą parametrów przerwy na reklamę, co zwiększa dokładność kierowania reklam i integracji z serwerami reklam.

Zastępowanie parametrów tagu reklamy

Aby zastąpić parametry tagu reklamy w strumieniu Google DAI, ustaw pole breakParams.adTagParams w przerwie na reklamę. Więcej informacji znajdziesz w artykułach Dodawanie parametrów kierowania do strumienia i Wszystkie parametry tagu reklamy VAST.

Ten przykład pokazuje tag reklamy strumienia DAI zawierający parametr zapytania mridx (numer reklamy w trakcie filmu):

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

Poniższe przykładowe żądanie tworzy przerwę na reklamę, która zastępuje wartość kierowania mridx:

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"}]
    }
  }'

Zastąp następujące elementy:

NETWORK_CODE: kod sieci Google Ad Managera. Więcej informacji znajdziesz w artykule Kod sieci Ad Managera.
ASSET_KEY: klucz pliku wydarzenia transmitowanego na żywo. Więcej informacji znajdziesz w artykule Znajdowanie adresu URL i klucza pliku linearnej transmisji na żywo.
OAUTH_TOKEN: token dostępu. Więcej informacji znajdziesz w artykule Uwierzytelnianie za pomocą OAuth2.

Rozwijanie tagu reklamy za pomocą makr DAI

DAI w Google obsługuje makra tagów reklamowych w formacie %%DAI_PATTERN:MACRO_NAME%%. Nazwa makra musi mieć format UPPER_CASE i zawierać tylko wielkie litery, cyfry i podkreślenia.

Możesz wstawić te makra w tagu reklamy w strumieniu DAI Google lub w żądaniu strumienia DAI, aby ustawić makra z wartościami w polu breakParams.macros.

Przykład poniżej pokazuje tag reklamy strumienia Google DAI zawierający makro BREAK_TYPE:

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

To żądanie aktualizuje przerwę na reklamę i ustawia wartość BREAK_TYPE makra:

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"}]
  }
}'

Zastąp AD_BREAK_ID identyfikatorem przerwy na reklamę.

Usługa Google DAI przetworzy tag reklamy z makrem w ten sposób:

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

Rozwijanie tagu reklamy za pomocą makr SCTE-35

Podczas konfigurowania wydarzenia transmisji na żywo w usłudze Google DAI możesz umieścić SCTE-35makra w głównym tagu reklamy.

Gdy rozpocznie się transmisja na żywo, możesz wstawić dane SCTE-35 do manifestu treści lub wywołać interfejs DAI Ad Break API z danymi SCTE-35 zawartymi w parametrze scte35CueOut. Google DAI używa zdekodowanych danych do wypełniania SCTE-35makr w tagu reklamy.

W tym przykładzie użyto makra %%TIME_SIGNAL_UPID_RAW%%:

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

Poniższy przykład wykorzystuje JSON do przedstawienia danych sygnału czasowego SCTE-35:

{
  "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
          …
        }
      }
    ]
  }
}

Usługa Google DAI przetwarza tag reklamy z makrem SCTE-35 w ten sposób:

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