Najczęstsze pytania dotyczące interfejsu Deal Sync API

P: Jaki jest mój identyfikator giełdy?

O: Identyfikator giełdy jest przypisywany przez DV3 podczas konfiguracji uwierzytelniania.

Pyt.: Jak wygląda hierarchia zamówień i produktów?

O: Ta funkcja jest przeznaczona głównie dla wydawców i reklamodawców, którzy chcą negocjować wiele umów i przesyłać je jako jeden obiekt negocjacji. Ma jednak ograniczenia, które wymagają, aby wszystkie produkty w zamówieniu były tego samego typu transakcji i typu cen.** Zawsze możesz skonfigurować 1 zamówienie na 1 zestaw produktów. **

P: Czy istnieje umowa, która jest przeznaczona dla WSZYSTKICH reklamodawców?

O: Interfejs API synchronizacji umów jest przeznaczony do umów prywatnych. Więcej informacji znajdziesz w sekcji Pakiet aukcji w przypadku umów publicznych.

P: Co się stanie, jeśli umowa nie ma daty zakończenia? Czy powinniśmy po prostu podać bardzo odległą datę, np. 31.12.9999?

O: Wymagamy daty zakończenia, więc data w przyszłości powinna być odpowiednia. Obecnie maksymalna dozwolona data to 31 grudnia 2030 r. Daty zakończenia można w przyszłości aktualizować.

P: Czy pole dimensionCreativeConfig umożliwia podanie wielu rozmiarów?

O: Tak. Dozwolony jest jednak tylko 1 typ kreacji.

P: Czy akceptujesz cenę aukcyjną w przypadku transakcji zarezerwowanych?

O: Nie. Umowy rezerwacyjne obsługują stałą cenę.

P: Czy w przypadku umów automatyzacji gwarantowanej dotyczących zasobów wideo wymagany jest czas trwania?

O: Nie. Jeśli to pole pozostanie nieustawione, zostanie wypełnione wartością „ANY” duration.

P: Czy któryś ze stanów „Zamówienie” powoduje automatyczne zatrzymanie transakcji w przypadku transakcji? Np. zamówienia dotyczące umów gwarantowanych ustawione jako oczekujące lub inne zamówienia ustawione jako oczekujące, zarchiwizowane, anulowane lub wstrzymane?

O: Nie, zamówienie jest wyłącznie obiektem negocjacji. Nie jest on propagowany, dopóki reklamodawca nie zaakceptuje zamówienia.

P: Co się stanie z zaakceptowaną już transakcją, jeśli platforma wyśle wywołanie aktualizacji?

O: Umowa jest nadal realizowana na starych warunkach. Gdy użytkownik zaakceptuje zmiany, umowa zostanie zaktualizowana zgodnie z nowymi warunkami.

P: Jeśli sprzedawca zmieni warunki umowy, np. zwiększy stałą wartość CPM, a my prześlemy Ci aktualizację. Czy umowa będzie się wyświetlać, zanim zostanie zaakceptowana?

O: Zakładając, że CPM został już zmieniony po stronie giełdy i jest odzwierciedlony w żądaniu stawki.

  1. W przypadku umów rezerwacyjnych środki nie zostaną wykorzystane do momentu ponownego zaakceptowania umowy. Elementy zamówienia są generowane na podstawie warunków transakcji, a aktualizacje warunków transakcji na tym etapie są nadal w fazie negocjacji i nie zostały zaakceptowane przez reklamodawców.
  2. W przypadku umów bez rezerwacji zależy to od elementu zamówienia kierowanego na umowę. Jeśli pytanie o stawkę może być dopasowane do elementów zamówienia kierowanych na tę umowę, reklama będzie się nadal wyświetlać.

P: Czy możemy ponownie użyć identyfikatora transakcji w wielu transakcjach?

O: Nie. Identyfikator ExternalDealId musi być unikalny we wszystkich usługach.

P: Czy umowa może mieć wielu partnerów?

O: Jeśli chcesz, aby umowa była powiązana z kilkoma partnerami, prześlij ją do partnera głównego.

P: Czy po utworzeniu umowy można zmienić identyfikator partnera powiązany z identyfikatorem umowy?

O: Nie. Po utworzeniu zamówienia nie można zmienić partnera.

P: Czy w zamówieniu obsługiwane są nazwy wielu wydawców?

O: Pole nazwy jest ciągiem znaków i służy reklamodawcy do celów informacyjnych. Możesz podać nazwy wielu wydawców rozdzielone przecinkami lub po prostu napisać „Wielu wydawców z giełdy X”.

P: Jaka jest różnica między stanami zamówienia „Anulowano” i „Zarchiwizowano”?

O: Użytkownicy mogą archiwizować i przywracać konta z archiwum. Po anulowaniu użytkownik nie może cofnąć tej czynności.

P: Czym są „Oferty błyskawiczne”? Wiele atrybutów jest wymaganych tylko w przypadku ofert błyskawicznych.

O: Oferty błyskawiczne to osobna integracja korzystająca z punktu końcowego Seller API. Zignoruj atrybuty specyficzne dla scenariusza ofert błyskawicznych. Nie jest on powiązany z przepływem pracy synchronizacji transakcji.

P: Podczas tworzenia zamówienia lub produktu pojawia się błąd „Bad Request”.

O: Przyczyn może być wiele, ale poniżej podajemy kilka najczęstszych.

  1. Zapoznaj się z przewodnikiem i sprawdź, czy nie brakuje Ci jakiegoś wymaganego pola.
  2. Wartość External_deal_id musi być unikalna we wszystkich usługach.
  3. Umowa rezerwacyjna nie obsługuje ceny aukcyjnej

Jeśli żadne z powyższych rozwiązań nie zadziała, spróbuj użyć klienta HTTP, np. Postman, aby sprawdzić, czy odpowiedź zawiera przydatne informacje.

Jeśli żadna z powyższych czynności nie pomoże, skontaktuj się z zespołem pomocy interfejsu DV3 Seller API.