DAI Erken Reklam Arası Bildirimi API'si

Google DAI platformunu kullanırken yüksek kaliteli reklamlar için hedefleme verileri sağlamak isteyebilirsiniz. bir sonraki canlı/doğrusal reklam arasını belirtir. Erken Reklam Arası Bildirim (EABN) API'si, aşağıdakileri kullanarak araya özel hedefleme uygulamanızı sağlar: anahtar/değer çiftleri, yüksek hacimde reklam kararları için ölçeklenebilirlik sağlar akışlar.

EABN API'sine yapılan çağrılar, hedeflenecek öğe anahtarını ve beklenen bir sonraki aranın süresini uzatın. Sürenin gerçek reklama yakın olması gerekir sayısını mümkün olduğunca belirleyin. Gönderilen beklenen süre sağlanan reklam arası Gereğinden az doldurulmuş reklam arası dolgu türü (varsayılan olarak boş seçenek listesine ayarlanır), aranın geri kalanı için kullanılır. Öğe beklenen süre gönderilen reklam arasından daha uzun olursa reklam aranız reklam tamamlanmadan önce bitmesini sağlar.

Bu zorunlu alanların yanı sıra özel hedefleme gönderebilirsiniz parametreleri, uygulanacak reklam kapsülü şablonunun adı veya SCTE35 İpucu verileri (varsa) kullanılabilir.

Ön koşullar

Hizmet hesabı oluşturma

EABN API'ye erişmek için Google hizmet hesabınızın olması gerekir.

  • Google Cloud hesabınız varsa IAM modülünü kullanarak bir hizmet hesabı. Daha fazla bilgi için bkz. Hizmet hesapları oluşturma ve yönetme.
  • Google Cloud hesabınız yoksa bir hizmet hesabı oluşturabilirsiniz Google API Konsolu'ndan, şu adımları uygulayarak:
    1. Yeni proje oluşturun veya mevcut bir projeyi seçin.
    2. Kimlik bilgileri sayfasında Hizmet hesaplarını yönet'i tıklayın.
    3. Hizmet hesapları sayfasında HİZMET HESABI OLUŞTUR'u tıklayın.
    4. Hizmet hesabı oluştur sayfasında hesap ayrıntılarını girin. Sonra OLUŞTUR'u tıklayın.

Hizmet hesabını başarıyla oluşturduktan sonra hesabın JSON dosyasını kopyalayın. anahtarı ile kimlik doğrulaması gerekir.

EABN API'sini etkinleştirme

Hizmet hesabınız oluşturulduktan sonra hesap yöneticinizden EABN API'sini kullandığınızdan emin olun.

DAI API'sini etkinleştirme

Hizmet hesabınız için EABN API etkinleştirildikten sonra DAI API'yi etkinleştirin hesap:

  1. Google API kitaplığında, "DAI API" araması yapın.

  2. DAI API'yi seçip etkinleştirin.

EABN API'sini kullanma

JSON/REST isteklerini kullanarak EABN API'yi çağırabilirsiniz.

Kimlik doğrulama

EABN API'ye kimliği doğrulanmış çağrılar yapmak için OAuth2 hizmeti oluşturmanız gerekir hizmet hesabınızdan JSON anahtarını ve kapsamı kullanarak https://www.googleapis.com/auth/video-ads Daha fazla bilgi için bkz. Sunucudan Sunucuya Uygulamalar için OAuth 2.0 Kullanma.

Her biri için Auth başlığı olarak sonuçta ortaya çıkan kimlik doğrulama jetonunu içermelidir. çağrısı ile ilişkilendirilir.

Erken reklam arası bildirimi gönderme

Erken reklam arası bildirimi göndermek için aşağıdakini kullanarak bir POST isteği gönderin URL ve istek gövdesi:

POST dai.googleapis.com/v1/adBreaks

İstek içeriği

Nesne
adBreak Zorunlu adBreak özellikleri için sarmalayıcı nesnesi
assetKey Zorunlu LiveStreamEvent için benzersiz tanımlayıcı. ara oluşturuldu
expectedDuration Zorunlu Google'ın standart süre biçimi kullanılarak bu reklam arasının süresi (xx.xxx, saniye sayısını temsil eden xx.xxxs)
scte35CueOut İsteğe bağlı scte35 işaret çıkışından Base-64 olarak kodlanmış veriler. Şunları içerebilir: splice_insert() veya time_signal() komutu.
Örnekler:
  • time_signal():
    /DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==
  • splice_insert():/DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo=
custParams İsteğe bağlı Özel reklam için bu ara için reklam isteklerine dahil edilecek anahtar/değer çiftleri AM360'ta = ile ayrılmış ve birleştirilen ölçüt hedefleme &.
Örnek:

key=value&key2=value2,value3 Hedefleme hakkında daha fazla bilgi için Tedarik hedefleme parametrelerini akışınıza ekleyin.
ptpln İsteğe bağlı Reklam kapsülü şablon adı

Yanıt başlığı

HTTP/1.1 200 OK

Yanıt gövdesi

Yanıt gövdesi, adBreak nesnesinde gönderilen tüm parametreleri içerir. ve ayrıca dahili DAI'yı içeren ek bir daiBreakId alanı akış içinde oluşturulan reklam arasının tanımlayıcısı.

Örnek

İstek

POST /v1/adBreaks HTTP/1.1
Content-Type: application/json

{
  "adBreak": {
    "assetKey": "asset1",
    "expectedDuration": "30s",
    "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
    "custParams": "param1=value1&param2=value2",
    "ptpln": "podtemplate"
  }
}

Yanıt

HTTP/1.1 200 OK

{
  "assetKey": "asset1",
  "expectedDuration": "30s",
  "custParams": "param1=value1&param2=value2",
  "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
  "ptpln": "podtemplate",
  "daiBreakId": 1
}

Örnek uygulama (Python)

from __future__ import absolute_import
from __future__ import division
from __future__ import print_function

from absl import app

from google.auth.transport.requests import AuthorizedSession
from google.oauth2 import service_account

SERVICE_ACCOUNT_KEY_FILE = "~/eabn_key.json"
ASSET_KEY = "asset1"

SCOPES = ['https://www.googleapis.com/auth/video-ads']
EABN_API_URL = 'https://dai.googleapis.com/v1/adBreaks'


def main():
  credentials = service_account.Credentials.from_service_account_file(
      SERVICE_ACCOUNT_KEY_FILE, scopes=SCOPES)

  authed_session = AuthorizedSession(credentials)

  data = {
      'assetKey': ASSET_KEY,
      'expectedDuration': '120s',
      'custParams': 'param1=value1&param2=value2',
      'scte35CueOut': '/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==',
  }

  r = authed_session.post(EABN_API_URL, json={'adBreak': data})
  print(r.status_code)
  print(r.headers)
  print(r.text)

if __name__ == '__main__':
  app.run(main)