Anlık seçme spesifikasyonunu öğrenin

Google, hedeflenen envanterinizle eşleşen reklam isteklerine dayalı olarak SegmentRequest gönderir. SegmentRequest nesnesi, SegmentResponse içinde verilen envanter için hangi segmentlerinizin geçerli olduğunu belirlemek üzere kullanabileceğiniz bağlamsal sinyaller veya güvenli sinyaller sağlar. Anlık Seçme, JSON biçiminde gönderilen SegmentRequest ve SegmentResponse nesnelerini destekler.

Bu kılavuz, entegrasyonunuzu oluşturmanıza yardımcı olabilecek bir Gerçek Zamanlı Seçim protokolü referansıdır.

SegmentRequest

Özellik	Tür	Açıklama
site	Site	Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Web sitesinin tanımlayıcısı. Reklam destekli içerik, tarayıcı dışı bir uygulama değil de bir web sitesiyse site alanı doldurulur.
app	Uygulama	Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Uygulamanın açıklayıcısı. Reklam destekli içerik bir web sitesi değil de tarayıcı dışı bir uygulamaysa app alanı doldurulur.
pub	Yayıncı	Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Yayıncının tanımlayıcısı.
user	Kullanıcı	Segment isteğini başlatan yayıncı içeriğine göz atan kullanıcının tanımlayıcısı.
device	Cihaz	Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Kullanıcının cihazının tanımlayıcısı.
segment_request_id	dize	Segment isteğini diğer tüm segment isteklerinden bağımsız olarak tanımlamak için kullanılan benzersiz tanımlayıcı.

Site

Özellik	Tür	Açıklama
page	dize	Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Gösterimi gösteren sayfanın URL'si.

Uygulama

Özellik	Tür	Açıklama
bundle	dize	Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Uygulamaya özgü olması amaçlanan, platforma özel bir uygulama tanımlayıcısı. Android'de bundle alanı bir paket veya paket adıdır. iOS'te bu, sayısal bir kimliktir.

Yayıncı

Özellik	Tür	Açıklama
id	dize	Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Web mülkü kodunun yayıncı kodu sonekiyle tanımlanan bir yayıncı kimliği. Örneğin, ca-pub-123 web mülkü koduna sahip bir yayıncının kimliği pub-123 olarak ayarlanır.

Kullanıcı

Özellik	Tür	Açıklama
consent	dize	Yayıncının IAB Kullanıcı Rızası Yönetim Platformu'ndan (CMP) getirilen, web'de güvenli base64 kodlu IAB Şeffaflık ve Kullanıcı Rızası Çerçevesi (TCF) 2. sürümü kullanıcı rızası dizesi. Yayıncı, TCF 2 sürümü için bir CMP ile entegrasyon sağladıysa ve bu CMP, GDPR'nin reklam isteği için geçerli olduğunu belirtip geçerli bir izin dizesi sağlıyorsa consent alanı doldurulur. Kullanıcı rızası dizesinde listelenen tedarikçiler hakkında ayrıntılı bilgi için vendor-list.consensu.org/v2/vendor-list.json adresindeki IAB Küresel Tedarikçi Listesi'ne bakın.
eids	EID dizisi	Yalnızca güvenli sinyaller seçim iş ortakları için desteklenir. Genişletilmiş kimlik örnekleri. Seçme listesinde eids alanı, yayıncı tarafından sağlanan verilerdir (ör. güvenli sinyaller).

SIM kimliği

Özellik	Tür	Açıklama
source	dize	Yalnızca güvenli sinyaller seçim iş ortakları için desteklenir. Dahil edilen veri grubundan sorumlu kaynak veya teknoloji sağlayıcı. Üst düzey alan olarak ifade edilir.
uids	UID dizi	Yalnızca güvenli sinyaller seçim iş ortakları için desteklenir. Belirtilen kaynaktaki UID nesneleri dizisi.

Benzersiz Kimlik

Özellik	Tür	Açıklama
id	dize	Yalnızca güvenli sinyaller seçim iş ortakları için desteklenir. Tanımlayıcı. Seçme işleminde id alanı güvenli bir sinyaldir. Güvenli sinyaller hakkında daha fazla bilgi edinmek için Ad Manager'ın Güvenli sinyalleri teklif verenlerle ve seçim iş ortaklarıyla paylaşma başlıklı makalesini inceleyin.

Cihaz

Özellik	Tür	Açıklama
geo	Coğrafi	Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Kullanıcının cihazının konumu.

Coğrafi

Özellik	Tür	Açıklama
country	dize	Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. ISO-3166-1 Alpha-3 standardını kullanan ülke.
region	dize	Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. ISO-3166-2 standardı kullanılarak oluşturulan bölge kodu; ABD ise 2 harfli eyalet kodu.
metro	dize	Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Google metro kodu, geo-table.csv dosyasında bulunuyor.

SegmentResponse

Özellik	Tür	Açıklama
segment	Segment array	Bir segmentin tanımlayıcısı.

Segment

Özellik	Tür	Açıklama
segment_id	dize	Segmentin kimliği. Kimlik, Marketplace API'nin curators.dataSegments kaynağındaki segment adında bulunan curatorDataSegmentId ile eşleşmelidir.