Authorized Buyers Gerçek Zamanlı Teklif Verme Protokolü

Bu kılavuzda, Authorized Buyers Gerçek Zamanlı Teklif verme protokolü 288'deki her bir alanın yanı sıra ek uygulama ipuçları ve bilgiler açıklanmaktadır.

Ayrıca bu kılavuzun temel aldığı Authorized Buyers GZT proto dosyasına da bakın.

BidRequest nesnesi

Bu, Google'ın teklif istemek için kullandığı mesajdır. BidRequest, tek bir gösterime ait reklam alanını içerir.

Bu bölümde, kullanıcı hakkında bildiğimiz bilgiler listelenir.

Gösterimin kaynaklandığı web sayfası veya mobil uygulama hakkında bilgi.
Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
id zorunlu bayt Google tarafından oluşturulan benzersiz istek kimliği. Bu 16 bayt uzunluğundadır.
ip isteğe bağlı bayt IPv4 için IP adresinin ilk 3 baytı veya IPv6 için ilk 6 bayt. IPv6 adreslerinden eklenen baytların sayısı ve konumunun daha sonra değişebileceğini unutmayın.
user_data_treatment yineleniyor enum user_data_treatment ayarlandığında, kullanıcının çerez/kimlik verileri istekten temizlenir ve açıklama metnine gönderilmez. Etkilenen alanlar şunlardır:
  • google_kullanıcı_kimliği
  • barındırılan_eşleme_verileri
  • mobile.encrypted_advertising_id
  • mobile.encrypted_hashed_idfa
  • session_id

TAG_FOR_CHILD_DIRECTED_TREATMENT = 0 - Mevcut talep, Çocukların Çevrimiçi Gizliliğini Koruma Yasası kapsamında çocuklara yönelik olarak değerlendirilmelidir. Daha fazla bilgi için bu makaleye göz atın.

google_user_id isteğe bağlı string Çerez eşleştirme hizmetinin dokümanlarında açıklandığı şekilde, kullanıcıya ait Google kimliği. Bu alan, ikili çerez kimliğinin doldurulmamış, web için uygun, base64 kodlu sürümüdür. Kodlama ayrıntıları için RFC 3548'deki URL ve Dosya Adı Güvenli Alfabe ile Kodlama 64 bölümüne bakın. Bu alan, çerez eşleştirme hizmeti tarafından döndürülen Google kimliği ile aynıdır.
cookie_version isteğe bağlı int32 [int32] google_user_id sürüm numarası. Eşlemeyi bazen google_user_id olarak değiştirebiliriz. Bu durumda, sürüm artırılır.
cookie_age_seconds isteğe bağlı int32 [int32] google_user_id oluşturulduktan sonraki saniye cinsinden süre. Bu sayı nitelenebilir.
hosted_match_data isteğe bağlı bayt Bu google_user_id için depolanan verileri çerez eşleştirme hizmetiyle eşleştir. Eşleşme varsa bu alan, google_hm parametresinde iletilen kod çözülmüş verileri içerir.
session_id isteğe bağlı string CTV/OTT cihazlarda kısa süreli kullanıcı oturumunu temsil eder ve maksimum oturum süresi 6 saattir. Reklam kişiselleştirme için session_id kullanımına hiçbir zaman izin verilmez. session_id, yalnızca sıklık sınırı, rakip hariç tutma veya ilgili amaçlar için kullanılabilir.
user_agent isteğe bağlı string Tarayıcıyı ve isteği gönderen cihazın türünü tanımlayan bir dize. Bazı veriler çıkartılabilir veya değiştirilebilir.
privacy_treatments isteğe bağlı Gizlilik Değerlendirmeleri Gizlilik tedavileri. Teklif isteğindeki bazı alanlar, kullanıcı gizliliğini korumak için yaklaşık olarak çıkarılabilir veya çıkarılabilir. Bu mesaj, bu istek üzerinden sunulan bir reklam fırsatı için geçerli olan gizlilik işlemleri hakkında bilgi sağlar.
user_agent_data isteğe bağlı KullanıcıAracısı Kullanıcı aracısı bilgileri
publisher_country isteğe bağlı string Yayıncının fatura adresi ülkesi. Bu, geo_criteria_id web sitesinde tespit edilen ülkeden veya web sitesinin barındırıldığı ülkeden farklı olabilir. Ülke kodlarının tam listesi için ülke kodları listesi dokümanlarına bakın.
host_publisher_id isteğe bağlı string Ana makine yayıncısının kimliği. Doldurulduğunda, ana makine yayıncısının gelir paylaşımına katıldığını ve kimliğin ads.txt dosyasını yetkilendirmek için kullanılabileceğini belirtir.
inventorypartnerdomain isteğe bağlı string Sitedeki veya uygulamadaki reklam envanterinin bir kısmının sahibi olan iş ortağının (sitenin veya uygulama sahibinin) alanı. İş ortağının ads.txt veya app-ads.txt dosyası burada barındırılır. Daha fazla bilgiyi http://iabtechlab.com/wp-content/uploads/2021/03/ctv-app-ads-explainer-guide.pdf adresinde bulabilirsiniz.
geo_criteria_id isteğe bağlı int32 [int32] Son kullanıcının konumu. Google Ads API'de kullanılan kodların bir alt kümesini kullanır. Kimlik listesi için teknik dokümanlardaki geo-table.csv tablosuna bakın. geo_criteria_id alanı, kullanımdan kaldırılan ülke, bölge, şehir ve metropol alanlarının yerini alır.
geo isteğe bağlı Coğrafi Kullanıcının yaklaşık coğrafi konumu. Tüm konum bilgileri, IP coğrafi konumdan türetildi. Enl/boylam alanları, diğer coğrafi alanlar (ör. şehir) tarafından da taşınan, coğrafi konumdan türetilen IP coğrafi konumu için bir referans konumu (ör. centroid) olabilir. Doğruluk, ilgili konumun yaklaşık alanına sahip bir dairenin yarıçapıdır. Kullanıcı gizliliğini korumak amacıyla konum ve doğruluğu doğru şekilde sabitlenir.
postal_code
postal_code_prefix 		isteğe bağlı string Son kullanıcının ülkesine uygun türde posta kodu algılandı (örneğin, ülke "US" ise posta kodu). postal_code_prefix alanı, doğruluğun tam kod olduğunu gösteremeyecek kadar düşük olduğu durumlarda ayarlanır. Aksi takdirde postal_code alanı ayarlanır.
encrypted_hyperlocal_set isteğe bağlı bayt Şifrelenmiş hiper yerel hedefleme sinyalleri.
hyperlocal_set isteğe bağlı HyperlocalSet encrypted_hyperlocal_set ürününün şifrelenmemiş sürümü. Bu alan yalnızca SSL bağlantısı kullanılırken ayarlanır.
timezone_offset isteğe bağlı int32 [int32] Kullanıcının GMT saat diliminin dakika cinsinden farkı. Örneğin, GMT+10 timezone_offset = 600 şeklindedir.
user_list yineleniyor Kullanıcı Listesi
publisher_id isteğe bağlı string Web mülkü kodunun yayıncı kodu son eki tarafından tanımlanan yayıncı kimliği. Örneğin "pub-123", web mülkü kodu "ca-pub-123"ün yayıncı kodudur (ca- web mülkünün ürüne özel ön ekidir).
seller_network_id isteğe bağlı int32 [int32] Satıcı ağ kimliği. Kimlik listesi için teknik dokümanlarda bulunan sellers-network-ids.txt dosyasını inceleyin. Bu ayar yalnızca site anonim değilse ve yayıncı site hedeflemeye izin veriyorsa ayarlanır.
partner_id isteğe bağlı sabit 64 Bu envanteri sağlayan iş ortağının kimliği. Bu, yalnızca seller_network_id ayarlandığında ve seller_network_id dışında başka iş ortağı bilgileri de mevcut olduğunda ayarlanır. İstikrarlı bir tanımlayıcı sağlamanın ötesinde, partner_id değeri anlamlı değildir.
url isteğe bağlı string Parametrelerin kaldırıldığı sayfanın URL'si. Bu her zaman bir protokolle (http veya https) başlar.
is_semi_transparent_request isteğe bağlı bool İstekte yarı şeffaf marka kullanımı kullanıldığını belirtir. Bu, istek URL'sinin yalnızca kesilmiş bir sürümünün sağlanacağı anlamına gelir. Bu karar yayıncı tarafından alınmıştır. //support.google.com/admanager/answer/4584891 adresine bakın.
detected_language yineleniyor string Web sayfasının dili, tarayıcı ayarları ve diğer sinyallere göre algılanan kullanıcı dilleri. Sıra rastgeledir. Kodlar, 2 veya 5 karakterden oluşur ve dil kodları tablosunda açıklanmıştır.
detected_vertical yineleniyor Sektör Not: Bu alandaki değerler artık çıkartılmıştır. Algılanan içerik temalarının sıralanmamış listesi. Kimlik listesi için teknik dokümanlardaki publisher-verticals.txt dosyasını inceleyin.
detected_content_label yineleniyor int32 [int32] Not: Bu alandaki değerler artık çıkartılmıştır. Algılanan içerik etiketlerinin listesi. Kimlik listesi için teknik dokümanlardaki content-labels.txt dosyasını inceleyin.
google_query_id isteğe bağlı string Bu, genel sorgu için benzersiz bir kimliği temsil eder. Bir sorgu için birden fazla açıklama metni varsa bu sorgu için tüm açıklama metni istekleri aynı google_query_id parametresini içerir.
auction_type isteğe bağlı enum Bu sorgu için yürütülecek açık artırma türü. Varsayılan = SECOND_PRICE.

UNKNOWN_AUCTION_TYPE = 0
FIRST_PRICE = 1
SECOND_PRICE = 2
FIXED_PRICE = 3

device isteğe bağlı Cihaz
key_value yineleniyor AnahtarDeğeri
mobile isteğe bağlı Mobil
video isteğe bağlı Video
publisher_settings_list_id isteğe bağlı sabit 64 Bu sayfa için geçerli olan yayıncı ayarları listesi kimliği. Ayrıntılar için GZT Yayıncı Ayarları kılavuzuna bakın.
publisher_type isteğe bağlı enum Reklamın gösterileceği envanterin yayıncı türü. Belirli bir istek için yayıncı envanteri, yayıncı tarafından temsil edilebilir veya bilinmeyen bir duruma sahip olabilir ve işletilebilir (sahip olunan ve işletilen). Varsayılan = UNKNOWN_PUBLISHER_TYPE.

UNKNOWN_PUBLISHER_TYPE = 0
PUBLISHER_OWNED_AND_OPERATED = 1
PUBLISHER_REPRESENTED = 2
page_visibility isteğe bağlı enum Reklam alanlarını içeren web sayfasının görünürlük durumu. www.w3.org/TR/page-Visibility/ konusuna bakın.

VISIBILITY_STATE_UNKNOWN = 0
VISIBILITY_STATE_VISIBLE = 1; Sayfa en azından kısmen görünürdür. Örneğin, simge durumuna küçültülmüş bir pencerenin ön planı sekmesinde.
VISIBILITY_STATE_HIDDEN = 2; Sayfa, kullanıcılara hiçbir şekilde gösterilmez. Örneğin, sayfa bir arka plan tarayıcı sekmesinde veya simge durumuna küçültülmüş bir penceredeyken olabilir.

adslot yineleniyor Reklam Alanı
bid_response_feedback yineleniyor BidResponsefeedback
response_deadline_ms isteğe bağlı int32 [int32] Google'ın bu belirli teklif isteği için ne kadar süre boyunca yanıt alacağını belirtir. Ayarlanmazsa teklif verenler varsayılan son tarihin kullanıldığını varsaymalıdır.
is_test isteğe bağlı bool True (Doğru) ise bu bir test isteğidir. Sonuçlar kullanıcılara gösterilmez ve açık artırmayı kazansa bile yanıtlar için faturalandırılmazsınız. Bu istek, gecikmeleri değerlendirmek veya diğer testler için kullanılabildiğinden normal işlemleri yapmaya devam etmelisiniz. Google trafiğiyle yaptığınız ilk test sırasında, verdiğiniz yanıtın doğru veya yanlış değeri olup olmadığına bakılmaksızın, verdiğiniz yanıtlar açık artırmadan filtrelenir.
is_ping isteğe bağlı bool Doğruysa bu istek ağ gecikmesini ölçmek içindir. Hiçbir teklif mantığını yürütmeden, yalnızca mümkün olan en kısa zamanda transaction_time_ms ile boş bir BidResponse döndürme
is_predicted_to_be_ignored isteğe bağlı bool Doğruysa açıklama metni modeli, bu istek için teklif vermeyeceğinizi tahmin etti. Teklif kalıpları değiştiğinde modeli otomatik olarak güncelleyebilmemiz için bu tür isteklerin örneklenmiş bir yüzdesini göndeririz.
supply_chain isteğe bağlı SupplyChain

UserAgent nesnesi

Kullanıcı aracısı bilgileri Bu alan, User-Agent üstbilgisinden veya Sec-CH-UA üstbilgilerinden çıkarılan kullanıcı aracısı hakkındaki bilgilerle doldurulur.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
browser isteğe bağlı BrandVersion Tarayıcıyı tanımlar.
platform isteğe bağlı BrandVersion Platformu tanımlar.
mobile isteğe bağlı bool Temsilci "mobil cihazlar için optimize edilmiş" içeriği tercih ediyorsa doğru değerini döndürür. Cihazla ilgili ayrıntılı bilgiler için BidRequest.device alanına bakın. Bu bilgi, bu alanla tutarlı olabilir veya olmayabilir (örneğin, cep telefonundaki tarayıcı "Masaüstü site" isteğinde bulunabilir).
architecture isteğe bağlı string Cihaz mimarisi (ör. "x86" veya "kol").
bitness isteğe bağlı string Cihazın bit hızı, ör. 64 bit mimari için "64".
model isteğe bağlı string Cihaz modeli.

Gizlilik Uygulamaları Nesnesi

Gizlilik tedavileri. Teklif isteğindeki bazı alanlar, kullanıcı gizliliğini korumak için yaklaşık olarak çıkarılabilir veya çıkarılabilir. Bu mesaj, bu istek üzerinden sunulan bir reklam fırsatı için geçerli olan gizlilik uygulamaları hakkında bilgi sağlar.

Üst öğe
Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
non_personalized_ads_reason isteğe bağlı NonPersonalizedAdsReason sıralama

Bu isteğe yanıt olarak döndürülen reklamların neden kişiselleştirilmemiş olması gerektiğini belirtir.

UNKNOWN = 0; Neden bilinmiyor.

PUBLISHER_DECLARED_NPA = 1; Yayıncı bu isteğin diğer sinyallerden bağımsız olarak kişiselleştirilmemiş reklamlar yayınlaması gerektiğini beyan etti.

RESTRICT_DATA_PROCESSING= 2; Yayıncı bu istek için kısıtlanmış veri işleme isteğinde bulundu.

USER_OPT_OUT = 3; Kullanıcı, reklam kişiselleştirmeyi devre dışı bıraktı.

allow_user_data_collection isteğe bağlı bool Yayıncı, teklif verenin ilgi alanına dayalı reklamlar ve yeniden pazarlama gibi amaçlarla kullanıcı profilleri oluşturmak için teklif isteği verilerini kullanmasına izin veriyorsa doğru değerini döndürür. Bu verileri kullanarak kullanıcı profilleri oluşturmak için teklif verenin de belirli bir gösterimi kazanması gerekir. Veri toplama kontrolleri hakkında başlıklı makaleyi inceleyin.

BrandVersion nesnesi

Üst öğe

Tarayıcı veya platform için üçlü (marka, sürüm)

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
brand isteğe bağlı string Marka tanımlayıcısı (ör. "Chrome" veya "Windows").
version yineleniyor string Sürüm, gerekirse bileşenlere bölünmüştür (ör. {"85", "1"} = v55.1).

Coğrafi nesne

Kullanıcının yaklaşık coğrafi konumu. Tüm konum bilgileri IP coğrafi konum türasyonundan türetilir. Enlem/boylam alanları, aynı zamanda diğer alanlar (örneğin, bir şehir) tarafından taşınan IP coğrafi konumdan türetilen konuma yönelik bir referans konumu (örneğin, merkez) olabilir ve doğruluk, söz konusu konumun yaklaşık alanına sahip bir dairenin yarıçapı olur. Konum ve doğruluğu, kullanıcı gizliliğini korumak için gerekli olduğu şekilde kesinleştirilir.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
lat isteğe bağlı double
lon isteğe bağlı double -180,0 ile +180,0 arasındaki boylam. Negatifin batıdır.
country isteğe bağlı string ISO-3166-1 Alpha-3 kullanılan ülke.
region isteğe bağlı string ISO-3166-2 kullanan bölge kodu; ABD'de ise 2 harfli eyalet kodu.
metro isteğe bağlı string Google metro kodu; Nielsen TPA'larına benzer, ancak tam olarak aynı değildir.
city isteğe bağlı string Birleşmiş Milletler Ticaret ve Ulaşım Kodları kullanan şehir. Şehir kodlarını görmek için ülkeler listesinden bir ülkeyi tıklayın.
zip isteğe bağlı string Posta kodu.
accuracy isteğe bağlı int32 [int32] Metre cinsinden tahmini konum doğruluğu.
utcoffset isteğe bağlı int32 [int32] UTC saat diliminden +/- dakika cinsinden yerel saat.

HyperlocalSet nesnesi

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
hyperlocal yineleniyor Yerel Meydan Bu alan şu anda en fazla bir hiper yerel poligon içeriyor.
center_point isteğe bağlı Yerel Mesafe.Nokta Bir coğrafi sınır alanının yaklaşık geometrik merkezi. Yalnızca coğrafi sınır alanının coğrafi şekline göre hesaplanır ve mobil cihazın coğrafi sınır alanı içindeki gerçek konumunu hiçbir şekilde belirtmez. Yukarıda birden çok hiper yerel poligon belirtilirse center_point, tüm hiper yerel poligonların geometrik merkezidir.

Yerel mesafe nesnesi

Üst öğe

Reklam isteğinin kaynağı olan cihazın IP adresine göre yaklaşık olarak tahmin edilen coğrafi konum bilgileri.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
corners yineleniyor Nokta Cihaz, bir köşe listesi ile tanımlanan coğrafi sınır çokgeninin herhangi bir noktasında olabilir. Şu anda, poligon her zaman 4 köşesi olan bir paralelkenardır.
Nokta nesne
Üst öğe

Dünya'nın yüzeyinde bulunan bir yer.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
latitude isteğe bağlı kayan noktalı Konumun enlemi.
longitude isteğe bağlı kayan noktalı Konumun boylamı.

UserList nesnesi

Bu alan varsayılan olarak doldurulmaz. Bunun yerine, teklif verenlerin anahtar olarak google_user_id veya hosted_match_data kullanarak liste kimliklerini depolamasını ve aramasını öneririz.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
id isteğe bağlı int64 Kullanıcı listesi kimliği.
age_seconds isteğe bağlı int32 [int32] Kullanıcının listeye eklenmesinden bu yana geçen süre (saniye cinsinden).

Dikey nesne

Google tarafından belirlendiği şekliyle, sayfa için algılanan bir veya daha fazla tema.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
id zorunlu int32 [int32] Dikey kimlik. Kimlik listesi için teknik dokümanlarda yayıncı-verticals.txt dosyasını inceleyin.
weight zorunlu kayan noktalı Bu sektörde (0,0, 1,0] aralığında ağırlık. Daha alakalı temaların ağırlığı daha yüksektir.

Cihaz nesnesi

Cihazla ilgili bilgiler.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
device_type isteğe bağlı enum Reklamın gösterileceği cihazın türü. Varsayılan = UNKNOWN_DEVICE.

UNKNOWN_DEVICE = 0
HIGHEND_PHONE = 1
TABLET = 2
PERSONAL_COMPUTER = 3 - Masaüstü veya dizüstü cihazlar.
CONNECTED_TV = 4 - Bağlı TV'ler (akıllı TV'ler) ve bağlı cihazlar (ör. Roku ve Apple TV).
GAME_CONSOLE = 5

platform isteğe bağlı string Cihazın platformu. Örnekler: Android, iPhone, Palm.
brand isteğe bağlı string Cihazın markası; örneğin, Nokia, Samsung.
model isteğe bağlı string Cihazın modeli (ör. N70, Galaxy).
os_version isteğe bağlı İşletim Sistemi Sürümü OS sürümü; örneğin, Android 2.1 için 2 veya iOS 3.3.1 için 3.3.
carrier_id isteğe bağlı int64 Cihaz internete kablosuz olarak değil operatör aracılığıyla bağlıysa mobil operatörün benzersiz tanımlayıcısı. Kargo şirketi kimliğinden operatör adını ve ülkesini öğrenmek için bu mobil operatörler tablosunu inceleyin.
screen_width isteğe bağlı int32 [int32] Cihaz ekranının piksel cinsinden genişliği.
screen_height isteğe bağlı int32 [int32] Cihaz ekranının piksel cinsinden yüksekliği.
screen_pixel_ratio_millis isteğe bağlı int32 [int32] Yüksek yoğunluklu cihazlar için kullanılır (örneğin, iOS retina ekranlar). Varsayılan olmayan bir değer, nominal ekran boyutunun (birim olarak piksellerle) ekrandaki gerçek piksel sayısını açıklamadığını gösterir. Örneğin, gerçekte 640x1280 piksel içeren bir ekran için nominal genişlik ve yükseklik 320x640 olabilir. Bu durumda her eksen, boyutlarının iki kat fazla piksel içerdiği için screen_width=320, screen_height=640 ve screen_pixel_ratio_millis=2000 değerine sahiptir.

Varsayılan = 0.
screen_orientation isteğe bağlı enum Reklam isteği gönderildiğinde cihazın ekran yönü. Varsayılan = UNKNOWN_ORIENTATION.

UNKNOWN_ORIENTATION = 0
PORTRAIT = 1
LANDSCAPE = 2

hardware_version isteğe bağlı string Apple iOS cihaz modeli; örneğin, "iphone 5s", "iphone 6+", "ipad 4".
limit_ad_tracking isteğe bağlı bool "Reklam İzlemeyi Sınırla", işletim sistemi veya cihaz ayarlarına dayalı olarak ticari olarak onaylanmış bir sinyaldir. Burada false, izlemenin sınırsız olduğunu, true ise izlemenin ticari yönergelere göre sınırlandırılması gerektiğini belirtir.

Bu sinyal, iOS Uygulama İzleme Şeffaflığı da dahil olmak üzere kullanıcı yüzeylerindeki kullanıcı kararlarını yansıtır. Ayrıca lmt ve App Tracking Transparency kılavuzu ile Android reklam kimliğine bakın.
app_tracking_authorization_status isteğe bağlı enum Bu alan yalnızca iOS cihazlar için doldurulur. Uygulama izleme yetkisinin durumunu gösterir. Bu değer, ATTrackingManager'dan alınır ve olduğu gibi sağlanır. iOS'in uygulama izleme yetkilendirmesi durumu hakkında daha fazla bilgi için bu makaleyi inceleyin.

NOT_DETERMINED = 0
RESTRICTED = 1
DENIED = 2
AUTHORIZED = 3

OsVersion nesnesi

Üst öğe

Platformun işletim sistemi sürümünü içerir. Örneğin, Android 2 için ana=2, reşit=0. iPhone 3.3.1, main=3 ve thumbnail=3 için.

Özellik Zorunlu/isteğe bağlı Type
major
minor
micro 		isteğe bağlı int32 [int32]

KeyValue nesnesi

Ek anahtar/değer özellikleri. Şu anda kullanılmıyor.

Özellik Zorunlu/isteğe bağlı Type
key
value 		isteğe bağlı string

Mobil nesne

Mobil cihazlardan gelen reklam sorguları hakkında bilgi. Mobil cihaz, akıllı telefon veya tablet olabilir. Bu durum hem web'e göz atan mobil cihazlardan hem de mobil uygulamalardan gelen reklam sorguları için mevcuttur.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
is_app isteğe bağlı bool True (doğru) değerine ayarlanırsa bu istek bir mobil uygulamadan gelir. app_id ayarlandığında her zaman doğru olur.
app_id isteğe bağlı string Bu reklam sorgusu bir mobil uygulamadan geldiğinde mobil uygulamanın tanımlayıcısı. Uygulama Apple iTunes uygulama mağazasından indirildiyse bu, uygulama mağazası kimliğidir (ör. 343200656). Bu, Android cihazlar için tam nitelikli paket adıdır. Örneğin, com.rovio.angrybirds. Windows cihazlar için Uygulama Kimliğidir; örneğin, f15abcde-f6gh-47i0-j3k8-37l93817mn3o.
is_interstitial_request isteğe bağlı bool True (Doğru) ise bu, bir mobil tam ekran reklam isteğidir.
app_category_ids yineleniyor int32 [int32] Not: Bu alandaki değerler artık çıkartılmıştır. Bu alan, mevcut mobil uygulamanın ait olduğu kategorilerin kimliklerini içerir. is_app yanlışsa bu alan boş olur. Mobil uygulamalar ile kategoriler arasındaki eşleme, Android uygulamaları için Google Play Store veya iOS uygulamaları için Apple iTunes Store tarafından tanımlanır. Kategori kimliğinden kategori adını bulmak için mobil uygulama kategorileri tablosuna bakın.
is_mobile_web_optimized isteğe bağlı bool Bir mobil web isteği için bu alan, sayfanın ileri teknoloji cep telefonlarındaki mobil tarayıcılar için optimize edilip edilmediğini gösterir. Varsayılan = false.
is_app_open_ad isteğe bağlı bool Mobil uygulama teklif isteğinin bir uygulama açılış reklamı için olup olmadığını belirtir. Daha fazla bilgi için Uygulama açılış reklamı kılavuzuna bakın.
encrypted_advertising_id isteğe bağlı bayt Bu alan, aşağıdakiler için reklam tanımlayıcılarında kullanılır:
  1. iOS cihazlar (bu Yardım Merkezi makalesinde açıklandığı gibi, Reklam Tanımlayıcı veya IDFA olarak adlandırılır.)
  2. Android cihazlar.
  3. Roku cihazlar.
  4. Microsoft Xbox cihazları.
  5. Amazon cihazlar.

encrypted_advertising_id bir IDFA ise, şifreli metnin şifresi çözüldükten sonra düz metin, iOS'in [ASIdentifierManager advertisingIdentifier] özelliği tarafından döndürülen IDFA (16 bayt UUID) olur. Düz metin, encrypted_hashed_idfa için IDFA'nın 16 baytlık MD5 hash değeridir. İstekte bulunan SDK sürümüne bağlı olarak iki alandan yalnızca biri kullanılabilir. Sonraki SDK'lar, karma olmayan değerler sağlar.
encrypted_hashed_idfa isteğe bağlı bayt Ayrıca encrypted_advertising_id açıklamasına bakın.
advertising_id isteğe bağlı bayt encrypted_advertising_id ürününün şifrelenmemiş sürümü. Bu alan yalnızca SSL bağlantısı kullanılırken ayarlanır. Bu alan 16 baytlık bir UUID'dir.
hashed_idfa isteğe bağlı bayt encrypted_hashed_idfa ürününün şifrelenmemiş sürümü. Bu alan yalnızca SSL bağlantısı kullanılırken ayarlanır. Bu alan 16 baytlık bir MD5'tir.
app_name isteğe bağlı string Android uygulamalarının uygulama adları Google Play Store'dan alınmıştır. iOS uygulamaları için uygulama adları App Annie tarafından sağlanır.
app_rating isteğe bağlı kayan noktalı Uygulama için ortalama kullanıcı puanı. Kullanıcı puanı aralığı 1,0 ile 5,0 arasındadır. Şu anda yalnızca Google Play Store'daki uygulamalar için kullanılabilir.
installed_sdk isteğe bağlı YüklüSdk Yayıncının uygulamasına yüklenen ve genellikle teklif verenin SDK'sı olduğu için teklif verenin erişebildiği SDK'nın kimliği ve bilgisi.
skadn isteğe bağlı SKAdNetworkRequest Yayıncının iOS 14 ve üzeri sürümler için uygulama yükleme ilişkilendirmesini destekleyen SKAdNetwork bilgileri Apple'ın SKAdNetwork API'si, reklamverenlerin başarılı bir yüklemenin ardından reklam ağına bir geri gönderme göndererek reklam odaklı uygulama yüklemesini ölçmesine yardımcı olur. Bir yüklemenin reklam gösterimiyle ilişkilendirilmesine izin vermek için yayıncıların, uygulamalarının mülk listesinde (Info.plist) desteklenen reklam ağlarını yapılandırması gerekir. Daha fazla bilgi için bu makaleyi inceleyin.

YüklüSdk nesnesi

Üst öğe

Genellikle teklif verenin SDK'sı olması nedeniyle teklif verenin erişebildiği yayıncı uygulamasında yüklü SDK'nın kimliği ve bilgisi.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
id isteğe bağlı string Yüklü SDK'nın tanımlayıcısı.
sdk_version isteğe bağlı Sürüm Yüklü SDK'nın sürümü.
adapter_version isteğe bağlı Sürüm Bağdaştırıcının yüklü SDK ile iletişim kuran sürümü.
Sürüm nesnesi
Üst öğe

Yüklü SDK ile yüklü SDK ve Google'ın SDK'sı arasında iletişim kuran bağdaştırıcının semantik sürümü.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
major isteğe bağlı int32 [int32] Varsayılan = -1
minor isteğe bağlı int32 [int32] Varsayılan = -1
micro isteğe bağlı int32 [int32] Varsayılan = -1

SKAdNetworkRequest nesnesi

Üst öğe

Yayıncının iOS 14 ve üzeri sürümler için uygulama yükleme ilişkilendirmesini destekleyen SKAdNetwork bilgileri Apple'ın SKAdNetwork API'si, reklamverenlerin başarılı bir yüklemenin ardından reklam ağına bir geri gönderme göndererek reklam odaklı uygulama yüklemesini ölçmesine yardımcı olur. Bir yüklemenin reklam gösterimiyle ilişkilendirilmesine izin vermek için yayıncıların, uygulamalarının mülk listesinde (Info.plist) desteklenen reklam ağlarını yapılandırması gerekir. Daha fazla bilgi için bu makaleye bakın.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
versions yineleniyor string OS sürümüne ve SDK sürümüne bağlı olarak istek tarafından desteklenen tüm SKAdNetwork sürümlerinin listesi.
sourceapp isteğe bağlı string Apple App Store'daki yayıncı uygulamasının kimliği.
skadnetids yineleniyor string Yayıncı uygulamasının Info.plist dosyasındaki SKAdNetworkIdentifier girişleri.
supported_fidelity_types yineleniyor enum İşletim sistemi ve SDK tarafından desteklenen SKAdNetwork API sürümüne ve reklam alanı özelliklerine bağlı olarak desteklenen doğruluk türlerinin listesi.

VIEW_THROUGH_ADS = 0; Bir reklamın en az 3 saniye boyunca görüntülenmesinden sonra 24 saat içinde gerçekleşen uygulama yüklemeleri ilişkilendirmesidir. SKAdnetwork sürüm 2.2 ve sonraki sürümlerde desteklenir. Daha fazla bilgi için bu makaleyi inceleyin.
STOREKIT_RENDERED_ADS = 1; Reklam tıklamalarıyla sağlanan, StoreKit tarafından oluşturulan App Store ürün sayfasından başlatılan uygulama yüklemeleri için ilişkilendirme. Tüm SKAdNetwork sürümleri için desteklenir. Daha fazla bilgi için bu makaleyi inceleyin.

skoverlay isteğe bağlı bool Bu isteğin video reklamlar için SKOverlay'yi destekleyip desteklemediğini belirtir.

Video nesnesi

Bu, video içi reklam isteğiyse videoyla ilgili bilgiler.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
placement isteğe bağlı enum Video reklamın nerede oynatılacağını açıklar. Varsayılan = UNKNOWN_PLACEMENT.

UNKNOWN_PLACEMENT = 0.
INSTREAM = 1 - Yayın içi, reklamın diğer video içeriğinden önce, sonra veya içerik oynatılırken oynatıldığı anlamına gelir. Bu, geleneksel bir TV reklamına benzer. Kullanıcının izlediği video içeriği reklam oynatılırken oynatılmıyor.
INTERSTITIAL = 2 - Geçiş, video reklamın video olmayan içeriğin (ör. haber makalesi veya video oyunu) önünde oynatıldığı anlamına gelir. Reklam, içeriğin kapladığı alanın tamamını veya büyük bir kısmını kaplar. Kullanıcı reklam bitene veya atlanana kadar içeriğe devam edemez.
IN_FEED = 3 - Feed içi video biçimi, kullanıcı sayfayı kaydırırken içerik feed'inde (genellikle sosyal uygulama feed'i veya editoryal içerik öğelerinin listesi vb.) gösterilen bir video reklam öğesidir. Kenar değil, ortalanmış olarak oluşturulur.
AUDIO = 4 - Ses, reklam öğesi olan bir reklam isteğidir. Bu öğe, video isteklerine özel olduğundan yukarıdaki YAYIN AÇMA işlevinden farklıdır.
IN_ARTICLE = 5 - Yazı içi video biçimi, editoryal içeriklerin paragrafları arasında bağımsız video oynatıcı olarak yüklenen ve oynatılan video reklam öğesidir.

description_url isteğe bağlı string Yayıncının Google'a video içeriğini açıkladığı, parametreler kaldırılmış sayfanın URL'si.
is_embedded_offsite isteğe bağlı bool Doğruysa video, yayıncının alanı dışındaki bir sayfaya yerleştirilir. Bu ayarlandığında, description_url her zaman olduğu gibi video açıklamasını gösterir ve BidRequest'teki url alanı, videonun yerleştirildiği sayfadır. Örneğin, Facebook'ta paylaşılan bir Vimeo videosundaki yayın içi reklam için is_embedded_offsite isteği ayarlandı. url alanı bir Facebook sayfası içindir ve description_url alanı Vimeo'daki videoyu işaret eder.
playback_method isteğe bağlı enum Video reklamın nasıl oynatılacağını açıklar. Mevcut en iyi ölçüm temel alınarak oynatma yönteminin otomatik oynatma, tıkla oynat veya fareyle üzerine gelme olduğu belirlenmiştir. Bu, kullanıcının bir web sayfasıyla ne kadar süre önce etkileşimde bulunduğu gibi bilgileri içerir. Otomatik oynatmada reklamlar, ses açık veya kapalı şekilde oynatılmaya başlayabilir. Bazı reklamlar (ör. feed içi reklamlar), kullanıcı reklamla etkileşime girene kadar yoksayılır.

Alternatif olarak, bir reklam normalde ses açık şekilde oynatılırsa ancak cihaz sessize alınırsa değer, ses kapalı olarak ayarlanır. Cihazın sessize alınıp alınmadığını belirlemenin mümkün olmadığı cihazlarda (örneğin, masaüstünde) sesin açık olduğunu varsayarız. Varsayılan = METHOD_UNKNOWN.

METHOD_UNKNOWN = 0
AUTO_PLAY_SOUND_ON = 1
AUTO_PLAY_SOUND_OFF = 2
CLICK_TO_PLAY = 3
MOUSE_OVER = 4
INITIATE_ON_ENTERING_VIEWPORT_SOUND_ON = 5
INITIATE_ON_ENTERING_VIEWPORT_SOUND_OFF = 6

is_clickable isteğe bağlı bool Envanterin, kullanıcıyı bir reklamveren sitesine götürmek için video reklamı tıklamaya izin verip vermediği. Özellikle bağlı TV'ler olmak üzere bazı platformlar, video reklamların tıklanmasını desteklemez. Bu durumda, bu alan false olarak ayarlanır.
videoad_start_delay isteğe bağlı int32 [int32] Reklamın başlangıcından itibaren reklamın gösterileceği zaman (milisaniye cinsinden). 0, videodan önce gösterilen reklam, -1 (veya herhangi bir negatif 32 bit hedef) videodan sonra, 1 (veya 32 bit tam sayı) videonun ortasında gösterilen reklam anlamına gelir. Değer yalnızca bu parametre ayarlandığında geçerli olur. Ayarlanmazsa görüntüleme konumu bilinmiyor.
max_ad_duration isteğe bağlı int32 [int32] Reklamın döndürmesi gereken milisaniye cinsinden maksimum süre. Ayarlanmazsa veya <= 0 değerine sahipse süreye izin verilir.
min_ad_duration isteğe bağlı int32 [int32] Döndürmeniz gereken reklamın milisaniye cinsinden minimum süresi. Ayarlanmazsa veya 0'dan küçük bir değere sahipse minimum süre yoktur.
max_ads_in_pod isteğe bağlı int32 [int32] Video kapsülündeki maksimum reklam sayısı. Sıfır olmayan bir değer, geçerli reklam alanının birden fazla video reklam gösterebilen bir video kapsülü olduğunu gösterir. Gösterilen gerçek video reklam sayısı bu değerden düşük veya bu değere eşit olabilir ancak bunu aşamaz.
video_ad_skippable isteğe bağlı enum Yayıncı atlanabilir video reklamlara izin veriyor/veriyor/engelliyor mu? Varsayılan = ALLOW_SKIPPABLE.

ALLOW_SKIPPABLE = 0
REQUIRE_SKIPPABLE = 1
BLOCK_SKIPPABLE = 2

skippable_max_ad_duration isteğe bağlı int32 [int32] Bu reklam atlanabilirse döndürülmesi gereken reklam için milisaniye cinsinden maksimum süre (bu genellikle atlanamayan reklamlar için izin verilen maksimum süreden farklıdır). Ayarlanmazsa veya <= 0 değerine sahipse süreye izin verilir.
protocols yineleniyor enum Desteklenen video teklif yanıtı protokolleri dizisi. Desteklenen video protokolleri.

VAST_1_0 = 1
VAST_2_0 = 2
VAST_3_0 = 3
VAST_1_0_WRAPPER = 4
VAST_2_0_WRAPPER = 5
VAST_3_0_WRAPPER = 6
VAST_4_0 = 7
VAST_4_0_WRAPPER = 8
DAAST_1_0 = 9
DAAST_1_0_WRAPPER = 10

allowed_video_formats yineleniyor enum Bu istek için izin verilen video dosyası biçimleri. Yanıt, en az birini desteklemelidir. 

UNKNOWN_VIDEO_FORMAT = -1;
// Flash video files are accepted (FLV).
VIDEO_FLV = 0;
VIDEO_MP4 = 1;
// Valid VAST ads with at least one media file
// hosted on youtube.com.
YT_HOSTED = 2;
// Flash VPAID (SWF).
VPAID_FLASH = 3;
// JavaScript VPAID.
VPAID_JS = 4;
AUDIO_MP3 = 5;
AUDIO_OGG = 6;
// Requires both MP3 & OGG as Google does not know
// which codecs are installed on the player.
AUDIO_MP3_OGG = 7;
VIDEO_WEBM = 8;
VIDEO_MOV = 9;
VIDEO_3GPP = 10;
VIDEO_HLS = 11;
VIDEO_DASH = 12;
// Audio version of MP4.
AUDIO_MP4A = 13;
companion_slot yineleniyor Tamamlayıcı Alan Videoyla birlikte gösterilebilecek tamamlayıcı reklam alanlarıyla ilgili bilgiler. Bu tekrarlanan bir alan olsa da çoğu durumda yalnızca bir değer olur. Tamamlayıcı reklam yoksa bu alan ayarlanmaz.
end_cap_support isteğe bağlı enum Video sonu desteği. Etkinleştirildiğinde, tamamlayıcı reklam, video reklam oynatıldıktan sonra video alanında bir bitiş sınırı (bilgi kartı) olarak oluşturulacak şekilde seçilebilir. Birden fazla tamamlayıcı reklam döndürülürse IMA SDK, cihazın ekran boyutuna en uygun reklamı seçer. Bitiş sınırı, yalnızca mobil video geçiş reklamı envanterinde desteklenir. Ağustos 2015'ten itibaren END_CAP_FORBIDDEN ve END_CAP_REQUIRED desteklenmiyor.

END_CAP_NOT_ENABLED = 0; - Tamamlayıcı reklam bitiş sınırı olarak oluşturulmaz.
END_CAP_OPTIONAL = 1; - Yanıtta uygun tamamlayıcı banner varsa bitiş sınırı oluşturulur ancak tamamlayıcı banner gerekli değildir.
END_CAP_FORBIDDEN = 2; - Tamamlayıcı reklamla yanıt filtrelendi.
END_CAP_REQUIRED = 3; - Tamamlayıcı reklam olmadan yanıt filtrelenir.

content_attributes isteğe bağlı ContentÖzellikler Video reklam değil, kullanıcının görüntülediği video özellikleri. Bu alanlar, video yayıncısının video meta verilerinin kullanılabilirliğini temel alır ve her zaman doldurulamayabilir.
DEPRECATED_inventory_type isteğe bağlı enum İsteğin gönderildiği envanterin türü. Kullanımdan kaldırıldı ancak Ocak 2017'ye kadar doldurulmaya devam edecek. Envanterin geçiş reklamı mı yoksa yayın içi mi olduğunu belirlemek için yerleşim alanını kullanın. İsteğin bir mobil cihazdan gelip gelmediğini belirlemek için Device.device_type ve isteğin bir uygulamadan gelip gelmediğini belirlemek için Mobile.is_app özelliğini kullanın. WEB_VIDEO, web tarayıcılarından INSTREAM yerleşimdir. GAMES hem uygulamalardan hem de web tarayıcılarından INTERSTITIAL yerleşimden oluşur. MOBILE_INTERSTITIAL, yalnızca uygulamalardaki INTERSTITIAL yerleşimdir. Bu envanter, görüntülü reklamlara da izin verir. adslot.excluded_attributes 21 değerini (CreativeType: Html) içermiyorsa bir reklam alanının görüntülü reklamlara izin verip vermediğini anlayabilirsiniz

MOBILE_APP_VIDEO, yalnızca uygulamalara ait INSTREAM yerleşimdir.

WEB_VIDEO = 0
GAMES = 1
MOBILE_INTERSTITIAL = 2
MOBILE_APP_VIDEO = 3

is_livestream isteğe bağlı bool Reklam isteğinin bir canlı video akışında yayınlanıp yayınlanmadığını belirleyin (0 = canlı değil, 1 = canlı). Varsayılan = false.

CompanionSlot nesnesi

Üst öğe

Videoyla birlikte gösterilebilecek tamamlayıcı reklam alanları hakkında bilgi. Bu tekrarlanan bir alan olsa da çoğu durumda yalnızca bir değer olur. Tamamlayıcı reklam yoksa bu alan ayarlanmaz. Kullanıcı videoyu atlarsa gösterilmez. Daha fazla bilgi için Video Reklamlar kılavuzuna bakın.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
height yineleniyor int32 [int32] Bu alanlar, bu alanda kullanılabilen yükseklik ve genişlikleri temsil eder. Her zaman aynı sayı yükseklikleri ve genişlikleri kullanılır.
width yineleniyor int32 [int32] Bu alanlar, bu alandaki kullanılabilir yükseklikleri ve genişlikleri temsil eder. Her zaman aynı sayı yükseklikleri ve genişlikleri kullanılır.
creative_format yineleniyor enum Bunlar, bu tamamlayıcı reklam alanında izin verilen reklam öğelerinin biçimleridir.

IMAGE_CREATIVE = 0
FLASH_CREATIVE = 1
HTML_CREATIVE = 2

ContentAttribute nesnesi

Üst öğe

Video reklam değil, kullanıcının görüntülediği video özellikleri.

Bu alanlar, video yayıncısının video meta verilerinin kullanılabilirliğini temel alır ve her zaman doldurulamayabilir.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
duration_seconds isteğe bağlı int32 [int32] Videonun saniye cinsinden süresidir.

AdSlot nesnesi

Sayfadaki reklam alanlarıyla ilgili bilgiler.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
id zorunlu int32 [int32] Belirli bir sayfada benzersiz olan ve genellikle 1'den sayılmaya başlanan, rastgele atanmış bir slot kimliği. Bunu, BidResponse'ta teklif vermek istediğiniz alanı tanımlamak için kullanırsınız.
ad_block_key isteğe bağlı uint64 Yayıncı, reklam alanı ve sayfa kombinasyonu için sabit bir tanımlayıcı.
targetable_channel yineleniyor string Bu reklam alanının üyesi olduğu kanal grubu. Kanal, sitedeki bir dizi reklam alanıdır. Reklamınızın nerede gösterileceği konusunda daha ayrıntılı kontrol sahibi olmak için bir kanalı ("spor bölümü" veya "tüm üst banner'lar" gibi) hedefleyebilirsiniz. Kanal adları yayıncı tarafından sağlanır.
width
height 		yineleniyor int32 [int32] Mobil geçiş reklamlarında (video reklamların uygun olduğu yerler dahil), ilk genişlik, yükseklik çifti ekran boyutudur (VAST video reklamlarının video oynatıcı boyutu da budur). Sonraki çiftler, geçiş reklamı boyutu kısıtlamalarını karşılayan önerilen geçiş reklamı boyutlarını temsil eder. Örneğin, ekran boyutundan daha büyük, genişliğin% 50'si ve yüksekliğinin% 40'ından küçük olmamalıdır.
flexible_adslot_settings isteğe bağlı EsnekReklam Alanı Ayarları Reklam alanı esnekse bu alan, alanın nasıl yeniden boyutlandırılabileceğiyle ilgili ayarları içerir.
excluded_attribute yineleniyor int32 [int32] Bu alanda gösterilebilecek reklamlar için izin verilmeyen özellik kimlikleri. Kimlik listesi için teknik dokümanlardaki publisher-excludedudable-creative-attributes.txt dosyasını inceleyin.
allowed_vendor_type yineleniyor int32 [int32] İzin verilen tedarikçi firma türleri. Kimliklerin listesi için teknik dokümanlardaki vendors.txt dosyasını inceleyin. Bu alan, engellemeleri geçersiz kılan anlaşmalar için geçerli değildir (bu Yardım Merkezi makalesine bakın).
consented_providers_settings isteğe bağlı ConsentedProvidersSettings Yayıncının AEA kullanıcılarının kişisel verilerinin reklam kişiselleştirme amacıyla kullanılmasına izin verdiğini Google'a bildirdiği sağlayıcılar hakkında bilgi. Bu alan yalnızca regs_gdpr doğru olduğunda doldurulur.
regs_gdpr isteğe bağlı bool Authorized Buyers, bu alanı yalnızca gösterimin AEA kullanıcısına sunulup sunulmayacağını Google'a sunulan bilgilere göre doldurur. GDPR hakkında yasal rehberlik sunmaz.
regs_lgpd isteğe bağlı bool Bu alan, Google'ın sahip olduğu bilgilere göre Brezilya'daki bir kullanıcıya sunulacağında "doğru" olarak ayarlanır. LGPD ile zorunlu kılınan isteklerde yayınlanmasına izin verilen reklam teknolojisi sağlayıcıların listesi için https://storage.googleapis.com/adx-rtb-dictionaries/lgpd-providers.csv adresine bakın.

LGPD hakkında daha fazla bilgi edinmek için bu makaleyi inceleyin.

excluded_sensitive_category yineleniyor int32 [int32] İzin verilmeyen hassas reklam kategorileri. Kimliklerin listesi için teknik dokümanlardaki ad-Sensitive-category.txt dosyasını inceleyin. Reklamları listelenen kategorilere göre sınıflandırabiliyorsanız bu hariç tutmaları uygulamanız gerekir. Bu alan, engellemeleri geçersiz kılan anlaşmalar için geçerli değildir (bu Yardım Merkezi makalesinde daha fazla bilgi bulabilirsiniz).
allowed_restricted_category yineleniyor int32 [int32] Özel ve herkesin katılabileceği açık artırmalarda izin verilen kısıtlanmış reklam kategorileri. Kimlik listesi için teknik dokümanlardaki ad-restricted-category.txt dosyasını inceleyin. Bunlar yalnızca özel ve herkesin katılabileceği açık artırma teklifleri için geçerlidir. Tercih edilen anlaşmalar veya programatik garantiler için allowed_restricted_category_for_deals alanına bakın.
allowed_restricted_category_for_deals yineleniyor int32 [int32] Tercih edilen anlaşmalar veya programatik garantiler için izin verilen kısıtlanmış reklam kategorileri. Teknik dokümanlardaki ad-restricted-category.txt dosyasının kimlik listesi vardır. Bunlar yalnızca tercih edilen anlaşmalar veya programatik garantiler için geçerlidir. Özel ve herkesin katılabileceği açık artırmalar için allowed_restricted_category alanına bakın. Bazı durumlarda kısıtlanmış kategorilere yalnızca tercih edilen anlaşmalarda veya programatik garantilerde izin verilir. Bu nedenle, bu alan allowed_restricted_category kapsamındaki tüm kategorileri ve ayrıca yalnızca tercih edilen anlaşmalar veya programatik garantiler için izin verilen kısıtlanmış kategorileri listeler.
allowed_languages yineleniyor string Yayıncının izin verdiği reklam öğesi dilleri listesi. Sıra rastgeledir. Kodlar 2 veya 5 karakterden oluşur ve dil kodları tablosunda açıklanmıştır. Ayarlanmazsa tüm dillere izin verilir.
excluded_product_category yineleniyor int32 [int32] İzin verilmeyen reklam ürünü kategorileri. Kimliklerin listesi için teknik dokümanlarda ad-product-category.txt dosyasını inceleyin. Reklamları listelenen kategorilere göre sınıflandırabiliyorsanız bu hariç tutmaları uygulamanız gerekir. Bu alan, engellemeleri geçersiz kılan anlaşmalar için geçerli değildir (bu Yardım Merkezi makalesinde olduğu gibi).
excluded_creatives yineleniyor Hariç Tutulan Reklam Öğesi Gösterim için izin verilmeyen reklam öğeleri. Bu listedeki reklam öğelerinden biriyle birlikte bir teklif göndermek, bu tür bir teklifin açık artırmadan önce filtrelenmesine neden olur. Bu özelliği etkinleştirmek istiyorsanız hesap yöneticinizle iletişime geçin.
only_deal_bids_accepted isteğe bağlı bool Reklam alanının yalnızca anlaşma teklifleri için uygun olup olmadığı. Bu alan doğru değerine ayarlandığında, herkesin katılabileceği açık artırma için teklifler filtrelenir. Bu alan yanlış olarak ayarlandığında teklif verenler herkesin katılabileceği açık artırma veya anlaşmalar için teklif verebilir.
matching_ad_data yineleniyor EşleşenReklam Verileri Eşleşen ön hedefleme yapılandırmaları hakkında bilgi.
exchange_bidding isteğe bağlı Exchange Teklif Verme Exchange teklif vermeyle ilgili parametreler (Google Ad Manager'da gerçek zamanlı teklif verme sağlayan üçüncü taraf exchange'ler). Bu alan, Authorized Buyers gerçek zamanlı teklif verenlerine yapılan çağrılarda hiçbir zaman doldurulmaz.
open_bidding isteğe bağlı OpenBidding Tüm Open Bidding isteklerinde gönderilen parametreler.
ad_unit_mapping isteğe bağlı AdUnitMapping Belirtilen reklam alanıyla eşleşen reklam birimi eşlemeleri.
dfp_ad_unit_code isteğe bağlı string Ad Manager reklam birimi kodu. Bu, şu anda yalnızca Open Bidding istekleri için ayarlanmıştır.
slot_visibility isteğe bağlı enum Alan için görünürlük bilgileri. Varsayılan = NO_DETECTION.

NO_DETECTION = 0
ABOVE_THE_FOLD = 1
BELOW_THE_FOLD = 2

viewability isteğe bağlı int32 [int32] Reklam alanı için görüntülenebilirlik yüzdesi. Bu, son kullanıcı tarafından geçmiş ve ortam verilerini temel alarak bu alanın görüntülenebilir olma ihtimaline dair bir tahmindir. [0, 100] aralığında yüzde olarak ifade edilir. -1 varsayılan değeri, görüntülenebilirliğin tahmin edilemediğini gösterir.
click_through_rate isteğe bağlı kayan noktalı Reklam alanında yayınlanan reklamlar için geçmiş tıklama oranı. Bu, [0,0, 1,0] aralığında bir kesir olarak ifade edilir. -1,0 olan varsayılan değer, geçmiş tıklama oranı verilerinin mevcut olmadığını gösterir. Bu sayı, Google Ads'den toplanan verileri içermez.
video_completion_rate isteğe bağlı kayan noktalı Reklam alanında yayınlanan video reklamların geçmişteki tamamlanma oranı. Bu, [0,0, 1,0] aralığında bir kesir olarak ifade edilir. -1,0 olan varsayılan değer, geçmiş tamamlanma oranı verilerinin mevcut olmadığını gösterir. Bu alan yalnızca video envanteri için geçerlidir ve Google Ads'den toplanan verileri içermez.
iframing_state isteğe bağlı enum Reklam alanının bulunduğu web sayfasındaki iFraming durumu. Varsayılan = UNKNOWN_IFRAME_STATE.

UNKNOWN_IFRAME_STATE = 0
NO_IFRAME = 1
SAME_DOMAIN_IFRAME = 2
CROSS_DOMAIN_IFRAME = 3

iframing_depth isteğe bağlı enum Web sayfasında bulunduğu reklam alanının iFrame derinliği. Şu anda yalnızca video reklam istekleri için ayarlanmıştır. Varsayılan = UNKNOWN_IFRAME_DEPTH.

UNKNOWN_IFRAME_DEPTH = 0
NOT_IN_IFRAME = 1
ONE_IFRAME = 2
MULTIPLE_IFRAME = 3

native_ad_template yineleniyor YerelReklamŞablonu Yerel reklam, yayıncı tarafından oluşturulan parçalardan oluşur. Bir yayıncı, birden fazla farklı yerel reklam şablonunu destekleyebilir. İstek banner'lara veya videolara da izin veriyorsa html_snippet veya video_url parametresini ayarlayarak diğer reklam türleriyle yanıt verebilirsiniz. Yalnızca yerel şablonlar mevcutsa gönderdiğiniz her yanıtta local_ad alanını ayarlamanız gerekir.
native_placement_type isteğe bağlı enum Yerel reklam alanının etrafındaki bağlama göre yerleşimini açıklar.

PLACEMENT_UNKNOWN = 0
PLACEMENT_IN_FEED = 1: İçerik feed'inde, örneğin organik feed'de/ızgara/listelemede/bantta.
PLACEMENT_ATOMIC_UNIT = 2 - Örneğin, makale sayfasında veya tek bir resim sayfasında içeriğin atom biriminde.
PLACEMENT_OUTSIDE = 3 - Temel içeriğin dışında (ör. sağ rayın reklamlar bölümünde, içeriğin yanında banner stilinde bir yerleşim olarak).
PLACEMENT_RECOMMENDATION = 4 - Öneri widget'ı, genellikle makale içeriğinin altında sunulur.

mediation_status isteğe bağlı enum Reklam isteğinin doğrudan yayıncıdan gelip gelmediği belirlenip belirlenmediği. Varsayılan = UNKNOWN.

UNKNOWN = 0
DIRECT_REQUEST = 1

auto_refresh isteğe bağlı Otomatik Yenile
sticky_settings isteğe bağlı Yapışkan Ayarlar
non_browser_slot_source isteğe bağlı enum Bu reklam alanının, masaüstü uygulamaları gibi tarayıcı dışı envanterde yayınlanabileceğini belirten yayıncı bildirimi. Varsayılan = UNDECLARED_SOURCE.

UNDECLARED_SOURCE = 0
DESKTOP_APP = 1

renderer isteğe bağlı enum Reklam isteğinde bulunan ortamı kimin kontrol edeceğini ve reklamı nasıl oluşturacağını tanımlar. Google tarafından yazılan kodun, bu alanın GOOGLE olarak ayarlandığı reklamı işleyeceği platformlarda. Bu alan PUBLISHER olduğunda, yayıncı reklamın oynatılmasını yönetmek için cihaza kendi kodunu yerleştirmiştir. Bu isteklerin ele alınma biçiminde herhangi bir teknik fark yoktur. Bu alanı, teknik olmayan nedenlerle farklı ortamlar arasında ayrım yapmak için kullanabilirsiniz. Bu alan yalnızca VAST video reklamlarına izin veren istekler için ayarlanır.

UNKNOWN_RENDERER = 0
GOOGLE = 1
PUBLISHER = 2

amp_ad_request_type isteğe bağlı enum Bu isteğin Accelerated Mobile Page (AMP) için olup olmadığı. AMP HTML sayfaları HTML, CSS ve JavaScript'in bazı kısımlarını kısıtlayarak daha hızlı yüklenir. AMP reklamlarının nasıl oluşturulacağı hakkında daha fazla bilgi için AMP reklamları README bölümüne bakın. Varsayılan = NON_AMP_PAGE.

UNKNOWN_AMP = 0 - AMP durumu bilinmiyor. İstek, bir AMP sayfasından geliyor olabilir veya olmayabilir.
NON_AMP_PAGE = 1 - AMP sayfası değil. Normal HTML, VAST video vb. olabilir.
AMP_PAGE_LATE_REQUEST = 2 - AMP HTML sayfasından geç yükleme isteği. Reklam, kısa bir gecikmeyle oluşturulacaktır ve bu nedenle sayfa oluşturma performansı olumsuz etkilenmeyecektir.

is_amp_page isteğe bağlı enum Bu sayfanın bir AMP sayfası olup olmadığı.

UNKNOWN_AMP_PAGE = 0 - AMP sayfa durumu bilinmiyor.
DIALECT_HTML = 1 - Bu bir AMP sayfası değil.
DIALECT_HTML_AMP = 2 - Bu bir AMP sayfasıdır.
amp_ad_requirement_type isteğe bağlı enum AMP reklamları için olası koşul türleri.

UNKNOWN_AMP_AD_REQUIREMENT_TYPE = 0 - AMP reklamıyla ilgili gereksinimler bilinmiyor.
AMP_AD_NOT_ALLOWED = 1 - AMP reklamlarına izin verilmiyor.
AMP_AD_ALLOWED_AND_NOT_EARLY_RENDERED = 2 - AMP reklamlarına veya AMP olmayan reklamlara izin verilir. AMP reklamları erken oluşturulmaz.
AMP_AD_ALLOWED_AND_EARLY_RENDERED = 3 - AMP reklamlarına veya AMP olmayan reklamlara izin verilir; AMP reklamları erken oluşturulur.
AMP_AD_REQUIRED = 4 - AMP reklamları gereklidir. AMP olmayan reklamlar yayıncı tarafından reddedilebilir.
is_rewarded isteğe bağlı bool Kullanıcının reklamı görüntülediği için ödül kazanıp kazanmadığı. Video reklamlar için tipik uygulamalar, kullanıcıların ek bir haber makalesini ücretsiz olarak okumalarına, oyunlarda ek can bulmalarına veya sponsorlu bir reklamsız müzik oturumu elde etmelerine olanak tanır. Ödül genellikle video reklam tamamlandıktan sonra dağıtılır.
allowed_ad_types yineleniyor enum Teklif yanıtında izin verilen olası reklam türleri. allowed_ad_types her zaman bir veya daha fazla değer içerir. Geçiş reklamları, banner reklamları da destekleyebilir. ALLOWED_AD_TYPE_NATIVE içeren bir reklam alanı, ALLOWED_AD_TYPE_VIDEO ayarlandığından bağımsız olarak yerel videoyu destekleyebilir veya desteklemeyebilir. Benzer şekilde, ALLOWED_AD_TYPE_VIDEO içermeyen bir reklam alanı, yerel bir videoyu desteklemez.ALLOWED_AD_TYPE_NATIVE

UNKNOWN_ALLOWED_AD_TYPE = -1
ALLOWED_AD_TYPE_BANNER = 0
ALLOWED_AD_TYPE_NATIVE = 1
ALLOWED_AD_TYPE_VIDEO = 2
ALLOWED_AD_TYPE_AUDIO = 3

session_depth isteğe bağlı int32 [int32] Bu tarama oturumunda bu kullanıcıya (bu site veya uygulamada) sunulan toplam gösterim sayısı ve 1. 30 dakika boyunca hiçbir işlem yapılmadığında oturum sonlandırılır. -1 olan varsayılan değer, oturum derinliğinin tahmin edilemeyeceğini belirtir.
publisher_settings_list_id yineleniyor sabit 64 Yayıncı ayarları, bu alan için geçerli olan kimlikleri listeler. Ayrıntılar için GZT Yayıncı Ayarları kılavuzuna bakın.
secure_signals yineleniyor GüvenliSinyal Yayıncı tarafından iletilen güvenli sinyaller.
api yineleniyor enum Bu gösterim için desteklenen API çerçevelerinin listesi. Bir API açıkça listelenmiyorsa bu API'nin desteklenmediği varsayılır. Aşağıdakilerden biri olabilir:

UNKNOWN_FRAMEWORK = 0
MRAID_1 = 3 Mobil Rich Media Reklam Arayüz Tanımları Sürüm 1.0.
MRAID_2 = 5 Mobil Rich Media Reklam Arayüz Tanımları Sürüm 2.0.
MRAID_3 = 6 Mobil Rich Media Reklam Arayüz Tanımları Sürüm 3.0.
OMID_1 = 7 Ölçüm Ölçümü Tanımı Sürüm 1.0'ı açın.

billable_event_rate_adjustment isteğe bağlı double Yalnızca özel SDK kullanılarak oluşturulan reklamlar için: Açık artırmadaki teklife uygulanan çarpan. Ayarlama, açık artırmanın kazanılmış olması koşuluyla teklifinizin faturalandırılabilir bir etkinlik (örneğin, reklam başarıyla oluşturma) oluşturma olasılığını (diğer tekliflerin açık artırmayı kazandıklarında faturalandırılabilir etkinlik oluşturma olasılığına göre) yansıtır. Bu düzenleme, 1'den büyük veya küçük olabilir. Bu yalnızca açık artırmadaki nihai sıralamayı etkiler. Özellikle, bu çarpan ödemeyi etkilemez. Varsayılan = 1,0.
omidpn isteğe bağlı string OM SDK entegrasyonunun tanımlayıcısı. Daha fazla bilgi için Open Measurement SDK'sı için OpenRTB Danışmanlığı bölümüne bakın.
omidpv isteğe bağlı string OM SDK entegrasyonunun sürümü. Daha fazla bilgi için Open Measurement SDK'sı için OpenRTB Danışmanlığı bölümüne bakın.
impression_expiration_seconds isteğe bağlı int32 [int32] Kazanan teklifin ardından saniye cinsinden bir gösterimin gerçekleşebileceği beklenen dönem. Gösterim yalnızca bu süre içinde sunuluyorsa faturalandırılabilir. Gösterimin geçerlilik süresi hakkında daha fazla bilgi edinmek için şu kılavuza bakın: https://developers.google.com/authorized-buyers/rtb/billing-event-guide
frequency_capping_scope zorunlu FrequencyCappingScope sıralama

Deneysel özellik, değişebilir. Daha fazla bilgi için GZT teklifleri için Google tarafından barındırılan sıklık sınırları ayarlama bölümüne bakın. Bu istek için kullanılabilecek sıklık sınırı yaptırımının kapsamını açıklar. Bir teklif için zorunlu kılınacak sıklık sınırları, BidResponse.ad.adslot.frequency_cap alanında belirtilebilir.

FREQUENCY_CAPPING_SCOPE_UNKNOWN = 0; Kullanılmaması gereken veya sıklık sınırı kapsamının güvenilir şekilde belirlenemeyeceğini belirten varsayılan değer.

FREQUENCY_CAPPING_SCOPE_NONE = 1; Bu istek için teklif yanıtı özelliklerine dayalı sıklık sınırı kullanılamaz. Sıklık sınırı olmayan teklif istekleri için sıklık sınırı olan bir teklif, açık artırmadan önce filtrelenir.

FREQUENCY_CAPPING_SCOPE_BROWSER = 2; Sıklık sınırı yaptırımı, aynı tarayıcı içindeki birden fazla sitede kullanılabilir.

FREQUENCY_CAPPING_SCOPE_DEVICE = 3; Sıklık sınırı yaptırımı, tarayıcılar hariç cihazdaki birden fazla sitede kullanılabilir.

FREQUENCY_CAPPING_SCOPE_APP = 4; Sıklık sınırı uygulama tek bir uygulamada kullanılabilir.

FREQUENCY_CAPPING_SCOPE_SITE = 5; Sıklık sınırı uygulama tek bir sitede kullanılabilir.

excluded_app_ids yineleniyor string Uygulamaların listesini, platforma özgü exchange'den bağımsız uygulama tanımlayıcılarına göre engelleyin. Android'de bu ad, paket veya paket adları (örneğin, com.foo.mygame) olmalıdır. iOS'te bunlar sayısal kimliklerdir.

EsnekAdSlotSettings nesnesi

Üst öğe

Alanın nasıl yeniden boyutlandırılabileceğiyle ilgili ayarlar.

Özellik Zorunlu/isteğe bağlı Type
max_width isteğe bağlı int32 [int32]
max_height isteğe bağlı int32 [int32]
min_width isteğe bağlı int32 [int32]
min_height isteğe bağlı int32 [int32]

ConsentedProvidersSettings nesnesi

Üst öğe

Yayıncının Google'a AEA kullanıcılarının kişisel verilerinin reklam kişiselleştirme amacıyla kullanılmasına izin verdiğini bildiren sağlayıcılar hakkında bilgi. Bu alan yalnızca regs_gdpr doğru olduğunda doldurulur.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
consented_providers yineleniyor int64 Yayıncının AEA'da AEA'daki kullanıcılara yasal olarak geçerli şekilde izin verdiğini belirttiği reklam teknolojisi sağlayıcılara (ATP'ler) karşılık gelen kimlik grubudur. 1) Yasal olarak gerekli olduğu durumlarda çerez veya başka yerel depolama bilgilerinin kullanılmasını ve 2) Google'ın AB Kullanıcı Rızası Politikası'na uygun olarak ATP tarafından reklamların kişiselleştirilmesi için kişisel verilerin toplanması, paylaşılması ve kullanılması.

Bir yayıncı, kullanıcı rızasını yönetmek için IAB Şeffaflık ve Kullanıcı Rızası Çerçevesi (TCF) 2. sürümü kullanıyorsa bu, Ek İzin dizesi aracılığıyla izin verilen ATP grubudur (Google'ın Ek İzin modu hakkında ayrıntılı bilgi için bu makaleye göz atın). TCF v2 izin dizesi üzerinden izin verilen ATP'ler, ConsentedProvidersSettings.tcf_consent_string alanında gösterilir.

Bir ATP kimliği ile ATP adı arasındaki bir eşleme, provider.csv'de yayınlanır.

tcf_consent_string isteğe bağlı string Yayıncının IAB Rıza Yönetimi Platformu'ndan (CMP) getirilen web için güvenli, 64 kodlu IAB Şeffaflık ve Kullanıcı Rızası Çerçevesi (TCF) v2 izin dizesi. Dizenin yapısı, IAB TCF v2 tarafından tanımlanır. Yayıncı, TCF 2. sürüm için bir CMP'ye entegre olmuşsa ve CMP, bu reklam isteği için GDPR'nin geçerli olduğunu belirtiyor ve geçerli bir izin dizesi sağlıyorsa bu alan doldurulur. Google TCF 2. sürüm entegrasyonu hakkında daha fazla bilgi için bu makaleye göz atın.

İzin dizesinde listelenen sağlayıcılar 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.

Hariç Tutulan Reklam Öğesi

Üst öğe

Google politikaları veya reklam öğesinin onaylanmaması, hariç tutulan reklam öğesi özellikleri, hariç tutulan ürün veya hassas kategoriler, izin verilen tedarikçi firma türleri, kısıtlanmış kategoriler veya teklif isteği için geçerli diller nedeniyle bu gösterim için teklif vermeye izin verilmeyen reklam öğeleri.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
buyer_creative_id isteğe bağlı string İzin verilmeyen reklam öğesinin alıcı reklam öğesi kimliği.

EşleştirmeAdData nesnesi

Üst öğe

Eşleşen ön hedefleme yapılandırmalarına karşılık gelen faturalandırma kimlikleri.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
billing_id yineleniyor int64 Eşleşen ön hedefleme yapılandırmalarına karşılık gelen faturalandırma kimlikleri.
minimum_cpm_micros isteğe bağlı int64 Açık artırmadan önce filtrelenmemek için teklif verebileceğiniz minimum BGBM değeri. Bu, küresel bir minimum veya yayıncı tarafından ayarlanan bir minimum değer olabilir. Değer, hesabınızın para birimi cinsinden mikro cinsindendir.
direct_deal yineleniyor DirectDeal
DirectDeal nesnesi
Üst öğe

Bu envanterle eşleşen anlaşmalar hakkında bilgi.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
direct_deal_id isteğe bağlı int64 Anlaşmayı tanımlayan kimlik.
fixed_cpm_micros isteğe bağlı int64 Anlaşmaya katılmak için en az fixed_cpm_micros (hesabınızın para birimi cinsinden mikro cinsinden) teklif vermeniz gerekir. Kazanırsanız sizden fixed_cpm_micros tutarında ücret alınır. Bu durum, deal_type=PRIVATE_AUCTION için geçerli değildir. Özel açık artırmalar için en az fixed_cpm_micros tutarında teklif vermeniz gerekir. fixed_cpm_micros tutarından daha yüksek BGBM teklifi vermek, deal_type=PRIVATE_AUCTION olduğunda kazanma şansınızı artırır ancak diğer anlaşma türlerinde kazanma şansınızı artırmaz.
deal_type isteğe bağlı enum Anlaşmanın türü. Varsayılan = UNKNOWN_DEAL_TYPE.

UNKNOWN_DEAL_TYPE = 0
PREFERRED_DEAL = 1
PRIVATE_AUCTION = 2
PROGRAMMATIC_GUARANTEED = 3 - Daha fazla bilgi için Programatik Garantili Anlaşmalar için GZT farkları yardım merkezi makalesine bakın.
AUCTION_PACKAGE = 4 - Daha fazla bilgi için Açık Artırma Paketleri yardım merkezi makalesine bakın.
MARKETPLACE_PACKAGE = 5 - Yayıncı tarafından seçilen envanter paketleri için anlaşma kimliği. Daha fazla bilgi için Pazar Yeri Paketleri yardım merkezi makalesine bakın.

publisher_blocks_overridden isteğe bağlı bool Yayıncının bu anlaşmayı yapılandırılmış engellemelerden muaf tutup tutmadığı. Bu ayar, Authorized Buyers politikalarını veya Reklam İnceleme Merkezi kararlarını geçersiz kılmaz.
creative_source isteğe bağlı enum Deneysel alan, değişebilir. Reklam öğesinin ana makinesini tanımlayan ve yalnızca Programatik Garantili anlaşmalar için doldurulacak bir enum. Şu anda bu alan yalnızca CREATIVE_SOURCE_ADVERTISER (Varsayılan) değerine ayarlanmalıdır.

CREATIVE_SOURCE_UNKNOWN = 0
CREATIVE_SOURCE_ADVERTISER = 1 - Reklam öğesi reklamveren tarafından barındırılır. Bu, teklif verenin teklif yanıtında bir reklam öğesi sağlaması gerektiği anlamına gelir.
CREATIVE_SOURCE_PUBLISHER = 2 - Reklam öğesi yayıncı tarafından barındırılır. Bu, teklif verenin teklif yanıtına bir reklam öğesi eklemesi gerekmez. Yayıncı tarafından barındırılan reklam öğeleri hakkında daha fazla bilgi için https://support.google.com/admanager/answer/9243220 adresine bakın. Bu özellik şu anda GZT teklif verenleri için desteklenmemektedir.

must_bid isteğe bağlı bool Bu alan yalnızca Programatik Garantili anlaşmalar için geçerlidir. Bu alan yanlışsa alıcının gösterime teklif vermeyi atlamasına izin verilir. Doğruysa alıcının, bu gösterim fırsatı için bu anlaşmada teklif vermesi gerekir.

Exchange Teklif Verme nesnesi

Üst öğe

Open Bidding'e katılan exchange'lerle (Ad Manager'da gerçek zamanlı teklif verme sağlayan üçüncü taraf exchange'ler) parametreler. Bu alan, Authorized Buyers gerçek zamanlı teklif verenlerine yapılan çağrılarda hiçbir zaman doldurulmaz.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
publisher_parameter yineleniyor string Ad Manager kullanıcı arayüzünde eşleşen getiri grubu yapılandırmalarının parçası olarak yayıncı tarafından isteğe bağlı olarak sağlanan UTF8 dizeleri. Biçim rastgeledir ve yayıncı ile exchange teklif vereni tarafından kabul edilmelidir.
key_value yineleniyor AnahtarDeğeri Yayıncıdan exchange'e gönderilecek yinelenen KeyValue çiftleri.

Open Bidding nesnesi

Üst öğe

Tüm Open Bidding isteklerinde gönderilen parametreler.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
is_open_bidding isteğe bağlı bool Yayıncı bu reklam alanını ve bu teklif vereni hedefleyen bir getiri grubu veya uyumlulaştırma grubu oluşturduysa bu alan doğru değerine ayarlanır. Open Bidding ve teklif verme süreci üzerindeki etkileri hakkında bilgi edinmek için Yardım Merkezimizi ziyaret edin.

AdUnitMapping nesnesi

Üst öğe

AdUnitMapping, teklif verenin ad alanındaki yayıncı envanter birimlerini tanımlamak için kullanılır. Eşlemeler, yalnızca teklif veren doğrudan bir yayıncıyla çalıştığı ve Google'ın reklam birimi ad alanından teklif verenin envanter ad alanına eşlemeyi sağladığında doldurulur. Reklam birimi eşlemesi yalnızca özel bir SDK kullanan istekler için geçerlidir. https://support.google.com/admanager/answer/9601810.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
Keyval İsteğe bağlı Anahtar Değer Teklif verenin ad alanındaki envanter birimini belirtmek için kullanılan anahtar/değer çifti.
FormatType İsteğe bağlı enum Eşleme için kullanılabilecek olası reklam birimi biçimleri. SDK'da kullanılacak adaptöre karşılık gelir.

Olası değerler:

  • FORMAT_UNKNOWN = 0;
  • Web veya mobil uygulamalar için görüntülü banner reklamlar. Örneğin, 320x50 leaderboard alanı. Buna, yayın dışı video dahildir.

    FORMAT_BANNER = 1;

  • Bir mobil uygulamanın içinde görüntülenecek tam ekran reklam.

    FORMAT_INTERSTITIAL = 2;

  • Web uygulamaları veya mobil uygulamalar için, yerleştirildikleri sitenin veya uygulamanın kullanıcı deneyimiyle uyumlu olan özel görüntülü ya da video reklamlar.

    FORMAT_NATIVE = 3;

  • Video içerik akışından önce, içerik akışı sırasında veya içerik akışından sonra görünen video reklamlar.

    FORMAT_VIDEO_VAST = 4;

  • Kullanıcıların uygulama içi ödül kazanmak amacıyla exchange'de gönüllü olarak reklam izlemesini sağlayan, mobil uygulamalar için video reklamlar.

    FORMAT_REWARDED = 5;

  • Kullanıcıların uygulama içi ödül karşılığında bir reklam izlemesine olanak tanıyan geçiş reklamları Etkinleştirilmesi zorunlu değildir. https://support.google.com/admanager/answer/7386053

    FORMAT_REWARDED_INTERSTITIAL = 6;

  • Uygulama açılış reklamları, uygulama yükleme ekranlarında gösterilir. Uygulama açılış reklamları, istediğiniz zaman kapatılabilir ve kullanıcılar uygulamayı ön plana aldığında gösterilecek şekilde tasarlanmıştır.

    FORMAT_APP_OPEN = 7;
Keyval nesnesi
Üst öğe

Envanter birimi alanı hiyerarşik olan ve birden fazla tanımlayıcısı olan teklif verenleri desteklemek için birden fazla anahtar/değer çifti belirtilebilir. Seçilen AdUnitMapping için anahtar/değer çiftleri, teklif yanıtında BidResponse.ad.sdk_rendered_ad.sdk_params olarak geri gönderilmelidir. Bu, teklif verenin SDK'sına iletilir.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
key İsteğe bağlı string Anahtar, teklif verenin SDK için envanter birimi tanımlayıcısının adıdır.
value İsteğe bağlı string Belirli bir biçim için teklif verenin envanter birimi tanımlayıcısının değeri.

NativeAdTemplate nesnesi

Üst öğe

Yerel reklam, yayıncı tarafından oluşturulan parçalardan oluşur. Bir yayıncı, birden fazla farklı yerel reklam şablonunu destekleyebilir. İstek banner'lara veya videolara da izin veriyorsa bunun yerine html_snippet, video_url veya video_vast_xml ayarlayarak diğer reklam türleriyle yanıt verebilirsiniz. Yalnızca yerel şablonlar mevcutsa gönderdiğiniz tüm yanıtlarda native_ad alanını ayarlamanız gerekir.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
required_fields isteğe bağlı int64 Yayıncının hangi alanları zorunlu kıldığını açıklayan Bitfield. Bu alanlar için değeri olmayan teklif yanıtları reddedilir. Tıklama ve görüntüleme izleme URL'leri her zaman dolaylı olarak gereklidir.

enum Fields - required_fields ve recommended_fields arasında kullanılan bitleri tanımlar. BidResponse.Ad.NativeAd içindeki her alan için bir bit vardır.

HEADLINE = 0x1
BODY = 0x2
CALL_TO_ACTION = 0x4
ADVERTISER = 0x8
IMAGE = 0x10
LOGO = 0x20
APP_ICON = 0x40
STAR_RATING = 0x80
PRICE = 0x100
STORE = 0x200
VIDEO = 0x400

recommended_fields isteğe bağlı int64 Yayıncı tarafından hangi alanların önerildiğini açıklayan bit alanı. Önerilen tüm alanlar desteklenir ancak önerilen tüm alanlar zorunlu değildir.

enum Fields - required_fields ve recommended_fields arasında kullanılan bitleri tanımlar. BidResponse.Ad.NativeAd içindeki her alan için bir bit vardır.

HEADLINE = 0x1
BODY = 0x2
CALL_TO_ACTION = 0x4
ADVERTISER = 0x8
IMAGE = 0x10
LOGO = 0x20
APP_ICON = 0x40
STAR_RATING = 0x80
PRICE = 0x100
STORE = 0x200
VIDEO = 0x400

headline_max_safe_length
body_max_safe_length
call_to_action_max_safe_length
advertiser_max_safe_length
price_max_safe_length 		isteğe bağlı int32 [int32] max_safe_length, kesme olmadan gösterilmesi garanti edilen maksimum Unicode karakter sayısını belirtir. Uzun dizeler, oluşturma sırasında yayıncı tarafından kesilir.
image_width
image_height
logo_width
logo_height
app_icon_width
app_icon_height 		isteğe bağlı int32 [int32] Gerekli en boy oranının hesaplanacağı genişlik ve yükseklik. Yanıtta daha büyük bir resim kullanabilirsiniz. En boy oranları, yükseklik ve genişlik ile ilişkilendirilenlerden önemli ölçüde farklı olan resimler filtrelenebilir.
style_id isteğe bağlı int32 [int32] Yerel reklamın oluşturulduğu belirli bir stil, HTML ve CSS için genel olarak farklı kimlik.
style_layout_type isteğe bağlı enum Her yerel reklam şablonu için stil düzeni türü. Varsayılan = PIXEL.

PIXEL = 0
FLUID = 1

style_height
style_width 		isteğe bağlı int32 [int32] style_layout_type değeri PIXEL ise oluşturma işleminden sonra tüm yerel reklamın genişliği ve yüksekliği. style_layout_type değeri FLUID ise style_height ve style_width doldurulamayabilir.

Nesneyi otomatik yenile

Üst öğe

Otomatik yenileme ayarları.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
refresh_settings yineleniyor Otomatik Yenileme Ayarları Yayıncının bu envanterde sahip olduğu otomatik yenileme ayarları. Yayıncılar bir envanter parçasında birden çok otomatik yenileme türü yapabileceği için bu işlem tekrarlanır.
refresh_count isteğe bağlı int32 [int32] Bu reklam alanının son sayfa yüklemesinden bu yana yenilenme sayısı.
AutoRefreshSettings nesnesi
Üst öğe
Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
refresh_type isteğe bağlı enum Beyan edilen otomatik yenilemenin türü. Varsayılan = UNKNOWN_AUTO_REFRESH_TYPE.

UNKNOWN_AUTO_REFRESH_TYPE = 0
USER_ACTION = 1 - Yenileme, kaydırma gibi kullanıcı tarafından başlatılan işlem tarafından tetiklenir.
EVENT = 2 - Etkinliğe dayalı içerik değişikliği. Örneğin, sayfada futbol maçının skoru değiştiğinde reklamlar yenilenir.
TIME = 3 - Zamana dayalı yenileme. Reklamlar, kullanıcı etkinliği olmasa bile önceden tanımlanmış bir zaman aralığında yenilenir.

min_refresh_interval_seconds isteğe bağlı int32 [int32] Minimum yenileme aralığı. Bu, tüm yenileme türleri için geçerlidir.

StickySettings nesnesi

Üst öğe

Yayıncı tarafından belirtilen kalıcılık ayarları.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
vertical_stickiness isteğe bağlı enum Kullanıcı sayfayı kaydırdığında reklam alanının ekranda kalan bir kenar çubuğu olup olmadığı. Varsayılan = UNKNOWN_STICKINESS.

UNKNOWN_STICKINESS = 0
IS_STICKY = 1

top_horizontal_stickiness isteğe bağlı enum Reklam alanının, kullanıcı sayfayı kaydırdığında ekranın üst kısmında kalan yatay bir alan olup olmadığı. Varsayılan = UNKNOWN_STICKINESS.

UNKNOWN_STICKINESS = 0
IS_STICKY = 1

bottom_horizontal_stickiness isteğe bağlı enum Reklam alanının, kullanıcı sayfayı kaydırdığında ekranın alt kısmında kalan yatay bir alan olup olmadığı. Varsayılan = UNKNOWN_STICKINESS.

UNKNOWN_STICKINESS = 0
IS_STICKY = 1

SecureSignal nesnesi

Üst öğe

Yayıncı tarafından iletilen güvenli sinyaller.

Özellik Zorunlu/isteğe bağlı Type Uygulama Ayrıntıları
data isteğe bağlı string Güvenli sinyal.
source_js isteğe bağlı Kaynak J'leri Kullanımdan kaldırıldı. Bu özellik, Şubat 2023'te kaldırılacaktır. Bunun yerine BidRequest.adslot.secure_signals.source kullanın.
source isteğe bağlı string Sinyalin kaynağı. Bu verileri oluşturan kitaplığın veya SDK'nın tanımlayıcısı.
SourceJs nesnesi
Üst öğe

Kullanımdan kaldırıldı. Bu özellik, Şubat 2023'te kaldırılacaktır. Bunun yerine BidRequest.adslot.secure_signals.source kullanın.

Özellik Zorunlu/isteğe bağlı Type Uygulama Ayrıntıları
id isteğe bağlı string Bu verileri oluşturan JavaScript kitaplığının tanımlayıcısı.

BidResponseRefund nesnesi

Önceki yanıtlarda gönderilen teklifler hakkında geri bildirim. Bu, yalnızca teklif vereniniz için gerçek zamanlı geri bildirim etkinleştirilmişse ayarlanır. Gerçek zamanlı geri bildirimi etkinleştirmek istiyorsanız hesap yöneticinizle iletişime geçin.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
request_id isteğe bağlı bayt BidRequest.id'deki benzersiz kimlik
creative_index isteğe bağlı int32 [int32] Birden fazla varsa BidResponse_Ad dizini. Dizin, ilk reklam öğesi için sıfırdan başlar.
creative_status_code isteğe bağlı int32 [int32] Reklamın durum kodu. Kimlik listesi için teknik dokümanlardaki creative-status-codes.txt bölümüne bakın.
cpm_micros isteğe bağlı int64 Teklif açık artırmayı kazandıysa bu, hesabınızın para biriminde ödenen fiyattır. Teklif açık artırmaya katılmışsa ancak daha yüksek teklif verildiyse bu, kazanmak için aşılması gereken BGBM'dir. Teklif açık artırmadan önce filtrelendiyse, yayıncı veya kazanan teklif veren fiyat geri bildirimini devre dışı bıraktıysa ya da hesabınız kazanan fiyatları diğer teklif verenlerle paylaşmayı devre dışı bıraktıysa bu ayar yapılmaz. İlk fiyat açık artırmalarında BidRequest.bid_response_feedback[].minimum_bid_to_win de doldurulur.
minimum_bid_to_win isteğe bağlı int64 Açık artırmayı kazanmak için gereken minimum teklif değeri, hesabınızın para birimi cinsinden mikro olarak. Teklifiniz açık artırmayı kazandıysa bu, filtrelenmemiş ikinci en yüksek tekliftir (taban fiyat dahil). Teklifiniz açık artırmayı kazanmadıysa kazanan adayın teklifidir. Bu alan, yalnızca teklifiniz bir ilk fiyat açık artırmasına katıldıysa doldurulur ve teklifiniz açık artırmadan önce filtrelendiyse doldurulmaz.
sampled_mediation_cpm_ahead_of_auction_winner isteğe bağlı int64 Bir yayıncı, aynı sorguda GZT açık artırması ve şelale tabanlı SDK uyumlulaştırması kullandığında, gerçek zamanlı açık artırmanın kazananı da gösterim kazanmak için bir uyumlulaştırma şelalesinde (fiyata göre sıralanmış şekilde) rekabet etmelidir. Teklif açık artırmaya katıldıysa ve hiçbir şelale yoksa bu alanın değeri 0'dır. Teklif açık artırmaya katılmışsa ve bir şelale varsa bu alanın değeri, açık artırma kazananından daha yüksek olan ve beklenen doluluk oranıyla ağırlıklandırılan örnek bir teklifi temsil eden fiyattır. Bu alan, teklif modellerini eğitmek için minimum_bid_to_win ile birlikte kullanılabilir. BGBM, hesabınızın para birimi cinsinden mikro cinsindendir.
event_notification_token isteğe bağlı bayt Teklif yanıtında yer alan etkinlik bildirimi jetonu.
buyer_creative_id isteğe bağlı string Teklif yanıtında yer alan alıcı reklam öğesi kimliği.

SupplyChain nesnesi

SupplyChain nesnesi. Daha fazla bilgi için bu makaleye bakın.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
complete isteğe bağlı bool Zincirin, site sahibi, site veya envanter diğer aracısına giden işleme dahil olan tüm düğümleri içerip içermediğini gösteren seçenek.
nodes yineleniyor SupplyChainNode Zincir sırasına göre SupplyChainNode nesneleri dizisi. Eksiksiz bir tedarik zincirinde ilk düğüm, işleme dahil olan ilk reklamcılık sistemini ve satıcı kimliğini (ör. sitenin, uygulamanın veya başka bir aracının sahibi) temsil eder. Eksik tedarik zincirinde bilinen ilk düğümü temsil eder. Son düğüm, bu teklif isteğini gönderen varlığı temsil eder.
version isteğe bağlı string Tedarik zinciri spesifikasyonunun "major.minor" biçiminde kullanılan sürümü. Örneğin, spesifikasyonun 1.0 sürümü için "1.0" dizesini kullanın.

SupplyChainNode nesnesi

Üst öğe
Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
advertising_system_identifier isteğe bağlı string Teklif verenlerin bağlandığı STP, Exchange, Başlık Sarmalayıcı vb. sistemin standart alan adı. Bu, yetki verilmiş sistemin net sahipliğini belirlemek amacıyla WHOIS ve ters IP aramalarını kolaylaştırmak için sistemin operasyonel alan adı (üst kurumsal alan adından farklıysa) olabilir. Bu değer, ads.txt dosyasında mevcut olan satıcıları tanımlamak için kullanılan değerle aynı olmalıdır.
seller_identifier isteğe bağlı string Reklamcılık sistemindeki satıcı veya bayi hesabıyla ilişkilendirilen tanımlayıcı. Bu değer, işlemlerde kullanılanla aynı değeri (ör. Google protokolünde "publisher_id") içermelidir. Uzunluk 64 karakterle sınırlandırılmalıdır.
handles_payment isteğe bağlı bool Bu düğümün envanter için ödeme akışına dahil olup olmayacağını belirtir. True olarak ayarlandığında, Advertising_system_identifier alanındaki reklamcılık sistemi satıcıya, zincirdeki önceki düğümü ödemekten sorumlu olan sellers_identifier alanında ödeme yapar. Yanlış değerine ayarlandığında bu düğüm, envanterin ödeme akışına dahil olmaz.

BidResponse nesnesi

Bu, bir BidRequest'e yanıt olarak döndürdüğünüz mesajdır. Sıfır veya daha fazla reklam belirtebilirsiniz. Her reklam için, reklamın yayınlanabileceği bir reklam alanı sağlamanız gerekir. Reklam alanı, BidRequest tarafından AdSlot.id tarafından tanımlanır. Teklif vermek istemiyorsanız reklamsız ve yalnızca processing_time_ms ayarlanmış bir yanıt gönderin.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
ad yineleniyor Reklam
debug_string isteğe bağlı string BidRequest'te is_test ayarlanmışsa hata ayıklama bilgilerini bu alana düz metin olarak döndürebilirsiniz. Bu alanı normal koşullarda veya 100 karakterden uzun değerlere ayarlamayın. Bu alanı yalnızca belirli sorunların giderilmesinin bir parçası olarak istendiğinde yapmanız gerekir.
processing_time_ms isteğe bağlı int32 [int32] Bu değeri, isteği aldığınız andan yanıtı döndürüldüğü ana kadar milisaniye cinsinden işleme süresine ayarlayın.
no_bid_reason isteğe bağlı int32 [int32] Teklifin gönderilmemesinin isteğe bağlı ve teklif veren tarafından belirlenen nedeni. Bu alan, OpenRTB protokolündeki BidResponse.nbr'ye eşdeğerdir ve teklifsiz neden kodlarının aynı ad alanını kullanır. Teklif vermeyen neden kodlarının tamamını görmek için developers.google.com/authorized-buyers/rtb/downloads/no-bid-reasons.txt adresine bakın.

Reklam nesnesi

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
event_notification_token isteğe bağlı bayt Etkinlik bildirim jetonu sorun giderme için teklif verenler tarafından Authorized Buyers'a gönderilir. Authorized Buyers, jetonu teklif için gerçek zamanlı geri bildirime ekler. Jetonun içeriği Authorized Buyers tarafından günlüğe kaydedilmez. Authorized Buyers, 128 bayttan uzun jetonları yoksayar.
buyer_creative_id isteğe bağlı string Bu yanıtta reklam öğesi için sizin seçtiğiniz benzersiz tanımlayıcı. Bu her zaman ayarlanmalıdır, en fazla 64 baytla sınırlandırılmalı ve geçerli bir UTF8 dizesi olmalıdır. Kullandığınız her buyer_creative_id her zaman aynı reklam öğesiyle ilişkilendirilmelidir. Bu alan, sorun bulunduğunda onay durumlarını bildirmek için kullanılır. Farklı reklam öğeleri için aynı kimliği belirtmeyin. Aksi takdirde, tek bir reklam öğesiyle ilgili sorun bulunursa tüm reklam öğeleri onaylanmaz. Farklı reklam öğelerinde aynı reklam öğesi için farklı kimlikler belirtmeyin. Aksi takdirde, onay durumu her kimlik için ayrı olarak atandığından hiçbir reklam öğesi yayınlanmaz.
html_snippet isteğe bağlı string Reklamı göstermek için web sayfasına yerleştirilecek HTML snippet'idir. Bu snippet'in hangi faturalandırma kimliğiyle ilişkilendirildiğini belirtmek için BidResponse.Ad.AdSlot.billing_id kullanın.
video_url isteğe bağlı string Video reklam getirme URL'si. URL, VAST 2.0 veya 3.0 standardına uygun bir XML yanıtı döndürmelidir. Bu reklamı hangi faturalandırma kimliğiyle ilişkilendireceğinizi belirtmek için BidResponse.Ad.AdSlot.billing_id kullanın. Yalnızca html_snippet, video_url, native_ad, sdk_rendered_ad, amp_ad_url veya video_vast_xml ayarlanmalıdır. Bu alanı yalnızca BidRequest bir video içi reklam içinse (BidRequest.video mevcut) ayarlayın.
video_vast_xml isteğe bağlı string Döndürülecek VAST dokümanı. Bu belge, VAST 2.0 veya 3.0 standardına uygun olmalıdır. Bu reklamın hangi faturalandırma kimliğiyle ilişkilendirileceğini belirtmek için BidResponse.Ad.AdSlot.billing_id kullanın. Bu alanı yalnızca BidRequest, bir video içi reklama yönelikse ve yanıt VAST XML ise ayarlayın. Yalnızca bir html_snippet, video_url, native_ad, sdk_rendered_ad, amp_ad_url veya video_vast_xml ayarlanmalıdır.
amp_ad_url isteğe bağlı string AMPHTML reklamı alınacak URL. Şu seçeneklerden yalnızca biri ayarlanmalıdır: html_snippet, video_url, native_ad, sdk_rendered_ad, amp_ad_url veya video_vast_xml.
native_ad isteğe bağlı YerelReklam Yerel reklamın içeriği. Yerel reklamlar, yayıncı tarafından oluşturulan birden fazla yapı taşından oluşur.
click_through_url yineleniyor string Snippet için hedef URL grubu. Bu, kullanıcının görüntülenen reklamı tıkladığında gideceği URL'leri ve oluşturulan reklamda görünen tüm URL'leri içerir. Reklam sunucusuna nihai açılış sayfasıyla ilgili olmayan ara çağrılar eklemeyin. Bu veriler, diğer hataların yanı sıra yayıncı tarafından engellenen URL'lerin filtrelenmesinden sonra kullanılır. Snippet veya video reklam döndüren ancak click_through_url belirtmeyen bir BidResponse silinir. Yerel reklamlarda tıklama URL'si olarak yalnızca ilk değer kullanılır, ancak tüm değerler sınıflandırma ve incelemeye tabidir. Bu alanı yalnızca html_snippet, video_url veya native_ad ayarlanmışsa belirleyin. Yerel reklamlar için NativeAd.click_link_url ayarlanmadan bırakılırsa kullanıcıyı açılış sayfasına yönlendirmek üzere click_through_url ilk değeri kullanılır. Yerel reklamlarda, kullanıcının nihayetinde gideceği hedefi ayarlamak için alan olarak click_link_url kullanmanızı öneririz. Dinamik açılış sayfaları söz konusu olduğunda bu alanı kullanmanız gerekir.
vendor_type yineleniyor int32 [int32] Bu snippet'ten gösterilebilecek reklamlara yönelik tüm tedarikçi firma türleri. Yalnızca teknik dokümanlarda sellers.txt dosyasında listelenen tedarikçi firma kimliklerini beyan etmeniz gerekir. Bildirdiğiniz tedarikçilerin, BidRequest'te gönderilen allowed_vendor_type listesinde olup olmadığını kontrol edeceğiz.
attribute yineleniyor int32 [int32] Bu snippet'ten gösterilebilecek reklamlarla ilgili tüm özellikler. Kimlik listesi için teknik dokümanlardaki buyer-declarable-creative-attributes.txt öğesine bakın. Bu özelliklerin hiçbirinin BidRequest'teki excluded_attribute listesinde olup olmadığını kontrol edeceğiz.
category yineleniyor int32 [int32] Bu snippet'ten gösterilebilecek reklamlar için tüm hassas kategoriler. Kimlik listesi için teknik dokümanlardaki ad-Sensitive-category.txt dosyasını inceleyin. Bu kategorilerin hiçbirinin BidRequest'teki excluded_sensitive_category listesinde olmadığından emin olacağız.
restricted_category yineleniyor int32 [int32] Bu snippet'ten gösterilebilecek reklamlar için tüm kısıtlanmış kategoriler. Kimlik listesi için teknik dokümanlardaki ad-restricted-category.txt dosyasını inceleyin. Bu kategorilerin BidRequest'teki allowed_restricted_category listesinde olup olmadığını kontrol edeceğiz.
advertiser_name yineleniyor string Reklamın tüm reklamverenlerinin adları.
bidder_name isteğe bağlı string Exchange teklif verenleri (Ad Manager'da gerçek zamanlı teklif verme yapan üçüncü taraf exchange'ler) için exchange'in reklamı sağlamak üzere çağırdığı teklif verenin adı. Bu, rastgele bir UTF8 metnidir ancak teklif vereni tanımlamak için yeterli olmalı ve aynı teklif veren için tutarlı olarak aynı değere ayarlanmalıdır.
width
height 		isteğe bağlı int32 [int32] Reklamın piksel cinsinden genişliği ve yüksekliği. Bunları ayarlamak isteğe bağlıdır. Ancak, bid BidRequest.AdSlot birden fazla genişlik ve yüksekliğe sahipse veya BidRequest.Mobile.is_interstitial_request doğruysa ayarlanmalıdır.
agency_id isteğe bağlı int64 Bu reklamla ilişkili ajans. Kimlik listesi için teknik dokümanlardaki agencies.txt dosyasını inceleyin. Bu reklamın ilişkili ajansı yoksa bu alanı ayarlanmamış olarak bırakmak yerine NONE (agency_id: 1) değeri kullanılmalıdır.
adslot yineleniyor Reklam Alanı
impression_tracking_url yineleniyor string Gösterim oluşturulduğunda çağrılacak URL'ler. Bu, tüm envanter türleri ve biçimler için desteklenir.
click_tracking_url yineleniyor string Kullanıcı reklamı tıkladığında aranacak URL'ler. Şu anda yalnızca yerel reklamlar ve yayıncı tarafından yönetilen reklam öğelerine sahip Programatik Garantili anlaşmalar için desteklenir. Yayıncı tarafından yönetilen durumlarda, bu tıklama izleyiciler teklif veren sunucusuna sunucuya gönderilir. Diğer tüm durumlarda bunlar kullanıcının cihazından gönderilir. Yayıncı tarafından yönetilen reklam öğeleri hakkında daha fazla bilgi için Yayıncı tarafından yönetilen reklam öğeleri bölümüne bakın.
ad_choices_destination_url isteğe bağlı string Reklam tercihleri sayfasına bağlantı. Bu yalnızca yerel reklamlar için desteklenir. Mevcutsa yerel reklam öğesine standart bir AdChoices simgesi eklenir ve bu URL'ye bağlanır.
impression_tracking_resource yineleniyor Gösterim İzleme Kaynağı Gösterim oluşturulduğunda çağrılacak kaynaklar. Bu, yalnızca yerel ve banner biçimleri ile açıkça beyaz listeye eklenmiş komut dosyaları için desteklenir.
sdk_rendered_ad isteğe bağlı Sdk ile Oluşturulan Reklam Alıcı tarafından bilinen bir SDK tarafından oluşturulacak reklam. Bu özellik, yalnızca BidRequest bir mobile.installed_sdk alt mesajı içerdiğinde kullanılabilir.
skadn isteğe bağlı SKAdNetworkResponse Reklamverenin SKAdNetwork bilgileri, iOS 14 ve üzeri sürümlerde uygulama yükleme ilişkilendirmesini destekler. Apple'ın SKAdNetwork API'si, reklamverenlerin başarılı bir yüklemenin ardından reklam ağına bir geri gönderme göndererek reklam odaklı uygulama yüklemesini ölçmesine yardımcı olur. Bir yüklemenin reklam gösterimiyle ilişkilendirilebilmesi için reklam ağlarının ağ kimliklerini ve imzalı reklamveren bilgilerini göndermeleri gerekir. Daha fazla bilgi için bu makaleyi inceleyin.
advertised_app_id isteğe bağlı string Reklamı yapılan uygulamanın kimliği (yalnızca uygulama tanıtımı için). Android'de bu, com.foo.mygame gibi bir paket veya paket adı olmalıdır. iOS'ta sayısal kimliktir. Uygulama tanıtım türlerine özel özelliklerden yararlanmak için bu alana ek olarak aşağıdaki app_promotion_type alanını da ayarlayın.
app_promotion_type isteğe bağlı enum Yukarıdaki advertised_app_id alanında belirtilen, reklamı yapılan uygulamaya karşılık gelen uygulama tanıtımının türü. Reklamı yapılan uygulama belirtilmemişse bu alan yok sayılır. Bu alan olmadan advertised_app_id alanı ayarlandığında, bu alan OTHER olarak ayarlanmış gibi değerlendirilir.

NativeAd nesnesi

Üst öğe

Yerel reklamın içeriği. Yerel reklamlar, yayıncı tarafından oluşturulan birden fazla yapı taşından oluşur. Aşağıdakilerden yalnızca biri ayarlanmalıdır: html_snippet, video_url, video_vast_xml veya native_ad. Bu alanı yalnızca BidRequest yerel reklam içinse (BidRequest.adslot.native mevcut) ayarlayın.

Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
headline isteğe bağlı string Reklamın kısa başlığı.
body isteğe bağlı string Reklamın uzun bir açıklaması.
call_to_action isteğe bağlı string Kullanıcının tıklaması gereken düğmenin etiketi.
advertiser isteğe bağlı string Reklam öğesinde gösterilecek reklamverenin veya sponsorun adı.
image isteğe bağlı Resim Büyük bir resim.
logo isteğe bağlı Resim Reklamverenin logosu için daha küçük bir resim.
app_icon isteğe bağlı Resim Uygulama indirme reklamları için uygulama simgesi.
video_url isteğe bağlı string Video reklam getirme URL'si. URL, VAST 2.0 standardına uygun bir XML yanıtı döndürmelidir. Bu alanı yalnızca BidRequest'in yerel reklamlara yönelik olup video alanının istendiği durumlarda ayarlayın.
star_rating isteğe bağlı double Uygulama mağazasındaki uygulama puanı. [0-5] aralığında olmalıdır.
isteğe bağlı string Kullanıcı reklamı tıkladığında tarayıcının/SDK'nın yükleneceği URL. Bu, doğrudan açılış sayfası veya sonunda bir yönlendirme zincirinin ilk adımı olabilir. Geriye dönük uyumluluk için bu politika ayarlanmazsa ilk Ad.click_through_url kullanılır. Yerel reklamlar için click_through_url yerine click_link_url kullanmanızı öneririz.
click_tracking_url isteğe bağlı string Kullanımdan kaldırıldı. Tıklama izleme için kullanılacak URL. SDK, bir arka plandaki ileti dizisinde tıklama izleme URL'sini pingler. URL çözümlenirken HTTP 30x yönlendirmeleri izlenir. SDK, yanıtın içeriğini yoksayar. Bu URL'nin kullanıcının açılış sayfası üzerinde herhangi bir etkisi yoktur.
price isteğe bağlı string Para birimi bilgileri dahil olmak üzere, tanıtılan uygulamanın fiyatı.
Resim nesnesi
Üst öğe
Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
url isteğe bağlı string
width
height 		isteğe bağlı int32 [int32] Resim genişliği ve yüksekliği piksel cinsinden belirtilir. En boy oranı korunduğu sürece, talep edilenden daha büyük bir resim sağlayabilirsiniz.

AdSlot nesnesi

Üst öğe
Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
id zorunlu int32 [int32] Reklamın görünebileceği BidRequest'teki alan kimliği.
max_cpm_micros zorunlu int64 Bu reklam alanı için açık artırmayı kazanırsanız ücretlendirilmek istediğiniz maksimum BGBM. Bu tutar, belirtilen currency veya varsayılan teklif verme para birimi cinsinden mikro cinsinden ifade edilir. Örneğin, 1, 29 ABD doları BGBM teklif vermek için max_cpm_micros = 1290000 olarak belirleyin. Kazanan teklifler, faturalandırılabilir birimlere yuvarlanır. Örneğin, ABD doları cinsinden teklifler bir sonraki 10.000 mikroya (bir sent) yuvarlanır.
min_cpm_micros isteğe bağlı int64 Bu reklam alanı için açık artırmayı kazanırsanız ücretlendirilmek istediğiniz minimum BGBM. Bu tutar, belirtilen currency veya varsayılan teklif verme para birimi cinsinden mikro cinsinden ifade edilir. Birkaç teklif arasından en yüksek olanı max_cpm_micros seçerseniz ikinci bir fiyat veya yayıncı tarafından ayarlanan açılış fiyatını geçersiz kılmak istiyorsanız bir açılış fiyatı biçimini tercih edebilirsiniz. Teklif, max_cpm_micros değerinden düşük veya eşit olmalıdır. Aksi takdirde yok sayılır. Bu alan isteğe bağlıdır ve ayarlanması gerekmez. Açık artırma türü FIRST_PRICE olarak ayarlanmış teklif isteklerine yanıt verirken bu alan kullanılamaz.
billing_id isteğe bağlı int64 Bu gösterimin ilişkilendirileceği faturalandırma kimliği. Değer, BidRequest.AdSlot.matching_ad_data.billing_id içinde gönderilen bu alan için faturalandırma kimlikleri grubunda olmalıdır. BidRequest'in birden fazla BidRequest.AdSlot.matching_ad_data.billing_id'i varsa her zaman bu ayarlanmalıdır.
deal_id isteğe bağlı int64 Bu teklifin katılmasını istediğiniz anlaşma kimliği. Anlaşma mevcutsa ancak anlaşmayı yoksayıp herkesin katılabileceği açık artırmaya katılmak istiyorsanız anlaşmayı "1" olarak ayarlayın.
exchange_deal_id isteğe bağlı string Exchange teklif verenleri (Ad Manager'da gerçek zamanlı teklif verme yapan üçüncü taraf exchange'ler) için exchange'in bu teklifle ilişkilendirilen ve yayıncılara bildirilen anlaşma kimliğindeki anlaşma kimliği. İlişkilendirilmiş bir anlaşma yoksa ayarlanmadan bırakın. Bu, rastgele bir UTF8 metnidir ve en fazla 64 bayt olmalıdır.
exchange_deal_type isteğe bağlı enum exchange_deal_id ayarlandığında anlaşmanın türü. Bu durum yayıncılara bildirilir ve anlaşmanın açık artırmada nasıl ele alınacağını etkiler.

OPEN_AUCTION = 0
PRIVATE_AUCTION = 1
PREFERRED_DEAL = 2
EXCHANGE_AUCTION_PACKAGE = 3

buyer_reporting_id isteğe bağlı string Alıcı, harcama yöntemini ve geçersiz trafik metriklerini Sorgu Aracı'ndaki IVT şeffaflık raporunda ayırmak için kullanılacak kimliği beyan etti. 1.000'den az gösterime sahip kimliklerin, metriklerin dökümünü almak için kullanılmayacağını unutmayın. 64 bayttan uzun kimlikler yok sayılır.
third_party_buyer_token isteğe bağlı string Açık teklif veren bir exchange bir aracıysa son üçüncü taraf alıcı bilgilerini tanımlamak için kullanılır. Bu bilgi üçüncü taraf alıcıdan elde edilir ve teklif yanıtında değiştirmeden Google'a iletilmelidir.
frequency_cap yineleniyor Sıklık Sınırı Deneysel özellik, değişebilir. Exchange'de zorunlu kılınan sıklık sınırıyla ilgili deneme hakkında daha fazla bilgi edinmek için github.com/google/ads-privacy/tree/master/experiments/frequency-capping adresini ziyaret edin.

Hesabınızda sıklık sınırını etkinleştirmek için hesap yöneticinizle iletişime geçin.

Teklife uygulanacak sıklık sınırını belirtir. Her bir kullanıcının gösterimleri, sıklık_sınırı ile belirtilen düzeyde sınırlanır. Kullanıcı için ek bir gösterim belirtilen sınırlardan herhangi birini ihlal ediyorsa teklif, açık artırmaya katılmaz. Aynı sıklık_sınırı için birden fazla sıklık sınırı belirtilebilir.

Sıklık sınırı bozuksa, teklif açık artırmadan önce filtrelenir. Sınırın hatalı biçimlendirilmiş örnekleri şunlardır:

  • sıklık_sınırı_kimliği boş veya çok uzun
  • maks_mmpions veya zaman_aralığı pozitif değil
  • Tek bir teklif için çok sayıda sıklık sınırı vardır
  • zaman_birimi belirtilmedi

    Aynı sıklık_sınırı değerine sahip sonraki bir teklifin farklı bir süre (zaman_birimi ve zaman_aralığı tarafından temsil edilir) kullanması durumunda, eski sıklık sınırına dahil olan gösterimlerin yeni ve tersi geçerli olarak sayılmayacağını unutmayın.

    • currency isteğe bağlı string

    ISO-4217 alfa kodları kullanılarak max_cpm_micros ve min_cpm_micros tarafından kullanılan para birimi. Bu alan doldurulursa teklifi yorumlamak için belirtilen para birimi kullanılır. Aksi takdirde, aşağıdaki öncelik düzeyinde belirlenen varsayılan teklif para birimi kullanılır:

    1. GZT hesap ayarlarında yapılandırılmışsa teklif veren düzeyindeki para birimi.
    2. Alıcı düzeyindeki para birimi. Alıcı, doldurulmuşsa teklif yanıtının billing_id alanında belirtilen faturalandırma kimliğine göre belirlenir. Aksi takdirde, teklif isteğinde gönderilen tek faturalandırma kimliğini temel alır.

    Alıcı hesabın para birimi, hesap oluşturulurken belirlenir ve Teknik Hesap Yöneticisi ile iletişime geçilerek kontrol edilebilir.
    Sıklık Sınırı nesnesi
    Üst öğe
    Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
    frequency_cap_id isteğe bağlı string Teklif verenin sıklık sınırı için kullanım alanını temsil eden kimlik; örneğin kampanyasını, reklamını, satır öğesini vb. temsil edebilir. Kullanıcıya özel bilgi veya tanımlayıcı içermemelidir.
    time_unit isteğe bağlı enum Sıklık sınırlarının uygulanabileceği zaman birimleri.

    UNKNOWN_TIME_UNIT = 0
    MINUTE = 1
    DAY = 2
    WEEK = 3
    MONTH = 4
    INDEFINITE = 5    : INDEFINITE kullanıldığında, zaman_aralığı yok sayılır. INDEFINITE, sıklık sınırının uzun bir süre (bir aydan uzun) uygulanacağı, ancak tamamıyla sınırsız olacağı anlamına gelir.

    time_range isteğe bağlı int32 [int32] Sıklık sınırının geçerli olduğu, zaman_birimi tarafından belirtilen birimlerdeki zaman aralığının uzunluğu. Örneğin, time_unit=WEEK ve time_range=3 ise üç haftalık bir dönem için sınır uygulanır. time_unit=INDEFINITE ise bu yok sayılır.
    max_impressions isteğe bağlı int32 [int32] Zaman_birimi ve zaman_aralığı tarafından açıklanan zaman aralığında kullanıcıya sunulan sıklık_sınırı_kimliği için gösterilmesine izin verilen maksimum gösterim sayısı.

    GösterimİzlemeKaynak nesnesi

    Üst öğe
    Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
    script_url isteğe bağlı string Bir JavaScript kaynağının URL'si. URL'ler komut dosyası etiketleri içermemelidir. Örneğin: "https://mycdn.com/tracker.js".
    context yineleniyor enum Oluşturma için ek bağlam sağlandı.

    UNKNOWN_CONTEXT = 0
    OMID = 1

    verification_parameters isteğe bağlı string Yüklendiğinde kaynağa aktarılacak kaynakla ilişkili parametreler. Parametrelerin biçimi komut dosyası satıcısına bağlıdır.
    vendor_key isteğe bağlı string Doğrulama komut dosyası sağlayıcısını benzersiz şekilde tanımlamak için kullanılır.

    SdkRenderedAd nesnesi

    Üst öğe
    Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
    id isteğe bağlı string Reklamı oluşturacak SDK'nın tanımlayıcısı. İlgili teklif isteğinde gönderilen bir mobile.installed_sdk.id ile eşleşmelidir.
    rendering_data isteğe bağlı string Reklamı oluşturmak için SDK'ya aktarılacak veriler. Bu veriler hem yayıncı hem de Google için şeffaf değildir.
    declared_ad isteğe bağlı DelcaredAd nesne Reklam SDK'sı ve özel engellemelerle oluşturulan yayıncı reklamları için reklam öğesi taramasını, sınıflandırmayı ve zorunlu kılmayı destekleyen reklam öğeleri tanımlandı. Yalnızca bir html_snippet, video_url, video_vast_xml veya native_ad ayarlayın.
    Bildirilen Reklam nesnesi

    Reklam SDK'sı ve özel engellemelerle oluşturulan yayıncı reklamları için reklam öğesi taramasını, sınıflandırmayı ve zorunlu kılmayı destekleyen reklam öğeleri tanımlandı. Yalnızca bir html_snippet, video_url, video_vast_xml veya native_ad ayarlayın.

    Üst öğe

    Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
    html_snippet isteğe bağlı string SDK tarafından oluşturulan reklamın HTML snippet'i temsilcisi.
    video_url isteğe bağlı string SDK tarafından oluşturulan reklamda kullanılan VAST öğesinin URL'si.
    video_vast_xml isteğe bağlı string SDK tarafından oluşturulan özel reklamı oluşturmak için kullanılan VAST dokümanı. Bu doküman, VAST 2.0 veya 3.0 standardına uygun olmalıdır.
    native_ad isteğe bağlı NativeAd Yerel reklamın içeriği. Yerel reklamlar, alıcı SDK'sı tarafından oluşturulan birden fazla yapı taşından oluşur.
    click_through_url isteğe bağlı string SDK tarafından oluşturulan reklamın son açılış sayfaları.

    SKAdNetworkResponse nesnesi

    Üst öğe
    Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
    version isteğe bağlı string Reklamveren tarafından desteklenen SKAdNetwork sürümü. İmzanın reklamveren tarafından nasıl oluşturulduğunu belirtmek için de kullanılır. Bu, BidRequest.mobile.skad.versions sürümlerinden biriyle eşleşmelidir.
    network isteğe bağlı string İmzada kullanılan reklam ağı tanımlayıcısı. Bu, BidRequest.mobile.skad.skadnetids içindeki öğelerden biriyle eşleşmelidir.
    campaign isteğe bağlı int64 Kampanya kimliği Apple'ın spesifikasyonlarıyla uyumludur. SKAdNetwork 3.0 ve önceki sürümlerde kullanılır. SKAdNetwork 4.0 ve sonraki sürümlerde BidResponse.ad.skad.source_identifier alanı değiştirildi.
    source_identifier isteğe bağlı int64 Reklam ağlarının reklam kampanyasını temsil etmek için tanımladığı dört basamaklı bir tam sayı. SKAdNetwork 4.0 ve sonraki sürümlerde kullanılır ve BidResponse.ad.skad.campaign alanının yerini alır.
    itunesitem isteğe bağlı string Apple'ın uygulama mağazasında reklamverenin uygulamasının kimliği.
    product_page_id isteğe bağlı string Gösterilecek özel ürün sayfasının kimliği (iOS 15 veya üstü için). Belirtilmezse varsayılan ürün sayfası gösterilir. Özel ürün sayfaları hakkında daha ayrıntılı bilgi için bu makaleyi inceleyin.
    fidelities yineleniyor Doğruluk Sürüm 2.2'den itibaren SKAdNetwork API, SKAdNetwork imzasının fidelity-type parametresi tarafından belirtilen birden fazla reklam sunma seçeneğini destekler. Bu, desteklenen her doğruluk türü için farklı olacak imzayı oluşturmak üzere kullanılan parametreleri içerir. Daha fazla bilgi için bu makaleyi inceleyin.
    nonce isteğe bağlı string İmza oluşturmak için kullanılmak üzere reklamveren tarafından oluşturulan benzersiz tamamen küçük harfli UUID. Not: Bu alan, birden fazla doğruluk türünü desteklemek için BidResponse.ad.skadn.fidelities.nonce alanının lehine kullanımdan kaldırılacaktır.
    sourceapp isteğe bağlı string Apple'ın uygulama mağazasındaki yayıncı uygulamasının kimliği. Bu, BidRequest.mobile.skad.sourceapp kimliği ile eşleşmelidir.
    timestamp isteğe bağlı int64 İmza oluşturulurken kullanılan milisaniye cinsinden milisaniye cinsinden süre. Not: Bu alan, birden fazla doğruluk türünü desteklemek için BidResponse.ad.skadn.fidelities.timestamp alanı yerine kullanımdan kaldırılacaktır.
    signature isteğe bağlı string SKAdNetwork imzası. Not: Bu alan, birden fazla doğruluk türünü desteklemek üzere BidResponse.ad.skadn.fidelities.signature alanının kullanılmasıyla kullanımdan kaldırılacaktır.
    skoverlay isteğe bağlı SKOverlay nesne Bu seçenekler, reklamı yapılan uygulamayı öneren SKOverlay'in nasıl sunulacağını gösterir. iOS 14 ve üzeri sürümler tarafından desteklenir.
    Doğruluk nesnesi
    Üst öğe

    2.2. sürümden itibaren SKAdNetwork API, SKAdNetwork imzasının fidelity-type parametresi tarafından belirtilen birden fazla reklam sunma seçeneğini destekler. Bu, desteklenen her doğruluk türü için farklı olacak imzayı oluşturmak üzere kullanılan parametreleri içerir. Daha fazla bilgi için bu makaleye bakın.

    Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
    fidelity_type isteğe bağlı enum İzlenecek ilişkilendirmenin doğruluk türü. Varsayılan = STOREKIT_RENDERED_ADS.

    VIEW_THROUGH_ADS = 0; Bir reklamın en az 3 saniye boyunca görüntülenmesinden sonra 24 saat içinde gerçekleşen uygulama yüklemeleri ilişkilendirmesidir. SKAdnetwork sürüm 2.2 ve sonraki sürümlerde desteklenir. Daha fazla bilgi için bu makaleyi inceleyin.
    STOREKIT_RENDERED_ADS = 1; Reklam tıklamalarıyla sağlanan, StoreKit tarafından oluşturulan App Store ürün sayfasından başlatılan uygulama yüklemeleri için ilişkilendirme. Tüm SKAdNetwork sürümleri için desteklenir. Daha fazla bilgi için bu makaleyi inceleyin.

    nonce isteğe bağlı string İmza oluşturmak için kullanılmak üzere reklamveren tarafından oluşturulan benzersiz tamamen küçük harfli UUID.
    timestamp isteğe bağlı int64 İmza oluşturulurken kullanılan milisaniye cinsinden milisaniye cinsinden süre.
    signature isteğe bağlı string SKAdNetwork imzası.
    SK Yer Paylaşımı
    Üst öğe
    Özellik Zorunlu/isteğe bağlı Type Uygulama ayrıntıları
    delay_seconds isteğe bağlı int32 [int32] Yer paylaşımını sunmadan önce reklam başladıktan sonra saniye cinsinden gecikme. Bu alan 0 olarak ayarlanırsa yer paylaşımı, reklam başlar başlamaz gösterilir. Bu alan ayarlanmadan bırakılırsa reklam için yer paylaşımı gösterilmez.
    endcard_delay_seconds isteğe bağlı int32 [int32] Yer paylaşımını sunmadan önce bitiş kartı gösterildikten sonra saniye cinsinden gecikme. (Bu alan yalnızca ödüllü veya geçiş video reklam öğeleri için geçerlidir.) Bu alan 0 olarak ayarlanırsa yer paylaşımı, bitiş kartı gösterildikten hemen sonra gösterilir. Bu alan ayarlanmadan bırakılırsa bitiş kartı için yer paylaşımı gösterilmez. Hem delay hem de endcard_delay_seconds ayarlanırsa reklam sona erdiğinde yer paylaşımı otomatik olarak kapatılır ve bitiş kartı gösterildikten sonra tekrar gösterilir.
    dismissible isteğe bağlı bool Bu yer paylaşımının kullanıcı tarafından kapatılıp kapatılamayacağını belirtir. Varsayılan olarak true değerini alır.