Anda mungkin harus bermigrasi ke v9 untuk mengupload File Data Terstruktur setelah 8 September 2025. Lihat halaman penghentian penggunaan kami untuk mengetahui detail selengkapnya dan panduan migrasi v9 kami untuk mendapatkan petunjuk langkah demi langkah.
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Terakhir diperbarui: 21-08-2025
Panduan ini akan memandu Anda melalui proses berikut:
Perbarui versi File Data Terstruktur yang dipilih ke v9 menggunakan
UI atau API Display & Video 360.
Migrasikan integrasi Anda dari versi File Data Terstruktur yang tidak digunakan lagi (v7,
v7.1, v8, atau v8.1) ke v9. Halaman ini mengarahkan Anda ke halaman yang menjelaskan perubahan antara
versi saat ini dan v9 yang dapat memengaruhi integrasi Anda. Dalam beberapa kasus,
Anda harus menggunakan v9 untuk mengupload SDF mulai 8 September 2025.
Untuk menggunakan v9, Anda harus memperbarui tindakan pembuatan SDF dan resource untuk menggunakan v9 saat mendownload dan mengupload File Data Terstruktur.
Memperbarui versi File Data Terstruktur
Untuk menggunakan versi File Data Terstruktur yang baru, perbarui versi yang ditetapkan di resource Partner dan Pengiklan induk Anda dan gunakan versi baru saat membuat tugas download individual di Display & Video 360 API.
Memperbarui setelan resource induk
Anda menetapkan versi File Data Terstruktur default di tingkat resource partner dan pengiklan. Versi ini digunakan sebagai default saat mendownload File Data Terstruktur melalui antarmuka atau API.
Ditetapkan di antarmuka
Di tingkat partner:
Buka partner yang dituju.
Buka halaman Detail Dasar di menu Setelan Partner di navigasi sebelah kiri.
Perbarui konfigurasi versi SDF di bagian File Data Terstruktur
menjadi v9.
Di tingkat pengiklan:
Buka pengiklan yang dituju.
Buka halaman Detail Dasar di menu Setelan Pengiklan di navigasi sebelah kiri.
Perbarui konfigurasi versi SDF di bagian File Data Terstruktur
menjadi v9. Jika versi default ditetapkan di tingkat Partner, setelan ini mungkin tidak dapat diedit.
Disetel di API
Di tingkat partner: Anda tidak dapat menetapkan versi SDF default di tingkat Partner dalam API.
Memperbarui permintaan sdfdownloadtasks.create di API
Saat membuat permintaan sdfdownloadtasks.create menggunakan
Display & Video 360 API, tetapkan kolom version isi permintaan ke
SDF_VERSION_9.
Bermigrasi dari versi SDF saat ini
Halaman berikut akan memandu Anda melakukan pembaruan yang diperlukan pada
integrasi saat bermigrasi dari versi saat ini ke v9 dan memberikan
daftar lengkap semua perubahan antara versi:
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Informasi yang saya butuhkan tidak ada","missingTheInformationINeed","thumb-down"],["Terlalu rumit/langkahnya terlalu banyak","tooComplicatedTooManySteps","thumb-down"],["Sudah usang","outOfDate","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Masalah kode / contoh","samplesCodeIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 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)"]]
