Marketplace API'sı

Genel bakış

Authorized Buyers Pazar Yeri API'si, alıcıların aşağıdakileri programatik olarak yönetmek için kullanabileceği bir kaynak koleksiyonudur:

  • Yayıncılarla yapılan görüşmeler
  • Açık artırma paketleri
  • Authorized Buyers Pazar Yeri kullanıcı arayüzüne müşteri erişimi

Bu kılavuzda Marketplace API tanıtılmakta ve Marketplace API kaynaklarının Authorized Buyers kullanıcı arayüzündeki Pazar Yeri özellikleriyle nasıl eşlendiği açıklanmaktadır.

Teklif verenler ve alıcılar

Marketplace API'si, Gerçek Zamanlı Teklif Verme API'sinin yapısıyla tutarlıdır. Her iki API de teklif veren ve alıcı işlemleri için kök düzeyinde kaynak olarak bidders ve buyers kullanır. Gerçek Zamanlı Teklif Verme ve Marketplace API'lerinin kaynak yollarında aynı teklif veren ve alıcı adlarını kullanabilirsiniz.

Müşteriler ve müşteri kullanıcılar

İstemciler ile müşteri kullanıcıları oluşturup yönetmek ve ajanslara veya reklamverenlere Authorized Buyers kullanıcı arayüzündeki Pazar Yeri sekmenize programatik olarak erişim izni vermek için Marketplace API'yi kullanabilirsiniz.

Client, Authorized Buyers hesabınızla ilişkili bir müşteriyi, ajansı veya reklamvereni temsil eder.

ClientUser, Client kapsamında kullanıcı arayüzü erişimine sahip olan belirli bir kişiyi temsil eder. İstemci kullanıcılar Marketplace API'ye erişemez. Müşteri kullanıcıların, hesabınızın Pazar Yeri sekmesine erişimi sınırlıdır. İstemci kullanıcı izinleri, üst Client öğesinde belirtilen role tarafından belirlenir.

Marketplace API'deki diğer kaynaklar, istemcilerin Clients kaynağında belirtilen ada göre referansta bulunur.

Authorized Buyers Pazar Yeri kullanıcı arayüzündeki müşteriler ve müşteri kullanıcılar hakkında daha fazla bilgi edinmek için aşağıdaki Yardım Merkezi makalelerine bakın:

Medya Planlayıcıları

Medya planlayıcısı, yayıncılarla anlaşmalar konusunda bağımsız olarak pazarlık yapan ve bir veya daha fazla teklif verenin kesinleşmiş anlaşmaları adına teklif vermesine olanak tanıyan bir ajans veya başka bir tüzel kişidir. Bu anlaşmalar, özel açık artırma veya tercih edilen anlaşmalardır ve kesinleştirilinceye kadar bunları görüntüleyemez veya bunlarla etkileşimde bulunamazsınız. Ardından, anlaşmalar bidders.finalizedDeals.list yanıtında görünür.

Belirli bir kesinleşmiş anlaşma için medya planlayıcısı tarafından pazarlık yapılıp yapılmadığını belirlemek için anlaşmanın mediaPlanner alanının doldurulup doldurulmadığını kontrol edebilirsiniz. Medya planlayıcıları, anlaşmada işlem yapmaya uygun olan TTP'ye özel lisans kimliklerinin listesini ayarlar. Bu liste, eligibleSeatIds alanıyla görüntülenebilir. Gerçek Zamanlı Teklif Verme teklif isteklerinde bu lisans kimlikleri, yayıncı tarafından ayarlanan izin verilenler veya engellenenler listelerinde görünebilir. Bu durum, tekliflerin açık artırmadan filtrelenip filtrelenmediğini belirler. Aşağıdaki BidRequest alanlarında görünebilirler:

  • OpenRTB protokolü
    • BidRequest.wseat
    • BidRequest.bseat
    • BidRequest.imp.pmp.deals.wseat
  • Google RTB protokolü
    • BidRequest.adslot.allowed_seat_ids
    • BidRequest.adslot.blocked_seat_ids
    • BidRequest.adslot.matching_ad_data.direct_deal.allowed_seat_ids

Açık artırma paketleri

Alıcı ve müşterileri açık artırma paketlerine abone olup aboneliğinden çıkarmak ve abone olduğunuz açık artırma paketlerini görüntülemek için Marketplace API'yi kullanabilirsiniz.

AuctionPackage, Pazar Yeri envanteri için hedefleme paketine benzer. Örneğin, bir açık artırma paketi, alıcının ticari çıkarlarıyla alakalı URL'lerden ve mobil uygulama kimlikleri koleksiyonunu hedefleyebilir.

Pazar Yeri API'si ile yeni açık artırma paketleri oluşturamazsınız. Açık artırma paketleri oluşturmak için Authorized Buyers Pazar Yeri kullanıcı arayüzünü kullanabilirsiniz. Marketplace API, açık artırma paketleriyle ilişkili belirli hedefleme bilgilerini içermez.

Açık artırma paketlerini diğer alıcılar ve müşterilerle paylaşabilir, Google veya diğer alıcılar tarafından oluşturulan açık artırma paketlerinin sizinle paylaşılmasını sağlayabilirsiniz.

Daha fazla bilgi için Açık artırma paketleri bölümüne bakın.

Yayıncı profilleri

Pazarlık yapabileceğiniz yayıncıların profillerini görüntülemek için Marketplace API'yi kullanabilirsiniz.

PublisherProfile, Marketplace API'de bir yayıncıyı temsil eder. Marketplace API'deki diğer kaynaklar, PublisherProfile dokümanlarında belirtilen ada sahip yayıncılara başvurur.

Yayıncı profillerinde, Authorized Buyers Pazar Yeri kullanıcı arayüzünün Keşif sekmesindeki Yayıncılar ile benzer bilgiler bulunur.

Daha fazla bilgi için Yayıncıları keşfetme bölümüne bakın.

Teklifler ve anlaşmalar

Pazar Yeri API'sini yayıncılarla anlaşmalar yapmak için kullanabilirsiniz. Anlaşmaları yönetmek için Marketplace API'yi kullanabileceğiniz bazı yöntemleri burada bulabilirsiniz:

Teklifler, alıcı veya müşteri ile yayıncı arasındaki bir veya daha fazla anlaşmanın en son pazarlık durumunu temsil eder ve Authorized Buyers Pazar Yeri kullanıcı arayüzünün Pazarlıklar sekmesine benzer.

Anlaşmalar, belirli bir teklif kapsamında pazarlık yapılan anlaşmanın en son şartlarını temsil eder ve Authorized Buyers Pazar Yeri kullanıcı arayüzünün belirli bir teklif için MEVCUT PAZARLIK etiketli anlaşmalar listesiyle karşılaştırılabilir.

Kesinleşmiş anlaşmalar, pazarlık aşamasını tamamlamış ve yayınlanmaya hazır olan anlaşmaları temsil eder. Buna, yayınlanmakta olan anlaşmalar dahildir. Kesinleşmiş anlaşmalar, Authorized Buyers Pazar Yeri kullanıcı arayüzünün Anlaşmalar sekmesine benzer.

Pazarlık yaptığınız anlaşmanın türüne bağlı olarak, Pazar Yeri API kaynakları arasında davranış farklı olabilir. Örneğin, alıcılar tüm anlaşma türleri için pazarlık başlatamaz. Pazarlıklar için Marketplace API uygulaması hakkında daha fazla bilgi edinmek için aşağıdaki kaynaklara bakın:

Authorized Buyers Pazar Yeri kullanıcı arayüzündeki pazarlıklar hakkında daha fazla bilgi edinmek için aşağıdakilere bakın: