Google, Anlık Seçim'de bir veya daha fazla gösterimi açıklayan sinyaller sağlamak için seçim uç noktanıza bir JSON
SegmentRequest
gönderir. Bu sayede, her biri için geçerli veri segmentlerini belirleyebilirsiniz.
Bu kılavuzda, SegmentRequest işleyen kürasyon mantığı geliştirme konusu ele alınmaktadır.
gzip kodlamasını kullanma
Google, uç noktanıza SegmentRequest gönderirken gzip kodlamasını kullanır. Uç noktanızın gzip kodlamasıyla alıp yanıt verebilmesi gerekir.
İçerik sinyali veya kitle sinyali uç noktalarıyla içerik seçimi
Anlık Seçim uç noktası oluşturduğunuzda, bağlamsal sinyaller mi yoksa kitle sinyalleri mi alacağınızı seçmeniz gerekir. Seçtiğiniz sinyaller; uç noktanıza gönderilen segment isteklerinin nasıl doldurulduğunu, ne kadar envanterin uç noktanıza gönderilen segment istekleri oluşturduğunu ve entegrasyonunuzda kullanılan düzenleme mantığını etkiler.
İçerik sinyallerini kullanma
Bağlamsal sinyaller, gösterimin kaynağını açıklayan yayıncı, cihaz ve kullanıcı hakkındaki bilgileri içerir. Aşağıdaki listede, kullanılabilir sinyaller açıklanmaktadır:
SegmentRequest.site: Gösterimi oluşturan web sitesini (ör. sitenin URL'si) açıklar.SegmentRequestiçinde yalnızcaSegmentRequest.siteveSegmentRequest.appdeğerlerinden biri doldurulabilir.SegmentRequest.app: Gösterimi oluşturan uygulamayı (ör. uygulamanın platforma özel uygulama tanımlayıcısı) açıklar.SegmentRequest.siteveSegmentRequest.appdeğerlerinden yalnızca biriSegmentRequestiçinde doldurulabilir.SegmentRequest.pub: Gösterimi oluşturan medyanın yayıncısını tanımlar. Örneğin, yayıncının kimliği.SegmentRequest.user: Kullanıcıların kişisel verilerinin nasıl işlenebileceğiyle ilgili tercihlerini açıklar. Örneğin, TCF izin dizesiyle.SegmentRequest.device: Cihazla ilgili bilgileri (ör. metropol düzeyinde hassasiyete sahip coğrafi konum) açıklar.
SegmentResponse içinde döndürülecek geçerli veri segmentlerini belirleyebilen seçim mantığını uygulamak için bağlamsal sinyalleri kullanabilirsiniz.
Kitle sinyallerini kullanma
Kitle sinyalleri, kullanıcı veya cihaz tanımlayıcılarının yanı sıra güvenli sinyalleri de içerir.
Güvenli sinyaller, yayıncı tarafından oluşturulan ve bir veya daha fazla iş ortağıyla paylaşılmak üzere seçilen verilerdir. Reklam isteğinde Google ile paylaşılmadan önce karartılırlar ve Gerçek Zamanlı Seçim'de SegmentRequest.user.eids.uids.id içinde karartılmış biçimde görünürler.
Uç noktanız kitle sinyallerini kullanacak şekilde yapılandırılmışsa uç noktanız yalnızca güvenli sinyalleri içerik seçimi hesabınızla paylaşmayı seçen yayıncıların envanteri için segment istekleri alır. Sonuç olarak, bağlamsal sinyal uç noktalarına kıyasla kitle sinyali uç noktalarına gönderilmeye uygun toplam gösterim sayısı daha azdır.
Uç noktanızın düzenleme mantığı, kitle sinyallerini yorumlamalı ve SegmentResponse içinde döndürülecek geçerli veri segmentlerini belirlemelidir.
SegmentRequest örnekleri
Bağlamsal sinyal Gerçek zamanlı içerik seçme uç noktası
{
"site":{
"page":"https://dfpgpt.appspot.com/smd/"
},
"pub":{
"id":"pub-1234567890987654"
},
"device":{
"geo":{
"country":"US",
"metro":"501"
}
}
}
Kitle sinyali Gerçek Zamanlı Seçim uç noktası
{
"device":{
"ifa":"OMITTED_IFA"
},
"user": {
"eids" : [ {
"source": "pubcid.org",
"uids":[
{ "id" :"OMITTED_SECURE_SIGNAL" }
]
}],
"buyeruid": "OMITTED_BUYERUID",
"id": "OMITTED_ID"
}
}
Sonraki adımlar
- Bazı
SegmentRequestalanlarının yorumlanmasında kullanılan referans veri dosyalarını bulma. - SegmentResponse ile nasıl yanıt vereceğinizi öğrenin.