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

Ostatnia aktualizacja: 21.08.2025

Ten przewodnik przeprowadzi Cię przez te procesy:

  • Zaktualizuj wybraną wersję plików uporządkowanych danych do wersji 9 za pomocą interfejsu Display & Video 360 lub interfejsu API.
  • Przenieś integrację z wersji plików uporządkowanych danych, które zostały wycofane (v7, v7.1, v8 lub v8.1), do wersji 9. Kieruje Cię do stron z informacjami o zmianach między Twoją obecną wersją a wersją 9, które mogą mieć wpływ na Twoją integrację. W niektórych przypadkach od 8 września 2025 r. do przesyłania plików SDF trzeba będzie używać wersji 9.

Pełną listę różnic między Twoją wersją a wersją 9 znajdziesz na stronach dotyczących migracji do poszczególnych wersji.

Aktualizowanie wersji plików uporządkowanych danych

Aby używać wersji 9, musisz zaktualizować zasoby i działania związane z generowaniem plików SDF, aby podczas pobierania i przesyłania plików uporządkowanych danych korzystać z wersji 9.

Aktualizowanie wersji plików uporządkowanych danych

Aby użyć nowej wersji plików uporządkowanych danych, zaktualizuj przypisaną wersję w zasobach nadrzędnego partnera i reklamodawcy oraz użyj nowej wersji podczas tworzenia poszczególnych zadań pobierania w interfejsie Display & Video 360 API.

Aktualizowanie ustawień zasobu nadrzędnego

Domyślną wersję plików danych strukturalnych ustawia się na poziomie zasobów partnera i reklamodawcy. Ta wersja jest używana domyślnie podczas pobierania plików uporządkowanych danych za pomocą interfejsu lub interfejsu API.

Ustawione w interfejsie

Na poziomie partnera:

  1. Otwórz stronę wybranego partnera.
  2. W menu nawigacyjnym po lewej stronie otwórz stronę Informacje podstawowe w sekcji Ustawienia partnera.
  3. W sekcji Pliki uporządkowanych danych zaktualizuj konfigurację wersji SDF na wersję 9.

Na poziomie reklamodawcy:

  1. Otwórz właściwości odpowiedniego reklamodawcy.
  2. W menu nawigacyjnym po lewej stronie otwórz stronę Informacje podstawowe w sekcji Ustawienia reklamodawcy.
  3. W sekcji Pliki uporządkowanych danych zaktualizuj konfigurację wersji SDF na v9. Jeśli wersja domyślna jest ustawiona na poziomie partnera, to ustawienie może być niedostępne do edycji.

Ustawienie w interfejsie API

Na poziomie partnera: w interfejsie API nie możesz ustawić domyślnej wersji pliku SDF na poziomie partnera.

Na poziomie reklamodawcy: wyślij żądanie advertisers.patch, aby zaktualizować wartość dataAccessConfig.sdfConfig.sdfConfig.version na SDF_VERSION_9 i w razie potrzeby zmienić wartość dataAccessConfig.sdfConfig.overridePartnerSdfConfig na „True” (Prawda).

Aktualizowanie żądań sdfdownloadtasks.create w interfejsie API

Podczas wysyłania żądania sdfdownloadtasks.create za pomocą interfejsu Display & Video 360 API ustaw pole version w treści żądania na SDF_VERSION_9.

Migracja z obecnej wersji SDF

Na tych stronach znajdziesz informacje o niezbędnych zmianach, które musisz wprowadzić w integracji podczas przechodzenia z obecnej wersji na wersję 9, oraz pełną listę wszystkich zmian między tymi wersjami: