Erken reklam arası bildirimleri gönderme

Google Dinamik Reklam Ekleme (DAI), yüksek eşzamanlılık düzeyinde canlı yayınları destekler. Erken Reklam Arası Bildirimleri (EABN), Google DAI'nin yaklaşan bir reklam arasını planlaması veya reklam kararlarını hemen başlatarak hem reklam doluluk oranını hem de yükleme süresini optimize etmesi için gönderilen isteklerdir.

Tam hizmet, kapsül yayını veya sunucu yönlendirmeli reklam ekleme için erken reklam arası bildirimleri başlatmak üzere AdBreakskaynağını kullanın. Bu kaynak, Google Ad Manager kullanıcı arayüzü veya Google Ad Manager SOAP API LiveStreamEventService üzerinden oluşturduğunuz tüm canlı yayınlar için reklam araları oluşturup yönetebilir.

Bu sayfada, reklam arasının erken reklam arası bildirimi olarak nasıl planlanacağı açıklanmaktadır.

Ön koşullar

Reklam aralarını oluşturmak veya yönetmek için canlı yayın için sistem tarafından oluşturulmuş bir öğe anahtarına veya özel öğe anahtarına ihtiyacınız vardır. Bu anahtarları canlı yayın ayrıntıları sayfasında da bulabilirsiniz. Google Ad Manager kullanıcı arayüzünü kullanarak DAI için canlı yayın oluşturma başlıklı makaleyi inceleyin.

Reklam arası planlama

Akışınızın izleyici sayısı artarken reklam arası planlayabilirsiniz. Her canlı yayın etkinliği için Create yayın yöntemini kullanarak en fazla altı saat önceden ayrı ayrı bir reklam arası planlayın. Beklenen başlangıç zamanınızı ve reklam arası kimliğinizi ekleyin. DAI, reklam kararlarını planlanan saate yakın bir zamanda başlatır. Anında reklam arası kararları için reklam arasının beklenen başlangıç zamanını çıkarın.

Google DAI'nin reklam kararlarını hemen başlatmasını sağlamak için Create çağrısını yaparken reklam arasının beklenen başlangıç zamanını atlayabilirsiniz.

Aşağıdaki örnekte, Linear türündeki bir canlı yayın etkinliği için 6 Mart 2025'te saat 16:00'da (UTC) başlayacak bir reklam arası planlanmaktadır:

cURL Node.js 
curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN' \
  -H 'content-type: application/json' \
  --data-raw '{"adBreakId":"mid-roll-1","assetKey":"ASSET_KEY","duration":"30s","expectedStartTime":"2025-03-06T16:00:00Z"}'

fetch("https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks", {
    "headers": {
      "authorization":
        "Bearer ACCESS_TOKEN",
        "Content-Type": "application/json",
    },
  "body": JSON.stringify({
    "adBreakId": "mid-roll-1",
    "duration": "30s",
    "expectedStartTime": "2025-03-06T16:00:00Z"
  }),
  "method": "POST"
});

İşlem başarılı olursa aşağıdaki JSON yanıtını görürsünüz:

{
  "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
  "adBreakId": "mid-roll-1",
  "assetKey": "...",
  "expectedStartTime": "2025-03-06T16:00:00Z",
  "duration": "30s",
  "breakState": "SCHEDULED"
}

Reklam aralarını sorgulamak için List yöntemini kullanın. Bir reklam arasının ayrıntılarını incelemek için Get yöntemini kullanın.

Aşağıdaki örnekte, bir canlı yayın etkinliğinin tüm reklam araları listelenmiştir:

cURL Node.js 
curl 'https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks' \
  -H 'authorization: Bearer ACCESS_TOKEN'

fetch(
  "https://admanager.googleapis.com/v1/networks/NETWORK_CODE/liveStreamEventsByAssetKey/ASSET_KEY/adBreaks",
  {
    "headers": {
      "authorization": "Bearer ACCESS_TOKEN",
    },
    "method": "GET"
  }
);

İşlem başarılı olursa aşağıdaki JSON yanıtını görürsünüz:

{
  "adBreaks": [
    {
      "name": "networks/.../liveStreamEventsByAssetKey/.../adBreaks/mid-roll-1",
      "adBreakId": "mid-roll-1",
      "assetKey": "...",
      "expectedStartTime": "2025-03-06T16:00:00Z",
      "duration": "30s",
      "breakState": "DECISIONED",
      "breakSequence": "1"
    }
  ]
}

Mevcut reklam arasını daha erkene planlamak istiyorsanız beklenen başlangıç zamanını değiştirmek için Patch yöntemini kullanın. Mevcut reklam arasını iptal etmek istiyorsanız durumu COMPLETED olmadan önce Delete yöntemini kullanın.

Başka bir reklam arası oluşturmak için mevcut reklam arasının durumu COMPLETED olana kadar bekleyin.