Ostatnia aktualizacja: 18.10.2023
W tym przewodniku znajdziesz informacje o procesie migracji do pliku uporządkowanych danych (SDF) w wersji 7 z poprzedniej wersji oraz wymagane i zalecane zmiany, które możesz wprowadzić, aby zoptymalizować integrację.
Pełną listę różnic między wersjami 6 i 7 znajdziesz w informacjach o wersji.
Migracja wersji plików uporządkowanych danych
Aby przejść na pliki uporządkowanych danych w wersji 7 z poprzedniej wersji, musisz określić nową wersję, zaktualizować przestrzenie identyfikatorów dla podzbioru dotychczasowych kolumn oraz dodać integrację z nowymi kolumnami.
Aktualizacja wersji plików uporządkowanych danych
Aby zaktualizować pliki uporządkowanych danych do nowej wersji, musisz zaktualizować wersję przypisaną do zasobów nadrzędnych partnera i reklamodawcy oraz poszczególne zadania pobierania w interfejsie API Display & Video 360.
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
- Otwórz stronę wybranego partnera. W menu Ustawienia partnera po lewej stronie otwórz stronę Informacje podstawowe. Zaktualizuj konfigurację wersji SDF w sekcji Pliki uporządkowanych danych, ustawiając ją na v7.
- Na poziomie reklamodawcy
- Otwórz właściwości wybranego reklamodawcy. Otwórz stronę Informacje podstawowe w menu Ustawienia reklamodawcy w menu nawigacyjnym po lewej stronie. Zaktualizuj konfigurację wersji SDF w sekcji Pliki uporządkowanych danych na v7. Jeśli wersja domyślna jest ustawiona na poziomie partnera, może nie być możliwe wprowadzenie zmian w tym ustawieniu.
Ustawienie w interfejsie API
- Na poziomie reklamodawcy
- Wyślij prośbę o zmianę
advertisers.patch, aby zaktualizowaćdataAccessConfig.sdfConfig.sdfConfig.versiondoSDF_VERSION_7, a w razie potrzebydataAccessConfig.sdfConfig.overridePartnerSdfConfigdoTrue.
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_7.
Aktualizowanie identyfikatorów w wymaganych kolumnach
W wersji 7 zostały zaktualizowane przestrzenie identyfikatorów używane przez podzbiór kolumn, aby odłączyć pliki uporządkowanych danych od przestarzałego produktu Pliki odczytu elementu i dostosować je do obsługiwanych narzędzi, takich jak interfejs API Display & Video 360.
W tej sekcji znajdziesz listę wszystkich kolumn, które używają innych identyfikatorów niż w wersji 6, oraz instrukcje pobierania informacji referencyjnych o nowych wartościach.
Zamówienie reklamowe
| Instrukcje dotyczące migracji kolumn w wersji 7 | |
|---|---|
|
Kierowanie na aplikację – wyklucz Kierowanie na aplikację – uwzględnij |
Te kolumny zostały zaktualizowane, aby używać identyfikatorów aplikacji w formacie „ Platformy aplikacji są identyfikowane za pomocą wartości tekstowej. Identyfikatory aplikacji to identyfikatory udostępnione przez odpowiednią platformę, np. identyfikator pakietu ze Sklepu Play lub identyfikator aplikacji ze sklepu App Store. |
|
Kierowanie na przeglądarkę – wykluczanie Kierowanie na przeglądarkę – uwzględnij |
Ta kolumna została zaktualizowana, aby używać wartości
Pobieraj zasoby |
|
Kierowanie na operatora – wyklucz Kierowanie na operatora – uwzględnij |
Ta kolumna została zaktualizowana, aby używać wartości
Pobieraj zasoby |
|
Kierowanie na kanał – Wyklucz Kierowanie na kanał – uwzględnij |
Ta kolumna została zaktualizowana, aby używać wartości
Pobieraj zasoby |
|
Kierowanie na urządzenia – Wyklucz Kierowanie na urządzenia – uwzględnij |
Ta kolumna została zaktualizowana, aby używać wartości
Pobieraj zasoby |
| Pomiar kanału DAR |
Ta kolumna została zaktualizowana, aby używać wartości
Pobieraj zasoby |
Kierowanie na witrynę – Wyklucz Kierowanie na witrynę – uwzględnij |
Ta kolumna została zaktualizowana, aby identyfikować witryny za pomocą ciągów znaków adresu URL. |
Element zamówienia
| Instrukcje dotyczące migracji kolumn w wersji 7 | |
|---|---|
|
Kierowanie na aplikację – wyklucz Kierowanie na aplikację – uwzględnij |
Te kolumny zostały zaktualizowane, aby używać identyfikatorów aplikacji w formacie „ Platformy aplikacji są identyfikowane za pomocą wartości tekstowej. Identyfikatory aplikacji to identyfikatory udostępnione przez odpowiednią platformę, np. identyfikator pakietu ze Sklepu Play lub identyfikator aplikacji ze sklepu App Store. |
| Mnożniki stawek |
Ta kolumna została zaktualizowana, aby używać nowych identyfikatorów kryteriów w przypadku typów wierszy aplikacja i witryna. Typ wiersza app został zaktualizowany, aby używać złączenia ciągów znaków wartości platformy aplikacji i identyfikatora platformy aplikacji, oddzielonych dwukropkiem, w przypadku identyfikatorów kryteriów. Platformy aplikacji są identyfikowane za pomocą wartości tekstowej. Identyfikatory aplikacji to identyfikatory udostępniane przez odpowiednią platformę, np. identyfikator pakietu ze Sklepu Play w Androidzie lub identyfikator aplikacji ze sklepu App Store firmy Apple. Typ wiersza witryna został zaktualizowany, aby używać ciągów adresów URL jako identyfikatorów kryteriów. |
|
Kierowanie na przeglądarkę – wykluczanie Kierowanie na przeglądarkę – uwzględnij |
Ta kolumna została zaktualizowana, aby używać wartości
Pobieraj zasoby |
|
Kierowanie na operatora – wyklucz Kierowanie na operatora – uwzględnij |
Ta kolumna została zaktualizowana, aby używać wartości
Pobieraj zasoby |
|
Kierowanie na kanał – Wyklucz Kierowanie na kanał – uwzględnij |
Ta kolumna została zaktualizowana, aby używać wartości
Pobieraj zasoby |
|
Kierowanie na urządzenia – Wyklucz Kierowanie na urządzenia – uwzględnij |
Ta kolumna została zaktualizowana, aby używać wartości
Pobieraj zasoby |
Kierowanie na witrynę – Wyklucz Kierowanie na witrynę – uwzględnij |
Ta kolumna została zaktualizowana, aby identyfikować witryny za pomocą ciągów znaków adresu URL. |
Produkt medialny
| Instrukcje dotyczące migracji kolumn w wersji 7 | |
|---|---|
|
Kierowanie na kanał – Wyklucz Kierowanie na kanał – uwzględnij |
Ta kolumna została zaktualizowana, aby używać wartości
Pobieraj zasoby |
| Kierowanie na urządzenia – uwzględnij |
Ta kolumna została zaktualizowana, aby używać wartości
Pobieraj zasoby |
Dodawanie integracji z kolumnami dodanymi od wersji 6
Jeśli migrujesz z wersji 6 na wersję 7, musisz dodać do odpowiednich plików te kolumny:
| Typ pliku | Kolumna |
|---|---|
| Element zamówienia | Liczba docelowej częstotliwości wyświetleń reklam TrueView |
| Element zamówienia | Okno czasowe docelowej częstotliwości wyświetleń reklam TrueView |
| Grupa reklam w YouTube | Kierowanie zoptymalizowane |
Jeśli przechodzisz z wcześniejszej wersji plików uporządkowanych danych, zapoznaj się z notatkami do wersji plików uporządkowanych danych, aby dowiedzieć się więcej o dodatkowych kolumnach dodanych między obecną wersją a wersją 6 plików uporządkowanych danych.
Dodatkowe zmiany
W wersji 7 wprowadziliśmy też kilka zmian, które powinny ułatwić Ci integrację i pozwolić na rezygnację z korzystania z pozakładanych plików odczytu entyfikacji.
Nowe sortowanie listy dla podzbioru kolumn
Wersja 7 formatu SDF gwarantuje stabilne uporządkowanie niektórych kolumn listy po wygenerowaniu pliku. Dzięki temu działanie jest bardziej spójne, a sprawdzanie łatwiejsze. Ta kolejność nie jest wymuszana podczas przesyłania pliku, ale jest stosowana podczas generowania zaktualizowanego pliku.
Pełną listę kolumn, które są teraz generowane w rosnącej kolejności numerycznej lub alfabetycznej, znajdziesz w informacjach o wersji 7.
Nowe rekomendacje dotyczące identyfikatorów
Zaktualizowaliśmy definicje kilku kolumn, aby usunąć odniesienia do przestarzałych plików odczytu podmiotu. Zamiast tego zalecamy inne sposoby wyszukiwania identyfikatorów.
Wartości zwracane przez te kolumny są takie same jak w pliku SDF w wersji 6, ale zalecamy zaktualizowanie integracji, aby pobierać identyfikatory za pomocą nowej zalecanej metody, o której wspominamy w opisach kolumn w wersji 7.
| Typy plików i ich kolumny | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Kampania |
|
|||||||||||||||||||||
| Zamówienie reklamowe |
|
|||||||||||||||||||||
| Element zamówienia |
|
|||||||||||||||||||||
| Produkt medialny |
|
|||||||||||||||||||||
| grupa reklam w YouTube, |
|
|||||||||||||||||||||