Przepływy pracy interfejsu API

Tworzenie umowy

1. Sprawdź, czy produkt został już utworzony, korzystając z metody LIST z filtrem external_deal_id. Wartość External_deal_id musi być unikalna we wszystkich usługach.

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

2. Utwórz zamówienie Nazwa jest generowana przez DV3. Zalecamy zapisanie tego identyfikatora w systemie, aby można było go później odzyskać.

3. Tworzenie produktu w ramach zamówienia Nazwa produktu jest generowana przez DV3. Zalecamy zapisanie tego identyfikatora w systemie, aby można było go później odzyskać.

   Możesz też zawsze użyć polecenia LIST z parametrem external_deal_id. Pole nazwy zawiera zarówno identyfikator zamówienia, jak i identyfikator produktu, dzięki czemu możesz łatwo zidentyfikować element nadrzędny.

Anulowanie oferty

1. Zmień stan zamówienia na Anulowane Anulowanie jest możliwe tylko wtedy, gdy zamówienie nie zostało zaakceptowane. Anulowanie jest stanem końcowym. Po anulowaniu zamówienia nie można go ponownie aktywować.

Pobieranie szczegółów umowy

1. Wyświetl szczegóły zamówienia. Stan zostanie zaktualizowany, gdy użytkownik zaakceptuje, zarchiwizuje lub anuluje zamówienie.
2. Sprawdzanie szczegółów produktu

Uzyskiwanie listy transakcji

1. WYŚWIETL zamówienia z filtrem stanu, aby uzyskać wszystkie zaakceptowane zamówienia lub zamówienia oczekujące na akceptację.
2. LIST produkty z filtrem external_deal_id.
3. WYŚWIETL wszystkie produkty w zamówieniu.

Aktualizowanie umowy

1. Aktualizowanie zamówienia dotyczącego danych kontaktowych wydawcy.
   1. name nie zezwala na aktualizację(nie można go ustawić w field_mask). Stan można ustawić tylko na „Anulowano” za pomocą interfejsu API.
   2. Parametr partner_id nie zezwala na aktualizację.
2. Aktualizacja produktu w przypadku aktualizacji konkretnego okresu obowiązywania umowy.
   1. Nie można zaktualizować tych pól: name, externalDealId, transactionType, pricingType, updateTime.
   2. Aktualizacja displayName nie wymaga akceptacji użytkownika.
   3. Aktualizacja rateDetails, creativeConfig spowoduje zmianę stanu zamówienia nadrzędnego na Oczekuje na zatwierdzenie. Reklamodawcy korzystający z DV360 będą proszeni o zaakceptowanie nowych warunków na stronie negocjacji, niezależnie od tego, czy poprzednie zamówienie zostało zaakceptowane.

Sprawdzanie, czy użytkownik zaakceptował transakcję

1. Pobierz zamówienie, jeśli znasz odpowiedni identyfikator zamówienia. Sprawdź pole stanu.
2. Jeśli identyfikator zamówienia nie został śledzony: List Products with external_deal_id filter, figure out order name from product name, a następnie Get Order. Sprawdź pole stanu.

Sprawdzanie, czy użytkownik skonfigurował okazję(tylko w przypadku PG)

1. Pobierz źródło zasobów reklamowych Nazwa to „exchanges/{exchangeId}/inventorysources/{external_deal_id}”. Sprawdź stan kupującego.
   1. Okazje rezerwacyjne
      1. BUYER_STATUS_ACTIVE oznacza, że umowa została zaakceptowana i skonfigurowana. Oczekuje się, że w tym stanie umowa będzie generować wydatki, gdy DV3 otrzyma pytanie o stawkę zgodne z warunkami umowy. Element zamówienia jest generowany automatycznie na etapie konfiguracji umowy. Więcej informacji znajdziesz w artykule Konfiguracja transakcji.
      2. BUYER_STATUS_PENDINGoznacza, że zamówienie zostało zaakceptowane, ale umowa nie została jeszcze skonfigurowana. W tym stanie nie będą generowane żadne wydatki.
      3. BUYER_STATUS_PAUSEDoznacza, że umowa została wyraźnie wstrzymana przez reklamodawców. W tym stanie nie będą generowane żadne wydatki.
   2. Oferty bez rezerwacji
      1. BUYER_STATUS_ACTIVE oznacza, że umowa została zaakceptowana. Oczekuje się, że w tym stanie umowa będzie wydawać środki, gdy DV3 otrzyma pytanie o stawkę zgodne z warunkami umowy ORAZ będzie istniał aktywny element zamówienia kierowany na tę umowę ORAZ pytanie o stawkę będzie zgodne z kryteriami kierowania elementu zamówienia. Więcej informacji znajdziesz w artykule Element zamówienia**. NIE MA interfejsu API sprzedawcy, który umożliwiałby sprawdzanie, czy umowa jest kierowana przez elementy zamówienia. **
      2. BUYER_STATUS_PENDINGnie dotyczy.
      3. BUYER_STATUS_PAUSEDoznacza, że umowa została wyraźnie wstrzymana przez reklamodawców. W tym stanie nie będą generowane żadne wydatki.

Wstrzymywanie i wznawianie umowy po jej zaakceptowaniu

1. Zaktualizuj Źródło zasobów reklamowych Stan sprzedawcy.
   1. Wstrzymanie lub wznowienie nie ma wpływu na wyświetlanie transakcji. Gdy sprzedawca wstrzyma transakcję, reklamodawcy zobaczą tylko ciąg znaków z informacją. Pomaga to reklamodawcy rozwiązać problem z umową, która nie generuje wydatków.

Ponowne negocjacje (aktualizacja umowy po zaakceptowaniu)

Ponowne negocjacje to zmiany wprowadzone w umowie po jej zaakceptowaniu przez kupującego. Może to być bardzo przydatne zarówno dla giełd, jak i kupujących, którzy chcą wprowadzać nowe zmiany w zaakceptowanych transakcjach. Na przykład giełda może stwierdzić, że czas zakończenia zaakceptowanej transakcji nie jest prawidłowy, i użyć usługi DV3 Update Product, aby przesłać aktualizacje do kupujących w DV3, jeśli transakcja jeszcze się nie rozpoczęła.

Jakie zmiany są dozwolone, a jakie nie.

Zezwalamy na zmiany we wszystkich polach z wyjątkiem niektórych pól o kluczowym znaczeniu dla wyświetlania reklam, takich jak startTime, endTime, rateDetails, creativeConfig itp. W przypadku tych pól o kluczowym znaczeniu dla wyświetlania reklam stosujemy weryfikację. Ogólnie rzecz biorąc, aktualizacje tych pól z wyjątkiem creativeConfig są dozwolone, jeśli czas rozpoczęcia oferty przypada co najmniej 1 dzień później. W przypadku aktywnych umów, których czas rozpoczęcia już minął, ale czas zakończenia jeszcze nie, dozwolone są tylko aktualizacje przyrostowe. W przypadku umów, których realizacja już się zakończyła (czas zakończenia jest w przeszłości), nie można wprowadzać żadnych zmian. Na przykład aktualizacja rateDetails umowy zawartej rok temu jest niedozwolona. W takich przypadkach usługa DV3 Update Product zwróci błąd weryfikacji.