Reklam arası parametrelerini kullanma

Reklam arası API'si, reklam arası parametrelerini kullanarak reklam etiketi parametrelerini ayarlamanıza olanak tanır. Bu sayede reklam hedefleme doğruluğu ve reklam sunucularıyla entegrasyon geliştirilir.

Reklam etiketi parametrelerini geçersiz kılma

Google DAI akışının reklam etiketi parametrelerini geçersiz kılmak için reklam arasının breakParams.adTagParams alanını ayarlayın. Daha fazla bilgi için Akışınıza hedefleme parametreleri sağlama ve Tüm VAST reklam etiketi parametreleri başlıklı makaleleri inceleyin.

Aşağıdaki örnekte, mridx (ara reklam numarası) sorgu parametresini içeren bir DAI yayınının reklam etiketi gösterilmektedir:

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

Aşağıdaki örnek istek, mridx hedefleme değerini geçersiz kılan bir reklam arası oluşturur:

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

Aşağıdakini değiştirin:

Reklam etiketini DAI makrolarıyla genişletme

Google DAI, %%DAI_PATTERN:MACRO_NAME%% biçimindeki reklam etiketi makrolarını destekler. Makro adı, yalnızca büyük harfler, sayılar ve alt çizgiler içeren UPPER_CASE biçiminde olmalıdır.

Bu makroları, breakParams.macros alanınızdaki değerlerle makroları ayarlamak için Google DAI akışının reklam etiketine veya DAI akış isteğine ekleyebilirsiniz.

Aşağıdaki örnekte, bir Google DAI akışının BREAK_TYPE makrosu içeren reklam etiketi gösterilmektedir:

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

Aşağıdaki istek, bir reklam arasını günceller ve BREAK_TYPE makro değerini ayarlar:

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

AD_BREAK_ID yerine reklam arası kimliğinizi yazın.

Google DAI, reklam etiketini makroyla birlikte aşağıdaki şekilde çözer:

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

SCTE-35 makrolarıyla reklam etiketini genişletme

Google DAI canlı yayın etkinliğinizi ayarlarken ana reklam etiketine SCTE-35 makroları yerleştirebilirsiniz.

Canlı yayın etkinliği başladığında içerik manifestine SCTE-35 verileri ekleyebilir veya scte35CueOut parametresine dahil edilen SCTE-35 verileriyle DAI reklam arası API'sini çağırabilirsiniz. Google DAI, reklam etiketindeki SCTE-35 makrolarını doldurmak için kodu çözülmüş verileri kullanır.

Aşağıdaki örnekte %%TIME_SIGNAL_UPID_RAW%% makrosu kullanılmaktadır:

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

Aşağıdaki örnekte, SCTE-35 zamanlanmış sinyal verilerini göstermek için JSON kullanılmaktadır:

{
  "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, SCTE-35 makrosu içeren reklam etiketini aşağıdaki şekilde çözer:

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