Programatik Garantili Anlaşmalar

Programatik Garantili Anlaşmalar'da satıcılarla sabit fiyatla satın alacağınız gösterim sayısı için pazarlık yaparsınız. Programatik Garantili Anlaşma teklifini kabul ederseniz satıcının envanterini görüşülen şartlara göre satın alma taahhüdü vermiş olursunuz. Taahhütleriniz ve uygunluğunuzu izleme araçları hakkında daha fazla bilgi edinmek için Programatik Garantili HDS çerçevesinin açıklandığı Yardım Merkezi makalesini inceleyin.

Oluştur

Programatik Garantili Anlaşmalar, pazarlıklar bir teklif isteği (RFP) ile başladığında oluşturulur. buyers.proposals.sendRfp ile bir satıcıya RFP göndererek pazarlık başlatabilirsiniz. Sonuçta elde edilen teklifin Programatik Garantili Anlaşmaya yönelik olması için RFP'nin programmaticGuaranteedTerms içermesi gerekir. Satıcılar size bir RFP gönderebilir ve bu RFP, Pazar Yeri API'sinde teklif olarak görünür. Oluşturulduktan sonra anlaşmanın teklifini buyers.proposals.list ile bulabilirsiniz. Böylece siz ve satıcı arasında pazarlık başlayabilir.

Gözden geçirin

Programatik Garantili Anlaşma teklifi oluşturulduktan sonra, her iki taraf da memnun olana veya teklif iptal edilene kadar teklifi ve karşılık gelen anlaşmasını ayarlayarak satıcıyla pazarlık yapabilirsiniz. Başarılı bir müzakerede aşağıdakilerden herhangi birini yapabilirsiniz:

  • Teklif veya anlaşmada yapılan değişiklikler için anket: Teklifte veya teklifin ilgili anlaşmasında her değişiklik yapıldığında proposalRevision artar. Satıcının teklifinizi kabul ettiğini veya karşı teklifle yanıt verdiğini tespit etmek için bunu kullanabilirsiniz.
  • Teklif veya anlaşma: Teklifinizi değiştirin veya satıcıya karşı teklif gönderin. Bu işlem, proposalRevision değerini artırır.
  • Satıcıyla iletişim kurun: Teklifler, alıcılar ve satıcılar tarafından görülebilen notlar içerir. Örneğin, bir teklifte veya anlaşmada yaptığınız değişiklik hakkında bağlam bilgisi sağlamak için not ekleyebilirsiniz.

Sonlandır ve yayına hazırla

Bir tekliften memnunsanız ve state değeri BUYER_ACCEPTANCE_REQUESTED ise teklifi kabul edebilirsiniz. Bu işlem, anlaşmayı kesinleştirip flightStartTime tarihinde yayınlanmaya başlar.

Anlaşmanın yalnızca reklam öğeleriniz hazır olduğunda yayınlanmaya başladığından emin olmak için Teknik Hesap Yöneticinizle iletişime geçerek Programatik Garantili Anlaşmalarınızı bu varsayılan davranışı devre dışı bırakmanızı ve bunun yerine, yayınlanmaya hazır olduklarında manuel olarak sinyal vermenizi öneririz. Aşağıda, Programatik Garantili Anlaşmalarınız yayınlanmaya hazır olduğunda manuel olarak işaret ettiğiniz örnek bir iş akışı verilmiştir:

  • Satıcıyla teklif için pazarlık yapın
  • Reklam öğelerini incelemeye göndermek için Gerçek Zamanlı Teklif Verme API'sini kullanın: Yerleştirmeyi düşündüğünüz reklam öğeleri incelenmeli ve anlaşmalarda kullanılmak üzere onaylanmalıdır.
  • Teklifi kabul etme: Teklif kabul edildikten sonra kabul edilen anlaşmalar, kesinleşmiş anlaşmalara yansıtılır.
  • Gerçek Zamanlı Teklif Verme API'sini daha önce gönderilen reklam öğelerini almak ve bunların Gerçek Zamanlı Teklif Verme'deki anlaşmalarda kullanılan tekliflerde kullanılmak üzere onaylandığını doğrulamak için kullanın: Reklam öğelerinin onaylandığını ve gelen anlaşma teklif isteklerine yanıt olarak yerleştirilebileceğini doğrulamak için dealsPolicyCompliance öğesini görüntüleyin.
    • Reklam öğesi onaylanmadıysa reddedilme nedenini belirlemek için konuları inceleyin. Reklam öğesini gerektiği gibi ayarlayın ve tüm sorunlar çözülene kadar inceleme sürecini başlatmak için reklam öğesine yama uygulayın.
  • Kesinleşmiş anlaşmada kullanılacak tüm reklam öğelerini ekleyin: Anlaşmayı yayınlamaya başlamadan önce reklam öğelerini birlikte kullanmayı düşündüğünüz anlaşmaya eklemenizi öneririz.
  • Anlaşmanın yayınlanmaya hazır olduğunu manuel olarak belirtmek: Anlaşma yayınlanmaya hazır olduğunda yapılandırılmış flightStartTime'daki anlaşma için teklif istekleri almaya başlayacaksınız. Bu istekler, flightEndTime veya impressionCap değerine ulaşılana kadar devam edecek.

Yeniden pazarlık yap

Anlaşma kesinleştikten sonra siz veya satıcı teklifi veya anlaşmalarını değiştirerek yeniden pazarlık başlatabilirsiniz. Yeniden pazarlık sırasında finalizedDeals kaynağı önceki sözleşmeyi yansıtır ve mümkünse buna göre hizmet vermeye devam eder. Bunun yerine deals kaynağı, ilk müzakereye benzer şekilde devam edecek olan yeniden pazarlık sürecinin mevcut durumunu yansıtır.

Yeniden pazarlık yapılan anlaşma hem siz hem de satıcı tarafından kabul edilirse orijinal kesinleşmiş anlaşmanın üzerine yazılır ve yeni sözleşmeye göre yayınlanır. Aksi takdirde, anlaşma iptal edilirse yeniden pazarlık başlamadan önceki durumuna döner.

Programatik Garantili Anlaşmalar için gösterimler için teklif verme

Programatik Garantili Anlaşma yayınlanmaya başladığında, Gerçek Zamanlı Teklif Verme entegrasyonunuz bu anlaşma için teklif istekleri alır ve anlaşmanın şartlarına göre (örneğin, belirli bir süre boyunca belirli sayıda gösterim için belirli bir fiyatla) teklif vermelidir.

Belirli bir teklif isteği birden fazla PG anlaşması içerebilir. Böyle bir durumda, istekte gönderilen her anlaşma kimliği için yanıt vermeniz beklenir. Programatik Garantili Anlaşmalar ile doğrudan alakalı alanlar aşağıdakileri içerir:

Google protokolü OpenRTB protokolü Açıklama
BidRequest.adslot.matching_ad_data.direct_deal.direct_deal_id BidRequest.imp.pmp.deals.id Anlaşmanın benzersiz tanımlayıcısı. Bu, Marketplace API tarafından döndürülen anlaşmanın kaynak kimliğiyle eşdeğer olacaktır.
BidRequest.adslot.matching_ad_data.direct_deal.deal_type BidRequest.imp.pmp.deals.ext.deal_type PROGRAMMATIC_GUARANTEED olarak ayarlanacak açık artırma türü veya OpenRTB JSON için "3" değeri.
BidRequest.adslot.matching_ad_data.direct_deal.fixed_cpm_micros BidRequest.imp.pmp.deals.bidfloor Alıcı ve satıcı tarafından kabul edilen anlaşmanın BGBM'sine eşdeğerdir. Pazar Yeri API'sinde fixedPrice olarak görünür. Programatik Garantili Anlaşmalar için bu, teklif yanıtında belirtilen tüm değeri geçersiz kılar.
BidRequest.adslot.matching_ad_data.direct_deal.publisher_blocks_overridden BidRequest.imp.pmp.deals.ext.publisher_blocks_overridden Programatik Garantili Anlaşmalar için her zaman true. Bu, hariç tutulan kategorilere izin verildiği anlamına gelir.
BidRequest.adslot.matching_ad_data.direct_deal.must_bid BidRequest.imp.pmp.deals.ext.must_bid Alıcıların anlaşma için teklif vermesinin gerekip gerekmediğini belirtir. Örneğin, anlaşma programın ilerisindeyse bu değer Yanlış olarak ayarlanır ve teklif verme isteğe bağlıdır. Aksi takdirde teklif verme gerekir. Diğer bir deyişle, teklif vermeme, anlaşma yayınını ve envanter kullanılabilirliğini olumsuz şekilde etkileyebilir.

Sunumu duraklatma ve devam ettirme

Kesinleşmiş Programatik Garantili anlaşmaya geçici olarak teklif veremiyorsanız duraklatmak için buyers.finalizedDeals.pause yöntemini kullanmanız gerekir. Örneğin, reklam öğeniz başlangıçta onaylanmışsa ancak onaylanmadıysa ve sonuç olarak yeniden gönderilmesi gerekiyorsa bunu yapabilirsiniz. Bu durum, anlaşma için teklif istekleri almanızı engellese de anlaşmanın şartları olarak pazarlık yapılan tüm yükümlülükleri yerine getirmeniz gerekeceğini unutmayın.

Kesinleşmiş anlaşmayı yayınlamaya devam etmek için buyers.finalizedDeals.resume kullanabilirsiniz.