API İş Akışları

Fırsat oluşturma

1. external_deal_id filtresiyle LIST ürünlerini kullanarak bir ürünün daha önce oluşturulup oluşturulmadığını kontrol edin. External_deal_id, tüm ürünlerde benzersiz olmalıdır.

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

2. Sipariş Oluştur'u tıklayın. Ad, DV3 tarafından oluşturulur. Bu kimliği ileride almak üzere sisteminizde bir yerde saklamanızı öneririz.

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

   Alternatif olarak, her zaman external_deal_id ile LIST komutunu kullanabilirsiniz. Ad alanı hem sipariş kimliğini hem de ürün kimliğini içerir. Bu sayede üst öğeyi kolayca tanımlayabilirsiniz.

Fırsatları iptal etme

1. Sipariş durumunu İptal Edildi olarak güncelleme Yalnızca sipariş kabul edilmediyse iptal etmeyi destekler. İptal edildi, son durumdur. İptal edilen sipariş yeniden etkinleştirilemez.

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

1. Sipariş ayrıntılarını öğrenme Kullanıcı siparişi Kabul Et, Arşivle veya İptal Et'tiğinde durum güncellenir.
2. Ürün ayrıntılarını öğrenin.

Fırsat listesi alma

1. Kabul edilen/kabul edilmesi beklenen tüm siparişleri almak için durum filtresiyle LİSTELE komutunu kullanın.
2. external_deal_id filtresiyle LIST ürünleri.
3. Bir siparişteki tüm ürünleri LİSTELEYİN.

Fırsat güncelleme

1. Yayıncı iletişim bilgileri için güncelleme emri.
   1. name, does not allow update(cannot be set in the field_mask). Durumun yalnızca API aracılığıyla İptal Edildi olarak ayarlanmasına izin verilir.
   2. partner_id, güncellemeye izin vermiyor.
2. Belirli bir fırsat süresi güncellemesi için ürünü güncelleyin.
   1. name, externalDealId, transactionType, pricingType, updateTime güncellenemez.
   2. displayName özelliğinin güncellenmesi için kullanıcının kabul etmesi gerekmez.
   3. Update rateDetails, creativeConfig, üst sipariş durumunu Onay Bekliyor olarak değiştirir. DV3 reklamverenlerinden, önceki Sipariş'in kabul edilip edilmediğine bakılmaksızın pazarlık sayfasında yeni şartı kabul etmeleri istenir.

Kullanıcının fırsatı kabul edip etmediğini görme

1. İlgili sipariş kimliğini biliyorsanız Get Order'ı (Siparişi Al) kullanın. Durum alanını kontrol edin.
2. Sipariş kimliği izlenmediyse: Ürünleri external_deal_id filtresiyle listeleyin, ürün adından sipariş adını öğrenin ve ardından Sipariş Al'ı kullanın. Durum alanını kontrol edin.

Kullanıcının fırsatı yapılandırıp yapılandırmadığını görme(yalnızca PG için)

1. Envanter kaynağını alın. Ad "exchanges/{exchangeId}/inventorysources/{external_deal_id}" şeklindedir. Alıcı Durumu'nu kontrol edin.
   1. Rezervasyon fırsatları
      1. BUYER_STATUS_ACTIVE, bir anlaşmanın kabul edildiği ve yapılandırıldığı anlamına gelir. DV3, anlaşma şartlarıyla eşleşen bir teklif isteği aldığında anlaşmanın bu durumda harcama yapması beklenir. Anlaşma yapılandırma adımında otomatik olarak bir satır öğesi oluşturulur. Daha fazla bilgi için Fırsat Yapılandırması başlıklı makaleyi inceleyin.
      2. BUYER_STATUS_PENDING, siparişin kabul edildiği ancak anlaşmanın henüz yapılandırılmadığı anlamına gelir. Bu durumda harcama yapılmaz.
      3. BUYER_STATUS_PAUSED, anlaşmanın reklamverenler tarafından açıkça duraklatıldığı anlamına gelir. Bu durumda harcama yapılmaz.
   2. Rezervasyon dışı fırsatlar
      1. BUYER_STATUS_ACTIVE, bir anlaşmanın kabul edildiği anlamına gelir. DV3, anlaşma şartlarıyla eşleşen bir teklif isteği aldığında VE bu anlaşmayı hedefleyen Etkin bir satır öğesi olduğunda VE teklif isteği, satır öğesi hedefleme ölçütleriyle eşleştiğinde anlaşmanın bu durumda harcama yapması beklenir. Daha fazla bilgi için satır öğesi bölümüne bakın.** Bir anlaşmanın satır öğeleri tarafından hedeflenip hedeflenmediğini sorgulamak için satıcı API'si YOKTUR. **
      2. BUYER_STATUS_PENDINGgeçerli değil.
      3. BUYER_STATUS_PAUSED, anlaşmanın reklamverenler tarafından açıkça duraklatıldığı anlamına gelir. Bu durumda harcama yapılmaz.

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

1. Envanter kaynağı satıcı durumunu güncelleyin.
   1. Duraklatma/devam ettirme, anlaşma yayınını etkilemez. Satıcının bir anlaşmayı duraklatması durumunda reklamverenlere yalnızca "Bilginize" şeklinde bir mesaj gösterilir. Bu, reklamverenin harcama yapılmayan bir anlaşmayla ilgili sorunları gidermesine yardımcı olur.

Yeniden pazarlık (Kabul ettikten 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 özellik, kabul edilen anlaşmalarda yeni değişiklikler yapmak için hem borsalar hem de alıcılar açısından çok faydalı olabilir. Örneğin, borsa, kabul edilen bir anlaşmanın bitiş zamanının doğru olmadığını tespit edebilir ve anlaşma henüz başlamadıysa güncellemeleri DV3 alıcılarına göndermek için DV3 Update Product'ı kullanabilir.

Hangi değişikliklere izin verildiği ve verilmediği.

startTime, endTime, rateDetails, creativeConfig gibi bazı kritik yayın alanları hariç tüm alanlarda değişiklik yapılmasına izin verilir. Bu kritik yayın alanlarıyla ilgili doğrulama işlemlerimiz vardır. Genel olarak, anlaşmanın başlangıç saati en az 1 gün sonraysa creativeConfig dışındaki bu alanlarda güncellemelere izin verilir. Yalnızca uçuşta olan ve başlangıç zamanı geçmişte, bitiş zamanı ise gelecekte olan anlaşmalar için artımlı güncellemelere izin verilir. Bitiş zamanı geçmiş olan tamamlanmış anlaşmalarda değişiklik yapılmasına izin verilmez. Örneğin, bir yıl önce tamamlanmış bir anlaşmanın rateDetails değerinin güncellenmesine izin verilmez. Bu gibi durumlarda DV3 Update Product, doğrulama hatası verir.