Bu sayfa, Cloud Translation API ile çevrilmiştir.

Yanıtı Oluşturun

Uygulamanız, Google'dan gelen teklif isteğini işledikten sonra bir yanıt oluşturup göndermelidir. Bu kılavuzda, yanıtı oluşturmak için uygulamanızı nasıl kodlayacağınız açıklanmaktadır.

Teklif yanıtı mesajı oluştur

Authorized Buyers, BidRequest bilgisini bir HTTP POST öğesinin mesaj gövdesi olarak gönderir. Uygulamanızın gönderdiği yanıtın Content-Type üstbilgisi application/octet-stream olarak ayarlanmalıdır ve serileştirilmiş protokol arabelleğinden oluşan bir ileti gövdesine sahip olmalıdır. Protokol arabelleği, realtime-bidding.proto politikasında tanımlandığı gibi BidResponse mesajıdır. Uygulamanız, her BidRequest yanıtına yanıt olarak ayrıştırılabilir bir BidResponse döndürmelidir. Zaman aşımları ve ayrıştırılamayan yanıtlar hata olarak kabul edilir ve Google, yüksek hata oranlarına sahip teklif verenleri geri kısıtlar.

Bir gösterim için teklif vermek istemiyorsanız processing_time_ms alanını olduğu gibi ayarlayıp diğer tüm alanları boş bırakabilirsiniz. realtime-bidding.proto parametresini referans veriler sayfasından edinebilirsiniz.

Reklam Öğesi Kimliği

BidResponse, buyer_creative_id alanı aracılığıyla bir reklam öğesi belirtiyor (64 bayt sınırı). Benzer reklam öğelerinde bile boyut, bildirilen URL, reklam öğesi özellikleri ve tedarikçi firma türleri dahil ancak bunlarla sınırlı olmamak üzere dikkate değer özellikler açısından farklılık varsa buyer_creative_id için benzersiz değerler bulunmalıdır. Diğer bir deyişle, herhangi iki reklama farklı reklam öğesi kimlikleri vermeniz gerekir. Bu kimlikler şunlardır:

Farklı görünün veya davranın.
Farklı resimler oluşturun.
Farklı yöntemlerle oluşturma (örneğin, bir reklam resim, diğeri Flash içerir).

Uygulamanızı tasarlarken, göndermeyi planladığınız reklam öğesi türleri için anlamlı tanımlayıcılar oluşturmanın sistematik bir yoluna karar vermelisiniz.

Reklam özellikleri

BidResponse.Ad.attribute içinde reklamın özelliklerini ve hedeflemesini tam olarak açıklayan reklam öğesi özelliklerini bildirmeniz gerekir. Beyan edilmesi gereken özellikler şunlardır (buyer-declarable-creative-attributes.txt adresinde desteklenen özelliklerin tam listesine de bakın):

7 Tagging: IsTagged
Reklamın içinde, daha sonra yeniden pazarlama için bir çerez kimlikleri listesi oluşturmak üzere bir piksel veya web işaretçisi bulunur.
8 Remarketing: IsRemarketing
Reklam, tüketicileri çerez kimliklerine veya cihaz kimliklerine göre hedefler. Burada çerez kimlikleri veya cihaz kimlikleri listesi, daha önce alıcının sahip olduğu veya temsil ettiği bir siteyle etkileşimde bulunmuş olan tüketici grubunu temsil eder.
9 UserInterestTargeting: IsUserInterestTargeted
Reklam, tüketicileri çerez kimliklerine veya cihaz kimliklerine göre hedefler. Burada çerez kimlikleri veya cihaz kimliği listesi, alıcının ortak ilgi alanı grubu olarak tanımladığı tüketici grubunu temsil eder.
30 InstreamVastVideoType: Vpaid
Reklamın oluşturulması için VPAID desteği gerekiyor.
32 MraidType: MRAID
Reklamın oluşturulması için MRAID API'si gerekir.

Ayrıca, aşağıdaki özellikler desteklenir ancak Authorized Buyers'ın bunları otomatik olarak tespit etmesi ve reklam öğelerinizi bildiriminiz yerine algılanan değerlere göre engellemesi (veya izin vermesi) nedeniyle aşağıdaki özellikler desteklenir. Reklam öğelerinizin algılanan özellikleriyle ilgili nasıl geri bildirim alacağınızla ilgili açıklama için Reklam Öğeleri API'si bölümüne bakın.

34 RichMediaCapabilityType: RichMediaCapabilityFlash
Reklamın oluşturulması için Flash desteği gerekiyor.
50 RichMediaCapabilityType: RichMediaCapabilityNonFlash
Reklamın oluşturulması için Flash gerekmez.
47 RichMediaCapabilityType: RichMediaCapabilitySSL
Reklam, SSL sayfasında oluşturulabilir. Authorized Buyers'ın, bu özelliğin belirtilen farklı değerlerine sahip reklam öğelerini ayrı olarak kabul ettiğini (ayrı olarak incelenir ve ayrı onay durumlarına sahip olurlar) unutmayın. Dolayısıyla, aynı reklam öğesinin hem SSL hem de SSL olmayan sürümleriyle teklif veriyorsanız bu ayrımın AdX'te doğru şekilde yansıtılması için bu özelliği uygun şekilde bildirmeniz gerekir.

Open Bidding alanları

Open Bidding'e katılan exchange ve ağ teklif verenleri tarafından gönderilen teklif yanıtları, standart gerçek zamanlı teklif vermeye katılan Authorized Buyers'ın yanıtlarına benzerdir. Open Bidding müşterileri az sayıda ek alan belirtebilir ve mevcut birkaç alanın alternatif kullanımları olabilir. Bunlardan bazıları:

OpenRTB	Authorized Buyers	Ayrıntılar
`BidResponse.imp[].pmp.deals[].id`	`BidResponse.ad[].adslot[].exchange_deal_id`	Exchange'in ad alanındaki bu teklifle ilişkili olan ve yayıncılara bildirilen anlaşma kimliği. Not: Bu alan şu anda yalnızca kapalı beta katılımcılarına gönderilmektedir.
`BidResponse.seatbid[].bid[].ext.exchange_deal_type`	`BidResponse.ad[].adslot[].exchange_deal_type`	Yayıncılara bildirilen ve anlaşmanın açık artırmada nasıl ele alınacağını etkileyen anlaşma türü. Not: Bu alan şu anda yalnızca kapalı beta katılımcılarına gönderilmektedir.
`BidResponse.seatbid[].bid[].ext.third_party_buyer_token`	`BidResponse.ad[].adslot[].third_party_buyer_token`	Open Bidding ile teklif veren exchange'in aracı olması durumunda nihai üçüncü taraf alıcı bilgilerini tanımlamak için kullanılan jeton. Bu bilgi üçüncü taraf alıcıdan alınır ve teklif yanıtında değiştirilmeden Google'a iletilmelidir.

Öneriler

Sunucularınızda kalıcı HTTPS bağlantılarını ("keep-alive" veya "bağlantı yeniden kullanımı" olarak da bilinir) etkinleştirin. Zaman aşımını en az 10 saniyeye ayarlayın. Yüksek değerler çoğu durumda faydalıdır. Authorized Buyers'ın istekleri yüksek bir hızda göndermesi ve her istek için ayrı bir TCP bağlantısı kurmanın getirdiği gecikme ek yükünü önlemesi gerektiğinden Google bunu uygulamanızın ilk gecikme testleri sırasında doğrular.
Teklif verenin kazandığında değil, gösterim oluşturulduğunda izlenecek isteğe bağlı gösterim izleme URL'sini ekleyin. Kazanç ve oluşturma arasındaki düşüş nedeniyle bu, daha doğru izleme istatistikleri sağlar.

Not: OpenRTB 2.5 veya daha yeni bir sürüm kullanılırken bunun standart alanı BidResponse.seatbid[].bid[].burl'dir.
Teklif veren kodunuzu kullanımdan kaldırılan alanlarda bağımlılıklardan uzak tutun. Bu, tekliflerinizin hata vererek başarısız olmasına neden olabilir.
BidResponse.Ad.width ve BidResponse.Ad.height öğelerini BidResponse'a ekleyin. Birden fazla reklam boyutu içeren bir isteğin BidResponse değeri, width ve height değerlerini içermelidir. Aksi takdirde açık artırmadan çıkarılır.
Yanıt boyutunu 8K'nin altında olacak şekilde sınırlandırın. Çok büyük yanıtlar ağ gecikmesini artırabilir ve zaman aşımlarına neden olabilir.
SKAdNetwork ilişkilendirmesi gerektiren iOS envanterindeki tekliflerle ilgili yönergeleri uygulayın.

Örnek teklif yanıtı

Aşağıdaki örnekler, Protobuf ve JSON isteklerinin kullanıcılar tarafından okunabilen örneklerini temsil etmektedir.

Google

Örneği göster

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 6496
    billing_id: 25059430769
    deal_id: 30183930
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_244584"
  advertiser_name: "Google"
  width: 300
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 6

OpenRTB JSON

Örneği göster

{
  "id": "KO9b4i49863AW26d1Tl9q6",
  "seatbid": [
    {
      "bid": [
        {
          "id": "Zc2MS8m162f920x7944",
          "impid": "1",
          "price": 0.133555,
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "w": 300,
          "h": 250,
          "crid": "test_creative_id_410013",
          "creativeType": "DISPLAY",
          "burl": "https://test.com/imp?id=123456",
          "cid": "37092002186",
          "adid": "test_creative_id_410013"
        }
      ],
      "seat": "8333:6953:689419"
    }
  ],
  "ext": {
    "pixels": "<script type='text/javascript'>var adContent = '';\nadContent += '<scr' + 'ipt type=\"text/javascript\" src=\"https://service.idsync.analytics.yahoo.com/sp/v0/pixels?pixelIds=58292,58301,58294&referrer=&limit=12&us_privacy=null&js=1&_origin=1&gdpr=0&euconsent=\"></scr' + 'ipt>' + '\\n';\ndocument.write(adContent);</script>"
  }
}

OpenRTB Protokol Arabelleği

Örneği göster

id: "kMr24Q2iIW45X66r58005i"
seatbid {
  bid {
    id: "ne1hrjHUhQ53A1rC721"
    impid: "1"
    price: 0.05813896656036377
    adid: "test_creative_id_744028"
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "53026323592"
    crid: "test_creative_id_744028"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 53026323592
    }
  }
  seat: "7524:3385:491205"
}
bidid: "6T5lR3ZI-U4xrqc15-Q6RK-426A53024Mf4"
cur: "USD"

Önemli: Örneklerde gösterilen Protobuf mesajları, burada kullanıcıların okuyabileceği metin olarak gösterilir. Ancak mesajlar kablo üzerinden bu şekilde gönderilmez. Google veya OpenRTB Protokol Arabelleği biçimi kullanılırken yalnızca serileştirilmiş Teklif yanıtı mesajları kabul edilir.

Aşağıdaki C++ kodunu kullanarak bir BidResponse mesajı oluşturup serileştirebilirsiniz:

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 öğesi belirtin

Teklif yanıtınız, teklifinizin kazanması durumunda yayınlanacak reklam öğesini belirtir. Teklifiniz desteklenen reklam biçimlerinden birini (AMP, video, yerel) içermelidir. Bu örnekte, reklam öğesini html_snippet alanını kullanarak belirtiyoruz.

Alternatif olarak, reklam biçimine bağlı olarak aşağıdaki alanlardan birini kullanarak reklam öğenizi belirtebilirsiniz:

SDK tarafından oluşturulan reklam
- BidResponse.Ad.sdk_rendered_ad
AMP
- BidResponse.Ad.amp_ad_url
Video
- BidResponse.Ad.video_url veya
- BidResponse.Ad.video_vast_xml
Yerel
- BidResponse.Ad.native_ad

BidResponse öğesinin html_snippet alanında HTML snippet'i kullanarak kendi sunucularınızda barındırılan bir reklam belirtin. Snippet, web sayfasına eklenen bir iFrame içine alınır. Bu da sayfa yüklendiğinde reklamın alınmasını ve oluşturulmasını sağlar. Reklamın (banner ya da geçiş reklamı) bir iFrame içinde doğru şekilde ve teklif verdiğiniz reklam alanı için uygun bir boyutta oluşturulması için HTML snippet'ini oluşturmanız gerekir.

Ayrıca, aşağıdaki durumlarda teklif yanıtında belirtilen reklam boyutu teklif isteğindeki boyut kombinasyonlarından tam olarak biriyle eşleşmelidir:

Reklam normal bir banner'dır (video, yerel veya geçiş reklamı değildir).
Teklif veren, teklif yanıtında boyutu beyan etti. İstekte birden fazla boyut olduğunda boyut beyanı zorunludur.
Geçiş reklamları için bir istisna söz konusudur. Geçiş reklamları için genişlik, ekran genişliğinin en az% 50'si ve yüksekliğin ekran yüksekliğinin en az% 40'ı kadar olmalıdır.

html_snippet alanı, doğru bir şekilde oluşturulan tüm geçerli HTML kodlarını destekler ancak Teklif Yanıtı mesajı oluştur bölümünde buyer_creative_id alanını belirtmeyle ilgili kısıtlamaları unutmayın. Bunun bir kullanımı, reklamı oluşturmanın bir parçası olarak sunucularınızdan getirilen URL'lerin bağımsız değişkenlerine ekstra bilgi eklemektir. Bu, gösterimle ilgili rastgele verileri kendi sunucularınıza geri iletmenizi sağlar.

Teklif yanıtlarında döndürülen HTML snippet'lerine ilişkin çoğu politika, üçüncü taraf reklamlarınınkiyle aynıdır. Daha fazla bilgi için Authorized Buyers Program Kuralları, Üçüncü taraf reklam sunma koşulları ve Reklamlarda tıklama URL'leri bildirme bölümlerine bakın.

Makroları belirtin

Bir reklam öğesini tanımlayan HTML snippet'i, makro adı verilen bir veya daha fazla özel yapı içerebilir. Reklam yayını sırasında değerler, makroların yerine geçer. Örneğin, müşteri teklif verme uygulamanız, açık artırmayı kazanırsa reklam için ne kadar ödeme yaptığını belirlemek üzere WINNING_PRICE makrosunu kullanabilir. Bu makroyu ayrıştırmak için fiyat onaylarının şifresini çözen bir uygulama uygulamanız gerekir. Daha fazla bilgi için Fiyat Onaylarının Şifresini Çözme sayfasına bakın.

Bir makroyu HTML snippet'inin parçası olarak %%MACRO%% biçiminde belirtin. Burada MACRO, aşağıdaki tabloda listelenen desteklenen makrolardan biridir.

Not: AMP reklam teklif yanıtları (amp_ad_url) için yalnızca WINNING_PRICE ve WINNING_PRICE_ESC makroları desteklenir.

Google, üçüncü tarafın sunduğu reklamın reklam öğesinde CLICK_URL_UNESC veya CLICK_URL_ESC makrosu kullanmanızı zorunlu kılar. Google, tıklama izleme için CLICK_URL makrolarını kullanır.

Bir makro kullanmak için bu makroyu reklama dahil ederek kullanıcılar tıkladığında URL'nin getirilmesini sağlayın. Getirme işleminin döndürülen değeri, CLICK_URL öğesine eklediğiniz başka bir URL'ye yapılan yönlendirmedir.

Makro	Açıklama
`ADVERTISING_IDENTIFIER`	Alıcıların gösterim oluşturmada iOS IDFA'yı veya Android'in reklam kimliğini almasına olanak tanır. Ayrıntılar için Reklamveren Tanımlayıcılarının Şifresini Çözme bölümüne bakın.
`CACHEBUSTER`	Rastgele, imzasız, 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'sinin çıkış yapılmış bir sürümü doğrudan makroyu izlemelidir. Örneğin, üçüncü taraf tıklama URL'si `http://my.adserver.com/some/path/handleclick?click=clk` ise makro çağrısından sonra üçüncü taraf tıklama URL'sinin tek çıkış karakterli sürümüyle aşağıdaki kod kullanılabilir: <a href="%%CLICK_URL_UNESC%%http%3A%2F%2Fmy.adserver.com%2Fsome%2Fpath%2Fhandleclick%3Fclick%3Dclk"></a> Reklam yayınlanırken bu aralık ş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, tıklamayı Google'a kaydeder ve daha sonra, üçüncü taraf tıklama URL'sine yönlendirir.
`CLICK_URL_ESC`	Reklam için çıkış karakterli tıklama URL'si. Değeri önce bir yönlendirme döndürecek başka bir sunucu üzerinden geçirmeniz gerekiyorsa `CLICK_URL_UNESC` yerine bunu kullanın. Örneğin, bir HTML snippet'inde aşağıdaki kod kullanılabilir: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC%%"></a> Reklam yayınlanırken bu aralık ş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ı `my.adserver.com` ile kaydeder. Böylece, `google_click_url` parametresinde iletilen URL'ye yönlendirme yapmaktan sorumlu olur. Bu, `my.adserver.com`'nin `google_click_url` parametresinin çıkışsını kaldırdığını varsayar. `%%CLICK_URL_ESC%%` ifadesinden sonra çift çıkış karakterli bir URL ekleyebilirsiniz. `my.adserver.com` tarafından çıkış yapıldıktan sonra, `google_click_url` öğesine eklenmiş URL'nin tek çıkış karakterli bir sürümü kalır. `google_click_url` getirildiğinde çıkış karakteri bir kez daha kaldırılır ve ardından yönlendirilir.
`CLICK_URL_ESC_ESC`	Reklamın çift çıkış karakterli URL'si. Değeri önce bir yönlendirme döndürecek başka bir sunucu üzerinden geçirmeniz gerekiyorsa `CLICK_URL_UNESC` yerine bunu kullanın. Örneğin, bir HTML snippet'inde aşağıdaki kod kullanılabilir: <a href="http://my.adserver.com/click?google_click_url=%%CLICK_URL_ESC_ESC%%"></a> Reklam yayınlanırken bu aralık ş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 `http:` değerine, teklif isteği SSL gerektiriyorsa `https:` değerine genişletilir.
`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 makrosu ile değiştirilir.
`TZ_OFFSET`	Saat dilimi farkı.
`VERIFICATION`	Üretim ve reklam öğesinin doğrulama ardışık düzeninde ne zaman tarandığıyla ilgili farklı değerler. Biçim: `%%?VERIFICATION:true-val:false-val%%`. Burada, boş dizeler dahil olmak üzere makrolar hariç tüm değerler `true-val` ve `false-val` için kullanılabilir. Open Bidding söz konusu olduğunda exchange'lerin bu makroyu kullanmasını öneririz. Bunu yaptıktan sonra, talep tarafı platformlarının değişiklik yapması gerekmez. Örneğin, bir reklam öğesi `%%?VERIFICATION:-1:5000%%` içerecekse metin değişikliği sunumda `5000` ve doğrulama ardışık düzeninde `-1` olur. Burada amaç, bu iki ping grubunu birbirinden ayırt etmenize yardımcı olmaktır.
`WINNING_PRICE`	Hesap para biriminin mikro cinsinden kodlanmış gösterim maliyeti (yani BGBM yerine YBM). Örneğin, 5 ABD doları tutarındaki kazanan BGBM, 5.000.000 mikro BGBM'ye veya 5.000 mikro YBM'ye karşılık gelir. Bu durumda `WINNING_PRICE` öğesinin kodu çözülmüş değeri 5.000 olur. Kazanan fiyat, YBM olarak belirtilir.
`WINNING_PRICE_ESC`	URL çıkışlı `WINNING_PRICE`.

Makrolarda URL çıkışları aşağıdaki şemayı kullanır:

Boşluk karakterinin yerini artı işareti (+) alır.
Alfasayısal karakterler (0-9, a-z, A-Z) ve !()*,-./:_~ kümesindeki karakterler değişmeden kalır.
Diğer tüm karakterler %XX ile değiştirilir. Burada XX, karakteri temsil eden onaltılık sayıdır.

Yayıncı kısıtlamaları

Yayıncılar, izin verecekleri reklamlara ilişkin kısıtlamaları aktarmak için BidRequest'yi kullanır. Ş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 özellikleri belirtir. İzin verilmeyen bir özelliğe sahip bir reklamı hiçbir zaman döndürmeyin. Tedarikçi firma türü gibi izin verilen özellikler için yalnızca tedarikçi türü BidRequest içindeki allowed_vendor_type listesindeyse bir reklam döndürün. Daha ayrıntılı bilgi için BidRequest protokol arabelleği tanımındaki bu alanlarla ilgili yorumlara bakın.

BidResponse içinde bir HTML snippet'i döndürülürse BidResponse içindeki attribute, category ve click_through_url alanlarını doğru şekilde ayarlamanız gerekir. Bir reklamın bu alanlar için birden fazla geçerli değeri varsa tüm değerleri eklemeniz gerekir. Daha fazla ayrıntı için BidResponse protokol arabelleği tanımında bu alanlarla ilgili yorumlara bakın. Bu alanların ayarlanmamış olduğu yanıtlar silinir.

Olası BidRequest.excluded_attribute değerleri şunlardır (publisher-excludable-creative-attributes.txt dosyasına bakın):

7 Tagging: IsTagged
Daha sonra yeniden pazarlama için bir çerez kimlikleri listesi oluşturmak amacıyla piksel veya web işaretçisi içeren reklamlara izin verilmez.
8 CookieTargeting: IsCookieTargeted
Tüketicileri çerez kimliklerine göre hedefleyen reklamlara izin verilmez. Burada çerez kimlikleri listesi, alıcının sahip olduğu veya temsil ettiği bir siteyle daha önce etkileşimde bulunmuş olan tüketici grubunu temsil eder.
9 UserInterestTargeting: IsUserInterestTargeted
Tüketicileri çerez kimliklerine göre hedefleyen reklamlara izin verilmez. Burada çerez kimlikleri listesi, alıcının ortak ilgi alanı grubu olarak tanımladığı tüketici grubunu temsil eder.
21 CreativeType: Html
Reklamların BidResponse.Ad içinde html_snippet veya snippet_template alanını kullanmasına izin verilmez.
22 CreativeType: VastVideo
Reklamların BidResponse.Ad öğesindeki video_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 oluşturulması için MRAID API'sinin gerekli kılınmasına 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 özelliklerinin gerekli kılınmasına izin verilmez.
48 RichMediaCapabilityType: RichMediaCapabilityNonSSL
Reklamların SSL olmayan istekler yapmasına izin verilmez.

Dolayısıyla, excluded_attribute alanı 7 değerini içeriyorsa liste oluşturmak için piksel veya web işaretçisi kullanan bir reklam döndürmemeniz gerekir. Bir reklam bunu yaparsa BidResponse özellik alanında 7 değerini ayarlaması gerekir. Benzer bir şekilde, excluded_attribute alanı 48 değerini içeriyorsa yalnızca bir SSL sayfasında oluşturulabilen reklamları döndürmeniz gerekir (ve buna göre özellik 47 RichMediaCapabilityType: RichMediaCapabilitySSL'yi tanımlamanız gerekir).

Ayrıca BidRequest içindeki excluded_sensitive_category alanı, referans veriler sayfasında bulunan ad-sensitive-categories.txt dosyasındaki kodları kullanır. Bu kodlardan bazılarının ayrıntılı açıklamalarını aşağıda bulabilirsiniz:

3 Politics
Politik veya tartışmalı toplumsal konuları kapsar. Konuları taraflı bir bakış açısından ele almayan haber kuruluşlarının reklamlarını kapsamaz.
4 Dating
Arkadaş bulma hizmetlerini ve online arkadaşlık topluluklarını içerir.
5 Religion
Dini reklamları ve dinsel görüşleri savunan veya dinsel görüşlere karşı olan reklamları kapsar. Astrolojiyi veya belirli bir dine/inanca ait olmayan ruhani görüşleri kapsamaz.
7 Video Games (Casual & Online)
Video oyunlarını, 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 ile 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ç vaat eden planlar.
18 Weight Loss
Zayıflama, diyet ve ilgili ürünleri ve 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:
Tarımsal ürünler, vitaminler, besin takviyeleri ve ilgili perakendecileri kapsar, ilaçlar hakkında bilgi sağlayan kaynakları kapsamaz.
24 Sexual & Reproductive Health
Cinsel işlev ve doğurganlık reklamlarını kapsar, normal hamilelik kaynaklarını kapsamaz.
35 Social Casino Games
Değer içeren herhangi bir kazanç (para veya ödüller gibi) 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 bölümünün giyinik olmadığı veya bedenin üzerinde 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 olduğu reklam görselleri.
37 Sensationalism
Genellikle abartılı dil veya görüntüler içeren bilgi mesajlarıyla kullanıcıların ilgisini çekip reklamı tıklamaları için teşvik etmeyi hedefleyen 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, mobil uygulama ortamlarına sunulan reklamlar için bağımsız ölçüm ve doğrulama hizmetleri sağlayan üçüncü taraf tedarikçi firmaları belirtmenizi sağlar.

Şu anda desteklenen reklam biçimleri arasında video, banner ve geçiş reklamları bulunmaktadır. Open Measurement'ın bu biçimleri içeren bir teklif yanıtında nasıl kullanılacağı hakkında daha fazla bilgi için Open Measurement SDK'sı Yardım Merkezi makalesine bakın.

Örnek teklif yanıtları

Aşağıdaki bölümlerde farklı reklam türleri için örnek teklif yanıtları gösterilmektedir.

Google

Örneği göster

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 68101
    billing_id: 86124453824
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 105
  buyer_creative_id: "test_creative_id_450011"
  width: 390
  height: 61
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 23

OpenRTB JSON

Örneği göster

{
  "id": "4735YiDtCstD1Y445YHstT",
  "cur": "USD",
  "seatbid": [
    {
      "seat": "6670:8027:659779",
      "bid": [
        {
          "ext": {
            "third_party_buyer_token": "7Njk3e2s21E6Url23a30w4d4621Qh57u4w2L9uy4xq864V6lMf348aC72L767592sIPdJ84U2E2aU00jjVGF3wbjl25L019c7Z43eKVb09Sk5fRX72B33Q92f359l40M0t6jAseiJVp8"
          },
          "crid": "test_creative_id_109447",
          "exp": 900,
          "id": "M9mAq8768Nr7W048E6G",
          "price": 0.025286061000000002,
          "adomain": [
            "google.com"
          ],
          "w": 320,
          "impid": "1",
          "h": 50,
          "burl": "https://test.com/imp?id=123456",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "cid": "48666909902"
        }
      ]
    }
  ]
}

OpenRTB Protokol Arabelleği

Örneği göster

id: "AA1796z4iC270863f4w9n0"
seatbid {
  bid {
    id: "9hJvWOk2f3GF6Z0qIR6"
    impid: "1"
    price: 0.917419
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "38676986454"
    crid: "test_creative_id_589316"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 38676986454
    }
  }
  seat: "5890:4144:786042"
}
bidid: "3L6xM6aN-2c492E7J-IxrR-gA80g0xJb980"
cur: "USD"

Uygulama Geçiş Reklamı

Google

Örneği göster

ad {
  html_snippet: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
  adslot {
    id: 1
    max_cpm_micros: 7510304
    billing_id: 70362152071
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_775966"
  advertiser_name: "Google"
  width: 344
  height: 566
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 16

OpenRTB JSON

Örneği göster

{
  "id": "I61Sxs7d484326p4D83O5f",
  "seatbid": [
    {
      "bid": [
        {
          "id": "9T39T8KnUivM9518KnH",
          "impid": "1",
          "price": 0.6353,
          "adid": "test_creative_id_288773",
          "adm": "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>",
          "adomain": [
            "google.com"
          ],
          "cid": "42824952399",
          "crid": "test_creative_id_288773",
          "w": 414,
          "h": 816,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "QyYKoxm0",
              "campaign": "87661657",
              "itunesitem": "434836425",
              "sourceapp": "240782188",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "j3kdO5nT3kl4X9488yr6h7N8I83Ck3n0fRQ1tidNAy13q29QBC67917Dw44w99BRx70a6z5i565lc64979x9G1a83d3gjiA0",
                  "timestamp": "1674986741687"
                },
                {
                  "fidelity": 0,
                  "nonce": "abc1f08d-785b-4937-90eb-c2bbd92dd5d8",
                  "signature": "H6opG1lxBHNi921C65Yq6972239i01goGrQb53xtq38Dlm9M0wU4256868fwy509762N5po8Ou2x3vb0JJX7432yLTv2X021",
                  "timestamp": "1674986741687"
                }
              ]
            },
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "6447:7558:568680"
    }
  ],
  "bidid": "4Jol9v45-xp0442M7-268b-9Ix24W30Q298"
}

OpenRTB Protokol Arabelleği

Örneği göster

id: "82WW59EKX928i315ws8Vf6"
seatbid {
  bid {
    id: "GzqINzH96g3ZX8g67FO"
    impid: "1"
    price: 0.011380645260214805
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "43834715105"
    crid: "test_creative_id_772436"
    cat: "IAB14"
    w: 360
    h: 640
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 43834715105
    }
  }
  seat: "1184:9545:274689"
}
cur: "USD"

Uygulama geçiş videosu

Google

Örneği göster

ad {
  adslot {
    id: 1
    max_cpm_micros: 830000
    billing_id: 45806415189
    buyer_reporting_id: "T7f433l"
  }
  click_through_url: "google.com"
  attribute: 47
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_596030"
  width: 640
  height: 360
  event_notification_token: "token"
}
processing_time_ms: 9

OpenRTB Protokol Arabelleği

Örneği göster

id: "cRPF1960K8WH788KM8ZT5k"
seatbid {
  bid {
    id: "99862J52T2r9f8n6hzY"
    impid: "1"
    price: 0.2873480215418293
    adid: "test_creative_id_958969"
    adm: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
    adomain: "google.com"
    cid: "80831705186"
    crid: "test_creative_id_958969"
    w: 480
    h: 854
  }
  seat: "5731:4728:218110"
}
bidid: "dR2wx766-444e907U-Xpv0-634m58Wa5V73"
cur: "USD"

Uygulama yerel

Google

Örneği göster

ad {
  adslot {
    id: 1
    max_cpm_micros: 80000
    billing_id: 52511964331
    deal_id: 1
  }
  click_through_url: "google.com"
  attribute: 70
  buyer_creative_id: "test_creative_id_287513"
  advertiser_name: "Google"
  native_ad {
    headline: "Luxury Mars Cruises"
    body: "Visit the planet in a luxury spaceship."
    call_to_action: "Book today"
    advertiser: "Galactic Luxury Cruises"
    image {
      url: "https://native.test.com/image?id=123456"
      width: 1200
      height: 627
    }
    app_icon {
      url: "https://native.test.com/icon?id=123456"
      width: 100
      height: 100
    }
    star_rating: 4.800000190734863
    click_link_url: "https://www.google.com"
  }
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "3.0"
    network: "Ft98iS7c"
    campaign: 31947859
    itunesitem: "305656909"
    sourceapp: "531025541"
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "9bGR391q8KEUGg0N8aI5Vg90fgX731q67y2xtXH09k27A5UccmE83YT9833q4g72P3t01759F15J9ZVSx0984q9A2eHnM5fn"
    }
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "42748172-ff0e-43a1-a9da-e97f28e09eab"
      timestamp: 1675328391911
      signature: "Hxr3FdOR2298951684ztq85X3GgF0gI1O3K7CuhAb6tC9g06fsvU1N1Uo7h7Ts38755801rVSB63o50cfk6q80N66vHr1u59"
    }
  }
  click_tracking_urls: "https://google.com/rtb/click?imp_id=4a4cb2c0-4012-4434-b37e-ed08095a1bc8"
  advertised_app_id: "APP_ID_OMITTED"
}
processing_time_ms: 57

OpenRTB JSON

Örneği göster

{
  "id": "w68lr2H3Q9S8mAc18QP2wp",
  "seatbid": [
    {
      "bid": [
        {
          "id": "4VF8803Y5b4314j072f",
          "impid": "1",
          "price": 0.01575,
          "adm": "{\"ver\": \"1.2\", \"assets\": [{\"id\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\"}}, {\"id\": 4, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"w\": 100, \"h\": 100}}, {\"id\": 5, \"img\": {\"url\": \"https://native.test.com/icon?id=123456\", \"w\": 200, \"h\": 200}}, {\"id\": 7, \"data\": {\"value\": \"\\uc804\\uc124\\uc758 \\ub9cc\\ub819 \\uc2ac\\ub77c\\uc784\\uc774 \\ub418\\uc5b4\\ubcf4\\uae30\"}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"]}",
          "adid": "test_creative_id_546056",
          "adomain": [
            "google.com"
          ],
          "cid": "19851733647",
          "crid": "test_creative_id_546056",
          "cat": [
            "IAB9-25"
          ],
          "w": 1200,
          "h": 627,
          "ext": {
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "7859:5415:609992"
    }
  ],
  "bidid": "58nBZSP4-e3LCgFS8-C2Pz-01O0337Vr56A",
  "cur": "USD"
}

OpenRTB Protokol Arabelleği

Örneği göster

id: "a504l3y62599Xv09173V2Z"
seatbid {
  bid {
    id: "jP1Ok7b46T9p789v6R2"
    impid: "1"
    price: 0.1680304792439826
    adid: "test_creative_id_620230"
    adomain: "google.com"
    cid: "74994669337"
    crid: "test_creative_id_620230"
    w: 1200
    h: 627
    adm_native {
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
        }
      }
      assets {
        id: 3
        data {
          value: "Book today"
        }
      }
      assets {
        id: 4
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/icon?id=123456"
          w: 128
          h: 128
        }
      }
      assets {
        id: 6
        data {
          value: "5"
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      imptrackers: "https://test.com/impression?id=123456&amt=${AUCTION_PRICE}"
    }
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      billing_id: 74994669337
      skadn {
        version: "3.0"
        network: "46L6RQ79"
        campaign: "17432314"
        itunesitem: "782565581"
        nonce: "ecfc7b9a-f328-4719-bba5-fa14c0233615"
        sourceapp: "187789793"
        timestamp: ""
        signature: "169L03hq0qtDeIoj19lL880oO96P24du405y60U08H71302C5d5r315jus940016d208o6kFt2G14x4YK530KI683wI41bR4"
        fidelities {
          fidelity: VIEW_THROUGH_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "12g8675BqX3x8jJ60Zt9LwlNQwfe20s6M6n4zwtJ4H5170DU991wfwi9hn108rX53bU872L60u2io288755x0RS9bsvAg68b"
        }
        fidelities {
          fidelity: STOREKIT_RENDERED_ADS
          nonce: "1919c279-d6c5-46d3-b486-0c15b91bfd51"
          timestamp: "1675346267364"
          signature: "qAF324j0597P58JrYins8Lz01v7p41zfJ8JK6l2hoZ36z6RS1GE7FT0r8bAn6B93s77tv04k59fr4J173W992Wa3Ev40489R"
        }
      }
    }
  }
  seat: "6989:4819:604522"
}
bidid: "15ds1647-89y8715T-V0AX-6DL468ks81Q5"
cur: "USD"

Web videosu

Google

Örneği göster

ad {
  adslot {
    id: 1
    max_cpm_micros: 16000000
    billing_id: 34223090460
    deal_id: 17775265
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  video_url: "https://video.test.com/ads?id=123456&wprice=%%WINNING_PRICE%%"
  buyer_creative_id: "test_creative_id_551392"
  advertiser_name: "Google"
  event_notification_token: "token"
}
processing_time_ms: 7

OpenRTB Protokol Arabelleği

Örneği göster

id: "q39213i4x083QS49D4334b"
seatbid {
  bid {
    id: "T55L5u7y56cBy4x484B"
    impid: "1"
    price: 0.35
    adm: "<iframe marginwidth=0 marginheight=0 height=600 frameborder=0 width=160 scrolling=no src=\"https://test.com/ads?id=123456&curl=%%CLICK_URL_ESC%%&wprice=%%WINNING_PRICE_ESC%%\"></iframe>"
    adomain: "google.com"
    cid: "11573735693"
    crid: "test_creative_id_591839"
    w: 300
    h: 600
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 11573735693
      third_party_buyer_token: "w7KR11S30AAE1345q5aG7tz46OkB8u911zbR7HVMwk0E6zUx7Y0uo4cxz32kwa3bZ320H00QT5yYifRxY8z96r74bLedPf6Fb25Z4y0U7T3i3j9k587N2iFlZ5Kl20Z5vou8M5zFWAwa"
    }
  }
  seat: "8020:4047:162759"
}
bidid: "DQd2WoG7-96j6H89H-4uCI-1303QT599c50"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 170
}

Yanıtı Oluşturun

Teklif yanıtı mesajı oluştur

Reklam Öğesi Kimliği

Reklam özellikleri

Open Bidding alanları

Öneriler

Örnek teklif yanıtı

Google

Örneği göster

OpenRTB JSON

Örneği göster

OpenRTB Protokol Arabelleği

Örneği göster

Reklam öğesi belirtin

Makroları belirtin

Yayıncı kısıtlamaları

Open Measurement

Örnek teklif yanıtları

Uygulama banner'ı

Google

Örneği göster

OpenRTB JSON

Örneği göster

OpenRTB Protokol Arabelleği

Örneği göster

Uygulama Geçiş Reklamı

Google

Örneği göster

OpenRTB JSON

Örneği göster

OpenRTB Protokol Arabelleği

Örneği göster

Uygulama geçiş videosu

Google

Örneği göster

OpenRTB Protokol Arabelleği

Örneği göster

Uygulama yerel

Google

Örneği göster

OpenRTB JSON

Örneği göster

OpenRTB Protokol Arabelleği

Örneği göster

Web videosu

Google

Örneği göster

Exchange teklif vereni için mobil web banner'ı

OpenRTB Protokol Arabelleği

Örneği göster