SGAI'yi kullanmaya başlama

Sunucu rehberli reklam ekleme (SGAI), istemci cihazlarında birleştirme. Google Hesabınızda Kapsül Yayınlama DAI'yı etkinleştirdiyseniz kullanıyorsanız SGAI'yi kullanabilirsiniz. Kapsül Yayınlama kullanmıyorsanız DAI etkinse hesap yöneticinizle iletişime geçin.

SGAI ile akış oluşturmak için Kapsül sunma API uç noktalarını kullanırsınız reklam meta verilerini ve reklam kapsülü manifestlerini alma.

Manifest düzenleme sunucunuz varsa reklam kapsülünü oluşturabilirsiniz. manifest URL'lerini oluşturun ve reklam kapsülü manifest bilgilerini içeren reklam işaretçileri ekleyin içerik akışınıza gönderebilirsiniz.

Alternatif olarak, başka bir mekanizma kullanarak reklam arası planlayabilirsiniz daha fazla tıklama URL'si eklemeniz gerekir. Bu durumlarda uygulamanız sesleri dinleyebilir kullanıcının akışla, uygulamanın kendisiyle etkileşimi gibi push bildirimi gönderebilirsiniz. Uygulama, bu etkinliklerden sonra reklamı oluşturabilir kapsül manifest URL'lerini ekleyin ve oynatıcıya reklam kapsülü manifestini yüklemeye başlamasını söyleyin.

Ön koşullar

Devam etmeden önce aşağıdakilere sahip olduğunuzdan emin olun:

  • Google Ad Manager ağınızda DAI Kapsül yayınlaması etkinleştirildi.
  • Kapsül yayınlama manifesti türünde bir canlı yayın etkinliği. Etkinliği oluşturmak için: bkz. DAI için canlı yayın oluşturun.

Önerileri uygulayın

Sizden önce reklam kapsülü manifest URL'sini oluşturun. şirketin adı Erken Reklam Arası Bildirimi (EABN) API'si ve beklenen süreyi, hedefleme bilgilerini ve diğer ayrıntıları belirtmek için parametrelerini dahil eder.

Üretim ve test akışları için EABN API'sini çağırın (özellikle reklamınız ağında programatik kampanyalar bulunmaktadır. Daha fazla bilgi için bkz. Programatik Doğrudan özellikleri ve yönergeleri.

Akış kaydı isteğinde bulunma

Bir kullanıcı video oynatıcı uygulamanızda içerik akışı başlattığında akış oturumu oluşturmak için hedefleme parametreleriyle kayıt isteği kullanabilirsiniz. Akış kaydı isteğinde bulunma hakkında ayrıntılı bilgi için Yöntem:akış. Daha sonra, yanıt verileri .

Aşağıdaki örneklerde akış kaydı isteğinde bulunulur:

Düz metin HTTP

  • İstek:
authority: dai.google.com
method: POST
path: /ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream
scheme: https
content-type: application/x-www-form-urlencoded

cust_params=customID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2
  • Yanıt:
{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

kabuk

  • Komut satırı:
curl \
-H "Host: dai.google.com" \
-H "content-type: application/x-www-form-urlencoded" \
  --data-binary "cust_params=channelID%253D1543216789%2526anotherKey%253Dvalue1%252Cvalue2" \
  --compressed "https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream"
  • Çıkış:
{
    "manifest_format": "hls",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "polling_frequency": 10,
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL"
}

JavaScript

  • Getirme API'sini kullanarak:
const response = await fetch("https://dai.google.com/ssai/pods/api/v1/network/51636543/custom_asset/hls-podserving-manifest/stream", {
  "headers": {
    "content-type": "application/x-www-form-urlencoded",
  },
  "body": "cust_params=channelID%3D1543216789%26anotherKey%3Dvalue1%2Cvalue2",
  "method": "POST",
});

  const stream = await response.json();
  console.log(stream);
  • Konsol günlüğü:
{
    "stream_id": "24fd4e7c-95a0-42be-8874-00625139b9db:TUL",
    "media_verification_url": "https://dai.google.com/view/p/service/linear/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/loc/TUL/network/51636543/event/TFyZF0IoSpqvCLtLv8JdCw/media/",
    "metadata_url": "https://dai.google.com/linear/pods/hls/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/metadata",
    "session_update_url": "https://dai.google.com/linear/v1/pa/event/TFyZF0IoSpqvCLtLv8JdCw/stream/24fd4e7c-95a0-42be-8874-00625139b9db:TUL/session",
    "polling_frequency": 10,
    "pod_manifest_url": "https://dai.google.com/linear/pods/v1/hls/event/TFyZF0IoSpqvCLtLv8JdCw/pod/$pod-id$.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db%3ATUL",
    "manifest_format": "hls"
}

Reklam arası meta verileri için anket

Akış kaydı isteğinde bulunduktan sonra reklam meta verileri için anket yapın. Alıcı: şu adresteki akış yanıtındaki polling_frequence öğesini kullanarak bir zamanlayıcı ayarladınız: reklamı çağırmak için kayıt adımına metadata olarak ayarlayın. Her anket için, başlangıçta ilişkilendirilen meta verileri içeren kısmi bir reklam listesi kullanılabilir hale gelir.

Reklam kapsülü manifest URL'sini oluşturma

Bir pod kaynağı geliştirmeyi öğreneceksiniz. Ardından, başlamak için URL'yi bir video oynatıcıya iletin. reklam kapsülünü yükleme.

Aşağıdaki örnekte reklam kapsülü manifest URL'sinin yapısı gösterilmektedir:

https://dai.google.com/linear/pods/v1/hls/network/51636543/custom_asset/pod_serving_hls_manifest_mp4/pod/101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000

Reklam kapsülü manifest URL parametrelerini reklam arasına göre hesaplayabilirsiniz video oynatıcıdan veya sunucu bildiriminden alınan bilgilerdir. Örneğin, bu parametrelere ilişkin gereksinimleri öğrenmek için Yöntem: pod manifest.

Reklam kapsülü manifestini oynat

İstemci video oynatıcı uygulamasında içerik akışını oynatmaya birincil video oynatıcınızın oynatma ve reklam zaman planlaması gibi bilgileri içerebilir.

Reklam kapsülü manifest URL'lerini oluşturur ve bunları sonra, video oynatıcının yaklaşan reklam arası etkinliklerini gözlemleyin ve her reklam arası oynatma sırasında id3 etkinliklerine abone olmanızı sağlar. Reklamı planlarsanız oluşturma sırasında id3 etkinliklerine abone olun.

Gösterimleri ve reklam etkinliklerini raporlayın

Bir video oynatıcı reklam kapsülünü oynattığında ve id3 süreli meta verilerle karşılaştığında reklam etkinliklerini dinleme ve bunları işleme koyabilmek için medya doğrulama ping'leri gönderebilir.