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

Yanıtı Oluşturun

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.

Protobuf Teklif Yanıtı mesajı oluştur

Authorized Buyers, mesajının e-posta mesajı olarak BidRequest gönderir. bir HTTP POST. Teklif verme uç noktanız Protobuf biçimini kullanacak şekilde yapılandırılmışsa uygulamanız, Content-Type üst bilgisi application/octet-stream olarak ayarlanmış ve serileştirilmiş bir protokol arabelleğinden oluşan bir mesaj gövdesi içeren bir yanıt göndermelidir. Protokol arabelleği, openrtb.proto'te tanımlandığı şekilde bir BidResponse mesajıdır. Uygulamanız her BidRequest için ayrıştırılabilir bir BidResponse döndürmelidir. Engelleme ayrıştırılamayan yanıtlar hata olarak kabul edilir ve Google daha yüksek hata oranlarına sahip teklif verenleri belirler.

Bir gösterim için teklif vermek istemiyorsanız yalnızca BidResponse.ext.processing_time_ms alanını ayarlayabilir ve diğer tüm alanları boş bırakabilirsiniz. openrtb.proto değerini referans verileri sayfasından edinebilirsiniz.

Reklam Öğesi Kimliği

BidResponse, BidResponse.seatbid.bid.crid alanı aracılığıyla bir reklam öğesi belirtir (64 bayt sınırı). Benzer reklam öğeleri bile boyut, beyan edilen URL, reklam öğesi özellikleri ve tedarikçi firma türleri dahil ancak bunlarla sınırlı olmamak üzere herhangi bir belirgin özellikte farklılık gösteriyorsa bu alan için benzersiz değerlere sahip olmalıdır. Başka bir deyişle, aşağıdaki özelliklere sahip iki reklama farklı reklam öğesi kimlikleri vermeniz gerekir:

Farklı şekilde görünün veya davranın.
Farklı resimler oluşturabilirsiniz.
Farklı yöntemlerle oluşturulur (ör. bir reklam resimden, diğeri videodan oluşur).

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

Google, reklamınızın genel özelliklerini tanımlamak için reklam öğesi özelliklerini özelliklerini ve hedeflemesini BidResponse.seatbid.bid.apis ve BidResponse.seatbid.bid.attr veya BidResponse.seatbid.bid.ext.attribute uzantısı. Aşağıdakiler özellikleri nasıl tanımlayabileceğinizi açıklar:

VPAID
BidResponse.seatbid.bid.apis değerini VPAID_1 olarak ayarla, veya VPAID_2. JSON biçimi için bu değer, Sırasıyla 1 veya 2.
MRAID
BidResponse.seatbid.bid.apis öğesini MRAID_1 veya JSON biçimi için 3 olarak ayarlayın.
SIZELESS
BidResponse.seatbid.bid.attr öğesini RESPONSIVE veya JSON biçimi için 18 olarak ayarlayın.
PLAYABLE
Bu, BidResponse.seatbid.bid.attr değerinin USER_INTERACTIVE olarak ayarlanmasıyla veya JSON biçimi için 13 olarak ayarlanmasıyla belirtilir.

Not: BidResponse.seatbid.bid.ext.attribute uzantısını kullanıyorsanız bu özellikleri belirtmek için buyer-declarable-creative-attributes.txt dosyasında bulunan değerleri kullanabilirsiniz.

Bkz. Reklam öğeleri kaynağı algılanan özelliklerle ilgili geri bildirim almaya yönelik bir açıklama nasıl sağlayabileceğini de öğreneceksiniz.

Open Bidding alanları

Open'a katılan exchange ve ağ teklif verenleri 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 az sayıda ek alan belirtebilir ve mevcut birkaç alanın alternatif kullanımları olabilir. Bu politikalar aşağıdakileri içerir:

OpenRTB	Authorized Buyers	Ayrıntılar
`BidResponse.imp[].pmp.deals[].id`	`BidResponse.ad[].adslot[].exchange_deal_id`	Exchange'in ad alanından, bu teklifle ilişkilendirilen ve yayıncılara bildirilen anlaşma kimliği. Not: Bu alan yalnızca kapalı beta katılımcılarına gönderilir.
`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. Not: Bu alan yalnızca kapalı beta katılımcılarına gönderilir.
`BidResponse.seatbid[].bid[].ext.third_party_buyer_token`	`BidResponse.ad[].adslot[].third_party_buyer_token`	Open Bidding kullanıcısı olarak exchange bir aracıysa nihai üçüncü taraf alıcı bilgilerini tanımlamak için kullanılan jeton. 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ı en az 10 saniyeye ayarlayın. Birçok durumda daha yüksek değerler faydalıdır. 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ği gönderin.
Aşağıdaki durumlarda izlenecek isteğe bağlı gösterim izleme URL'sini ekleyin: gösteriminin oluşturulmasını sağlar. Kazanma ve oluşturma işlemleri arasındaki düşüş nedeniyle bu yöntem, daha doğru izleme istatistikleri sağlar.

Not: OpenRTB kullanılırken bunun için standart alan BidResponse.seatbid.bid.burl.
Teklif veren kodunuzu, tekliflerinizin hatalarla başarısız olmasına neden olabilecek desteği sonlandırılmış alanlara bağımlı olmaktan uzak tutun.
BidResponse dosyanıza BidResponse.seatbid.bid.w ve BidResponse.seatbid.bid.h ekleyin. CEVAP Birden fazla reklam boyutu içeren bir istek için BidResponse bu alanları dahil etmezseniz açık artırmadan çıkarılacaktır.
Yanıtınızın boyutunu 8 KB'nın altında tutun. Ç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, Protobuf ve JSON isteklerinin insan tarafından okunabilen örneklerini temsil etmektedir.

OpenRTB Protobuf

Örneği göster

id: "q745y3S4jz5Qg43A6izy2V"
seatbid {
  bid {
    id: "Fi366E0I1RN4Ofm8Ug5"
    impid: "1"
    price: 0.02
    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: "51570472186"
    crid: "test_creative_id_520474"
    w: 468
    h: 60
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 51570472186
    }
  }
  seat: "1608:1311:489067"
}
bidid: "6930l9D4-1A9090lR-451S-01g3xTZv8382"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 100
}

OpenRTB JSON

Örneği göster

{
  "id": "sW2R7543D2w77f0542uu0F",
  "seatbid": [
    {
      "bid": [
        {
          "id": "U4495qveIO2A83s1iOs",
          "impid": "1",
          "price": 0.10701,
          "adid": "test_creative_id_323125",
          "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": "54460865479",
          "crid": "test_creative_id_323125",
          "w": 300,
          "h": 250,
          "ext": {
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "1506:2993:976791"
    }
  ],
  "bidid": "WN7415ff-hN7R6080-3txk-r0J45ckY5970"
}

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: 10100
    billing_id: 30279159795
  }
  click_through_url: "google.com"
  attribute: 47
  buyer_creative_id: "test_creative_id_766108"
  advertiser_name: "Google"
  width: 320
  height: 50
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
}
processing_time_ms: 8

Önemli: Örneklerde gösterilen Protobuf mesajları burada kullanıcı tarafından okunabilir metin olarak temsil edilmiştir. Ancak mesajlar kablo üzerinden bu şekilde gönderilmez. Google veya OpenRTB Protobuf'u kullanırken biçiminde, yalnızca serileştirilmiş teklif yanıtı mesajları kabul edilir.

Aşağıdaki C++ kodunu kullanarak bir BidResponse mesajı oluşturup seri hale getirebilirsiniz:

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 belirtme

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

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

SDK tarafından oluşturulmuş reklam
- BidResponse.seatbid.bid.ext.sdk_rendered_ad
AMP
- BidResponse.seatbid.bid.amp_ad_url
Video
- BidResponse.seatbid.bid.adm
Yerel
- BidResponse.seatbid.bid.adm_native

HTML snippet'i kullanarak kendi sunucularınızda barındırılan bir reklam BidResponse.seatbid.bid.adm alanına girin. Ön bilgi, reklamın alınmasına neden olan ve web sayfasına eklenen bir iFrame otomatik olarak oluşturulur. HTML snippet'ini reklam (banner veya geçiş reklamı), bir iFrame içinde ve uygun boyutu belirleyin.

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

Reklam, normal bir banner'dır (video, yerel veya geçiş reklamı değildir).
Teklif veren, boyutu teklif yanıtında belirtmiştir. Boyut beyanı: istekte birden fazla boyut olduğunda gereklidir.
Geçiş reklamları için istisna uygulanır. Geçiş reklamlarının genişliği, ekran genişliğinin en az %50'si, yüksekliği ise ekran yüksekliğinin en az %40'ı kadar olmalıdır.

Düzgün şekilde oluşturulan herhangi bir geçerli HTML kodunu kullanarak bir HTML snippet'i reklam öğesi olarak belirtebilirsiniz. Ancak BidResponse mesajı oluştur bölümünde crid alanını belirtmeyle ilgili kısıtlamaları göz önünde bulundurun. Bunun bir kullanımı da, aynı işleve sahip URL'lerin bağımsız değişkenlerine fazladan bilgi eklemektir. reklamın bir parçası olarak sunucularınızdan getirilir. Bu sayede, gösterimle ilgili rastgele verileri kendi sunucularınıza iletebilirsiniz.

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'te tıklama URL'leri hakkında daha fazla bilgi edinin.

Makroları belirtme

Makrolar, şunları içeren bazı teklif yanıtı alanlarına yerleştirilmiş, biçimlendirilmiş metindir: Reklam yayını sırasında alakalı bir değerle değiştirilen URL'ler. Örneğin, kazanan teklifiniz HTML'de AUCTION_PRICE makrosu içeriyorsa snippet reklam öğesini seçtiğinizde, makronun yerine gösterim için ödediğiniz tutarı belirlemek için şifresini çözebileceğiniz açık artırmadır.

Makroları aşağıdaki alanlara ekleyebilirsiniz:

BidResponse.seatbid.bid.adm

HTML snippet'i, yerel, video URL'si ve video VAST XML biçimleri için makrolar desteklenir.
BidResponse.seatbid.bid.adm_native.eventtrackers.url
BidResponse.seatbid.bid.adm_native.imptrackers
BidResponse.seatbid.bid.ext.amp_ad_url

AMP reklam öğeleri için yalnızca Google'a özgü WINNING_PRICE ve WINNING_PRICE_ESC makroları desteklenir.
BidResponse.seatbid.bid.burl
BidResponse.seatbid.bid.ext.impression_tracking_url

Aşağıdaki şartları karşılıyorsanız BidResponse.seatbid.bid.burl yerine bunu kullanın: birden fazla faturalandırma URL'si gerektirir.

Örneğin, bir makroyu HTML snippet'inin parçası olarak aşağıdakileri yaparak ekleyebilirsiniz: ${MACRO} öğesini, reklam öğesini getirmek için kullanılan URL'ye yerleştirme, Burada MACRO, OpenRTB spesifikasyonu.

Google RTB makroları

Google, OpenRTB'de bulunanların dışında ek makroları destekler spesifikasyonları. Bunlar farklı biçimlendirilmiştir ve Bir URL'ye yerleştirilmişse %%MACRO%%. Aşağıdaki tabloda şu makroları kullanın:

Makro	Açıklama
`ADVERTISING_IDENTIFIER`	Alıcıların gösterim oluşturma. Ayrıntılar için Reklamveren Tanımlayıcılarının Şifresini Çözme başlıklı makaleye bakın.
`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, kod dışı sürümü, üçüncü taraf tıklama URL'sinin makrosu ile ilgili bazı bilgiler bulabilirsiniz. Örneğin, üçüncü taraf tıklama URL'si `http://my.adserver.com/some/path/handleclick?click=clk`, aşağıdaki kod tek çıkış karakterli versiyonda kullanılabilir : <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, ardından yeniden yönlendirir üçüncü taraf tıklama URL'si ile ilişkilendiremezsiniz.
`CLICK_URL_ESC`	Reklamın çıkış karakterli tıklama URL'si. Değeri önce başka bir sunucuya iletmeniz ve bu sunucunun da yeniden yönlendirme döndürmesi gerekiyorsa `CLICK_URL_UNESC` yerine bunu kullanın. Ö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ı `my.adserver.com` ile kaydeder. Bu da belirtilen URL'de iletilen URL'ye yönlendirme yapmaktan `google_click_url` parametresinden yararlanın. Bu durumda, `my.adserver.com` parametresinin `google_click_url` parametresinden kaçış karakteri kaldırıldığı varsayılır. Arka arkaya çift çıkışlı bir URL ekleyebilirsiniz. `%%CLICK_URL_ESC%%` Çıkış yapma işlemi `my.adserver.com`, `google_click_url` için eklenen URL. `google_click_url` getirildi, çıkıştan bir kez daha kaldırılacak ve sonra yeniden yönlendirir.
`CLICK_URL_ESC_ESC`	Reklamın çift çıkış karakterli URL'si. Değeri önce başka bir sunucuya iletmeniz ve bu sunucunun da yeniden yönlendirme döndürmesi gerekiyorsa `CLICK_URL_UNESC` yerine bunu kullanın. Ö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 veya`http:` 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ğrulama ardışık düzeninde taranması için farklı değerler. Biçimi şöyledir: Herhangi bir değer olduğunda `%%?VERIFICATION:true-val:false-val%%` ancak makrolar, `true-val` ve `false-val`, boş dizeler dahil. Open Bidding için exchange'lerin bu makroyu kullanmasını önerir. bunu yaptıklarında talep tarafı bunların değişiklik yapmasına gerek yok. Örneğin, bir reklam öğesi `%%?VERIFICATION:-1:5000%%` içeriyorsa metin değişimi, yayın sırasında `5000`, doğrulama ardışık düzeninde ise `-1` olur. Bu, bu iki ping grubunu birbirinden ayırt etmenize yardımcı olur.
`WINNING_PRICE`	ABD doları cinsinden, kodlanmış gösterim maliyeti (yani BGBM yerine YBM) mikro düzeyde olması gerekir. Örneğin, 5 ABD doları olan kazanan BGBM, 5.000.000 mikro BGBM'ye veya 5.000 mikro EBM'ye karşılık gelir. Bu durumda `WINNING_PRICE` değerinin kod çözme işlemi uygulanmış değeri 5.000 olur. Kazanan fiyat YBM olarak belirtilir. Bu makroyu ayrıştırmak için, Fiyat onaylarının şifresini çözer. Daha fazla bilgi için Fiyat Onaylarının Şifresini Çözme sayfasına bakın.
`WINNING_PRICE_ESC`	URL çıkışlı `WINNING_PRICE`.

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

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ı ve gereksinimleri

Teklif isteği, yayıncıların açık artırmadaki reklam öğelerine uyguladığı kısıtlama ve şart türleri hakkında bilgi içerir.

BidRequest.bcat
- Bu alan tarafından belirtilen engellenen kategorileri, Gerçek Zamanlı Teklif Verme API'sinin detectedCategories alanını kullanarak gönderilen reklam öğeleriniz için algılanan kategorilerle karşılaştırabilirsiniz.
BidRequest.imp.ext.allowed_vendor_type
BidRequest.imp.secure
- Pratikte bu her zaman true ayarlanır. Google, tüm reklam öğeleri için SSL desteği gerektirir.
BidRequest.imp.{audio/banner/native/video}
BidRequest.imp.{audio/banner/native/video}.api
BidRequest.imp.{audio/banner/native/video}.battr
BidRequest.imp.{audio/banner/video}.mimes

Kısıtlanmış özellik içeren bir reklamla asla teklif vermeyin. İzin verilen özellikler için Örneğin, tedarikçi firma türü, yalnızca tedarikçi firma türü BidRequest içindeki allowed_vendor_type listesi. Yalnızca reklam biçimleri, teklif isteklerinde belirtilen biçimleri BidRequest.imp.banner teklifinize dahil edilmelidir. Daha fazla bilgi için BidRequest protokol arabelleği tanımında bu alanlarla ilgili yorumlara bakın.

BidResponse içinde reklam döndürülürse şunu yapmanız gerekir: BidResponse.seatbid.bid.attr doğru şekilde ayarlandı BidResponse.seatbid.bid.cat ve BidResponse.seatbid.bid.adomain veya BidResponse.seatbid.bid.adm_native.link.url alanı BidResponse Bir reklamın bu alanlar için birden fazla geçerli değeri varsa her değeri eklemeniz gerekir. Bu alanlarla ilgili yorumları şurada görebilirsiniz: BidResponse protokol arabelleği tanımına bakın. Bu alanların ayarlanmadığı yanıtlar yok sayılır.

Open Measurement

Open Measurement, üçüncü taraf tedarikçiler için bağımsız tedarikçiler mobil uygulamaya sunulan reklamlara yönelik ölçüm ve doğrulama hizmetleri ortam olarak da bilinir.

Desteklenen reklam biçimleri arasında video, banner ve geçiş reklamları yer alır. 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 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.

OpenRTB Protobuf

Örneği göster

id: "m7T91l3qg177P4b39N26W1"
seatbid {
  bid {
    id: "5viGQ43x3HI44d22DW3"
    impid: "1"
    price: 0.040404
    adid: "test_creative_id_566440"
    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: "67427969102"
    crid: "test_creative_id_566440"
    cat: "IAB3"
    cat: "IAB13"
    w: 320
    h: 50
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      billing_id: 67427969102
    }
  }
  seat: "1912:1424:626226"
  group: false
}
bidid: "38508qU5-957YGflD-M2rg-7B19HjXU00n2"
cur: "USD"

OpenRTB JSON

Örneği göster

{
  "id": "SwkWZ9w3I3gJ803j84253U",
  "seatbid": [
    {
      "bid": [
        {
          "id": "ro22H780p349mF6oe0h",
          "impid": "1",
          "price": 0.04001,
          "adid": "test_creative_id_978541",
          "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": "82346236545",
          "crid": "test_creative_id_978541",
          "w": 390,
          "h": 61,
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "5c39728P",
              "campaign": "10199716",
              "itunesitem": "640052147",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 1,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "0HY71438fqxkY2tqD14kV9DY1q3Fi77sc99e0D97Qo833M266T75c28Y5NM23wiL61WyNCe0277ER5eM32UxaKGf99GUM1jI",
                  "timestamp": "1714079463090"
                },
                {
                  "fidelity": 0,
                  "nonce": "9b05b355-a526-4f7c-9925-ab5c91b9dbef",
                  "signature": "J6RVg1KI31q1lB68f6F16fA07kY93DAYU2IL5ETDuvczR48oMr3S3X9tIohWi4L2VcE0w4mi42o0Mqa174U7o65951z44ru4",
                  "timestamp": "1714079463090"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "4372:2283:725828"
    }
  ],
  "bidid": "Z8aZJEk4-r2e3z85n-je52-q0E586r76K4T"
}

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: 31014
    billing_id: 16751333146
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 50
  category: 0
  buyer_creative_id: "test_creative_id_173035"
  advertiser_name: "Google"
  width: 300
  height: 250
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 10

Uygulama Geçiş Reklamı

OpenRTB Protobuf

Örneği göster

id: "wqZn032336g5U2Saroj8Lc"
seatbid {
  bid {
    id: "mTD7EYxAyF6n763v7pJ"
    impid: "1"
    price: 0.033932000398635864
    adid: "test_creative_id_237493"
    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"
    adomain: "google.com"
    cid: "42834631855"
    crid: "test_creative_id_237493"
    cat: "IAB2-18"
    cat: "IAB20"
    w: 360
    h: 711
    burl: "https://test.com/imp?id=123456"
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      attribute: 8
      event_notification_token {
        payload: "token"
      }
      billing_id: 42834631855
    }
  }
}
bidid: "62i6224k-ada8764U-y4Fi-2z760VkR3s35"
cur: "USD"

OpenRTB JSON

Örneği göster

{
  "id": "BQig8glrLj2K7p818w3s0S",
  "seatbid": [
    {
      "bid": [
        {
          "id": "v0x1j4q0B388Z5lv600",
          "impid": "1",
          "price": 0.25109,
          "adid": "test_creative_id_654733",
          "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": "73848702501",
          "crid": "test_creative_id_654733",
          "w": 428,
          "h": 846,
          "ext": {
            "skadn": {
              "version": "4.0",
              "network": "43D4r5x9",
              "sourceidentifier": "6217",
              "itunesitem": "950280085",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "8fZn83e3d0742gU7E8Ra7Vif4v1vK61X899f7G7q9Dl998035Gq81Zd4r3032814bQ03HP49709yf38n6U35YY29D0w2Ac5B",
                  "timestamp": "1714058970102"
                },
                {
                  "fidelity": 1,
                  "nonce": "0d223af6-1847-43aa-9f4f-963de4468b68",
                  "signature": "zs0k0e335UoH9M6mp1V228I8JAl2526LCKF0dc2l8x7o4270lsQ37B12Cf91a770RcNqSG7Kl667xsw97Eo4nA23o41h3c0H",
                  "timestamp": "1714058970102"
                }
              ]
            },
            "app_promotion_type": "INSTALLS",
            "impression_tracking_url": [
              "https://test.com/impression?id=123456",
              "https://test.com/impression?id=123456"
            ]
          }
        }
      ],
      "seat": "9150:1636:894279"
    }
  ],
  "bidid": "taiup4HY-42ggR62I-120u-3kyZ4831M9Yt"
}

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: 1079285
    billing_id: 37034094959
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 105
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_903208"
  advertiser_name: "Google"
  width: 398
  height: 744
  impression_tracking_url: "https://test.com/imp?id=123456"
  impression_tracking_url: "https://test.com/imp?id=123456"
  event_notification_token: "token"
  skadn {
    version: "4.0"
    network: "41dEOEaD"
    itunesitem: "151251861"
    sourceapp: "500811620"
    fidelities {
      fidelity_type: VIEW_THROUGH_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "p1f6bi578Q0jX163o5ws6n630p142H1v75rziXPtoak952g0Be18230732OkYu7epL9elCJ25078L09G5Mi6u7s7MyO2j5sI"
    }
    fidelities {
      fidelity_type: STOREKIT_RENDERED_ADS
      nonce: "0c9020f9-14c4-4dcd-8944-23ab140556a8"
      timestamp: 1714094838257
      signature: "JFtn495ab0EX97ci69Ru9c39ot9TWn5T0052F4439Y2a9u7zN2do7Q9AH4N584irpJmS8K877980K14iQgO74I33vgx231Cf"
    }
    skadn_options {
      always_open_appstore: true
    }
    source_identifier: 72
  }
}
processing_time_ms: 70

Uygulama geçiş reklamı videosu

OpenRTB Protobuf

Ö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"

Google

Örneği göster

ad {
  adslot {
    id: 1
    max_cpm_micros: 5037989
    billing_id: 82632801525
    currency: "TWD"
  }
  click_through_url: "google.com"
  attribute: 47
  category: 7
  buyer_creative_id: "test_creative_id_497252"
  advertiser_name: "Google"
  width: 720
  height: 1280
  video_vast_xml: "OMITTED_VAST_XML"
  event_notification_token: "token"
  advertised_app_id: "APP_ID_OMITTED"
  app_promotion_type: INSTALLS
}
processing_time_ms: 70

Uygulama yerel

OpenRTB Protobuf

Örneği göster

id: "P3mh232944yQx803R73ayZ"
seatbid {
  bid {
    id: "79B1S3h454910R471JL"
    impid: "1"
    price: 0.044748470187187195
    adomain: "google.com"
    cid: "52078759229"
    crid: "test_creative_id_537521"
    cat: "IAB20"
    burl: "https://test.com/imp?id=123456"
    adm_native {
      ver: "1.2"
      assets {
        id: 1
        required: true
        title {
          text: "Luxury Mars Cruises"
        }
      }
      assets {
        id: 5
        required: true
        img {
          url: "https://native.test.com/image?id=123456"
          w: 1200
          h: 627
          type: MAIN
        }
      }
      assets {
        id: 6
        required: false
        img {
          url: "https://native.test.com/logo?id=123456"
          w: 100
          h: 100
          type: LOGO
        }
      }
      assets {
        id: 2
        required: true
        data {
          value: "Visit the planet in a luxury spaceship."
          type: DESC
        }
      }
      assets {
        id: 3
        required: false
        data {
          value: "Book today"
          type: CTATEXT
        }
      }
      assets {
        id: 4
        required: true
        data {
          value: "Galactic Luxury Cruises"
          type: SPONSORED
        }
      }
      link {
        url: "https://www.google.com"
        clicktrackers: "https://native.test.com/click?id=123456"
      }
      eventtrackers {
        event: IMPRESSION
        method: IMG
        url: "https://test.com/event?id=123456"
      }
    }
    [com.google.doubleclick.bid] {
      event_notification_token {
        payload: "token"
      }
      billing_id: 52078759229
    }
  }
  seat: "2237:7356:617887"
}
cur: "USD"

OpenRTB JSON

Örneği göster

{
  "id": "3u95d40fy46B0y3CEL73uy",
  "seatbid": [
    {
      "bid": [
        {
          "id": "d501820Aa099K69Ia64",
          "impid": "1",
          "price": 1.63,
          "burl": "https://test.com/imp?id=123456",
          "adm": "{\"assets\": [{\"id\": 1, \"required\": 1, \"title\": {\"text\": \"Luxury Mars Cruises\"}}, {\"id\": 2, \"required\": 1, \"data\": {\"value\": \"Visit the planet in a luxury spaceship.\", \"label\": \"\"}}, {\"id\": 3, \"data\": {\"value\": \"Book today\", \"label\": \"\"}}, {\"id\": 4, \"required\": 1, \"data\": {\"value\": \"Galactic Luxury Cruises\", \"label\": \"\"}}, {\"id\": 5, \"required\": 1, \"img\": {\"url\": \"https://native.test.com/image?id=123456\", \"h\": 628, \"w\": 1200}}, {\"id\": 6, \"img\": {\"url\": \"https://native.test.com/logo?id=123456\", \"h\": 640, \"w\": 640}}], \"link\": {\"url\": \"https://www.google.com\", \"clicktrackers\": [\"https://native.test.com/click?id=123456\"]}, \"imptrackers\": [\"https://test.com/impression?id=123456&amt=${AUCTION_PRICE}\"], \"privacy\": \"\"}",
          "adid": "test_creative_id_237765",
          "adomain": [
            "google.com"
          ],
          "cid": "30567639040",
          "crid": "test_creative_id_237765",
          "cat": [
            "IAB8"
          ],
          "ext": {
            "skadn": {
              "version": "3.0",
              "network": "345vh5bv",
              "campaign": "62744790",
              "itunesitem": "608550422",
              "sourceapp": "com.google.testapp",
              "fidelities": [
                {
                  "fidelity": 0,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "4063Vhn5W7oGEcJ202oj6k990Y3H7f9sJ6luK3O65RbQ3S9kp45VK84le4a424c6SU79384DTdXS1cHWcxl9SB98563Y38K9"
                },
                {
                  "fidelity": 1,
                  "nonce": "88db095e-1022-48bb-ad38-54a1075886aa",
                  "timestamp": "1714430552729",
                  "signature": "r1852LY7j0f25q2s868j1Ub7r07S16e607BC5909O272F8i528732r22W7D138t3706205Ez139N73Iho3vJKp257Pp4vmet"
                }
              ]
            },
            "app_promotion_type": 1,
            "event_notification_token": {
              "payload": "token"
            }
          }
        }
      ],
      "seat": "3512:7802:295531"
    }
  ],
  "cur": "USD"
}

Google

Örneği göster

ad {
  adslot {
    id: 1
    max_cpm_micros: 1581987
    billing_id: 32132054378
  }
  click_through_url: "google.com"
  attribute: 47
  attribute: 8
  buyer_creative_id: "test_creative_id_285893"
  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: 800
      height: 800
    }
    logo {
      url: "https://native.test.com/logo?id=123456"
      width: 200
      height: 200
    }
    price: "\342\202\254106.40"
    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"
  ad_choices_destination_url: "https://test.com/preferences"
  event_notification_token: "token"
}
processing_time_ms: 20

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 Protobuf

Örneği göster

id: "878w58e050dSf05LS9l424"
seatbid {
  bid {
    id: "478u6K990C990n7FPTX"
    impid: "1"
    price: 0.03
    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: "46483683815"
    crid: "test_creative_id_527097"
    w: 320
    h: 50
    [com.google.doubleclick.bid] {
      impression_tracking_url: "https://test.com/impression?id=123456"
      impression_tracking_url: "https://test.com/impression?id=123456"
      event_notification_token {
        payload: "token"
      }
      billing_id: 46483683815
    }
  }
  seat: "6954:3639:781296"
}
bidid: "7a2CAWgt-IKR8mp06-0E3d-TPNq4zO9l767"
[com.google.doubleclick.bid_response] {
  processing_time_ms: 120
}

Yanıtı Oluşturun

Protobuf Teklif Yanıtı mesajı oluştur

Reklam Öğesi Kimliği

Reklam özellikleri

Open Bidding alanları

Öneriler

Örnek teklif yanıtı

OpenRTB Protobuf

Örneği göster

OpenRTB JSON

Örneği göster

Google

Örneği göster

Reklam öğesini belirtme

Makroları belirtme

Google RTB makroları

Yayıncı kısıtlamaları ve gereksinimleri

Open Measurement

Örnek teklif yanıtları

Uygulama banner'ı

OpenRTB Protobuf

Örneği göster

OpenRTB JSON

Örneği göster

Google

Örneği göster

Uygulama Geçiş Reklamı

OpenRTB Protobuf

Örneği göster

OpenRTB JSON

Örneği göster

Google

Örneği göster

Uygulama geçiş reklamı videosu

OpenRTB Protobuf

Örneği göster

Google

Örneği göster

Uygulama yerel

OpenRTB Protobuf

Örneği göster

OpenRTB JSON

Örneği göster

Google

Örneği göster

Web videosu

Google

Örneği göster

Exchange teklif vereni için mobil web banner'ı

OpenRTB Protobuf

Örneği göster