Migracja do plików uporządkowanych danych w wersji 7

Ostatnia aktualizacja: 18.10.2023 r.

W tym przewodniku opisujemy proces przechodzenia z poprzedniej wersji na pliki uporządkowanych danych (SDF) w wersji 7 oraz zmiany (zarówno wymagane, jak i sugerowane), które warto wprowadzić, aby lepiej 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

Migracja do plików uporządkowanych danych w wersji 7 z poprzedniej wersji wymaga określenia nowej wersji, zaktualizowania przestrzeni identyfikatorów w podzbiorze istniejących kolumn i dodania integracji z nowymi kolumnami.

Aktualizowanie wersji plików uporządkowanych danych

Aby zaktualizować pliki uporządkowanych danych do nowej wersji, musisz zaktualizować wersję przypisaną do nadrzędnych zasobów partnerów i reklamodawców oraz poszczególne zadania pobierania w interfejsie Display & Video 360 API.

Zaktualizuj ustawienia zasobu nadrzędnego

Domyślna wersja plików uporządkowanych danych jest ustawiana na poziomie zasobu partnera i reklamodawcy. Ta wersja jest używana jako domyślna podczas pobierania plików uporządkowanych danych za pomocą interfejsu lub API.

Ustaw w interfejsie

Na poziomie partnera

Przejdź do odpowiedniego partnera. W menu Ustawienia partnera w menu po lewej stronie otwórz stronę Informacje podstawowe. Zmień konfigurację wersji plików SDF w sekcji Pliki uporządkowanych danych do v7.

Na poziomie reklamodawcy

Przejdź do odpowiedniego reklamodawcy. Wejdź na stronę Informacje podstawowe w menu Ustawienia reklamodawcy w menu po lewej stronie. Zmień konfigurację wersji SDF w sekcji Pliki uporządkowanych danych do v7. Jeśli wersja domyślna jest ustawiona na poziomie partnera, tego ustawienia nie można edytować.

Ustaw w interfejsie API

Na poziomie reklamodawcy

Prześlij prośbę o aktualizację dataAccessConfig.sdfConfig.sdfConfig.version do wersji SDF_VERSION_7 i w razie potrzeby dataAccessConfig.sdfConfig.overridePartnerSdfConfig na True.advertisers.patch

Zaktualizuj żądania sdfdownloadtasks.create w interfejsie API

Podczas tworzenia żądania sdfdownloadtasks.create za pomocą interfejsu Display & Video 360 API ustaw pole version treści żądania na SDF_VERSION_7.

Zaktualizuj identyfikatory w wymaganych kolumnach

W wersji 7 przestrzenie identyfikatorów używane przez podzbiór kolumn zostały zaktualizowane, aby oddzielać pliki uporządkowanych danych od wycofanej usługi Pliki odczytu encji i dopasować je do obsługiwanych narzędzi, takich jak Display & Video 360 API.

Ostrzeżenie: zaktualizowane identyfikatory mogą być niezgodne ze skryptami ustalania stawek niestandardowych. Najnowsze informacje o identyfikatorach, których należy używać przed migracją, znajdziesz w dokumentacji referencyjnej sygnałów skryptów ustalania stawek niestandardowych.

W tej sekcji znajdziesz listę wszystkich kolumn zawierających inne identyfikatory niż wersja 6 oraz instrukcje pobierania informacji o nowych wartościach.

Zamówienie reklamowe

Instrukcje migracji kolumn do wersji 7
Kierowanie na aplikacje – wyklucz Kierowanie na aplikacje – uwzględnij	Te kolumny zostały zaktualizowane tak, aby korzystały z identyfikatorów aplikacji w formacie „App Platform:App ID”. Przykłady: „APP:com.google.android.gm”, „APP:422689480” i „ANDROID_TV_APP:com.google.android.youtube.tvunplugged” Platformy aplikacji są identyfikowane przez wartość ciągu znaków. Identyfikatory aplikacji to identyfikatory dostarczane przez odpowiednią platformę, np. identyfikator pakietu ze Sklepu Play na Androida lub identyfikator aplikacji ze sklepu Apple App Store.
Kierowanie na przeglądarkę – wyklucz Kierowanie na przeglądarkę – uwzględnij	Ta kolumna została zaktualizowana, aby korzystać z wartości targetingOptionId zasobów Display & Video 360 API TargetingOption w sekcji Typ kierowania TARGETING_TYPE_BROWSER. Pobieraj zasoby TargetingOption pojedynczo lub na listach podzielonych na strony za pomocą usługi targetingTypes.targetingOptions.
Kierowanie na operatora – wyklucz Kierowanie na operatora – uwzględnij	Ta kolumna została zaktualizowana, aby korzystać z wartości targetingOptionId zasobów Display & Video 360 API TargetingOption w sekcji Typ kierowania TARGETING_TYPE_CARRIER_AND_ISP. Pobieraj zasoby TargetingOption pojedynczo lub na listach podzielonych na strony za pomocą usługi targetingTypes.targetingOptions.
Kierowanie na kanały – wyklucz Kierowanie na kanały – uwzględnij	Ta kolumna została zaktualizowana, aby używała wartości channelId zasobu Channel interfejsu Display & Video 360 API. Pobieraj zasoby Channel pojedynczo lub na listach podzielonych na strony za pomocą usług advertisers.channels i partners.channels.
Kierowanie na urządzenia – wyklucz Kierowanie na urządzenia – uwzględnij	Zaktualizowaliśmy tę kolumnę, aby korzystać z wartości targetingOptionId zasobów TargetingOption interfejsu Display & Video 360 API w ramach tych typów kierowania: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Pobieraj zasoby TargetingOption pojedynczo lub na listach podzielonych na strony za pomocą usługi targetingTypes.targetingOptions.
Pomiar kanału DAR	Ta kolumna została zaktualizowana, aby używała wartości channelId zasobu Channel interfejsu Display & Video 360 API. Pobieraj zasoby Channel pojedynczo lub na listach podzielonych na strony za pomocą usług advertisers.channels i partners.channels.
Kierowanie na witryny – wyklucz Kierowanie na witryny – uwzględnij	Ta kolumna została zaktualizowana, aby umożliwić identyfikowanie witryn za pomocą ciągów adresów URL.

Element zamówienia

Instrukcje migracji kolumn do wersji 7
Kierowanie na aplikacje – wyklucz Kierowanie na aplikacje – uwzględnij	Te kolumny zostały zaktualizowane tak, aby korzystały z identyfikatorów aplikacji w formacie „App Platform:App ID”. Przykłady: „APP:com.google.android.gm”, „APP:422689480” i „ANDROID_TV_APP:com.google.android.youtube.tvunplugged” Platformy aplikacji są identyfikowane przez wartość ciągu znaków. Identyfikatory aplikacji to identyfikatory dostarczane przez odpowiednią platformę, np. identyfikator pakietu ze Sklepu Play na Androida lub identyfikator aplikacji ze sklepu Apple App Store.
Mnożniki stawek	Ta kolumna została zaktualizowana, aby używać nowych identyfikatorów kryteriów dla wierszy typu aplikacja i witryna. Typ wiersza aplikacja został zaktualizowany, aby w identyfikatorach kryteriów używać połączonych wartości ciągu znaków platformy aplikacji i identyfikatora platformy aplikacji, rozdzielonych dwukropkiem. Platformy aplikacji są identyfikowane przez wartość ciągu znaków. Identyfikatory aplikacji to identyfikatory dostarczane przez odpowiednią platformę, np. identyfikator pakietu ze Sklepu Play na Androida lub identyfikator aplikacji ze sklepu Apple App Store. Typ wiersza witryna został zaktualizowany, aby używać ciągów adresów URL jako identyfikatorów kryteriów.
Kierowanie na przeglądarkę – wyklucz Kierowanie na przeglądarkę – uwzględnij	Ta kolumna została zaktualizowana, aby korzystać z wartości targetingOptionId zasobów Display & Video 360 API TargetingOption w sekcji Typ kierowania TARGETING_TYPE_BROWSER. Pobieraj zasoby TargetingOption pojedynczo lub na listach podzielonych na strony za pomocą usługi targetingTypes.targetingOptions.
Kierowanie na operatora – wyklucz Kierowanie na operatora – uwzględnij	Ta kolumna została zaktualizowana, aby korzystać z wartości targetingOptionId zasobów Display & Video 360 API TargetingOption w sekcji Typ kierowania TARGETING_TYPE_CARRIER_AND_ISP. Pobieraj zasoby TargetingOption pojedynczo lub na listach podzielonych na strony za pomocą usługi targetingTypes.targetingOptions.
Kierowanie na kanały – wyklucz Kierowanie na kanały – uwzględnij	Ta kolumna została zaktualizowana, aby używała wartości channelId zasobu Channel interfejsu Display & Video 360 API. Pobieraj zasoby Channel pojedynczo lub na listach podzielonych na strony za pomocą usług advertisers.channels i partners.channels.
Kierowanie na urządzenia – wyklucz Kierowanie na urządzenia – uwzględnij	Zaktualizowaliśmy tę kolumnę, aby korzystać z wartości targetingOptionId zasobów TargetingOption interfejsu Display & Video 360 API w ramach tych typów kierowania: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Pobieraj zasoby TargetingOption pojedynczo lub na listach podzielonych na strony za pomocą usługi targetingTypes.targetingOptions.
Kierowanie na witryny – wyklucz Kierowanie na witryny – uwzględnij	Ta kolumna została zaktualizowana, aby umożliwić identyfikowanie witryn za pomocą ciągów adresów URL.

Produkt medialny

Instrukcje migracji kolumn do wersji 7
Kierowanie na kanały – wyklucz Kierowanie na kanały – uwzględnij	Ta kolumna została zaktualizowana, aby używała wartości channelId zasobu Channel interfejsu Display & Video 360 API. Pobieraj zasoby Channel pojedynczo lub na listach podzielonych na strony za pomocą usług advertisers.channels i partners.channels.
Kierowanie na urządzenia – uwzględnij	Zaktualizowaliśmy tę kolumnę, aby korzystać z wartości targetingOptionId zasobów TargetingOption interfejsu Display & Video 360 API w ramach tych typów kierowania: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Pobieraj zasoby TargetingOption pojedynczo lub na listach podzielonych na strony za pomocą usługi targetingTypes.targetingOptions.

Dodaj integrację z kolumnami dodanymi od wersji 6

Jeśli przechodzisz z wersji 6 na 7, musisz dodać do odpowiednich plików te kolumny:

Typ pliku	Kolumna
Element zamówienia	TrueView: liczba docelowych częstotliwości
Element zamówienia	TrueView: okno czasowe docelowej częstotliwości
Grupa reklam w YouTube	Kierowanie zoptymalizowane

Jeśli przechodzisz z poprzedniej wersji plików uporządkowanych danych, zajrzyj do informacji o wersji plików uporządkowanych danych, aby dowiedzieć się więcej o dodatkowych kolumnach dodanych między bieżącą wersją a plikami SDF w wersji 6.

Dodatkowe zmiany

W wersji 7 wprowadziliśmy też powierzchowne zmiany, które powinny uprościć integrację i zrezygnować z używania wycofanych plików odczytu encji do celów referencyjnych.

Nowa kolejność na listach w niektórych kolumnach

Plik SDF w wersji 7 gwarantuje stabilną kolejność niektórych kolumn z listą podczas generowania pliku. Dzięki temu zachowasz spójność i łatwiejsze sprawdzenie. Ta kolejność nie jest egzekwowana przy przesyłaniu pliku, ale jest stosowana podczas generowania zaktualizowanego pliku.

Pełną listę kolumn, które są teraz generowane w kolejności rosnącej lub alfabetycznej, znajdziesz w informacjach o wersji 7.

Rekomendacje związane z nowymi informacjami o identyfikatorze

Zaktualizowaliśmy definicje wielu kolumn, aby usunąć odwołania do wycofanych plików odczytu elementu. Zamiast tego zalecamy inne metody wyszukiwania identyfikatorów.

Wartości zwracane przez te kolumny niczym się nie różnią od wartości w plikach SDF w wersji 6, ale zalecamy zaktualizowanie integracji, aby pobierać identyfikatory za pomocą nowej zalecanej metody, którą znajdziesz w opisach kolumn w wersji 7.

Typy plików i ich kolumny
Kampania	Kierowanie geograficzne – wyklucz Kierowanie geograficzne – uwzględnij Kierowanie na źródło zasobów reklamowych – wyklucz Kierowanie na źródło zasobów reklamowych – uwzględnij Kierowanie na język – wyklucz Kierowanie na język – uwzględnij
Zamówienie reklamowe	Kierowanie na odbiorców o podobnych zainteresowaniach i na rynku – wyklucz Kierowanie na odbiorców o podobnych zainteresowaniach i na rynku – uwzględnij Kierowanie na kolekcję aplikacji – wyklucz Kierowanie na kolekcję aplikacji – uwzględnij Kierowanie na odbiorców – wyklucz Kierowanie na odbiorców – uwzględnij Kierowanie na kategorie – wyklucz Kierowanie na kategorie – uwzględnij Kierowanie na gatunki treści – wyklucz Kierowanie na gatunki treści – uwzględnij Kierowanie na listy niestandardowe Kierowanie geograficzne – wyklucz Kierowanie geograficzne – uwzględnij Kierowanie na źródło zasobów reklamowych – wyklucz Kierowanie na źródło zasobów reklamowych – uwzględnij Kierowanie na listę słów kluczowych – wyklucz Kierowanie na język – wyklucz Kierowanie na język – uwzględnij
Element zamówienia	Kierowanie na odbiorców o podobnych zainteresowaniach i na rynku – wyklucz Kierowanie na odbiorców o podobnych zainteresowaniach i na rynku – uwzględnij Kierowanie na kolekcję aplikacji – wyklucz Kierowanie na kolekcję aplikacji – uwzględnij Kierowanie na odbiorców – wyklucz Kierowanie na odbiorców – uwzględnij Kierowanie na kategorie – wyklucz Kierowanie na kategorie – uwzględnij Kierowanie na odbiorców z połączonych list Kierowanie na gatunki treści – wyklucz Kierowanie na gatunki treści – uwzględnij Identyfikatory aktywności Floodlight konwersji Przypisania kreacji Kierowanie na listy niestandardowe Kierowanie geograficzne – wyklucz Kierowanie geograficzne – uwzględnij Kierowanie na źródło zasobów reklamowych – wyklucz Kierowanie na źródło zasobów reklamowych – uwzględnij Kierowanie na listę słów kluczowych – wyklucz Kierowanie na język – wyklucz Kierowanie na język – uwzględnij
Produkt medialny	Kierowanie na odbiorców – wyklucz Kierowanie na odbiorców – uwzględnij Kierowanie na kategorie – wyklucz Kierowanie na kategorie – uwzględnij Kierowanie geograficzne – uwzględnij Kierowanie na język – wyklucz Kierowanie na język – uwzględnij
Grupa reklam w YouTube	Kierowanie na odbiorców o podobnych zainteresowaniach i na rynku – wyklucz Kierowanie na odbiorców o podobnych zainteresowaniach i na rynku – uwzględnij Kierowanie na odbiorców – wyklucz Kierowanie na odbiorców – uwzględnij Kierowanie na kategorie – wyklucz Kierowanie na kategorie – uwzględnij Kierowanie na listy niestandardowe