Najczęstsze pytania dotyczące interfejsu Deal Sync API

Poznaj odpowiedzi na najczęstsze pytania dotyczące integracji z interfejsem Display & Video 360 Deal Sync API.

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

O: Identyfikator giełdy jest przypisywany przez zespół Display & Video 360 podczas konfiguracji uwierzytelniania.

P: Jaki jest cel hierarchii zamówień i produktów?

O: Ta hierarchia umożliwia wydawcom i reklamodawcom negocjowanie wielu umów i przesyłanie ich razem jako jednego obiektu negocjacji. Obowiązują ograniczenia: wszystkie produkty w zamówieniu muszą mieć ten sam typ transakcji i typ ceny. Możesz zawsze używać konfiguracji 1 zamówienie – 1 produkt.

P: Czy istnieje typ umowy dostępny dla WSZYSTKICH reklamodawców?

O: Interfejs Deal Sync API jest przeznaczony do transakcji prywatnych. W przypadku umów publicznych przygotowanych dla wszystkich reklamodawców zapoznaj się z sekcją Pakiety aukcji (pakiety zasobów reklamowych).

Pytanie: Co się stanie, jeśli umowa nie ma daty zakończenia?

O: Data zakończenia jest wymagana, więc ustawienie daty w przyszłości jest w porządku. Maksymalny dozwolony rok to 2036. Daty zakończenia można w przyszłości aktualizować lub przedłużać.

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

O: Tak, ale w przypadku każdego produktu dozwolony jest tylko jeden typ kreacji.

P: Czy kreacje natywne są obsługiwane w przypadku umów automatyzacji gwarantowanej?

O: Nie. Umowy z rezerwacją (gwarantowane) nie obsługują kreacji natywnychCREATIVE_TYPE_NATIVE.

Jeśli chcesz korzystać z gwarantowanej automatyzacji, która akceptuje kreacje natywne, skontaktuj się z przedstawicielem Google.

P: Czy akceptujesz ceny aukcyjne w przypadku transakcji zarezerwowanych?

Nie. Umowy rezerwacji (gwarantowane) obsługują tylko stałe ceny.

P: Czy w przypadku umów automatyzacji gwarantowanej (PG) dotyczących filmów wymagany jest czas trwania?

O: Nie. Jeśli nie ustawisz czasu trwania, domyślną wartością będzie ANY.

P: Czy któryś ze stanów zamówienia powoduje, że umowa przestaje generować transakcje?

O: Nie. Zamówienie jest wyłącznie obiektem negocjacji. Zmiany nie będą miały wpływu na wyświetlanie reklam, dopóki reklamodawca nie zaakceptuje zamówienia.

Pytanie: Co się stanie z zaakceptowaną umową, jeśli giełda wyśle wywołanie aktualizacji?

O: Umowa będzie nadal realizowana na wcześniej zaakceptowanych warunkach. Gdy reklamodawca zaakceptuje zaktualizowane warunki, umowa zacznie generować wyświetlenia zgodnie z nowymi warunkami.

P: Czy umowa będzie nadal wyświetlać reklamy, jeśli zaktualizowane warunki nie zostały jeszcze zaakceptowane?

O: Zakładając, że CPM został już zmieniony po stronie giełdy i jest odzwierciedlony w prośbie o stawkę:

  1. W przypadku umów z rezerwacją: umowa nie będzie generować wydatków, dopóki reklamodawca ponownie jej nie zaakceptuje. Elementy zamówienia są generowane na podstawie warunków umowy. Aktualizacje pozostają w trakcie negocjacji do momentu zaakceptowania ich przez reklamodawcę.
  2. W przypadku umów bez rezerwacji: wyświetlanie zależy od kierowania elementu zamówienia na umowę. Jeśli żądania stawek są zgodne z kryteriami elementu zamówienia kierowanego na tę transakcję, wyświetlanie jest kontynuowane.

P: Czy możemy ponownie użyć identyfikatora umowy w przypadku kilku umów?

O: Nie. Wartość external_deal_id musi być unikalna dla wszystkich produktów.

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

O: Jeśli chcesz powiązać umowę z wieloma partnerami, wyślij ją do partnera głównego.

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

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

P: Czy w zamówieniu można podać kilka nazw wydawców?

O: Pole nazwy wydawcy to ciąg znaków używany przez reklamodawcę w celach informacyjnych. Możesz podać wiele nazw wydawców rozdzielonych przecinkami lub wpisać „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ć zamówienia i je przywracać. Anulowanego zamówienia nie można ponownie aktywować ani cofnąć anulowania.

Pytanie: Co to są „umowy błyskawiczne”?

O: Oferty błyskawiczne to osobna integracja wykorzystująca punkt końcowy interfejsu Seller API. Zignoruj atrybuty specyficzne dla ofert błyskawicznych, ponieważ nie są one powiązane z przepływem pracy synchronizacji ofert.

Pytanie: Co sprawdzić, jeśli otrzymam błąd „Nieprawidłowe żądanie”?

O: Oto kilka najczęstszych przyczyn:

  1. Sprawdź przewodnik, aby upewnić się, że wszystkie wymagane pola są wypełnione.
  2. Sprawdź, czy atrybut external_deal_id jest unikalny dla wszystkich produktów.
  3. Upewnij się, że w przypadku umów dotyczących rezerwacji nie określono cen aukcyjnych.

Jeśli problem nadal występuje, przetestuj żądanie za pomocą klienta HTTP, takiego jak Postman, aby sprawdzić szczegółowe komunikaty o błędach w treści odpowiedzi.

Jeśli żadne z powyższych rozwiązań nie rozwiąże problemu, skontaktuj się z zespołem pomocy interfejsu Display & Video 360 Seller API.