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 akışı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:

NETWORK_CODE: Google Ad Manager ağ kodunuz. Daha fazla bilgi için Ad Manager ağ kodu başlıklı makaleyi inceleyin.
ASSET_KEY: Canlı yayın etkinliğinizin öğe anahtarı. Daha fazla bilgi için Canlı doğrusal akış URL'sini ve öğe anahtarını bulma başlıklı makaleyi inceleyin.
OAUTH_TOKEN: erişim jetonunuz. Daha fazla bilgi için OAuth2 ile kimlik doğrulama başlıklı makaleyi inceleyin.

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 harf, rakam ve alt çizgi 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 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 oluştururken ana reklam etiketine SCTE-35makrolar yerleştirebilirsiniz.

Canlı yayın etkinliği başladığında içerik manifestine SCTE-35 verilerini 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, reklam etiketini SCTE-35 makrosuyla aşağıdaki şekilde çözer:

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