Uygulamanız Google'dan gelen teklif isteğini işledikten sonra, ve bir yanıt gönderin. Bu kılavuzda, derlemek için uygulamanızı nasıl kodlayacağınız açıklanmaktadır. yanıt verelim.
BidResponse mesajı oluştur
Authorized Buyers, bilgilendirme mesajının mesajı olarak BidRequest
gönderir.
bir HTTP POST
. Uygulamanızın gönderdiği yanıt
Content-Type
başlığı application/octet-stream
olarak ayarlandı
ve serileştirilmiş protokol arabelleğinden oluşan bir ileti gövdesi içerir. Protokol
arabellek, aşağıda tanımlandığı gibi bir BidResponse
mesajıdır
realtime-bidding.proto
. Uygulamanız ayrıştırılabilir
Her BidRequest
ile ilgili olarak BidResponse
. Engelleme
ayrıştırılamayan yanıtlar hata olarak kabul edilir ve Google
daha yüksek hata oranlarıyla
teklif verenler arasında yer alır.
Bir gösterim için teklif vermek istemiyorsanız,
processing_time_ms
alanını olduğu gibi bırakın ve diğer tüm alanları bırakın
boştur. realtime-bidding.proto
adlı sağlayıcıyı şuradan edinebilirsiniz:
referans verileri sayfasını ziyaret edin.
Reklam Öğesi Kimliği
BidResponse
öğeniz,
buyer_creative_id
alanı (64 bayt sınırı). Hatta benzer reklam öğeleri
buyer_creative_id
için farklı değerlere sahip olmalıdırlar.
dahil ancak bunlarla sınırlı olmamak üzere şu gibi önemli özellikleri kullanabilirsiniz: boyut, belirtilen URL,
reklam öğesi özelliklerini ve satıcı türlerini kapsar. Başka bir deyişle,
aşağıdaki gibi görünen her iki reklama da reklam öğesi kimliği ekler:
- Farklı şekilde görünün veya davranın.
- Farklı resimler oluşturun.
- Farklı yollarla oluşturma (örneğin, bir reklam bir resim, diğeri Flash içeriyor).
Uygulamanızı tasarlarken, uygulamalarınızın uygulamalarınızın Planladığınız reklam öğesi türleri için anlamlı tanımlayıcılar oluşturmak tıklayın.
Reklam özellikleri
Reklamın
özellikleri ve BidResponse.Ad.attribute
içindeki hedeflemesi. İlgili içeriği oluşturmak için kullanılan
özellikleri aşağıdaki gibidir (desteklenen tam listeyi de inceleyebilirsiniz:
özellikleri
buyer-declarable-creative-attributes.txt):
7 Tagging: IsTagged
Reklamın içinde bir piksel veya web işaretçisi bulunmalıdır. sonraki yeniden pazarlama için çerez kimlikleri listesi8 Remarketing: IsRemarketing
Reklam, tüketicileri çerez kimliklerine veya Cihaz Kimliklerine göre hedefler. cihaz kimliği veya çerez kimliği listesi, bir kullanıcı grubunu temsil eden Alıcının sahip olduğu veya temsil ettiği bir siteyle daha önce etkileşimde bulunmuş olması gerekir.9 UserInterestTargeting: IsUserInterestTargeted
Reklam, tüketicileri çerez kimliklerine veya Cihaz Kimliklerine göre hedefler. Çerez kimlikleri veya Cihaz Kimliği listesi, alıcının ortak ilgi grubu olarak tanımlanır.30 InstreamVastVideoType: Vpaid
Reklamın oluşturulması için VPAID desteği gerekiyor.32 MraidType: MRAID
Reklamın oluşturulması için DFP API'si gerekir.
Ayrıca, aşağıdaki özellikler desteklenir ancak bunların bildirimleri zorunlu değildir, çünkü Authorized Buyers bunları otomatik olarak algılar ve izin verin). Görüntüleyin Reklam Öğeleri API'sı alan adınız için algılanan özellikleri ile ilgili nasıl büyük bir artış yakalayabileceğinizden bahsedeceğim.
34 RichMediaCapabilityType: RichMediaCapabilityFlash
Reklamın oluşturulması için Flash desteği gerekiyor.50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
Reklamın oluşturulması için Flash gerekli değildir.47 RichMediaCapabilityType: RichMediaCapabilitySSL
Reklam, SSL sayfasında oluşturulabilir. Authorized Buyers'ın reklam öğelerini dikkate aldığını unutmayın bu özelliğin beyan edilen farklı değerleriyle (ayrı olarak incelenecek) ayrı olarak kabul edilir ve ayrı onay durumuna sahiptir). Bu nedenle, hem SSL hem de SSL olmayan sürümlerini içeriyorsa bu özelliği buna göre bildirmeniz gerekir. Böylece bu ayrım AdX'te doğru şekilde yansıtılır.
Open Bidding alanları
Open'a katılan exchange ve ağ üzerinden teklif verenler tarafından gönderilen teklif yanıtları Teklif verme, standart programa katılan Authorized Buyers'a benzer gerçek zamanlı teklif verme. Open Bidding müşterileri, ek alan vardır ve mevcut birkaç alanın alternatif kullanımları olabilir. Bu şunları içerir:
OpenRTB | Authorized Buyers | Ayrıntılar |
---|---|---|
BidResponse.imp[].pmp.deals[].id |
BidResponse.ad[].adslot[].exchange_deal_id |
Bu öğeyle ilişkili exchange'in ad alanındaki anlaşma kimliği teklif vermesi ve yayıncılara bildirilmesini sağlar. |
BidResponse.seatbid[].bid[].ext.exchange_deal_type |
BidResponse.ad[].adslot[].exchange_deal_type |
Anlaşmanın ne durumda olduğunu etkileyen ve yayıncılara bildirilen anlaşmanın türü kabul edilir. |
BidResponse.seatbid[].bid[].ext.third_party_buyer_token |
BidResponse.ad[].adslot[].third_party_buyer_token |
bir aracıdır. Bu, üçüncü taraf alıcıdır ve teklifte değiştirilmeden Google'a iletilmelidir tıklayın. |
Öneriler
- Kalıcı HTTPS bağlantılarını etkinleştirin ("Keep-alive" veya "bağlantı yeniden kullanımı"). Zaman aşımını daha yüksek değerler kullanmak birçok durumda fayda sağlar. Google doğrular uygulamanızın ilk gecikme testlerinde Authorized Buyers, yüksek bir oranda istek gönderir ve her cihaz için ayrı TCP bağlantısı oluşturmanın gecikme ek yükünü isteğinde bulunabilirsiniz.
Aşağıdaki durumlarda izlenecek isteğe bağlı gösterim izleme URL'sini ekleyin: gösteriminin oluşturulmasını sağlar. Ayrılma nedeniyle elde etmeye çalışır. Bu, dönüşüm hunisinin her yerinde istatistikleri.
- Teklif veren kodunuzda kullanımdan kaldırılan alanlarda bağımlılık olmamasını sağlayın. Bu durum, tekliflerinizin hata vererek başarısız olmasına neden olabilir.
BidResponse.Ad.width
veBidResponse
içindeBidResponse.Ad.height
. CEVAP Birden fazla reklam boyutu içeren bir istek içinBidResponse
width
veheight
değerlerini ekleyin, aksi takdirde görebilirsiniz.- Yanıt boyutunuzu 8K'nın altında olacak şekilde ayarlayın. Çok büyük yanıtlar artabilir ağ gecikmesi ve zaman aşımlarına neden olabilir.
- Talimatlar için SKAdNetwork ilişkilendirmesi gerektiren iOS envanteri için teklifler.
Örnek teklif yanıtı
Aşağıdaki örnekler kullanıcılar tarafından okunabilen Protobuf ve JSON istekleri.
OpenRTB JSON
OpenRTB Protobuf
Önemli: örnekler burada okunabilir metin olarak temsil edilir. Ancak proje yönetimi aracılığıyla gönderilir. Google veya OpenRTB Protobuf'u kullanırken biçiminde, yalnızca serileştirilmiş teklif yanıtı mesajları kabul edilir.
Bir BidResponse
mesajını oluşturmak ve serileştirmek için:
şu C++ kodunu takip edin:
BidResponse bid_response; // fill in bid response with bid information string post_response; if (bid_response.SerializeToString(&post_response)) { // respond to the POST with post_response as the content } else { // return an error to the POST }
Reklam öğesini belirtin
Teklif yanıtınız, teklifinizin kazanması durumunda yayınlanacak reklam öğesini belirtir. Teklifiniz
desteklenen reklam biçimlerinden (AMP, video, yerel) birini içermelidir. Burada
gibi, reklam öğesini html_snippet
alanını kullanarak belirtiriz.
Alternatif olarak, şu alanları tıklayın:
- SDK tarafından oluşturulmuş reklam
BidResponse.Ad.sdk_rendered_ad
- AMP
BidResponse.Ad.amp_ad_url
- Video
BidResponse.Ad.video_url
veyaBidResponse.Ad.video_vast_xml
- Yerel
BidResponse.Ad.native_ad
HTML snippet'i kullanarak kendi sunucularınızda barındırılan bir reklam
BidResponse
öğesinin html_snippet
alanı. İlgili içeriği oluşturmak için kullanılan
snippet, web sayfasına eklenen bir iFrame içine alınır. Böylece,
alınıp oluşturulmadığını
anlatacağım. HTML kodunu oluşturmanız gerekir
snippet'i kullanarak reklamın (banner veya geçiş reklamı)
iFrame ve teklif verdiğiniz reklam alanına uygun bir boyutta olmalıdır.
Ayrıca, teklif yanıtında belirtilen reklam boyutu tam olarak aşağıdaki durumlarda teklif isteğindeki boyut kombinasyonlarının sayısını belirtir:
- Reklam normal bir banner'dır (video, yerel veya geçiş reklamı değildir).
- Teklif veren, teklif yanıtında boyutu beyan etmiştir. Boyut beyanı: istekte birden fazla boyut olduğunda gereklidir.
- Geçiş reklamları için bir istisna vardır. Geçiş reklamları için ekran genişliğinin en az% 50'si ve yüksekliğin en az% 40'ı kadar olmalıdır ekran yüksekliği gibi.
html_snippet
alanı,
düzgün bir şekilde oluşturulur, ancak
Teklif yanıtı mesajı oluştur bölümündeki buyer_creative_id
alanını tıklayın. Bir
kullanımı, kendileri için geçerli olan URL'lerin bağımsız değişkenlerine
sunucularınızdan getirildiğinden emin olursunuz. Bu, programa dahil olan
gösterimle ilgili rastgele verileri kendi sunucularınıza gönderir.
Teklif yanıtlarında döndürülen HTML snippet'lerine ilişkin çoğu politika üçüncü taraf reklamları için Authorized Buyers'a göz atın Program Kuralları, Üçüncü taraf kullanım şartları reklam sunma ve Google Ads'de tıklama URL'leri hakkında daha fazla bilgi edinin.
Makroları belirtin
Bir reklam öğesini tanımlayan HTML snippet'i bir veya daha fazla özel öğe içerebilir.
yapılandırıldığı anlamına gelir. Reklam sunma zamanında, değerler
makrolarında da yer alır. Örneğin, istemci teklif verme uygulamanız
WINNING_PRICE
makrosu kullanarak,
otomatik olarak eklenir. Bu makroyu ayrıştırmak için,
fiyat onaylarının şifresini çözen bir uygulamadır. Daha fazla bilgi için Şifre Çözme Fiyatı
Onaylamalar sayfasını inceleyebilirsiniz.
Şu biçimde HTML snippet'inin parçası olarak bir makro belirtir:
MACRO
, desteklenen değerlerden biridir. %%MACRO%%
makrolarının listesini inceleyin.
Google, CLICK_URL_UNESC
veya
Üçüncü tarafın sunduğu reklam öğesinde CLICK_URL_ESC
makrosu
reklam. Google, tıklama izleme için CLICK_URL
makrolarını kullanır.
Makro kullanmak için, makroyu reklama ekleyin. Böylece,
tıklamasını sağlarsınız. Getirme işleminin döndürülen değeri, başka bir öğeye yönlendirme
CLICK_URL
öğesine eklediğiniz URL.
Makro | Açıklama |
---|---|
ADVERTISING_IDENTIFIER |
Alıcıların, gösterim oluşturma sırasında iOS IDFA veya Android reklam kimliğini almasına izin verir. Reklamveren Tanımlayıcılarının Şifresini Çözme bölümünü inceleyin inceleyebilirsiniz. |
CACHEBUSTER |
Rastgele, işaretsiz, dört baytlık bir tam sayının dize gösterimi. |
CLICK_URL_UNESC |
Reklamın çıkış karaktersiz tıklama URL'si. Snippet'te, üçüncü taraf tıklama URL'si doğrudan makroyu izlemelidir. Örneğin, üçüncü taraf tıklama URL'si
<a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> Reklam yayını sırasında bu, şu şekilde genişletilir: <a href="http://google-click-url?...&ad_url=http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> URL, ilk olarak tıklamayı Google'a kaydeder ve daha sonra üçüncü taraf tıklama URL'sine yönlendirir. |
CLICK_URL_ESC |
Reklamın çıkış karakterli tıklama URL'si. Şunun yerine bunu kullanın:
Önce değeri aktarmanız gerekiyorsa Örneğin, aşağıdaki kod bir HTML snippet'inde kullanılabilir: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> Reklam yayını sırasında bu, şu şekilde genişletilir: <a href="http://my.adserver.com/click?google_click_url=http://google-click- url%3F...%26ad_url%3D"></a> Bu işlem, tıklamayı Arka arkaya çift çıkışlı bir URL ekleyebilirsiniz.
|
CLICK_URL_ESC_ESC |
Reklamın çift çıkış karakterli URL'si. Şunun yerine bunu kullanın:
Önce değeri aktarmanız gerekiyorsa Örneğin, aşağıdaki kod bir HTML snippet'inde kullanılabilir: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> Reklam yayını sırasında bu, şu şekilde genişletilir: <a href="http://my.otheradserver.com/click?google_click_url=http%3A%2F%2Fmy.adserver.com%2Fclick%3Fgoogle_click_url%3Dhttp%3A%2F%2Fgoogle-click-%20url%253F...%2526ad_url%253D"></a> |
SCHEME |
Teklif isteği SSL gerektirmiyorsa veyahttp:
Teklif isteği SSL gerektiriyorsa https: . |
SITE |
İçerik URL'sinin URL çıkışlı alanı veya anonim envanter için anonim kimlik. |
SITE_URL |
Kullanımdan kaldırıldı. Aynı işlevi sağlayan SITE makrosuyla değiştirilir. |
TZ_OFFSET |
Saat dilimi farkı. |
VERIFICATION |
Üretim ve reklam öğesinin doğrulamada ne zaman taranacağı için farklı değerler
ardışık düzendir. Biçim: herhangi bir yerde %%?VERIFICATION:true-val:false-val%%
makrolar hariç diğer değerler true-val ve false-val için kullanılabilir,
boş dizeler dahil. Open Bidding için exchange'lerin şu makroyu kullanmasını öneririz:
Bu durumda, talep tarafı platformlarının değişiklik yapması gerekmez.. . Örneğin, bir reklam öğesi %%?VERIFICATION:-1:5000%% içeriyorsa
metin değiştirme, sunumda 5000 ve-1
doğrulama ardışık düzeni üzerinde çalışır. Bunun amacı, bu iki ping grubunu birbirinden ayırt etmenize yardımcı olmaktır. |
WINNING_PRICE |
ABD doları cinsinden, kodlanmış gösterim maliyeti (yani BGBM yerine YBM)
mikro düzeyde olması gerekir. Örneğin, 5 ABD doları tutarında kazanan BGBM
5.000.000 mikro BGBM veya 5.000 mikro YBM'ye karşılık gelir. Şifre çözülmüş
bu örnekte WINNING_PRICE değeri 5.000 olur.
Kazanan fiyat YBM olarak belirtilir.
|
WINNING_PRICE_ESC |
URL çıkışlı WINNING_PRICE . |
Makrolarda çıkış yapan URL'ler aşağıdaki şemayı kullanır:
- Boşluk karakterinin yerini artı işareti (
+
) alır. - Alfanümerik karakterler (0-9, a-z, A-Z) ve !()*,-./:_~ kümesindeki karakterler değişmez.
- Diğer tüm karakterler,
XX
onaltılık değerdir ve%XX
ile değiştirilir karakteri temsil eden sayıdır.
Yayıncı kısıtlamaları
Yayıncılar, hangi reklamlara yönelik kısıtlamalar uygulamak için BidRequest
kullanır?
bir seçimdir. Şu alanlardaki kısıtlamaları uygulamanız gerekir:
allowed_vendor_type
excluded_attribute
excluded_sensitive_category
Bir alan reklamın izin verilen özelliklerini, diğeri ise
izin verilmeyen özellikler. İzin verilmeyen özellik içeren bir reklamı asla döndürmeyin. İzin verilenler için
Bir reklamı yalnızca tedarikçi firma türü
BidRequest
içindeki allowed_vendor_type
listesi. Bkz.
BidRequest
protokol arabelleğinde bu alanların yorumları
tanımına bakın.
BidResponse
içinde bir HTML snippet'i döndürülürse
attribute
, category
ve diğer özellikleri doğru
ve click_through_url
alanlarını BidResponse
içine alın.
Bir reklam bu alanlar için birden fazla geçerli değere sahipse
dahil edebilirsiniz. Bu alanlarla ilgili yorumları görmek için
Daha fazla ayrıntı için BidResponse
protokol arabelleği tanımına bakın.
Bu alanlar ayarlanmamış yanıtlar silinir.
Olası BidRequest.excluded_attribute
değerleri:
(publisher-excludable-creative-attributes.txt bölümüne bakın):
7 Tagging: IsTagged
çerez kimlikleri kullanmanızı öneririz.8 CookieTargeting: IsCookieTargeted
Tüketicileri çerez kimlikleri listesinin temsil ettiği çerez kimliklerine göre hedefleyen reklamlara izin verilmez Alıcının sahip olduğu veya temsil ettiği bir siteyle daha önce etkileşimde bulunmuş tüketici grubu.9 UserInterestTargeting: IsUserInterestTargeted
Tüketicileri çerez kimlikleri listesinin temsil ettiği çerez kimliklerine göre hedefleyen reklamlara izin verilmez alıcının ortak ilgi alanı grubu olarak tanımladığı tüketici grubu.21 CreativeType: Html
Reklamlarınhtml_snippet
veyasnippet_template
öğelerini kullanmasına izin verilmez alanıBidResponse.Ad
içinde yer alır.22 CreativeType: VastVideo
ReklamlarınBidResponse.Ad
öğesindevideo_url
alanını kullanmasına izin verilmiyor.30 InstreamVastVideoType: Vpaid
Reklamların oluşturulması için VPAID desteği gerektirmesine izin verilmez.32 MraidType: MRAID
Reklamların, MRAID API'sinin oluşturulmasını gerektirmesine izin verilmez.34 RichMediaCapabilityType: RichMediaCapabilityFlash
Reklamların oluşturulması için Flash desteği gerektirmesine izin verilmez.39 RichMediaCapabilityType: RichMediaCapabilityHTML5
Reklamların oluşturulması için HTML5 özelliklerini gerektirmesine izin verilmez.48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
Reklamların SSL olmayan istekler yapmasına izin verilmez.
Dolayısıyla, excluded_attribute
alanı
7'yi seçerseniz, o zaman için piksel veya web işaretçisi kullanan bir
bir liste oluşturuyoruz. Bir reklam bunu yaparsa reklamın
BidResponse
özellik alanına girin.
Benzer şekilde, excluded_attribute
alanında 48 değeri varsa
yalnızca SSL sayfasında (ve buna göre, yalnızca
47 RichMediaCapabilityType: RichMediaCapabilitySSL özelliğini bildirin.
Ayrıca,excluded_sensitive_category
BidRequest
,
referans verileri sayfasında ad-sensitive-categories.txt
dosyası bulunabilir. Genişletilmiş
şu kodlardan bazılarının açıklamaları verilmiştir:
3 Politics
Politik veya tartışmalı toplumsal konuları içeren; konusu, konularla ilgili olarak genellikle taraflı bir bakış açısıyla ilişkili olmayan haber kuruluşlarının reklamlarını kapsamaz.4 Dating
Arkadaşlık hizmetlerini ve online arkadaşlık topluluklarını kapsar.5 Religion
Dini reklamlar ve dini görüşleri savunan veya dinsel görüşlere karşı olan reklamlar içerir; astrolojiyi veya belirli bir dine/inanca ait olmayan ruhani görüşleri kapsamaz.7 Video Games (Casual & Online)
Video oyunları, online oyunlar ve indirilebilir oyunları kapsar; video oyunu konsollarını kapsamaz.8 Ringtones & Downloadables
Zil sesleri gibi mobil eklentileri ve masaüstü PC'ler için ekran koruyucular, duvar kağıtları, sosyal ağlar için profil düzenleri ve grafikler gibi diğer indirilebilir öğeler.10 Get Rich Quick
Hızlı kazanç vadeden şemalar18 Weight Loss
Zayıflama, diyet ve ilgili ürünler ile programları kapsar; sağlıklı beslenme veya genel sağlık reklamlarını kapsamaz.19 Cosmetic Procedures & Body Modification
Gerdirme, yağ aldırma, lazer müdahaleleri, tüy aldırma, saç ektirme, dövmeler ve bedende yapılan değişiklikleri kapsar.23 Drugs & Supplements:
Farmasötik ürünler, vitaminler, besin takviyeleri ve ilgili perakendecileri kapsar; uyuşturucular hakkında bilgi veren kaynakları kapsamaz.24 Sexual & Reproductive Health
Cinsel işlev ve doğurganlık reklamlarını kapsar; normal hamilelik kaynaklarını içermez.35 Social Casino Games
Değer içeren herhangi bir kazanç (para veya ödüller) fırsatı sunmayan kumar simülasyon oyunlarını (bunlar dahil ancak bunlarla sınırlı kalmamak üzere; poker, slot makineleri, bingo, piyangolar, spor bahisleri ve yarış bahislerinin yanı sıra, diğer iskambil ve kumarhane oyunları) kapsar.36 Significant Skin Exposure
İnsan vücudunun göğüs kemiğinden kalçanın yarısına kadar herhangi bir kısmının giyinik olmadığı reklam resimleri; veya vücut; iç çamaşırı, mayo, iç çamaşırı ya da içi görülen başka giysilerin veya havlu ya da yatak çarşafı gibi giysi olmayan öğelerin giydirilmesinden kaynaklanır.37 Sensationalism
Genellikle abartılı dil veya görüntüler içeren bilgi mesajıyla kullanıcıların ilgisini çekip reklamı tıklamaları için teşvik etmeyi amaçlayan reklamlar. Sansasyonel konulara (ünlülerin tutuklanması, ölümü veya boşanması gibi) odaklanan veya şok yaratarak değer elde etmeyi amaçlayan reklamları içerir.
Open Measurement
Open Measurement, bağımsız ölçüm ve ölçüm hizmetleri sunan üçüncü taraf tedarikçi firmaları belirtmenize doğrulama hizmetlerine erişebilir.Şu anda desteklenen reklam biçimleri arasında video, banner ve geçiş reklamları bulunmaktadır. Okuyucu Gelirleri Yöneticisi'ni Bu biçimleri içeren bir teklif yanıtında Open Measurement'ın nasıl kullanılacağı hakkında daha fazla bilgi için Open Measurement SDK Yardım Merkezi'ne bakın makalesine göz atın.
Örnek teklif yanıtları
Aşağıdaki bölümlerde, farklı reklam türleri için örnek teklif yanıtları gösterilmektedir.