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 verme 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 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ırlandırma

Siz herhangi bir yayıncıdan gelen istekleri kabul etmeye hazır olana kadar Open Bidding entegrasyonunuz "gizli modda" kalabilir. Gizli moddayken, hesap ekibinizle birlikte çalışarak seçili yayıncılarla bağlantı kurabilir ve siz ölçeklendirmeye hazır olana kadar bu durumda kalabilirsiniz. Gizli moddan çıktıktan sonra, hesabınız tüm yayıncılar tarafından görülebilir.

Desteklenen protokoller ve kodlama

Open Bidding, özel Authorized Buyers ve OpenRTB gerçek zamanlı teklif verme GZT protokollerini kullanır. Daha fazla bilgi edinin.

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. Google'ın OpenRTB uygulaması ve bu uygulamanın özel Authorized Buyers Gerçek Zamanlı Teklif Verme protokolüyle ilişkisi hakkında 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 özel alanlar hakkında daha fazla bilgi edinmek için İstek Kılavuzu'na bakın.

Teklif Vererek Yanıt Verin

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

Teklif vermeyi düşündüğünüz 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çimlerine yönelik tekliflere yanıt verecek şekilde yapılandırmanıza yardımcı olacak aşağıdaki kılavuzları inceleyin:

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

Google'ın ücretlendirileceğiniz faturalandırılabilir etkinlikleri ne zaman kaydettiği ile ilgili gösterim düzeyinde verileri almak için isteğe bağlı impression_tracking_url alanını kullanmanız önemle tavsiye edilir. OpenRTB için bu, BidResponse.seatbid[].bid[].ext.impression_tracking_url ve Google protokolünde BidResponse.ad[].impression_tracking_url olarak gösterilir.

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

Bu özelliğin amacı, exchange'in faturalandırıldığı gösterim sayısının, Google Display & Video 360 (DV360) tarafından ödenen gösterim sayısıyla aynı olmasını sağlamaktır.

Google, Open Bidding tarafından yayınlanan DV360 gösterimlerini doğru şekilde belirleyerek, size ödeme yapılmayan 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üzeltebilir.

Teklif isteklerinde google_query_id parametresini yay

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 yayılmalıdır. Bu, Open Bidding tutarsızlık çözümü için bir ön koşuldur. Şu anda beklenen google_query_id uzunluğu yaklaşık 64 bayttır.

Teklif yanıtlarında üçüncü_ taraf_alıcı_jetonunu yay

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. Böylece Google yayıncı platformları, Open Bidding iş ortağından alınan kazanan teklifin aynı gösterim fırsatı için Google talebi adına bir teklif olduğunu belirleyebilir. Bu alanın şu anda maksimum uzunluğunun 150 bayt olması beklenir.

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

Tutarsızlık çözümünün Google talebinden gelen tekliflere uygulandığından emin olmak için bir exchange, Google reklam öğesi işaretlemesini sarmalayıcılar (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 Open Bidding gösterimlerini geçersiz kılabilir ve faturalandıramayabilir. Google, third_party_buyer_token ile tekliflerin başka bir alıcı adına değil, Google talebi adına gönderildiğini onaylamak için reklam öğesi işaretlemesini düzenli olarak kontrol eder.

HTML5 reklam öğeleri

Google HTML işaretlemesini olduğu gibi göndermek için bir exchange gereklidir. Normalde geçerli olan exchange'e özel makro genişletmeleri ve isteğe bağlı olarak, exchange'in normalde eklediği ekstra izleyici pikselleri veya komut dosyaları kullanılır.

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

VAST video reklam öğeleri

Tutarsızlık çözümüne uygun olmak için bir exchange'in, VAST XML yanıtlarında VASTTagURI alanını doldurmak üzere aşağıdaki yaklaşımlardan birini kullanması gerekir:

  1. Bir exchange, VASTTagURI öğesinin değerini, normalde uygulanan exchange'e özel makro genişletmeleri ile Google tarafından adm alanında döndürülen VAST XML dokümanının parçası olarak olduğu gibi koruyabilir.
  2. DV360, nurl alanını bir exchange'e verilen teklif yanıtlarında VAST dokümanı URL'siyle doldurabilir. Daha sonra bir exchange, Google'ın (DV360) VASTTagURI etiketinde yanıt verdiği nurl değerini iletebilir ve exchange'e özel makrolar gerektiğinde normal şekilde genişletilir.

Bir exchange, gerekirse 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 (PD), Özel Açık Artırmalar'ı (PA) kullanabilir. 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		 Exchange'in teklifle ilişkili ad alanındaki ve yayıncılara bildirilen 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 enum. Bu durum yayıncılara bildirilir ve anlaşmanın açık artırmada nasıl işleneceğini 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 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"
    }
  }
}

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

  • Ç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şleme Daha fazla bilgi.
  • Çerez Eşleştirme Desteği: Teklif verenleriyle exchange tarafından başlatılan eşleştirme Daha fazla bilgi.

Gecikmeyi yönetme

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

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

Tıklama makroları

Tıklama makrolarını uygulamanızı öneririz. Bunlar, hesabınız ve birlikte çalıştığınız yayıncılar için tıklamaları ve tıklamayla türetilmiş metrikleri içeren raporlamaya olanak tanır. Daha fazla bilgi edinin.

API'ler

Open Bidding müşterileri, sorun giderme açısından 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 ekibiyle 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.