Open Bidding Entegrasyonunu Yapılandırma

Open Bidding exchange'lerin ve diğer alıcıların Google'ın gerçek zamanlı teklif verme özelliğinden yararlanmasını sağlar. Google Ad Manager ve AdMob envanterine teklif vermek için temel altyapıyı kullanıyor.

Open Bidding'e katılmak için gerçek zamanlı teklif verme özelliğini yapılandırın ve teklif verene teklif veren bir Google Ads hesabı oluşturup test amacıyla Google hesap yöneticinize ileterek doğru şekilde çalıştığından emin olun. Bu, bir defalık bir işlemdir.

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

Open Bidding entegrasyonunuz "gizli modda" kalabilir olana kadar tüm yayıncıların isteklerini kabul etmesini sağlar. Gizli moddayken şunları yapabilirsiniz: hesap ekibinizle birlikte çalışarak belirli yayıncılarla bağlantı kurabilir ve siz ölçeklendirmeye hazır oluncaya kadar bu duruma getirin. Gizli moddan çıktıktan sonra hesabı tüm yayıncılar tarafından görülebilir.

Desteklenen protokoller ve kodlama

Google'ın OpenRTB uygulamasını kullanmanızı öneririz. Google GZT protokolü desteği sonlandırıldı. Daha fazla bilgi edinin.

Google OpenRTB uygulaması

Google'ın OpenRTB uygulaması, OpenRTB spesifikasyonu ve Authorized Buyers ve Open Bidding için uzantılar ekler Teklife özgü işlevler. Google'ın OpenRTB hakkında daha fazla bilgi edinmek için uygulama ve tescilli Authorized Buyers alıcılarıyla Gerçek Zamanlı Teklif Verme protokolü için OpenRTB Kılavuzu'na bakın.

Gelen teklif isteklerini yönetme

Open Bidding, Authorized Buyers ile aynı BidRequest yapısını kullanır Alıcılar ancak bazı alanlar yalnızca Open Bidding katılımcılarına gönderilir. İstek Kılavuzu'na göz atın. başlıklı makaleyi inceleyin.

Teklif vererek yanıtla

Open Bidding de buna benzer bir BidResponse yapısı kullanır Open Bidding'e gönderilen bazı özel alanlar ile birlikte katılımcı sayısı. Yanıt Kılavuzu'na bakın başlıklı makalemizi incelemenizi öneririz.

Teklif vermek istediğiniz tercih edilen reklam biçimine bağlı olarak, önemli farklılıklar gösterebilmektedir. Verilerinizi yapılandırmanıza yardımcı olacak aşağıdaki kılavuzları teklif verenin yaygın reklam biçimlerine yönelik tekliflerle yanıt vermesi için başvurun:

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

İsteğe bağlı impression_tracking_url kullanmanız önemle tavsiye edilir. Google'ın faturalandırılabilir kaydı ne zaman kaydettiğiyle ilgili gösterim düzeyinde verilerin alınması için kullanılan alan ücret alınacak etkinliklerdir. OpenRTB için bu, BidResponse.seatbid[].bid[].ext.impression_tracking_url olarak açığa çıkarılıyor. ve Google'da BidResponse.ad[].impression_tracking_url olarak protokolü.

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

Bu özelliğin amacı, belirli bir kullanıcının belirli bir zamanda gösterim sayısı, exchange'in ödeme yapan gösterim sayısıyla Google Görüntülü Reklam Ağı ve Video 360 (DV360).

Open tarafından sunulan DV360 gösterimlerini doğru şekilde tanımlayarak Teklif verdiğinizde Google, reklam spam'i ve faturalandırılabilir etkinlik tutarsızlıkları için düzenleme yapabilir ödeme aldığınız gösterimler için faturalandırılmadığınızdan emin olun.

Teklif isteklerinde google_query_id parametresini uygulama

Reklam gruplarının genelinde geçerli gösterim sayısının Google talebi, google_query_id şuradan dağıtılmalıdır: olduğu gibi Google talep platformlarına yönelik Open Bidding istekleri. Bu, Google Ads'in Open Bidding tutarsızlık çözümü. Projenin beklenen mevcut uzunluğu google_query_id yaklaşık 64 bayttır.

Teklif yanıtlarında üçüncü_taraf_alıcı_tokenini uygulama

Google talep platformunun bir exchange'in dahili açık artırmada, third_party_buyer_token alanı olduğu gibi dağıtılmalıdır Open Bidding gösterimi aracılığıyla teklif yanıtını geri alır. Bu da Google yayıncı platformlarını kullanarak, açık artırmadan kazanan teklifin Teklifli sistem iş ortağı, aynı gösterim için Google talebi adına verilen bir tekliftir fırsat. Bu alanın mevcut maksimum uzunluğunun 150 olması bekleniyor bayt olarak kabul edilir.

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

Tutarsızlık çözümünün, Yeşil Ofis’in tekliflerine Google talebi, Google reklam öğesi işaretlemesini yaymak için bir exchange gerekir sarmalayıcı olmadan (komut dosyası etiketleri, iframe'ler veya VAST sarmalayıcıları) kullanabilirsiniz. Nedeni: ve tutarsızlığın çözümüyle ilişkili olan, Google talep platformları tarafından sayılmayan teklifli sistem gösterimleri. Google reklam öğesi işaretlemesini düzenli olarak kontrol ederek third_party_buyer_token, Google talebi adına gönderildi ve değil.

HTML5 reklam öğeleri

Google HTML işaretlemesini olduğu gibi göndermek için bir exchange gereklidir normal olarak geçerli olan exchange'e özgü makro genişletmeleri ve isteğe bağlı olarak normal olarak eklediği fazladan izleyici pikselleri veya komut dosyaları.

Bir exchange Google'ı sarmalarsa Google, tutarsızlık çözümünü uygulayamaz HTML reklam öğesini bir etikete (script, iframe veya diğer teknikleriyle) uyumlu bir şekilde çalışır.

Bu örnekte, teklif yanıtındaki Google (DV360) reklam öğesi HTML kodu kelimesi kelimesine aktarılır, başına ve sonuna exchange'e özel bir HTML eklenir girin.

<!-- 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 -->

Bu örnekte, Google tarafından döndürülen HTML kodu reklam öğesi kodu karartılmıştır. bir exchange tarafından sağlanan teklif yanıtında yer alır ve göz önünde bulundurun. Google tarafından sağlanan HTML kodu, tarayıcıda exchange'in sağladığı sarmalayıcıyı kullanabilirsiniz.

<!-- 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ıkların çözülmesine uygun olmak için bir exchange'in VASTTagURI alanını doldurmak için aşağıdaki yaklaşımlardan birini kullanın: VAST XML yanıtları:

  1. Bir exchange, VASTTagURI öğesinin değerini Google tarafından adm alanında döndürülen VAST XML belgesinin bir bölümü olduğu gibi kullanın.
  2. DV360, nurl alanını bir VAST dokümanı URL'siyle doldurabilir. teklif yanıtlarının sayısını belirler. Ardından, bir exchange Google'ın (DV360) VASTTagURI içinde yanıt verdiği nurl etiketi ile birlikte, exchange'e özel makrolar gerektiğinde normal bir şekilde genişletilir.

Exchange, VAST içinde ek VAST etkinliği ve hata izleyicileri belirtebilir XML dokümanı.

Bu örnekte, teklif yanıtındaki Google (DV360) reklam öğesi VAST URI'si öğesi, tam olarak geçirilir (bir exchange, belirli VAST etkinliğini ekler ve hata izleyiciler.

<!-- 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 -->

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

<!-- 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, Tercih Edilen Anlaşmalar (PD), Özel Açık Artırmalar (PA) dönüşümünü artırdı. Anlaşma kimliği ve türü aşağıdaki gibi belirtilmelidir:

Alan Açıklama
OpenRTB protokolü:
BidResponse.seatbid[].bid[].dealid

Google protokolü:
BidResponse.ad[].adslot[].exchange_deal_id		 Teklifle ilişkili ve yayıncılara bildirilen exchange'in ad alanındaki anlaşma kimliği. Bu, rastgele bir UTF8 metnidir ve 64 bayttan büyük olmamalıdır.
OpenRTB protokolü:
BidResponse.seatbid[].bid[].ext.exchange_deal_type

Google protokolü:
BidResponse.ad[].adslot[].exchange_deal_type		 Anlaşma türünü belirten bir sıralama. Bu, yayıncılara bildirilir ve anlaşmanın nasıl yapılacağını etkiler kabul edilir. 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 OpenRTB 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"
    }
  }
}

Google tarafından barındırılan eşleşme tablolarını kullanın Open Bidding katılımcıları, aşağıdaki seçeneklerden en uygun olanlarını kullanabilir gereksinimleri:

  • Çerez Eşleştirme: Alıcı veya exchange tarafından başlatılan eşleştirme Daha fazla bilgi
  • Piksel Eşleştirme: Google tarafından başlatılan eşleştirme Daha fazla bilgi
  • Çerez Eşleştirme Desteği: Teklif verenlerle exchange tarafından başlatılan eşleştirme Daha fazla bilgi
ziyaret edin.

Gecikmeyi yönetme

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

Çok sayıda teklif isteği alan büyük exchange'ler Gecikmeyi ve gecikmeyi azaltmak için Google ile eşleme anlaşması yapma değişkenlik gösterebilir. Eşleme hakkında daha fazla bilgi edinin.

Tıklama makroları

Tıklama makrolarını uygulamanızı öneririz. Bunlar, raporlamaya izin verir. tıklamaları ve tıklama türetilmiş metrikleri içeren, sizin için geçerli olan çeşitli kaynakları da kullanabilirsiniz. Daha fazla bilgi edinin.

API'ler

Open Bidding müşterileri Authorized Buyers REST API'lerini kullanabilir erişebilir. Yalnızca şu API kaynaklarına şu anda erişilebilir:

Hesabınızı yapılandırmak için Teknik Hesap Yöneticinizle iletişime geçebilirsiniz API'lere erişmek ve API oluşturmak için gereken hesap kimliğini almak için çağrısının en iyi yolu. Bu API'lerin kullanımıyla ilgili teknik destek almak için adxbuyerapi-support@google.com destek takma adı.

Ek kaynaklar

Örnek teklif istekleri ve yanıtları

Desteklenen tüm protokoller için teklif isteği ve yanıt örnekleri şu adreste bulunabilir: İstek ve Yanıt kılavuzlar.