Open Bidding Entegrasyonunu Yapılandırma

Open Bidding, exchange'lerin ve diğer alıcıların Google Ad Manager ve AdMob envanterine teklif vermek için 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ıza göre ö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 gelen istekleri kabul etmeye hazır olana kadar "özel modda" kalabilir. Gizli moddayken, belirli yayıncılarla bağlantı kurmak için hesap ekibinizle birlikte çalışabilir ve ölçeklendirmeye hazır olana kadar bu durumda kalabilirsiniz. Özel 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

Google OpenRTB uygulaması

Google'ın OpenRTB uygulaması, OpenRTB spesifikasyonunda bulunan 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.

Teklifle yanıt verme

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

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

Farklılıkları azaltmak için gösterimleri izleme

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

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

Bu özellik, bir borsanın faturalandırdığı gösterim sayısının Google Display & Video 360 (DV360) tarafından ödenen gösterim sayısıyla eşleşmesini sağlamayı amaçlar.

Google, Open Bidding tarafından sunulan DV360 gösterimlerini doğru şekilde tanımlayarak reklam spam'i ve faturalandırılabilir etkinliklerdeki tutarsızlıklar için gerekli düzenlemeleri yapabilir. Böylece, ödeme almadığınız gösterimler için faturalandırılmazsınız.

Teklif isteklerinde google_query_id'yi yayma

Geçerli gösterim sayısının Google talebiyle eşleşmesini sağlamak için google_query_id, Open Bidding isteklerinden Google talep platformlarına olduğu gibi yayılmalıdır. Bu, Open Bidding tutarsızlık çözümünün ön koşuludur. google_query_id için beklenen mevcut uzunluk yaklaşık 64 bayttır.

Teklif yanıtlarında third_party_buyer_token değerini yayma

Google talep platformunun bir exchange'in dahili açık artırmasını kazanması durumunda, third_party_buyer_token alanı, Open Bidding gösterimi aracılığıyla teklif yanıtında olduğu gibi yayılmalıdır. Bu, Google yayıncı platformlarının bir Open Bidding iş ortağından gelen kazanan teklifin 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ı beklenmektedir.

Google reklam öğesi biçimlendirmesini teklif yanıtlarında olduğu gibi iletme

Uyuşmazlı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ı olmadan (komut dosyası etiketleri, iFrame'ler veya VAST sarmalayıcılar) yayması gerekir. Uyuşmazlık çözümü nedeniyle Google, Google talebi platformları tarafından sayılmayan bu Açık Artırma gösterimlerini geçersiz kılabilir ve bunlar için fatura düzenlemeyebilir. Google, third_party_buyer_token ile tekliflerin başka bir alıcı adına değil, Google talebi adına gönderildiğini doğrulamak için reklam öğesi işaretlemelerini düzenli olarak kontrol eder.

HTML5 reklam öğeleri

Google HTML işaretlemesini olduğu gibi göndermek için bir borsa gereklidir. Bu işaretleme, normalde geçerli olan borsaya özgü makro genişletmeleri ve isteğe bağlı olarak, borsanın normalde eklediği ekstra izleyici piksellerini veya komut dosyalarını içerir.

Bir borsa, Google HTML reklam öğesini Google HTML kodunu yükleyen veya oluşturmak için kullanılan bir etikete (script, iframe veya diğer teknikler) sarmalarsa Google, uyuşmazlık çözümünü uygulayamaz.

VAST video reklam öğeleri

Uyuşmazlık çözümüne uygun olması için borsanın, VAST XML yanıtlarında VASTTagURI değerini doldurmak üzere aşağıdaki yaklaşımlardan birini kullanması gerekir:

  1. Bir borsa, VASTTagURI öğesinin değerini, Google tarafından BidResponse.seatbid.bid.adm alanında döndürülen VAST XML belgesinin bir parçası olarak, normalde geçerli olan borsaya özgü makro genişletmelerle birlikte olduğu gibi koruyabilir.
  2. DV360, bir borsaya verilen teklif yanıtlarında BidResponse.seatbid.bid.adm.nurl alanını VAST dokümanı URL'siyle doldurabilir. Borsa daha sonra bu değeri VASTTagURI etiketiyle iletebilir. Borsaya özel makrolar gerektiğinde normal şekilde genişletilir.

Gerekirse bir borsa, VAST XML belgesinde ek VAST etkinliği ve hata izleyicileri belirtebilir.

Fırsatlar

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

Alan Açıklama
BidResponse.seatbid.bid.dealid Teklifle ilişkili olan ve yayıncılara bildirilen, exchange'in ad alanındaki anlaşma kimliği. Bu, rastgele bir UTF8 metnidir ve 64 bayttan uzun olmamalı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"
    }
  }
}

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

  • Çerez eşleştirme: Alıcı veya borsa 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ımcısı: Borsa tarafından başlatılan, teklif verenlerle eşleştirme Daha fazla bilgi

Gecikmeyi yönetme

Gelen teklif isteklerine yanıt verirken teklif veren uç noktalarınızın sahip olacağı gecikmeyi tahmin etmek için Eşleme Kılavuzu'nda bulunan ticaret yerlerini kullanmanız gerekir.

Yüksek hacimli teklif istekleri alan büyük borsalar, gecikmeyi ve gecikme değişkenliğini azaltmak için Google ile eşleme düzenlemesi yapmayı düşünebilir. Eşleme hakkında daha fazla bilgi edinin.

Tıklama makroları

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

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:

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 adxbuyerapi-support@google.com destek takma adıyla iletişime geçebilirsiniz.

Ek kaynaklar

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