Early ad break notification v1

Erken Reklam Arası Bildirimi API'sini kullanma

• Reklam arasının oluşturulduğu ilgili canlı yayının tanımlayıcısıdır. Bu tanımlayıcı aşağıdakilerden biri olabilir:
• Canlı yayının "Öğe Anahtarı".
• Canlı yayının "Özel Öğe Anahtarı". Bu anahtar, kendi tanımlayıcı dizenizi belirterek kendi anahtar alanınızı yönetmenize olanak tanır.
• Canlı yayının "İçerik Kaynağı Kimliği" ve "İçerik Kimliği".

Not: Bu tanımlayıcı türünü kullanabilmeniz gerekir. Daha fazla bilgi için hesap yöneticinizle iletişime geçin.

• Bir sonraki reklam arasının beklenen süresi. Süre, gerçek reklam arası süresine mümkün olduğunca yakın olmalıdır.

Bu zorunlu alanlara ek olarak özel hedefleme parametreleri, uygulanacak bir reklam kapsülü şablonunun adını veya varsa SCTE35 Cue Out verilerini de gönderebilirsiniz.

Ön koşullar

EABN API'yi kullanmak için bir hizmet hesabı oluşturmanız ve hesabı Google Ad Manager ağınıza eklemeniz gerekir.

Hizmet hesabı oluşturma

EABN API'sini çağırmak için bir hizmet hesabı oluşturmak üzere aşağıdaki adımları tamamlayın: - Google Cloud hesabınız varsa hizmet hesabı oluşturmak için IAM modülünü kullanın. Daha fazla bilgi için Hizmet hesapları oluşturma ve yönetme başlıklı makaleyi inceleyin. - Google Cloud hesabınız yoksa Google API Console'dan hesap oluşturmak için aşağıdaki adımları uygulayın:

1. Yeni bir 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 HESAPLARI OLUŞTUR'u tıklayın.
4. Hizmet hesabı oluştur sayfasında hesap ayrıntılarını girin. Ardından OLUŞTUR'u tıklayın.

Hizmet hesabı oluşturduktan sonra, kimlik doğrulama için kullanılan hesabın JSON anahtarını kopyalayın.

Hizmet hesabınızı Google Ad Manager ağınıza ekleme

Hizmet hesabınızı ağınıza eklemek için API erişimi için bir hizmet hesabı kullanıcısı ekleme başlıklı makaledeki adımları tamamlayın.

API'yi etkinleştirme

Hizmet hesabını oluşturduktan sonra, hesabınız için API'yi etkinleştirmek üzere hesap yöneticinize aşağıdaki bilgileri sağlayın:

• Google Cloud Hesabınızın e-posta adresi
• Hizmet hesabınız
• Google Ad Manager ağınızın ağ kodu.

API, hesap yöneticiniz tarafından etkinleştirildikten sonra API'yi etkinleştirmek için aşağıdaki adımları uygulayın:

1. Google API kitaplığında "Google Ad Manager Video API"yi arayın.
2. ETKİNLEŞTİR'i tıklayın.

Not: API, arama sonuçlarında görünmüyorsa hesabınızın DAI API için etkinleştirildiğini onaylamak üzere hesap yöneticinizle iletişime geçin.

API'yi kullanma

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

Yetkilendirme

EABN API'ye yetkili çağrılar yapmak için hizmet hesabınızdaki JSON anahtarını ve https://www.googleapis.com/auth/video-ads kapsamını kullanarak OAuth2 hizmet hesabı kimlik bilgileri oluşturmanız gerekir. Daha fazla bilgi için Sunucudan Sunucuya Uygulamalar için OAuth 2.0'ı Kullanma başlıklı makaleyi inceleyin.

Elde edilen yetkilendirme jetonunu, EABN API'sine yapılan her çağrı için bir Kimlik Doğrulama üst bilgisi olarak eklemeniz gerekir.

Erken reklam arası bildirimi gönderme

Erken reklam arası bildirimi göndermek için canlı yayını nasıl belirtmeyi tercih ettiğinize bağlı olarak üç geçerli EABN URL'sinden birine bir POST isteği gönderin. Aşağıdaki bölümlerde, URL'ler arasındaki farklar açıklanmakta ve istek ve yanıt örnekleri verilmektedir.

URL'ler

Erken reklam arası bildirimi için üç geçerli URL vardır. Reklam arası oluşturmak (POST) veya atanan reklam aralarının listesini almak (GET) için üç türün de kullanabilirsiniz.

Canlı yayının öğe anahtarını kullanmak için:

POST admanagervideo.googleapis.com/v1/networks/{network_code}/assets/{asset_key}/adBreaks

GET admanagervideo.googleapis.com/v1/networks/{network_code}/assets/{asset_key}/adBreaks

Canlı yayının özel öğe anahtarını kullanmak için:

POST admanagervideo.googleapis.com/v1/networks/{network_code}/customAssets/{custom_asset_key}/adBreaks

GET admanagervideo.googleapis.com/v1/networks/{network_code}/customAssets/{custom_asset_key}/adBreaks

İçerik kaynağı kimliği ve Content ID yaklaşımını kullanmak için:

POST admanagervideo.googleapis.com/v1/networks/{network_code}/sources/{content_source_id}/content/{content_id}/adBreaks

GET admanagervideo.googleapis.com/v1/networks/{network_code}/sources/{content_source_id}/content/{content_id}/adBreaks

Tüm parametreler için:

• network_code, Google Ad Manager ağınızın ağ kodunu temsil eder.
• asset_key, canlı yayın ayrıntıları sayfanızda gösterilen öğe anahtarını temsil eder.
• custom_asset_key, canlı yayınınızın özel öğe anahtarını temsil eder.
• content_source_id, Google Ad Manager'daki bir içerik kaynağının kimliğini temsil eder.
• content_id, Google Ad Manager'daki bir içeriğin kimliğini temsil eder.

Not: Belirtilen content_source_id/content_id çifti, Google Ad Manager'daki bir canlı yayınla ilişkilendirilmelidir.

İstek gövdesi: Yalnızca reklam arası oluşturmak için kullanılır (POST)

Nesne
expectedDuration	Zorunlu	Bu reklam arasının, Google'ın standart süre biçimi (xx.xxx saniye sayısının olduğu xx.xxxs) kullanılarak gösterilen süresi
customParams	İsteğe bağlı	AM360'taki özel ölçüt hedefleme için bu arayla ilgili reklam isteklerine dahil edilecek, = ve & . Örnek: key=value&key2=value2,value3 Hedefleme hakkında daha fazla bilgi için Akışınıza hedefleme parametreleri sağlama başlıklı makaleyi inceleyin.
podTemplateName	İsteğe bağlı	Reklam kapsülü şablon adı
scte35CueOut	İsteğe bağlı	scte35 işaret çıkışından alınan Base-64 ile kodlanmış veriler. Şunları içerebilir: splice_insert() veya time_signal() komutunu kullanın. Örnekler: time_signal(): /DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg== splice_insert(): /DAvAAAAAAAA///wFAVIAACPf+/+c2nALv4AUsz1AAAAAAAKAAhDVUVJAAABNWLbowo=

Örnek istekler

Reklam arası oluşturma

POST admanagervideo.googleapis.com/v1/networks/.../sources/.../content/.../adBreaks
Content-Type: application/json
Authorization: Bearer …
{
    "expectedDuration": "30s",
    "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
    "customParams": "param1=value1&param2=value2",
    "podTemplateName": "podtemplate"
}

Yanıt gövdesi

Yanıt gövdesinde, adBreak nesnesinde gönderilen tüm parametrelerin yanı sıra oluşturulan reklam arasının Google genelindeki standart kimliğini içeren ek bir name alanı bulunur. Bu alan aşağıdaki biçimde döndürülür:

networks/{network_code}/assets/{asset_key}/adBreaks/{ad_break_id}

Örnek yanıt

HTTP/1.1 200 OK
{
  "name": "networks/.../assets/.../adBreaks/1",
  "expectedDuration": "30s",
  "scte35CueOut": "/DA0AAAAAAAA///wBQb+cr0AUAAeAhxDVUVJSAAAjn/PAAGlmbAICAAAAAAsoKGKNAIAmsnRfg==",
  "customParams": "param1=value1&param2=value2",
  "podTemplateName": "podtemplate"
}

Atanan reklam aralarını listeleme

GET admanagervideo.googleapis.com/v1/networks/.../sources/.../content/.../adBreaks
Content-Type: application/json
Authorization: Bearer …

Yanıt gövdesi

Yanıt gövdesi, akışa atanan her reklam arası için ek bir breakState alanıyla reklam aralarını içerir. breakState alanı aşağıdaki değerleri destekler:

 // Ad break decisioning has started.
BREAK_STATE_DECISIONED

// Break has started to be delivered to end users.
BREAK_STATE_COMPLETE

Örnek yanıt

HTTP/1.1 200 OK
{
  "name": "networks/.../assets/.../adBreaks/1",
  "expectedDuration": "30s",
  "breakState": "BREAK_STATE_COMPLETE"
}