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.

BidResponse mesajı oluşturma

Teklif göndermek için teklifli sistem uygulamanızın, yapılandırılmış biçiminizde bir Bid içeren BidResponse ile teklif isteğine yanıt vermesi gerekir. JSON biçimini kullanıyorsanız yanıtınızda Content-Type üstbilgisi application/json; charset=utf-8 olarak ayarlanmalı ve gövdede JSON BidResponse bulunmalıdır. Protobuf biçimini kullanıyorsanız uygulamanızın Content-Type başlığını application/octet-stream olarak ayarlaması ve gövdeye serileştirilmiş BidResponse eklemesi gerekir.

Protobuf biçimi için bir BidResponse oluşturmak ve serileştirmek istiyorsanız standart OpenRTB BidResponse alanlarını ve Google uzantılarını Protobuf'ta uygulayan openrtb.proto ve openrtb-adx.proto'ya dayalı Protobuf kitaplıkları oluşturup kullanmanız gerekir. Bunları Protos & Reference Data (Protos ve Referans Verileri) bölümünde bulabilirsiniz.

Bir gösterim için teklif vermek istemiyorsanız boş bir HTTP 204 yanıtı döndürmeniz gerekir. Uygulamanız her BidRequest için bir yanıt 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 kısıtlar.

Reklam Öğesi Kimliği

BidResponse, BidResponse.seatbid.bid.crid alanı (128 bayt sınırı) aracılığıyla bir reklam öğesi belirtir. 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 önemli özellikler açısından 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ı görünme veya davranma
  • Farklı resimler oluşturun.
  • Farklı yöntemlerle oluşturulmuş (ör. biri resim, diğeri video olan reklamlar).

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

Reklam özellikleri

Google, reklamınızın özelliklerini ve hedeflemesini açıklamak için BidResponse.seatbid.bid.apis ve BidResponse.seatbid.bid.attr kombinasyonunu veya BidResponse.seatbid.bid.ext.attribute uzantısını kullanarak reklam öğesi özelliklerini beyan etmenizi önerir. Aşağıda, özellikleri nasıl beyan edebileceğiniz açıklanmaktadır:

  • VPAID
    BidResponse.seatbid.bid.apis değerini VPAID_1 veya VPAID_2 olarak ayarlayın. JSON biçimi için bu, sırasıyla 1 veya 2 olarak ayarlanabilir.
  • MRAID
    BidResponse.seatbid.bid.apis değerini MRAID_1 veya JSON biçimi için 3 olarak ayarlayın.
  • SIZELESS
    BidResponse.seatbid.bid.attr değerini RESPONSIVE veya JSON biçimi için 18 olarak ayarlayın.
  • PLAYABLE
    Bu, BidResponse.seatbid.bid.attr değerini USER_INTERACTIVE veya JSON biçimi için 13 olarak ayarlayarak belirtilir.

Reklam öğelerinizin algılanan özellikleriyle ilgili geri bildirim alma hakkında açıklama için Reklam öğeleri kaynağı bölümüne bakın.

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 teklif yanıtlarına benzer. 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:

Alan Ayrıntılar
BidResponse.imp.pmp.deals.id

Exchange'in ad alanından, bu teklifle ilişkili olan ve yayıncılara bildirilen anlaşma kimliği.

BidResponse.seatbid.bid.ext.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ü.

BidResponse.seatbid.bid.ext.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ı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. Çoğu durumda daha yüksek değerler faydalıdır. Google, uygulamanızın ilk gecikme testleri sırasında bunu doğrular. Bunun nedeni, Authorized Buyers'ın yüksek bir hızda istek göndermesi ve her istek için ayrı bir TCP bağlantısı kurmanın gecikme yükünden kaçınması gerekmesidir.
  • Teklif verenin kazandığı zaman yerine gösterimin ne zaman oluşturulduğunu izlemek için isteğe bağlı gösterim izleyici URL'sini ekleyin. Kazananlar ve oluşturmalar arasındaki düşüş nedeniyle bu, daha doğru izleme istatistikleri sağlar.

  • Teklif veren kodunuzu, tekliflerinizin hatalarla başarısız olmasına neden olabilecek desteği sonlandırılmış alanlara bağımlılıklardan uzak tutun.
  • BidResponse için BidResponse.seatbid.bid.w ve BidResponse.seatbid.bid.h ekleyin. Birden fazla reklam boyutu içeren bir isteğe verilen BidResponse, bu alanları içermelidir. Aksi takdirde açık artırmadan çıkarılır.
  • Yanıt boyutunuzu 8K'nın altında tutun. Çok büyük yanıtlar, ağ gecikmesini artırabilir ve zaman aşımına neden olabilir.
  • SKAdNetwork ilişkilendirmesi gerektiren iOS envanterindeki tekliflerle ilgili kurallara uyun.

Örnek teklif yanıtı

Aşağıdaki örneklerde, Protobuf ve JSON isteklerinin okunabilir örnekleri gösterilmektedir.

OpenRTB Protobuf

OpenRTB JSON

Önemli: Örneklerde gösterilen Protobuf mesajları, burada kullanıcı tarafından okunabilir metin olarak gösterilir. Ancak mesajlar kablo üzerinden bu şekilde gönderilmez. OpenRTB Protobuf biçimi kullanılırken yalnızca serileştirilmiş BidResponse mesajları kabul edilir.

Aşağıdaki C++ kodunu kullanarak bir BidResponse mesajı oluşturabilir ve 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 öğesini belirtme

Teklif yanıtınız, teklifiniz kazanırsa 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 göre aşağıdaki alanlardan birini kullanarak reklam öğenizi belirtebilirsiniz:

  • SDK tarafından oluşturulan reklam
    • BidResponse.seatbid.bid.ext.sdk_rendered_ad
  • AMP
    • BidResponse.seatbid.bid.amp_ad_url
  • Video
    • BidResponse.seatbid.bid.adm
  • Doğal reklam
    • BidResponse.seatbid.bid.adm_native

BidResponse.seatbid.bid.adm alanında bir 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 sayede, sayfa yüklendiğinde reklam alınır ve oluşturulur. HTML snippet'ini, reklamın (banner veya geçiş reklamı) bir iFrame içinde ve teklif verdiğiniz reklam alanı için uygun boyutta doğru şekilde oluşturulacağı şekilde hazırlamanız gerekir.

Ayrıca, teklif yanıtında bildirilen reklam boyutu, aşağıdaki durumlarda teklif isteğindeki 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, teklif yanıtında boyutu beyan etmiştir. İstekte birden fazla boyut olduğunda boyut bildirimi zorunludur.
  • Geçiş reklamları için bir istisna yapılı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 geçerli bir HTML kodu kullanarak HTML snippet reklam öğesi belirtebilirsiniz ancak BidResponse mesajı oluşturma bölümünde crid alanını belirtmeyle ilgili kısıtlamaları göz önünde bulundurun. Bunun bir kullanım alanı, reklamın oluşturulması kapsamında sunucularınızdan getirilen URL'lerin bağımsız değişkenlerine ek bilgiler eklemektir. Bu sayede, gösterimle ilgili rastgele verileri kendi sunucularınıza geri iletebilirsiniz.

Teklif yanıtlarında döndürülen HTML snippet'leriyle ilgili politikaların çoğu, üçüncü taraf reklamlarıyla ilgili politikalarla aynıdır. Daha fazla bilgi için Authorized Buyers Program Yönergeleri, Üçüncü taraf reklam sunma koşulları ve Reklamlarda tıklama URL'lerini bildirme bölümlerine bakın.

Tutarlı tıklama URL'leri kullanma

BidResponse.seatbid.bid.ext.clickurl alanında belirttiğiniz tıklama URL'si, reklam öğenizde belirtilen açılış sayfası URL'si ile aynı olmalıdır. Aşağıda, https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1 olarak ayarlanan clickurl alanıyla tutarlı, desteklenen biçimlerdeki reklam öğesi örnekleri verilmiştir:

HTML

<div id="my-app-install-ad"
     style="font-family: sans-serif; border: 1px solid #ddd; padding: 10px;
            display: flex; align-items: center; width: 100%; height: 100%;
            box-sizing: border-box; cursor: pointer;"
     onclick="window.open('https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1', '_blank')">
  <img src="https://example.com/path/to/app_icon.png" alt="App Icon"
       style="width: 60px; height: 60px; margin-right: 10px;
              border-radius: 8px;">
  <div style="flex-grow: 1;">
    <h4 style="margin: 0 0 5px 0; font-size: 16px; color: #1a73e8;">
      My Awesome App
    </h4>
    <p style="margin: 0 0 10px 0; font-size: 14px; color: #5f6368;">
      The best app for doing awesome things! Download now and get started!
    </p>
    <span style="background-color: #1a73e8; color: white; padding: 8px 12px;
                 text-align: center; text-decoration: none;
                 display: inline-block; border-radius: 4px; font-size: 14px;
                 font-weight: bold;">Install</span>
  </div>
</div>

VAST XML

<VAST version="3.0">
  <Ad id="creative_id_789">
    <InLine>
      <AdSystem>MyBidderSystem</AdSystem>
      <AdTitle>My Awesome App Install Video</AdTitle>
      <Description>Install My Awesome App now!</Description>
      <Error>
        <![CDATA[https://tracking.example.com/vast_error?errorcode=[ERRORCODE]]]>
      </Error>
      <Impression>
        <![CDATA[https://tracking.example.com/vast_impression]]>
      </Impression>
      <Creatives>
        <!-- Main Video Creative -->
        <Creative>
          <Linear>
            <Duration>00:00:15</Duration>
            <TrackingEvents>
              <Tracking event="start">
                <![CDATA[https://tracking.example.com/vast_event?label=start]]>
              </Tracking>
              <Tracking event="firstQuartile">
                <![CDATA[https://tracking.example.com/vast_event?label=firstQuartile]]>
              </Tracking>
              <Tracking event="midpoint">
                <![CDATA[https://tracking.example.com/vast_event?label=midpoint]]>
              </Tracking>
              <Tracking event="thirdQuartile">
                <![CDATA[https://tracking.example.com/vast_event?label=thirdQuartile]]>
              </Tracking>
              <Tracking event="complete">
                <![CDATA[https://tracking.example.com/vast_event?label=complete]]>
              </Tracking>
            </TrackingEvents>
            <VideoClicks>
              <ClickThrough id="gplay-video">
                <![CDATA[https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1]]>
              </ClickThrough>
              <ClickTracking id="bidder-tracker-video">
                <![CDATA[https://tracking.example.com/vast_click]]>
              </ClickTracking>
            </VideoClicks>
            <MediaFiles>
              <MediaFile delivery="progressive" type="video/mp4" width="640"
                         height="360" bitrate="800" scalable="true"
                         maintainAspectRatio="true">
                <![CDATA[https://cdn.example.com/myawesomeapp_video.mp4]]>
              </MediaFile>
            </MediaFiles>
          </Linear>
        </Creative>
        <!-- Companion Ad Creative -->
        <Creative>
          <CompanionAds>
            <Companion id="companion1" width="300" height="250"
                       assetWidth="300" assetHeight="250">
              <StaticResource creativeType="image/png">
                <![CDATA[https://cdn.example.com/companion_banner_300x250.png]]>
              </StaticResource>
              <TrackingEvents>
                <Tracking event="creativeView">
                  <![CDATA[https://tracking.example.com/vast_companion_view]]>
                </Tracking>
              </TrackingEvents>
              <CompanionClickThrough>
                <![CDATA[https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1]]>
              </CompanionClickThrough>
              <CompanionClickTracking>
                <![CDATA[https://tracking.example.com/vast_companion_click]]>
              </CompanionClickTracking>
            </Companion>
          </CompanionAds>
        </Creative>
      </Creatives>
    </InLine>
  </Ad>
</VAST>

Yerel biçim

{
  "ver": "1.2",
  "assets": [
    {
      "id": 1,
      "title": {
        "text": "My Awesome App"
      }
    },
    {
      "id": 2,
      "img": {
        "url": "https://example.com/path/to/app_icon.png",
        "w": 60,
        "h": 60
      }
    },
    {
      "id": 3,
      "data": {
        "value":
          "The best app for doing awesome things! Download now and get started!"
      }
    },
    {
      "id": 4,
      "data": {
        "value": "Install"
      }
    }
  ],
  "link": {
    "url": "https://play.google.com/store/apps/details?id=com.example.myawesomeapp&referrer=utm_source%3Dgoogle_ab%26utm_medium%3Dcpc%26utm_campaign%3Dinstall_campaign_1",
    "clicktrackers": [
      "https://tracking.example.com/native_click"
    ]
  },
  "imptrackers": [
    "https://tracking.example.com/native_impression"
  ]
}

Makroları belirtme

Makrolar, reklam yayınlama sırasında alakalı bir değerle değiştirilen URL'leri içeren bazı teklif yanıtı alanlarına yerleştirilmiş biçimlendirilmiş metinlerdir. Örneğin, kazanan teklifiniz, teklifinize dahil edilen HTML snippet'i reklam öğesinde AUCTION_PRICE makrosunu içeriyorsa makro, açık artırmada gösterim için ödediğiniz tutarı belirlemek üzere şifresini çözebileceğiniz bir değerle değiştirilir.

Makroları aşağıdaki alanlara ekleyebilirsiniz:

  • BidResponse.seatbid.bid.adm

    Makrolar HTML snippet'i, yerel, video URL'si ve video VAST XML biçimleri için 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 özel WINNING_PRICE ve WINNING_PRICE_ESC makroları desteklenir.

  • BidResponse.seatbid.bid.burl

  • BidResponse.seatbid.bid.ext.impression_tracking_url

    Birden fazla faturalandırma URL'si gerekiyorsa BidResponse.seatbid.bid.burl yerine bunu kullanın.

Örneğin, reklam öğesini getirmek için kullanılan URL'ye ${MACRO} öğesini yerleştirerek bir makroyu HTML snippet'inin parçası olarak ekleyebilirsiniz. Burada MACRO, OpenRTB spesifikasyonunda açıklanan desteklenen makrolardan biridir.

Google makroları

Google, OpenRTB spesifikasyonunda bulunanların dışında ek makroları destekler. Bunlar farklı şekilde biçimlendirilir ve bir URL'ye yerleştirildiklerinde %%MACRO%% olarak görünür. Aşağıdaki tabloda bu makrolar açıklanmaktadır:

Makro Açıklama
ADVERTISING_IDENTIFIER Alıcıların, gösterim oluşturma sırasında iOS IDFA veya Android'in reklam kimliğini almasına olanak tanır. Ayrıntılar için Reklamveren Kimliklerinin Şifresini Çözme başlıklı makaleyi inceleyin.
CACHEBUSTER Rastgele, işaretsiz, dört baytlık bir tam sayının dize temsili.
CLICK_URL_UNESC

Reklamın kaçış karakteri içermeyen tıklama URL'si. Snippet'te, üçüncü taraf tıklama URL'sinin çıkış karakteri eklenmiş 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ının ardından üçüncü taraf tıklama URL'sinin tek kaçışlı 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 sunma 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 önce tıklamayı Google'a kaydeder, ardından üçüncü taraf tıklama URL'sine yönlendirir.

CLICK_URL_ESC

Reklamın çıkış karakteri eklenmiş tıklama URL'si. Değeri önce başka bir sunucuya iletmeniz ve ardından bu sunucunun bir 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 sunma 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 google_click_url parametresinde iletilen URL'ye yönlendirmeden sorumlu olur. Bu, my.adserver.com parametresinin google_click_url parametresini kaçış karakterinden çıkardığını varsayar.

%%CLICK_URL_ESC%% parametresinden sonra çift çıkış karakterli bir URL ekleyebilirsiniz. my.adserver.com tarafından kod dışına alma işlemi tamamlandıktan sonra, URL'nin tek kaçış karakterli bir sürümü google_click_url parametresine eklenmiş olarak kalır. google_click_url getirildiğinde, bir kez daha çıkış karakteri eklenir ve ardından yönlendirilir.

CLICK_URL_ESC_ESC

Reklamın iki kez çıkış karakteri eklenmiş URL'si. Değeri önce başka bir sunucuya iletmeniz ve bu sunucunun bir 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 sunma 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 http:, gerektiriyorsa https: olarak 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ştirildi.
TZ_OFFSET Saat dilimi farkı.
VERIFICATION

Üretim için farklı değerler ve reklam öğesinin doğrulama ardışık düzeninde tarandığı zaman. Biçim şu şekildedir: %%?VERIFICATION:true-val:false-val%%. Burada, makrolar hariç olmak üzere boş dizeler de dahil herhangi bir değer true-val ve false-val için kullanılabilir. Open Bidding için exchange'lerin bu makroyu kullanmasını öneririz. Exchange'ler bu makroyu kullandığında talep tarafı platformlarının değişiklik yapması gerekmez.

Örneğin, bir reklam öğesi %%?VERIFICATION:-1:5000%% içeriyorsa metin değiştirme, yayınlama sırasında 5000 ve doğrulama ardışık düzeninde -1 olur. Bu, bu iki ping grubu arasında ayrım yapmaya yardımcı olur.

WINNING_PRICE

Hesap para biriminin mikrosu cinsinden kodlanmış gösterim maliyeti (BGBM yerine GBBM). Örneğin, 5 ABD doları tutarındaki kazanan BGBM, 5.000.000 mikro BGBM'ye veya 5.000 mikro TBM'ye karşılık gelir. Bu durumda WINNING_PRICE parametresinin kodu çözülmüş değeri 5.000 olur. Kazanan fiyat, YBM cinsinden belirtilir.

Bu makroyu ayrıştırmak için fiyat onaylarının şifresini çözen bir uygulama kullanmanız gerekir. Daha fazla bilgi için Fiyat Onaylarının Şifresini Çözme sayfasını inceleyin.

WINNING_PRICE_ESC URL çıkışlı WINNING_PRICE.

Google, üçüncü taraf tarafından sunulan 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 URL çıkış karakteri kullanımı aşağıdaki şemayı kullanır:

  • Boşluk karakteri, artı işaretiyle (+) değiştirilir.
  • Alfanümerik 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ı ve şartları

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, Real-Time Bidding API'nin detectedCategories alanını kullanarak gönderdiğiniz reklam öğeleri için algılanan kategorilerle karşılaştırabilirsiniz.
  • BidRequest.imp.ext.allowed_vendor_type
  • BidRequest.imp.secure
    • Google tüm reklam öğeleri için SSL desteği gerektirdiğinden bu değer pratikte her zaman true olarak ayarlanır.
  • 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 hiçbir zaman teklif vermeyin. Tedarikçi firma türü gibi izin verilen özellikler için yalnızca tedarikçi firma türü BidRequest içindeki allowed_vendor_type listesinde yer alan reklamları döndürün. Teklifinizde yalnızca, teklif isteğinde BidRequest.imp.banner gibi alanlar doldurularak belirtilen reklam biçimleri yer almalıdır. Daha fazla bilgi için BidRequest protokol arabelleği tanımındaki bu alanlarla ilgili yorumlara bakın.

BidResponse içinde bir reklam döndürülürse BidResponse içinde BidResponse.seatbid.bid.attr, BidResponse.seatbid.bid.cat ve BidResponse.seatbid.bid.adomain ya da BidResponse.seatbid.bid.adm_native.link.url alanlarını doğru şekilde ayarlamanız gerekir. Bir reklamın bu alanlar için birden fazla geçerli değeri varsa her değeri eklemeniz gerekir. Daha fazla bilgi için BidResponse protokol arabelleği tanımındaki bu alanlarla ilgili yorumlara bakın. Bu alanların ayarlanmadığı yanıtlar silinir.

Open Measurement

Open Measurement, mobil uygulama ortamlarında yayınlanan reklamlar için bağımsız ölçüm ve doğrulama hizmetleri sunan üçüncü taraf satıcıları belirtmenize olanak tanır.

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'sı Yardım Merkezi makalesini inceleyin.

Örnek teklif yanıtları

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

Uygulama banner'ı

OpenRTB Protobuf

OpenRTB JSON

Uygulama Geçiş Reklamı

OpenRTB Protobuf

OpenRTB JSON

Uygulama geçiş reklamı videosu

OpenRTB Protobuf

OpenRTB JSON

Uygulama içi doğal reklam

OpenRTB Protobuf

OpenRTB JSON

Web videosu

OpenRTB Protobuf

OpenRTB JSON

Exchange teklif vereni için mobil web banner'ı

OpenRTB Protobuf

OpenRTB JSON