SGAI'yi kullanmaya başlama

Sunucu yönlendirmeli reklam ekleme (SGAI), istemci cihazlarda birleştirilmeye hazır bir reklam kapsülü manifesti sağlar. Google Ad Manager ağınızdaki kapsül sunma DAI'sini etkinleştirdiyseniz SGAI'yi kullanabilirsiniz. Kapsül Yayınlama DAI'nız etkin değilse hesap yöneticinizle iletişime geçin.

SGAI ile, reklam meta verilerini ve reklam kapsülü manifestlerini almak için bir akış oluşturmak üzere Pod yayınlama API uç noktalarını kullanırsınız.

Bir manifest değiştirme sunucunuz varsa tercih ettiğiniz spesifikasyona göre reklam kapsülü manifest URL'lerini oluşturabilir ve reklam kapsülü manifest bilgilerini içerik akışınıza taşıyan reklam işaretçileri ekleyebilirsiniz.

Alternatif olarak, yayın manifestindeki reklam işaretçilerinden farklı bir mekanizma kullanarak reklam arası planlayabilirsiniz. Bu durumlarda uygulamanız, kullanıcının akışla, uygulamayla veya push bildirimle etkileşimi gibi diğer etkinlikleri dinleyebilir. Bu etkinliklerden sonra uygulama, reklam kapsülü manifest URL'lerini oluşturabilir ve oynatıcıya reklam kapsülü manifestini yüklemeye başlamasını söyleyebilir.

Ön koşullar

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

  • Google Ad Manager ağınızda DAI kapsülü yayınlama etkinleştirildi.
  • Kapsül yayınlama manifesti türüne sahip bir canlı yayın etkinliği. Etkinliği oluşturmak için DAI için canlı yayın oluşturma başlıklı makaleyi inceleyin.

Önerileri takip etme

Reklam kapsülü manifest URL'sini oluşturmadan önce, her reklam arasının beklenen süresini, hedefleme bilgilerini ve diğer parametrelerini belirtmek için Erken Reklam Arası Bildirimi (EABN) API'sini çağırmanızı öneririz.

Üretim ve test akışları için EABN API'yi çağırın. Özellikle reklam ağınız programlı kampanyalara sahipse bunu yapın. Daha fazla bilgi için Programatik Doğrudan özellikleri ve yönergeleri başlıklı makaleyi inceleyin.

Akış kaydı isteği gönderme

Bir kullanıcı video oynatıcı uygulamanızda içerik akışı başlattığında, Ad Manager'da bir akış oturumu oluşturmak için hedefleme parametrelerini içeren bir akış kaydı isteği gönderirsiniz. Akış kaydı isteği gönderme hakkında ayrıntılı bilgi için Method:stream bölümüne bakın. Ardından, istek üzerinden yanıt verilerini alırsınız.

Aşağıdaki örneklerde bir yayın kaydı isteği gönderilmektedir:

Düz metin HTTP kabuk JavaScript
  • İ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"
}
  • 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"
}
  • Fetch API'yi kullanma:
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ği gönderdikten sonra reklam meta verilerini sorgulayın. Anket yapmak için, kayıt adımında reklam metadata çağırmak üzere akış yanıtında polling_frequence kullanarak bir zamanlayıcı ayarlarsınız. Her anket için, meta verileri kullanıma sunulduğunda reklamların kısmi bir listesini alabilirsiniz.

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

Kapsül Yayınlama API'sinin kapsül kaynağı için bir URL oluşturun. Ardından, reklam kapsülünü yüklemeye başlamak için URL'yi bir video oynatıcıya iletin.

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/ad_break_id/ab101.m3u8?stream_id=24fd4e7c-95a0-42be-8874-00625139b9db:TUL&pd=120000

Reklam kapsülü manifest URL parametrelerini, video oynatıcıdan veya sunucu bildiriminden alınan reklam arası bilgilerine göre hesaplayabilirsiniz. Bu parametrelerin koşulları için Yöntem: pod manifesti bölümüne bakın.

Reklam kapsülü manifestini oynatma

İstemci video oynatıcı uygulamasında, birincil video oynatıcıyla içerik akışı oynatmaya başlayın ve video oynatıcınızın oynatma ve reklam zamanlamasını gözlemlemeyle ilgili dokümanlarını inceleyin (varsa).

Reklam kapsülü manifesti URL'lerini oluşturup bunları sunucu tarafındaki manifest'e eklerseniz video oynatıcının yaklaşan reklam arası etkinliklerini gözlemleyin ve her reklam arası oynatma sırasında id3 etkinliklerine abone olduğunuzdan emin olun. Reklam arası etkinliklerini istemci tarafında planlıyorsanız oluşturma sırasında id3 etkinliklerine abone olun.

Gösterimleri ve reklam etkinliklerini raporlama

Bir video oynatıcı reklam kapsülünü oynattığında ve zamanlanmış ID3 meta verileriyle karşılaştığında, video oynatıcının tetiklediği reklam etkinliklerini dinleyin ve medya doğrulama ping'leri göndermek için bunları işleyin.