Anlık seçme spesifikasyonunu öğrenin

Google, hedeflenen envanterinizle eşleşen reklam isteklerine dayalı olarak Gerçek Zamanlı Seçme entegrasyonunuza bir 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 kitle sinyalleri 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, anlık içerik seçimi 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 bir web sitesiyse site alanı doldurulur.
app Uygulama Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Uygulamanın açıklaması. 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ıyı tanımlayan bir açıklama.
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, 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 piksel (DIPS) cinsinden genişlik.
h int Yalnızca bağlamsal içerik seçimi iş ortakları için desteklenir. Cihazdan bağımsız pikseller (DIP) 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. Video oynatıcının cihazdan bağımsız pikseller (DIPS) cinsinden 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 (DIP) 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ı'na 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, belirgin 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, 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
id dize Google kullanıcı kimliği.
buyeruid dize Çerez Eşleştirme Hizmeti ile yüklenen barındırılan eşleşme verileri. Bu, varsayılan olarak dolgu olmadan web güvenli Base64 kodlamasıyla belirtilir. Hesap yöneticinizle iletişime geçerek bu alanın kodlama olmadan doldurulmasını isteğe bağlı olarak yapılandırabilirsiniz.
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 sürümü izin 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çilerle ilgili ayrıntılar 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 kitle düzenleme iş ortakları için desteklenir. Genişletilmiş kimlik örnekleri. Seçme işleminde eids alanı, yayıncının kullanıma sunduğu verilerdir (ör. güvenli sinyaller).

SIM kimliği

Özellik Tür Açıklama
source dize Yalnızca kitle düzenleme 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 kitle düzenleme iş ortakları için desteklenir. Belirtilen kaynaktaki UID nesneleri dizisi.

Benzersiz Kimlik

Özellik Tür Açıklama
id dize Yalnızca kitle düzenleme 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")
ifa dize Şifrelenmemiş cihaz reklam kimliği (karma oluşturulmamış). Google'ın Anlık Seçim protokolünde bu genellikle 36 karakterli bir UUID'dir. Android kimlikleri küçük harflerle, IDFA'lar ise büyük harflerle yazılır. Samsung cihazlarda bunlar 32 karakterlik alfanümerik değerlerdir.

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. geo-table.csv dosyasında Google metro kodu bulundu.
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.