Na tej stronie znajdziesz szczegółowe informacje o limitach i sprawdzonych metodach zarządzania kierowaniem za pomocą interfejsu Display & Video 360 API.
Kierowanie przypisane podczas tworzenia elementu zamówienia
Niektóre typy kierowania mają wartości domyślne przypisane podczas tworzenia elementu zamówienia. Te typy kierowania to:
Aby uniknąć błędów, zapoznaj się z pełnym pakietem kierowania, który jest przypisywany do elementów zamówienia podczas ich tworzenia. Możesz pobrać wszystkie ustawienia kierowania przypisane do elementu zamówienia w różnych zastosowaniach za pomocą metody bulkListAssignedTargetingOptions.
Niektóre ustawienia są domyślne, gdy nie przypisano kierowania określonego typu. Jeśli na przykład do elementu zamówienia nie jest przypisana opcja kierowania TARGETING_TYPE_AUTHORIZED_SELLER_STATUS, podczas wyświetlania reklam będzie on korzystać z ustawienia „Autoryzowani sprzedawcy bezpośredni i odsprzedawcy”.
Opcje kierowania mogą zostać wycofane
Opcje kierowania nie są statyczne. Niewielka liczba opcji może być co jakiś czas wycofywana. Wycofane opcje kierowania nie mają wpływu na wyświetlanie reklam w elemencie zamówienia. Po wycofaniu te opcje zostaną odłączone. Żądania próby pobrania lub przypisania tych opcji będą powodować błędy.
Aby uniknąć tych błędów, regularnie sprawdzaj zapisane identyfikatory opcji kierowania. Aby oszczędzać limit, zalecamy regularne zapisywanie w pamięci podręcznej często używanych identyfikatorów.
Przechowywanie identyfikatorów oznacza, że możesz nie zauważyć, że opcja kierowania została wycofana. Regularnie używaj metody get, aby pobierać wszystkie zapisane identyfikatory opcji kierowania i sprawdzać, czy są one nadal obsługiwane przez Display & Video 360.
Równoczesne żądania kierowania do tego samego elementu zamówienia zakończą się niepowodzeniem
Próba zaktualizowania ustawień lub przypisanego kierowania elementu zamówienia za pomocą współbieżnych żądań spowoduje zwrócenie błędu.
Aby dodać lub usunąć jednocześnie wiele przypisanych opcji kierowania w przypadku jednego elementu zamówienia, użyj jednego żądania bulkEditAssignedTargetingOptions. Jeśli chcesz zaktualizować ustawienia i kierowanie elementu zamówienia, umieść żądania w kolejce, aby mieć pewność, że zostaną wysłane po kolei.
Typowe błędy kierowania
Podczas zarządzania kierowaniem za pomocą interfejsu Display & Video 360 API mogą wystąpić 3 typy błędów.
Błędy konfiguracji
Kierowanie podlega ograniczeniom konfiguracji. Jeśli żądanie próbuje zaktualizować kierowanie w taki sposób, aby naruszało te reguły, zwróci błąd.
Błędy konfiguracji są często spowodowane istniejącym kierowaniem. Aby tego uniknąć, wykonaj te czynności:
- Pobierz dotychczasowe kierowanie określonego typu za pomocą żądania
list. - Sprawdź dotychczasowe kierowanie. Określ, które ustawienia kierowania należy dodać lub usunąć, aby uzyskać pożądaną konfigurację.
- Aktualizuj kierowanie za pomocą żądania
bulkEditAssignedTargetingOptions.
Kierowania odziedziczonego przez zasoby nadrzędne nie można usunąć, ale może ono powodować te błędy.
Błędy dotyczące YouTube i sieci partnerów wideo Google
Nie możesz aktualizować kierowania na YouTube i sieć partnerów za pomocą interfejsu Display & Video 360 API. Żądania próbujące zaktualizować to kierowanie będą zwracać błąd.
Ten rodzaj kierowania jest zdefiniowany w ten sposób:
- Kierowanie przypisane do elementu zamówienia lub grupy reklam typu YouTube i sieć partnerów wideo Google.
- Kierowanie reklamodawców na pozycje w sesji oraz poszczególne kanały i filmy w YouTube.
Błędy współbieżności
Żądania aktualizacji ustawień lub kierowania tego samego elementu zamówienia w tym samym czasie mogą zwracać błąd.
Aby tego uniknąć:
- Zbiorczo zarządzaj kierowaniem za pomocą żądania zbiorczej edycji.
- Kolejkuj żądania, które aktualizują ten sam element zamówienia. Nie wysyłaj prośby, dopóki nie otrzymasz odpowiedzi na poprzednią.