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

Ostatnia aktualizacja: 18.10.2023 r.

W tym przewodniku omawiamy proces migracji do plików uporządkowanych danych w wersji 7 z poprzedniej wersji oraz zmiany, zarówno wymagane, jak i zalecane, 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 podzbioru istniejących kolumn oraz dodania integracji z nowymi kolumnami.

Zaktualizuj wersję plików uporządkowanych danych

Aby zaktualizować pliki uporządkowanych danych do nowej wersji, musisz zaktualizować wersję przypisaną do zasobów partnera nadrzędnego i reklamodawcy oraz Twoje indywidualne zadania pobierania za pomocą interfejsu Display & Video 360 API.

Zaktualizuj ustawienia zasobów nadrzędnych

Domyślna wersja plików uporządkowanych danych jest ustawiana na poziomie zasobów partnera i reklamodawcy. Jest ona używana jako domyślna przy pobieraniu plików uporządkowanych danych za pomocą interfejsu lub interfejsu API.

Ustaw w interfejsie

Na poziomie partnera

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

Na poziomie reklamodawcy

Otwórz właściwości odpowiedniego reklamodawcy. Otwórz stronę Informacje podstawowe w menu Ustawienia reklamodawcy w panelu nawigacyjnym po lewej stronie. W sekcji Pliki uporządkowanych danych zaktualizuj konfigurację wersji SDF do wersji v7. Jeśli wersja domyślna jest ustawiona na poziomie partnera, nie można edytować tego ustawienia.

Ustawione w interfejsie API

Na poziomie reklamodawcy

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

Zaktualizuj żądania sdfdownloadtasks.create w interfejsie API

Tworząc żądanie sdfdownloadtasks.create za pomocą interfejsu Display & Video 360 API, ustaw pole version w treści żądania na SDF_VERSION_7.

Zaktualizuj identyfikatory w wymaganych kolumnach

W wersji 7 zaktualizowaliśmy przestrzenie identyfikatorów używane przez podzbiór kolumn, aby oddzielić pliki uporządkowanych danych od wycofanej usługi Pliki odczytu elementów i dostosować 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żyć przed migracją, znajdziesz w dokumentacji referencyjnej sygnałów dotyczących skryptów ustalania stawek niestandardowych.

W tej sekcji wymieniono każdą kolumnę z innymi identyfikatorami niż w wersji 6 oraz instrukcje pobierania informacji referencyjnych dotyczących nowych wartości.

Zamówienie reklamowe

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

Element zamówienia

Instrukcje migracji kolumn do wersji 7
Kierowanie na aplikacje – wyklucz Kierowanie na aplikacje – uwzględnianie	Te kolumny zostały zaktualizowane i używają identyfikatorów aplikacji w formacie „App Platform:App ID”. Przykłady: „APP:com.google.android.gm”, „APP:422689480”, „ANDROID_TV_APP:com.google.android.youtube.tvunplugged” Platformy aplikacji są identyfikowane za pomocą wartości ciągu znaków. Identyfikatory aplikacji to identyfikatory podawane przez odpowiednią platformę, np. identyfikator pakietu ze Sklepu Play na Androida lub identyfikator aplikacji ze sklepu App Store firmy Apple.
Mnożniki stawek	Ta kolumna została zaktualizowana, aby używać w niej nowych identyfikatorów kryteriów dla wierszy 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 za pomocą wartości ciągu znaków. Identyfikatory aplikacji to identyfikatory podawane przez odpowiednią platformę, np. identyfikator pakietu ze Sklepu Play na Androida lub identyfikator aplikacji ze sklepu App Store firmy Apple. Zaktualizowaliśmy typ wiersza site, aby używał ciągów adresów URL jako identyfikatorów kryteriów.
Kierowanie na przeglądarkę – wyklucz Kierowanie na przeglądarkę – uwzględnianie	Ta kolumna została zaktualizowana i korzysta z wartości targetingOptionId zasobów Display & Video 360 API TargetingOption dla typu kierowania TARGETING_TYPE_BROWSER. Pobierz zasoby TargetingOption pojedynczo lub z list podzielonych na strony za pomocą usługi targetingTypes.targetingOptions.
Kierowanie na operatora – wyklucz Kierowanie na operatora – uwzględnianie	Ta kolumna została zaktualizowana i korzysta z wartości targetingOptionId zasobów Display & Video 360 API TargetingOption dla typu kierowania TARGETING_TYPE_CARRIER_AND_ISP. Pobierz zasoby TargetingOption pojedynczo lub z list podzielonych na strony za pomocą usługi targetingTypes.targetingOptions.
Kierowanie na kanał – wyklucz Kierowanie na kanał – uwzględniaj	Ta kolumna została zaktualizowana i używa wartości channelId zasobu Display & Video 360 API Channel. Pobierz zasoby Channel pojedynczo lub z list podzielonych na strony za pomocą usług advertisers.channels i partners.channels.
Kierowanie na urządzenia – wyklucz Kierowanie na urządzenia – uwzględniaj	Ta kolumna została zaktualizowana i używa wartości targetingOptionId interfejsu Display & Video 360 API TargetingOption w ramach tych typów kierowania: TARGETING_TYPE_DEVICE_TYPE TARGETING_TYPE_DEVICE_MAKE_MODEL TARGETING_TYPE_OPERATING_SYSTEM Pobierz zasoby TargetingOption pojedynczo lub z list podzielonych na strony za pomocą usługi targetingTypes.targetingOptions.
Kierowanie na witryny – wyklucz Kierowanie na witryny – uwzględnia	Ta kolumna została zaktualizowana, aby identyfikować witryny za pomocą ciągów znaków z adresem URL.

Produkt medialny

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

Dodaj integrację z kolumnami dodanymi od wersji 6

W przypadku migracji z wersji 6 na 7 musisz dodać do odpowiednich plików te kolumny:

Typ pliku	Kolumna
Element zamówienia	Docelowa liczba wyświetleń reklam TrueView
Element zamówienia	Przedział czasu docelowej częstotliwości wyświetleń reklam TrueView
Grupa reklam w YouTube	Kierowanie zoptymalizowane

Jeśli przeprowadzasz migrację z wcześniejszej wersji plików uporządkowanych danych, informacje o dodatkowych kolumnach dodanych między bieżącą wersją a plikami SDF w wersji 6 znajdziesz w informacjach o wersji plików uporządkowanych danych.

Dodatkowe zmiany

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

Nowa kolejność list dla podzbioru kolumn

Plik SDF w wersji 7 gwarantuje stabilną kolejność określonych kolumn listy po wygenerowaniu pliku. Dzięki temu zachowanie jest bardziej spójne i ułatwiamy ich sprawdzanie. 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 kolejności rosnącej lub alfabetycznej, znajdziesz w informacjach o wersji 7.

Nowe rekomendacje dotyczące identyfikatorów plików referencyjnych

Zaktualizowaliśmy definicje kilku kolumn, aby usunąć odniesienia do wycofywanych plików odczytu elementu. Zamiast tego zaleciliśmy inne sposoby wyszukiwania identyfikatorów.

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

Typy plików i ich kolumny
Kampania	Kierowanie geograficzne – wyklucz Kierowanie geograficzne – uwzględnianie Kierowanie na źródło zasobów reklamowych – wykluczanie Kierowanie na źródło zasobów reklamowych – uwzględnianie Kierowanie na język – wyklucz Kierowanie na język – uwzględnianie
Zamówienie reklamowe	Kierowanie na odbiorców o podobnych zainteresowaniach i odbiorców na rynku – wyklucz Kierowanie na odbiorców o podobnych zainteresowaniach i odbiorców na rynku – uwzględnia Kierowanie na kolekcje aplikacji – wykluczanie Kierowanie na kolekcje aplikacji – uwzględnianie Kierowanie na odbiorców – wyklucz Kierowanie na grupę docelową – uwzględnia Kierowanie na kategorię – wyklucz Kierowanie na kategorię – uwzględnianie Kierowanie na gatunek treści – wyklucz Kierowanie na gatunek treści – uwzględnianie Kierowanie na listy niestandardowe Kierowanie geograficzne – wyklucz Kierowanie geograficzne – uwzględnianie Kierowanie na źródło zasobów reklamowych – wykluczanie Kierowanie na źródło zasobów reklamowych – uwzględnianie Kierowanie na listę słów kluczowych – wykluczanie Kierowanie na język – wyklucz Kierowanie na język – uwzględnianie
Element zamówienia	Kierowanie na odbiorców o podobnych zainteresowaniach i odbiorców na rynku – wyklucz Kierowanie na odbiorców o podobnych zainteresowaniach i odbiorców na rynku – uwzględnia Kierowanie na kolekcje aplikacji – wykluczanie Kierowanie na kolekcje aplikacji – uwzględnianie Kierowanie na odbiorców – wyklucz Kierowanie na grupę docelową – uwzględnia Kierowanie na kategorię – wyklucz Kierowanie na kategorię – uwzględnianie Połączone kierowanie na odbiorców Kierowanie na gatunek treści – wyklucz Kierowanie na gatunek treści – uwzględnianie Identyfikatory aktywności Floodlight powiązanych z konwersjami Przypisania kreacji Kierowanie na listy niestandardowe Kierowanie geograficzne – wyklucz Kierowanie geograficzne – uwzględnianie Kierowanie na źródło zasobów reklamowych – wykluczanie Kierowanie na źródło zasobów reklamowych – uwzględnianie Kierowanie na listę słów kluczowych – wykluczanie Kierowanie na język – wyklucz Kierowanie na język – uwzględnianie
Produkt medialny	Kierowanie na odbiorców – wyklucz Kierowanie na grupę docelową – uwzględnia Kierowanie na kategorię – wyklucz Kierowanie na kategorię – uwzględnianie Kierowanie geograficzne – uwzględnianie Kierowanie na język – wyklucz Kierowanie na język – uwzględnianie
Grupa reklam w YouTube	Kierowanie na odbiorców o podobnych zainteresowaniach i odbiorców na rynku – wyklucz Kierowanie na odbiorców o podobnych zainteresowaniach i odbiorców na rynku – uwzględnia Kierowanie na odbiorców – wyklucz Kierowanie na grupę docelową – uwzględnia Kierowanie na kategorię – wyklucz Kierowanie na kategorię – uwzględnianie Kierowanie na listy niestandardowe