Anlık seçme spesifikasyonunu öğrenin

Google, hedeflenen envanterinizle eşleşen reklam isteklerine göre Gerçek Zamanlı Seçme entegrasyonunuza bir SegmentRequest gönderir. SegmentRequest nesnesi, SegmentResponse'taki belirli 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 Real-time Curation protokolü için bir referanstır.

SegmentRequest

Özellik Tür Açıklama
imp Imp dizisi Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Sunulan gösterim fırsatlarını gösterir.
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 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ıdır. 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ı.

Göst.

Özellik Tür Açıklama
id dize Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Segment isteği bağlamında bu gösterimin benzersiz tanımlayıcısı. Değer 1'den başlar ve n gösterim için n'ye kadar artar.
banner Banner Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Gösterim bir banner reklam fırsatı olarak sunuluyorsa bu alan doldurulur.
video Video Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Gösterim bir video reklam fırsatı olarak sunuluyorsa bu alan doldurulur.
ext ImpExt Bu alan, Imp nesnesinin uzantılarıyla doldurulur.

Banner

Özellik Tür Açıklama
w int Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Cihazdan bağımsız pikseller (DIP) cinsinden genişlik.
h int Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Cihazdan bağımsız pikseller (DIPS) cinsinden yükseklik.
pos int Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Reklamın ekrandaki konumu. Olası yerleşim konumları hakkında daha fazla bilgi edinmek için AdCOM 1.0'daki Liste: Yerleşim Konumları bölümüne bakın.

Video

Özellik Tür Açıklama
w int Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Cihazdan bağımsız pikseller (DIPS) cinsinden video oynatıcının genişliği.
h int Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Video oynatıcının cihazdan bağımsız pikseller (DIPS) cinsinden yüksekliği.
pos int Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Reklamın ekrandaki konumu. Olası yerleşim konumları hakkında daha fazla bilgi edinmek için AdCOM 1.0'daki Liste: Yerleşim Konumları bölümüne bakın.

ImpExt

Özellik Tür Açıklama
gpid dize Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Genel yerleşim kimliğini açıklar. Yayıncı tarafından belirtilen, sayfadaki her reklam birimi için tedarik yolları arasında tutarlı olan, farklı ve kalıcı bir kimlik. Bu makaleyi inceleyin.

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.
mobile int Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Sitenin, mobil cihazlarda görüntülendiğinde düzeni optimize edecek şekilde programlanıp programlanmadığını gösterir. 0 = hayır, 1 = evet.

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ı, 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, web mülkü kodu ca-pub-123 olan 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) alınan, web'de güvenli olan bir base64 kodlu IAB Şeffaflık ve Kullanıcı Rızası Çerçevesi (TCF) 2.0 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 Katılımcı 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 işleminde 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 dizisi Yalnızca güvenli sinyaller seçim iş ortakları için desteklenir. Belirtilen kaynaktan alınan 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.
devicetype int Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Cihazın genel türü. Olası cihaz türleri hakkında daha fazla bilgi edinmek için AdCOM 1.0'daki Liste: Cihaz Türleri bölümüne bakın.
os dize Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Cihazın işletim sistemi (ör. "iOS").
make dize Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Cihaz markası (ör. "Apple")

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 bulunur.
city dize Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Ticaret ve Ulaşım Yerleri için Birleşmiş Milletler Kodunu kullanan şehir.

SegmentResponse

Özellik Tür Açıklama
segment Segment dizisi 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.