Ostatnia aktualizacja: 12.11.2024
W tym przewodniku opisaliśmy proces migracji z użycia pliku uporządkowanych danych w wersji 7.1 na wersję 8 i wyjaśniliśmy zmiany między tymi wersjami, które mogą mieć wpływ na integrację.
Pełną listę różnic między wersjami 7.1 i 8 znajdziesz w informacjach o wersji.
Migracja wersji plików uporządkowanych danych
Aby przejść na pliki uporządkowanych danych (SDF) w wersji 8 z poprzedniej wersji:
- Zaktualizuj zasoby i działania generowania SDF, aby używać wersji 8.
- Zaktualizuj logikę zasobu reklamy, aby identyfikować typ podczas tworzenia.
- Dodaj nową logikę odczytywania, tworzenia i aktualizowania zasobów kampanii generujących popyt.
Aktualizacja wersji plików uporządkowanych danych
Aby używać nowej wersji plików uporządkowanych danych, zaktualizuj przypisaną wersję w zasobach nadrzędnych partnera i reklamodawcy, a potem twórz w interfejsie Display & Video 360 API poszczególne zadania pobierania.
Aktualizowanie ustawień zasobu nadrzędnego
Domyślna wersja plików uporządkowanych danych jest ustawiana na poziomie zasobu partnera i reklamodawcy. Ta wersja jest używana domyślnie podczas pobierania plików uporządkowanych danych za pomocą interfejsu lub interfejsu API.
Ustaw w interfejsie
Na poziomie partnera
- Przejdź do profilu wybranego partnera.
- W menu nawigacyjnym po lewej stronie rozwiń menu Ustawienia partnera i otwórz stronę Informacje podstawowe.
- Zaktualizuj konfigurację wersji SDF w sekcji Pliki uporządkowanych danych, ustawiając ją na v8.
Na poziomie reklamodawcy
- Otwórz właściwości wybranego reklamodawcy.
- W menu nawigacyjnym po lewej stronie rozwiń menu Ustawienia reklamodawcy i otwórz stronę Informacje podstawowe.
- Zaktualizuj konfigurację wersji SDF w sekcji Pliki uporządkowanych danych na v8. Jeśli wersja domyślna jest ustawiona na poziomie partnera, nie można edytować tego ustawienia.
Ustaw w interfejsie API
- Na poziomie partnera
- Nie możesz ustawić domyślnej wersji pliku SDF na poziomie partnera w interfejsie API.
- Na poziomie reklamodawcy
- Wyślij prośbę o aktualizację
advertisers.patch, aby zmienićdataAccessConfig.sdfConfig.sdfConfig.versionnaSDF_VERSION_8, a w razie potrzebydataAccessConfig.sdfConfig.overridePartnerSdfConfignaTrue.
Aktualizowanie żądań sdfdownloadtasks.create w interfejsie API
Podczas wysyłania żądania sdfdownloadtasks.create za pomocą interfejsu Display & Video 360 API ustaw pole version w ciele żądania na SDF_VERSION_8.
Określ typ w Zasobach reklamy
Wersja 8 dodaje do plików Ad kolumnę Ad Type, która podaje typ reklamy reprezentowany przez każdy wiersz. Ta nowa kolumna jest wymagana i będzie wypełniana podczas pobierania plików reklam v8 dla dotychczasowych zasobów.
Podczas aktualizowania istniejących reklam nie należy zmieniać wartości w tej kolumnie.
Podczas tworzenia nowych reklam musisz wypełnić tę kolumnę jedną z wartości wymienionych w jej opisie.
Aktualizacja logiki dotyczącej zasobów generujących popyt
Wersja 8 obsługuje tworzenie, pobieranie i aktualizowanie kampanii generujących popyt za pomocą plików Element zamówienia, Grupa reklam i Reklama. Zasoby generowania zapotrzebowania korzystają z innej logiki weryfikacji sygnatury czasowej, wymagają wypełniania dodatkowych kolumn i są ograniczone przez nowe ograniczenia w przypadku 3 typów plików.
Weryfikacja sygnatury czasowej
W przypadku wszystkich elementów zamówienia, które nie są elementami zamówienia generującymi popyt, kolumna Timestamp w pliku Element zamówienia jest wypełniana podczas pobierania o ostatniej modyfikacji elementu zamówienia. Ta wartość jest używana podczas aktualizowania elementu zamówienia za pomocą pliku SDF w celu sprawdzenia, czy element zamówienia nie został zaktualizowany od czasu pobrania pierwotnego pliku. W takim przypadku aktualizacja się nie powiedzie.
W przypadku elementów zamówienia w kampaniach generujących popyt kolumna Timestamp i powiązana z nią weryfikacja działają inaczej. W przypadku wpisów elementu zamówienia generującego popyt kolumna jest wypełniana bieżącym czasem w momencie pobierania. Podczas przesyłania Display & Video 360 sprawdza, czy od podanego sygnatury czasowej minęło więcej niż 24 godziny. Jeśli minęło więcej niż 24 godziny, wpis oryginalnego pliku jest uważany za nieaktualny i aktualizacja nie powiedzie się. W takiej sytuacji pobierz plik ponownie i wprowadź zmiany na podstawie nowszej wersji. Ta nowa metoda weryfikacji nie uniemożliwia zastąpienia zmian wprowadzonych w ciągu ostatnich 24 godzin. Aby uniknąć przypadkowego zastąpienia elementów zamówienia generujących popyt, uwzględnij w przesyłanych plikach tylko te elementy, które chcesz zaktualizować.
Kolumny wymagane
W przypadku wymienionych poniżej typów plików oprócz kolumn wymaganych w przypadku wszystkich jednostek danego typu pliku są teraz wymagane kolumny dotyczące niektórych zasobów Demand Gen.
Element zamówienia
Wymagane kolumny w przypadku tych wartości kolumn
Line Item
Type
|
||||
| Generowanie popytu |
|
|||
Reklama
Wymagane kolumny w przypadku tych wartości kolumn
Ad
Ad Type
|
|||||||||
| Karuzela generująca popyt |
|
||||||||
| Obraz generujący popyt |
|
||||||||
| Produkt generujący popyt |
|
||||||||
| Film generujący popyt |
|
||||||||
Zaktualizowane ograniczenia
Oprócz nowych wymaganych kolumn w przypadku niektórych elementów zamówienia i reklam generujących popyt nowe ograniczenia stosowania mają też różne kolumny w typach plików Element zamówienia, Grupa reklam i Reklama.
Ograniczenia te są liczne i dotyczą konkretnych kolumn, dlatego w tym przewodniku nie znajdziesz pełnej listy ograniczeń. Przed utworzeniem lub zaktualizowaniem zasobów generowania zapotrzebowania za pomocą przesyłania pliku SDF zalecamy dokładne zapoznanie się z dokumentacją referencyjną v8 dotyczącą typów plików Element zamówienia, Grupa reklam i Reklama.