Fırsat Senkronizasyonu API'si hakkında SSS

Display & Video 360 Deal Sync API ile entegrasyon hakkında sık sorulan soruların yanıtlarını bulun.

S: Exchange kimliğim nedir?

Y: Exchange kimliği, kimlik doğrulama kurulumu sırasında Display & Video 360 ekibi tarafından atanır.

S: Sipariş ve ürün hiyerarşisinin amacı nedir?

Y: Bu hiyerarşi, yayıncıların ve reklamverenlerin birden fazla anlaşma üzerinde görüşme yapmasına ve bunları tek bir görüşme nesnesi olarak birlikte göndermesine olanak tanır. Kısıtlamalar vardır: Bir sipariş kapsamındaki tüm ürünler aynı işlem türüne ve fiyatlandırma türüne sahip olmalıdır. Her zaman 1 sipariş, 1 ürün kurulumu kullanabilirsiniz.

S: TÜM reklamverenler için kullanılabilen bir anlaşma türü var mı?

Y: Anlaşma Senkronizasyon API'si, özel anlaşmalar için tasarlanmıştır. Tüm reklamverenler için seçilmiş herkese açık anlaşmalar hakkında bilgi edinmek istiyorsanız Açık Artırma Paketleri (Envanter Paketleri) başlıklı makaleyi inceleyin.

S: Bir fırsatın bitiş tarihi yoksa ne olur?

Y: Bitiş tarihi gereklidir. Bu nedenle, gelecekteki bir tarihi ayarlayabilirsiniz. İzin verilen maksimum yıl 2036'dır. Bitiş tarihleri daha sonra güncellenebilir veya uzatılabilir.

S: dimensionCreativeConfig alanı birden fazla boyuta izin veriyor mu?

Y: Evet, ancak ürün başına yalnızca tek bir reklam öğesi türüne izin verilir.

S: Doğal reklam öğeleri, Programatik Garantili (PG) anlaşmalarda destekleniyor mu?

Y: Hayır. Rezervasyon (garantili) anlaşmalar, doğal reklam öğelerini desteklemez (CREATIVE_TYPE_NATIVE).

Yerel reklam öğelerini kabul eden Programatik Garantili anlaşmalar yayınlamak istiyorsanız Google temsilcinizle iletişime geçin.

S: Ayrılmış işlemler için açık artırma fiyatlandırmasını kabul ediyor musunuz?

Y: Hayır. Rezervasyon (garantili) anlaşmaları yalnızca sabit fiyatlandırmayı destekler.

S: Video Programatik Garantili (PG) anlaşmaları için süre gerekli mi?

Y: Hayır. Ayarlanmazsa süre varsayılan olarak ANY olur.

S: Herhangi bir sipariş durumu, anlaşmanın işlem yapmayı durdurmasına neden olur mu?

Y: Hayır. Sipariş tamamen bir pazarlık nesnesidir. Reklamveren siparişi kabul etmediği sürece değişiklikler reklam sunumu için geçerli olmaz.

S: Borsa bir güncelleme çağrısı gönderirse kabul edilen anlaşma ne olur?

Y: Anlaşma, daha önce kabul edilen şartlara göre yayınlanmaya devam eder. Reklamveren güncellenen şartları kabul ettiğinde anlaşma, yeni şartlarla yayınlanmaya başlar.

S: Güncellenen şartlar henüz kabul edilmediyse anlaşma yayınlanmaya devam eder mi?

Y: BGBM'nin exchange tarafında zaten değiştiğini ve teklif isteğine yansıtıldığını varsayarsak:

1. Rezervasyon anlaşmaları için: Anlaşma, reklamveren tarafından yeniden kabul edilene kadar harcama yapmaz. Satır öğeleri anlaşma şartlarına göre oluşturulur. Güncellemeler, reklamveren tarafından kabul edilene kadar pazarlık aşamasında kalır.
2. Rezervasyon dışı anlaşmalar için: Yayın, anlaşmayı hedefleyen satır öğesi hedeflemeye bağlıdır. Teklif istekleri, bu anlaşmayı hedefleyen satır öğesi ölçütleriyle eşleşirse yayın devam eder.

S: Bir anlaşma kimliğini birden fazla anlaşmada yeniden kullanabilir miyiz?

Y: Hayır. external_deal_id, tüm ürünlerde benzersiz olmalıdır.

S: Bir anlaşmada birden fazla iş ortağı olabilir mi?

Y: Bir anlaşmayı birden fazla iş ortağıyla ilişkilendirmek istiyorsanız anlaşmanızı merkezi bir iş ortağına gönderin.

S: Bir anlaşmayla ilişkili ortak kimliği, anlaşma oluşturulduktan sonra değiştirilebilir mi?

Y: Hayır. Sipariş oluşturulduktan sonra iş ortağı değiştirilemez.

S: Bir siparişte birden fazla yayıncı adı destekleniyor mu?

Y: Yayıncı adı alanı, reklamveren için bilgilendirme amaçlı kullanılan bir dizedir. Virgülle ayrılmış birden fazla yayıncı adı belirtebilir veya "X Exchange'inden birden fazla yayıncı" ifadesini kullanabilirsiniz.

S: "İPTAL EDİLDİ" ve "ARŞİVLENDİ" sipariş durumları arasındaki fark nedir?

Y: Kullanıcılar siparişleri arşivleyebilir ve geri yükleyebilir. İptal edilen siparişler yeniden etkinleştirilemez veya iptal işlemi geri alınamaz.

S: "Anında Anlaşmalar" nedir?

Y: Anlık Fırsatlar, Seller API uç noktası kullanılarak yapılan ayrı bir entegrasyon çalışmasıdır. Anlık Fırsatlar'a özel özellikleri yoksayın. Bu özellikler, Fırsat Senkronizasyonu iş akışıyla ilgili değildir.

S: Kötü İstek (Bad Request) hatası alırsam neyi kontrol etmeliyim?

Y: Bu durumun birkaç yaygın nedeni vardır:

1. Tüm zorunlu alanların doldurulduğundan emin olmak için referans kılavuzuna bakın.
2. external_deal_id özelliğinin tüm ürünler arasında benzersiz olduğunu doğrulayın.
3. Rezervasyon fırsatlarında açık artırma fiyatı belirtilmediğinden emin olun.

Sorun devam ederse yanıt gövdesindeki ayrıntılı hata mesajlarını incelemek için isteği Postman gibi bir HTTP istemcisiyle test edin.

Önceki çözümlerden hiçbiri sorunu çözmezse Display & Video 360 Seller API destek ekibiyle iletişime geçin.