API İş Akışları

Bu kılavuzda, Fırsat Senkronizasyonu API'si kullanılarak fırsat oluşturma, iptal etme, alma, güncelleme ve fırsat görüşmesi yapma ile ilgili yaygın API iş akışları açıklanmaktadır.

Fırsat oluşturma

  1. externalDealId filtresiyle LIST ürünleri çağırarak bir ürünün daha önce oluşturulup oluşturulmadığını kontrol edin. Filtre dizesinde hem camelCase externalDealId hem de snake_case external_deal_id desteklenir. external_deal_id tüm ürünler arasında benzersiz olmalıdır.

    GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*/orders/*}/products?filter=externalDealId="{external_deal_id}"

  2. Create Order. Sipariş adı DV360 tarafından oluşturulur. Bu kimliği gelecekte almak üzere sisteminizde saklamanızı öneririz.

  3. Sipariş altında ürün oluşturun. Ürün adı DV360 tarafından oluşturulur. Bu kimliği gelecekte almak üzere sisteminizde saklamanızı öneririz.

Alternatif olarak, external_deal_id numaralı telefondan LIST'i arayabilirsiniz. Kaynak adı hem sipariş kimliğini hem de ürün kimliğini içerdiğinden üst siparişi tanımlayabilirsiniz.

Fırsatı iptal etme

  1. Sipariş durumunu İPTAL EDİLDİ olarak güncelleyin. İptal işlemi yalnızca sipariş henüz kabul edilmediyse desteklenir. İptal edildi, nihai bir durumdur. İptal edilen siparişler yeniden etkinleştirilemez. Sipariş herhangi bir ürün içeriyorsa external_deal_id yeniden kullanılamaz.

Fırsat ayrıntılarını alma

  1. Sipariş ayrıntılarını alma. Durum, kullanıcı siparişi kabul ettiğinde, arşivlediğinde veya iptal ettiğinde güncellenir.
  2. Ürün ayrıntılarını öğrenin.

Fırsat listesi alma

  1. Kabul edilen veya kabul edilmeyi bekleyen tüm siparişleri almak için durum filtresiyle LİSTELE'yi tıklayın.
  2. external_deal_id filtresiyle ürünleri LİSTELEYİN.
  3. Bir siparişteki tüm ürünleri LİSTELEYİN.

Fırsatı güncelleme

  1. Güncelleme Yayıncı iletişim bilgileri için sipariş.
    1. name güncellenemiyor (updateMask içinde ayarlanamıyor). Durum yalnızca API kullanılarak CANCELED olarak ayarlanabilir.
    2. partner_id güncellenemiyor.
  2. Güncelleme Belirli bir anlaşma koşulu için ürün güncellemesi.
    1. name, externalDealId, transactionType, pricingType ve updateTime güncellenemez.
    2. displayName güncellenirken kullanıcının yeniden kabul etmesi gerekmez.
    3. rateDetails veya creativeConfig güncellendiğinde üst siparişin durumu PENDING_ACCEPTANCE olarak değişir. DV360 reklamverenlerinden, önceki Sipariş kabul edilmiş olsa bile Pazarlıklar sayfasında yeni şartları kabul etmeleri istenir.

Kullanıcının fırsatı kabul edip etmediğini kontrol edin

  1. İlgili Sipariş Adı'nı biliyorsanız Get Order kullanın. status alanını kontrol edin.
  2. Sipariş Adı izlenmediyse: Ürünleri external_deal_id filtresiyle listeleyin, Sipariş Adı'nı Ürün Adı'ndan belirleyin, ve ardından Get Order'ı çağırın. status alanını kontrol edin.

Kullanıcının anlaşmayı yapılandırıp yapılandırmadığını kontrol edin (yalnızca Programatik Garantili)

  1. Get Inventory Source (Envanter Kaynağını Alma). Kaynak adı: exchanges/{exchangeId}/inventorysources/{external_deal_id}. Buyer Status'u (Alıcı Durumu) kontrol edin.
    1. Rezervasyon fırsatları:
      1. BUYER_STATUS_ACTIVE: Anlaşma kabul edilmiş ve yapılandırılmıştır. DV360, anlaşma şartlarına uygun teklif istekleri aldığında anlaşma harcama yapmaya başlar. Anlaşma yapılandırması sırasında otomatik olarak bir satır öğesi oluşturulur. Ayrıntılar için Fırsat Yapılandırması'na bakın.
      2. BUYER_STATUS_PENDING: Sipariş kabul edildi ancak fırsat henüz yapılandırılmadı. Bu durumda harcama yapılmaz.
      3. BUYER_STATUS_PAUSED: Anlaşma, reklamveren tarafından duraklatıldı. Bu durumda harcama yapılmaz.
    2. Rezervasyon gerektirmeyen fırsatlar:
      1. BUYER_STATUS_ACTIVE: Anlaşma kabul edildi. Anlaşma, DV360 eşleşen teklif istekleri aldığında, etkin bir satır öğesi anlaşmayı hedeflediğinde ve teklif istekleri satır öğesi hedefleme ölçütleriyle eşleştiğinde harcama yapmaya başlar. Ayrıntılar için Satır Öğeleri bölümüne bakın. (Not: Bir fırsatın satır öğeleri tarafından hedeflenip hedeflenmediğini sorgulamak için Seller API yoktur).
      2. BUYER_STATUS_PENDING: Rezervasyon gerektirmeyen fırsatlar için geçerli değildir.
      3. BUYER_STATUS_PAUSED: Anlaşma, reklamveren tarafından açıkça duraklatılmıştır. Bu durumda harcama yapılmaz.

Kabul edildikten sonra bir anlaşmayı duraklatma ve devam ettirme

  1. Güncelle Envanter Kaynağı Satıcı Durumu.
    1. Duraklatma veya duraklatmayı kaldırma, anlaşma yayınını durdurmaz. Bir satıcı anlaşmayı duraklattığında, harcama yapılmayan anlaşmalarla ilgili sorunları gidermeye yardımcı olmak için DV360 kullanıcı arayüzünde reklamverenlere bilgilendirici bir mesaj gösterilir.

Yeniden pazarlık (kabul edildikten sonra anlaşmayı güncelleme)

Yeniden pazarlık, bir anlaşma alıcı tarafından kabul edildikten sonra yapılan güncellemeleri ifade eder. Bu sayede exchange'ler ve alıcılar, mevcut anlaşmalardaki şartları ayarlayabilir. Örneğin, bir borsa, kabul edilen bir anlaşmanın yayın bitiş zamanının yanlış olduğunu tespit edebilir. Borsa, anlaşma yayınlanmaya başlamadan önce DV360 alıcılarına güncellemeler göndermek için Product Patch'i kullanabilir.

İzin verilen ve verilmeyen değişiklikler

Anlaşma görüşmeleri ve yeniden görüşme kurallarının ayrıntılı dökümü için Display & Video 360 Yardım Merkezi makalelerine bakın:

Önceki
Varlık Yapısı
Sonraki
Beta Süreci