Migracja do plików uporządkowanych danych w wersji 9
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
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.
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:
Otwórz stronę wybranego partnera.
W menu nawigacyjnym po lewej stronie otwórz stronę Informacje podstawowe w sekcji Ustawienia partnera.
W sekcji Pliki uporządkowanych danych zaktualizuj konfigurację wersji SDF na wersję 9.
Na poziomie reklamodawcy:
Otwórz właściwości odpowiedniego reklamodawcy.
W menu nawigacyjnym po lewej stronie otwórz stronę Informacje podstawowe w sekcji Ustawienia reklamodawcy.
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.
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:
[[["Łatwo zrozumieć","easyToUnderstand","thumb-up"],["Rozwiązało to mój problem","solvedMyProblem","thumb-up"],["Inne","otherUp","thumb-up"]],[["Brak potrzebnych mi informacji","missingTheInformationINeed","thumb-down"],["Zbyt skomplikowane / zbyt wiele czynności do wykonania","tooComplicatedTooManySteps","thumb-down"],["Nieaktualne treści","outOfDate","thumb-down"],["Problem z tłumaczeniem","translationIssue","thumb-down"],["Problem z przykładami/kodem","samplesCodeIssue","thumb-down"],["Inne","otherDown","thumb-down"]],["Ostatnia aktualizacja: 2025-08-21 UTC."],[],[],null,["# Migrate to Structured Data Files v9\n\n*Last update: 2025-08-21*\n\nThis guide leads you through these processes:\n\n- Update your selected Structured Data Files version to v9 using the Display \\& Video 360 UI or API.\n- Migrate your integration from deprecated Structured Data Files versions (v7, v7.1, v8, or v8.1) to v9. It points you to pages detailing the changes between your current version and v9 that may impact your integration. In some cases, you will have to use v9 to upload SDFs starting on September 8, 2025.\n\nSee the [migration pages specific to each version](#migrate_from_your_current_sdf_version) for an\nexhaustive list of differences between your version and v9.\n\nUpdate your Structured Data Files version\n-----------------------------------------\n\nTo use v9, you must update your resources and SDF generation actions to use v9\nwhen downloading and uploading Structured Data Files.\n\n### Update Structured Data Files version\n\nTo use a new Structured Data Files version, update the assigned version in your\nparent Partner and Advertiser resources and use the new version when creating\nindividual download tasks in the [Display \\& Video 360 API](/display-video/api/guides/getting-started/overview).\n\n#### Update parent resource settings\n\nYou set the default Structured Data Files version at the partner and advertiser\nresource level. This version is used as the default when downloading Structured\nData Files through the interface or API.\n\n##### Set in the interface\n\n**At the partner level:**\n\n1. Navigate to the intended partner.\n2. Go to the **Basic Details** page under the **Partner Settings** menu in the left-hand navigation.\n3. Update the **SDF version** configuration in the Structured Data Files section to **v9**.\n\n**At the advertiser level:**\n\n1. Navigate to the intended advertiser.\n2. Go to the **Basic Details** page under the **Advertiser Settings** menu in the left-hand navigation.\n3. Update the **SDF version** configuration in the **Structured Data Files** section to **v9**. If the default version is set at the Partner level, this setting may not be editable.\n\n#### Set in the API\n\n**At the partner level:** You cannot set the default SDF version at the Partner\nlevel in the API.\n\n**At the advertiser level:** Make an [`advertisers.patch`](/display-video/api/reference/rest/current/advertisers/patch) request to\nupdate the\n[`dataAccessConfig.sdfConfig.sdfConfig.version`](/display-video/api/reference/rest/current/SdfConfig#FIELDS.version) to\n`SDF_VERSION_9` and, if needed,\n[`dataAccessConfig.sdfConfig.overridePartnerSdfConfig`](/display-video/api/reference/rest/current/advertisers#AdvertiserSdfConfig.FIELDS.override_partner_sdf_config)\nto True.\n\n### Update `sdfdownloadtasks.create` requests in the API\n\nWhen making a [`sdfdownloadtasks.create`](/display-video/api/reference/rest/current/sdfdownloadtasks/create) request using the\nDisplay \\& Video 360 API, set the [`version`](/display-video/api/reference/rest/current/sdfdownloadtasks/create#body.request_body.FIELDS.version) field of the request body to\n`SDF_VERSION_9`.\n\nMigrate from your current SDF version\n-------------------------------------\n\n| **Important:** The only new feature in v9 is the ability to declare whether a line item will serve EU political ads. This column will be required starting **September 8, 2025**.\n\nThe following pages walk you through the necessary updates to make to your\nintegration when migrating from your current version to v9 and provide a\ncomprehensive list of all changes between the versions:\n\n- [Migrate from v7](/display-video/api/structured-data-file/v7/migrate-to-v9)\n- [Migrate from v7.1](/display-video/api/structured-data-file/v7-1/migrate-to-v9)\n- [Migrate from v8](/display-video/api/structured-data-file/v8/migrate-to-v9)\n- [Migrate from v8.1](/display-video/api/structured-data-file/v8-1/migrate-to-v9)"]]
