Open Bidding Entegrasyonunu Yapılandırma

Open Bidding, exchange'lerin ve diğer alıcıların Google Ad Manager ve AdMob envanteri için teklif vermek üzere Google'ın gerçek zamanlı teklif altyapısından yararlanmasını sağlar.

Open Bidding'e katılmak için Open Bidding kullanım alanınız için özelleştirilmiş bir gerçek zamanlı teklif verme entegrasyonu yapılandırın ve entegrasyonun doğru şekilde çalıştığını test edip doğrulaması için teklif veren uç noktalarını Google hesap yöneticinize gönderin. Bu, bir defalık bir işlemdir.

Entegrasyonunuzu belirli yayıncılarla sınırlama

Open Bidding entegrasyonunuz, herhangi bir yayıncıdan istek kabul etmeye hazır olana kadar "gizli mod"da kalabilir. Özel moddayken hesap ekibinizle birlikte çalışarak belirli yayıncılarla bağlantı kurabilir ve ölçeklendirmeye hazır olana kadar bu durumda kalabilirsiniz. Gizli moddan çıktığınızda hesabınız tüm yayıncılar tarafından görülebilir.

Desteklenen protokoller ve kodlama

OpenRTB'yi JSON veya Protobuf biçimlerinde kullanabilirsiniz. Daha fazla bilgi edinin.

Google OpenRTB uygulaması

Google'ın OpenRTB uygulaması, OpenRTB spesifikasyonundaki tüm özellikleri desteklemez ve Authorized Buyers ile Open Bidding'e özgü işlevler için uzantılar ekler. Daha fazla bilgi edinmek için OpenRTB Kılavuzu'na bakın.

Gelen teklif isteklerini işleme

Open Bidding, Authorized Buyers ile aynı BidRequest yapısını kullanır ancak bazı alanlar yalnızca Open Bidding katılımcılarına gönderilir. Teklif isteğinde gönderilen Open Bidding'e özgü alanlar hakkında daha fazla bilgi edinmek için İstek Kılavuzu'na bakın.

Teklif ile yanıt verme

Open Bidding, Authorized Buyers'a benzer bir BidResponse yapısı da kullanır. Bu yapıda, Open Bidding katılımcılarına özel bazı alanlar gönderilir. Yanıt verebileceğiniz Open Bidding'e özgü alanlar hakkında daha fazla bilgi edinmek için Yanıt Kılavuzu'na bakın.

Not: Open Bidding katılımcılarına gönderilen teklif isteklerine, envanter biçimine bağlı olarak 300 ila 1.000 ms içinde yanıt verilmelidir. Belirli bir istek için özel koşulu belirlemek üzere BidRequest.tmax alanını kontrol edin.

Teklif vermek istediğiniz tercih edilen reklam biçimine bağlı olarak yanıt yapısı önemli ölçüde farklılık gösterebilir. Teklif veren uygulamanızı, yaygın reklam biçimleri için tekliflerle yanıt verecek şekilde yapılandırmanıza yardımcı olacak aşağıdaki kılavuzları inceleyin:

• Geçiş reklamları
• Video reklamlar
• OpenRTB video reklamlar
• Yerel reklamlar
• Yerel video reklamlar
• Alıcı SDK'sı reklamları

Tutarsızlıkları azaltmak için gösterimleri izleme

Google'ın sizden ücret alınacak faturalandırılabilir etkinlikleri ne zaman kaydettiğiyle ilgili gösterim düzeyinde verileri almak için isteğe bağlı BidResponse.seatbid.bid.ext.impression_tracking_url alanını kullanmanız önemle tavsiye edilir.

Google talep tutarsızlığı çözümü (Beta)

Bu özellik, bir exchange'in faturalandırıldığı gösterim sayısının Google Display & Video 360 (DV360) tarafından ödenen gösterim sayısıyla uyumlu olmasını sağlamayı amaçlar.

Google, Açık Teklif Verme tarafından yayınlanan DV360 gösterimlerini doğru bir şekilde tanımlayarak, ödeme almadığınız gösterimler için faturalandırılmadığınızdan emin olmak amacıyla reklam spam'i ve faturalandırılabilir etkinlik tutarsızlıklarını düzenleyebilir.

Teklif isteklerinde google_query_id'yi iletmek

Geçerli gösterim sayısının Google talebi genelinde eşleştiğinden emin olmak için google_query_id, Open Bidding isteklerinden Google talep platformlarına olduğu gibi dağıtılmalıdır. Bu, Open Bidding tutarsızlık çözümünün ön koşuludur. google_query_id öğesinin şu anda beklenen uzunluğu yaklaşık 64 bayttır.

Teklif yanıtlarında third_party_buyer_token özelliğini iletin

Google talep platformunun bir exchange'in dahili açık artırmasını kazanması durumunda, third_party_buyer_token alanı teklif yanıtında Open Bidding gösterimi üzerinden olduğu gibi dağıtılmalıdır. Bu, Google yayıncı platformlarının bir Open Bidding iş ortağının kazanan teklifinin, aynı gösterim fırsatı için Google talebi adına verilen bir teklif olduğunu belirlemesine olanak tanır. Bu alanın mevcut maksimum uzunluğunun 150 bayt olması beklenir.

Google reklam öğesi işaretlemesini teklif yanıtlarında olduğu gibi iletin

Tutarsızlık çözümünün Google talebinden gelen teklifler için geçerli olmasını sağlamak amacıyla, bir exchange'in Google reklam öğesi işaretlemesini herhangi bir sarmalayıcı (komut dosyası etiketleri, iFrame'ler veya VAST sarmalayıcıları) olmadan yayması gerekir. Tutarsızlık çözümü nedeniyle Google, Google talep platformları tarafından sayılmayan Açık Teklif gösterimlerini geçersiz kılabilir ve bunlar için faturalandırma yapmayabilir. Google, third_party_buyer_token içeren tekliflerin başka bir alıcı adına değil, Google talebi adına gönderildiğini doğrulamak için reklam öğesi işaretlemesini düzenli olarak kontrol eder.

HTML5 reklam öğeleri

Bir exchange'in, Google HTML işaretini normalde geçerli olan exchange'e özel makro genişletmeleri ve isteğe bağlı olarak exchange'in normalde eklediği ek izleyici pikselleri veya komut dosyaları ile olduğu gibi göndermesi gerekir.

Bir exchange, Google HTML reklam öğesini daha sonra Google HTML kodunu yükleyen veya oluşturan bir etikete (script, iframe veya diğer teknikler) sardıysa Google tutarsızlık çözümünü uygulayamaz.

Teknik koşulları karşılıyor

Bu örnekte, Google (DV360) teklif yanıtındaki reklam öğesi HTML kodu aynen iletilir, bir exchange'e özel HTML koduyla önceden eklenir ve eklenir.

<!-- START exchange-specific HTML header -->
<iframe src="https://exchange.example.com/impression?…" width="0" height="0" frameborder="0" scrolling="no" style="display:none;" marginheight="0" marginwidth="0"></iframe>
<!-- END exchange-specific HTML header -->
<!-- START HTML code as returned by Google in the bid response -->
<DIV STYLE="position: absolute; left: 0px; top: 0px; visibility: hidden;"><IMG SRC="https://pagead2.googlesyndication.com/pagead/gen_204?id=xbid&dbm_b=…" BORDER=0 WIDTH=1 HEIGHT=1 ALT="" STYLE="display:none"></DIV><iframe title="Blank" src="https://googleads.g.doubleclick.net/xbbe/pixel?d=…" style="display:none" aria-hidden="true"></iframe><div><div style="position:relative; display:inline-block;"><div class="GoogleActiveViewClass" id="DfaVisibilityIdentifier_…"><script>var url = 'https://googleads.g.doubleclick.net/dbm/ad?…';document.write('<script src="' + (window.rfl ? window.rfl(url) : url) + '"></s' + 'cript>');</script>…
<!-- END HTML code as returned by Google in the bid response -->
<!-- START exchange-specific HTML footer -->
<img src='https://exchange.example.com/track?…' width='0' height='0' style='display:none;'>
<!-- END exchange-specific HTML footer -->

Teknik şartları karşılamıyor

Bu örnekte, reklam öğesi Google tarafından döndürülen HTML kodu bir exchange tarafından sağlanan teklif yanıtında karartılmıştır ve teklif yanıtında aynen görünmez. Google tarafından sağlanan HTML kodu, tarayıcıda exchange tarafından sağlanan bir sarmalayıcı tarafından oluşturulabilir.

<!-- START exchange ad tag that encodes / renders Google creative in the browser -->
<!-- Google creatives markup from the bid response (adm) is not present verbatim -->
<span class="ad"><script type='text/javascript' src='https://exchange.example.com/ad?p=%%WINNING_PRICE%%&m=n_ybbRoVpsLlXSo8gVHRn-W0tynBt-Hoe8t8m0qwKhLFiaF-0gB0U4w-5pjeB8IMIkg7PcRri5iCIjBMMKDqg
…'></script></span>
<!-- END exchange ad tag that encodes / renders Google creative in the browser -->

VAST video reklam öğeleri

Tutarsızlık çözümünden yararlanabilmek için exchange'in, VAST XML yanıtlarında VASTTagURI değerini doldurmak üzere aşağıdaki yaklaşımlardan birini kullanması gerekir:

1. Bir exchange, VASTTagURI öğesinin değerini Google tarafından döndürülen VAST XML dokümanı kapsamında BidResponse.seatbid.bid.adm alanında olduğu gibi koruyabilir. Bu durumda, normalde geçerli olan exchange'e özgü makro genişletmeleri kullanılır.
2. DV360, bir exchange'e gönderilen teklif yanıtlarında BidResponse.seatbid.bid.adm.nurl alanını VAST doküman URL'siyle doldurabilir. Ardından bir exchange, bu değeri VASTTagURI etiketiyle iletebilir. Exchange'e özgü makrolar gerektiği gibi normal şekilde genişletilir.

Bir exchange, gerekirse VAST XML belgesinde ek VAST etkinlik ve hata izleyicileri belirtebilir.

Teknik koşulları karşılıyor

Bu örnekte, Google (DV360) teklif yanıtındaki reklam öğesi VAST URI'si aynen iletilir. Bir exchange, kendi VAST etkinliğini ve hata izleyicilerini ekler.

<!-- START exchange VAST tag referencing Google creative -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="123456789"><Wrapper>

<!-- Google VAST URI from the bid response is present verbatim -->
<AdSystem>XBid</AdSystem><VASTAdTagURI><![CDATA[https://bid.g.doubleclick.net/dbm/vast?…]]></VASTAdTagURI>

<!-- START Exchange-specific event trackers -->

<Error><![CDATA[https://video.exchange.example.com/vast_error?error=[ERRORCODE]&…]]></Error><Impression><![CDATA[https://video.exchange.example.com/impression?price=%%WINNING_PRICE%%&…]]></Impression><Creatives><Creative id="1234567890" sequence="1"><Linear><TrackingEvents><Tracking event="creativeView"><![CDATA[https://video.exchange.example.com/track/view?…]]></Tracking><Tracking event="start"><![CDATA[https://video.exchange.example.com/track/start?…]]></Tracking><Tracking event="midpoint"><![CDATA[https://video.exchange.example.com/track/midpoint?…]]></Tracking></TrackingEvents><VideoClicks><ClickTracking><![CDATA[https://video.exchange.example.com/click?…]]></ClickTracking></VideoClicks>

<!-- END Exchange-specific event trackers -->

</Linear></Creative></Creatives></Wrapper></Ad></VAST>

<!-- END exchange VAST tag referencing Google creative -->

Teknik şartları karşılamıyor

Bu örnekte, reklam öğesi Google tarafından döndürülen VAST kodu veya URI teklif yanıtında aynen görünmez. Bunun yerine exchange'e özel bir VAST sarmalayıcı kullanılır. Google tarafından sağlanan VAST kodu, SDK bir reklam yüklediğinde exchange tarafından sağlanan bir VAST sarmalayıcısı (VASTAdTagURI öğesinde tanımlandığı gibi, https://video.exchange.example.com/creative?…) tarafından yüklenebilir.

<!-- START exchange VAST tag that encodes or loads Google VAST creative subsequently -->
<!-- Google VAST URI or VAST document from the bid response is not present verbatim -->

<?xml version="1.0" encoding="UTF-8"?><VAST version="2.0"><Ad id="1234567890"><Wrapper><AdSystem version="0.1">VideoExchange</AdSystem><VASTAdTagURI><![CDATA[https://video.exchange.example.com/creative?…]]></VASTAdTagURI><Error><![CDATA[https://video.exchange.example.com/error?ec=[ERRORCODE]]]></Error><Impression><![CDATA[https://video.exchange.example.com/imp?…]]></Impression><Creatives><Creative></Creative></Creatives></Wrapper></Ad></VAST>
<!-- END exchange VAST tag that encodes or loads Google VAST creative subsequently -->

Fırsatlar

Open Bidding'e katılan exchange'ler, Open Bidding ile Tercih Edilen Anlaşmalar'ı (PD) ve Özel Açık Artırmaları (PA) kullanabilir. Anlaşma kimliği ve türü aşağıdaki gibi belirtilmelidir:

Alan	Açıklama
BidResponse.seatbid.bid.dealid	Exchange'in teklifle ilişkilendirilen ve yayıncılara raporlanan ad alanındaki anlaşma kimliği. Bu, rastgele UTF8 metnidir ve en fazla 64 bayt uzunluğunda olmalıdır.
BidResponse.seatbid.bid.ext.exchange_deal_type	Anlaşmanın türünü belirten bir enum. Bu durum yayıncılara bildirilir ve anlaşmanın açık artırmada nasıl ele alınacağını etkiler. Olası değerler: OPEN_AUCTION = 0; PRIVATE_AUCTION = 1; PREFERRED_DEAL = 2; EXCHANGE_AUCTION_PACKAGE = 3;

Aşağıda, PD/PA için örnek bir teklif yanıtı verilmiştir.

id: "ECHO_BIDREQUEST_ID"
seatbid {
  bid {
    id: "BID_ID"
    impid: "1"
    price: 1.23
    adm: "AD_TAG"
    adomain: "DECLARED_LANDING_PAGE_URL"
    cid: "BILLING_ID"
    crid: "CREATIVE_ID"
    dealid: "DEAL_ID"
    w: 300
    h: 250
    [com.google.doubleclick.bid] {
      impression_tracking_url: "IMPRESSION_TRACKING_URL"
      exchange_deal_type: "DEAL_TYPE"
    }
  }
}

Çerez eşleştirme

Google tarafından barındırılan eşleşme tablolarını doldurmak için Open Bidding katılımcıları, aşağıdaki seçeneklerden kendi ihtiyaçlarına en uygun olanı kullanabilir:

• Çerez eşleştirme: Alıcı veya exchange tarafından başlatılan eşleştirme Daha fazla bilgi
• Pixel eşleştirme: Google tarafından başlatılan eşleştirme Daha fazla bilgi edinin.
• Çerez Eşleştirme Yardımı: Teklif verenleriyle exchange tarafından başlatılan eşleştirme Daha fazla bilgi edinin.

Not: Open Bidding katılımcıları şu anda kullanıcı listeleri oluşturamaz, dolduramaz veya hedefleyemez.

Gecikmeyi yönetme

Teklif veren uç noktalarınızın gelen teklif isteklerine yanıt verirken yaşayacağı gecikmeyi tahmin etmek için Eşleme Kılavuzu'nda bulunan alım satım konumlarını kullanmanız gerekir.

Envanter genellikle en yakın alım satım konumu üzerinden gönderilir ancak bu garanti edilmez. Tüm gösterimler için erişimi garanti etmenin tek yolu, tüm teklif verme konumlarında teklif veren uç noktalarının bulunmasıdır.

Çok sayıda teklif isteği alan büyük exchange'ler, gecikmeyi ve gecikme dalgalanmasını azaltmak için Google ile eşleme anlaşması yapmayı düşünmelidir. Eşleme hakkında daha fazla bilgi edinin.

Tıklama makroları

Tıklama makroları uygulamanızı öneririz. Bu sayede, hesabınız ve birlikte çalıştığınız yayıncılar için tıklamaları ve tıklamadan türetilen metrikleri içeren raporlar oluşturabilirsiniz. Daha fazla bilgi edinin.

API'ler

Open Bidding müşterileri, sorun giderme amacıyla yararlı olabilecek verilere erişmek için Authorized Buyers REST API'lerini kullanabilir. Şu anda yalnızca aşağıdaki API kaynaklarına erişilebilir:

• v1.4 Performans Raporu
• v2beta1 GZT Sorun Giderilme

Hesabınızı bu API'lere erişecek şekilde yapılandırmak ve API çağrıları yapmak için gereken hesap kimliğini almak üzere teknik hesap yöneticinizle iletişime geçebilirsiniz. Bu API'lerin kullanımıyla ilgili teknik destek için [e-mail] destek takma adına e-posta gönderebilirsiniz.

Ek kaynaklar

• Bağlantıları yönetmeyle ilgili en iyi uygulamalar
• Teklif URL'si makrolarını kullanma
• WINNING_PRICE makrosunu kullanıyorsanız fiyat onaylarının şifresini çözme
• Test önerileri ve en iyi uygulamalar

Örnek teklif istekleri ve yanıtları

Desteklenen tüm protokoller için teklif isteği ve yanıt örneklerini İstek ve Yanıt kılavuzlarında bulabilirsiniz.