Bermigrasi ke File Data Terstruktur v7

Terakhir diperbarui: 18-10-2023

Panduan ini memandu Anda dalam proses migrasi ke File Data Terstruktur (SDF) v7 dari versi sebelumnya serta perubahan yang wajib dan disarankan, yang dapat Anda lakukan untuk lebih mengoptimalkan integrasi.

Lihat catatan rilis untuk melihat daftar lengkap perbedaan antara v6 dan v7.

Memigrasikan versi File Data Terstruktur Anda

Migrasi ke File Data Terstruktur v7 dari versi sebelumnya mengharuskan Anda untuk menentukan versi baru, memperbarui ruang ID untuk sebagian kolom yang ada, dan menambahkan integrasi dengan kolom baru.

Mengupdate versi File Data Terstruktur

Untuk mengupdate ke versi File Data Terstruktur baru, Anda harus mengupdate versi yang ditetapkan ke resource Partner dan Pengiklan induk serta setiap tugas download di Display & Video 360 API.

Memperbarui setelan resource induk

Versi File Data Terstruktur default ditetapkan 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 Basic Details pada menu Partner Settings di navigasi sebelah kiri. Update konfigurasi SDF versi di bagian Structured Data Files ke v7.
Di tingkat pengiklan
Buka pengiklan yang diinginkan. Buka halaman Basic Details pada menu Advertiser Settings di navigasi sebelah kiri. Update konfigurasi SDF versi di bagian Structured Data Files ke v7. Jika versi default ditetapkan di tingkat Partner, setelan ini mungkin tidak dapat diedit.
Ditetapkan di API
Di tingkat pengiklan
Buat permintaan advertisers.patch untuk memperbarui dataAccessConfig.sdfConfig.sdfConfig.version ke SDF_VERSION_7 dan, jika diperlukan, dataAccessConfig.sdfConfig.overridePartnerSdfConfig ke True.

Memperbarui permintaan sdfdownloadtasks.create di API

Saat membuat permintaan sdfdownloadtasks.create menggunakan Display & Video 360 API, tetapkan kolom version dari isi permintaan ke SDF_VERSION_7.

Perbarui ID di kolom yang wajib diisi

Pada v7, ruang ID yang digunakan oleh subset kolom telah diperbarui untuk memisahkan File Data Terstruktur dari produk Entity Read Files yang tidak digunakan lagi dan makin menyelaraskan dengan alat yang didukung, seperti Display & Video 360 API.

Bagian ini mencantumkan setiap kolom menggunakan ID yang berbeda dengan v6 dan petunjuk cara mengambil informasi referensi tentang nilai baru.

Perjanjian Pemasangan Iklan

Petunjuk migrasi v7 untuk kolom

Penargetan Aplikasi - Kecualikan

Penargetan Aplikasi - Sertakan

Kolom ini telah diperbarui untuk menggunakan ID aplikasi dengan format "App Platform:App ID". Contohnya mencakup: "APP:com.google.android.gm", "APP:422689480", "ANDROID_TV_APP:com.google.android.youtube.tvunplugged"

Platform aplikasi diidentifikasi oleh nilai string. ID aplikasi adalah ID yang diberikan oleh platform yang relevan, seperti ID paket dari Play Store Android atau App ID dari App Store Apple.

Penargetan Browser - Kecualikan

Penargetan Browser - Sertakan

Kolom ini telah diperbarui untuk menggunakan nilai targetingOptionId dari resource TargetingOption Display & Video 360 API di bagian jenis penargetan TARGETING_TYPE_BROWSER.

Ambil resource TargetingOption satu per satu atau dalam daftar yang dipaginasi menggunakan layanan targetingTypes.targetingOptions.

Penargetan Operator - Kecualikan

Penargetan Operator - Sertakan

Kolom ini telah diperbarui untuk menggunakan nilai targetingOptionId dari resource TargetingOption Display & Video 360 API di bagian jenis penargetan TARGETING_TYPE_CARRIER_AND_ISP.

Ambil resource TargetingOption satu per satu atau dalam daftar yang dipaginasi menggunakan layanan targetingTypes.targetingOptions.

Penargetan Saluran - Kecualikan

Penargetan Saluran - Sertakan

Kolom ini telah diperbarui untuk menggunakan nilai channelId dari resource Channel Display & Video 360 API.

Ambil resource Channel satu per satu atau dalam daftar yang dipaginasi menggunakan layanan advertisers.channels dan partners.channels.

Penargetan Perangkat - Kecualikan

Penargetan Perangkat - Sertakan

Kolom ini telah diperbarui untuk menggunakan nilai targetingOptionId dari resource TargetingOption Display & Video 360 API pada jenis penargetan berikut:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

Ambil resource TargetingOption satu per satu atau dalam daftar yang dipaginasi menggunakan layanan targetingTypes.targetingOptions.

Mengukur Saluran DAR

Kolom ini telah diperbarui untuk menggunakan nilai channelId dari resource Channel Display & Video 360 API.

Ambil resource Channel satu per satu atau dalam daftar yang dipaginasi menggunakan layanan advertisers.channels dan partners.channels.

Penargetan Situs - Kecualikan

Penargetan Situs - Sertakan

Kolom ini telah diperbarui untuk mengidentifikasi situs melalui string URL.

Item Baris

Petunjuk migrasi v7 untuk kolom

Penargetan Aplikasi - Kecualikan

Penargetan Aplikasi - Sertakan

Kolom ini telah diperbarui untuk menggunakan ID aplikasi dengan format "App Platform:App ID". Contohnya mencakup: "APP:com.google.android.gm", "APP:422689480", "ANDROID_TV_APP:com.google.android.youtube.tvunplugged"

Platform aplikasi diidentifikasi oleh nilai string. ID aplikasi adalah ID yang diberikan oleh platform yang relevan, seperti ID paket dari Play Store Android atau App ID dari App Store Apple.

Pengganda Bid

Kolom ini telah diperbarui agar menggunakan ID Kriteria baru untuk jenis baris aplikasi dan situs.

Jenis baris app telah diupdate untuk menggunakan nilai string gabungan dari platform aplikasi dan ID platform aplikasi, yang dipisahkan dengan titik dua, untuk ID kriteria. Platform aplikasi diidentifikasi oleh nilai string. ID aplikasi adalah ID yang diberikan oleh platform yang relevan, seperti ID paket dari Play Store Android atau App ID dari App Store Apple.

Jenis baris situs telah diperbarui untuk menggunakan string URL sebagai ID Kriteria.

Penargetan Browser - Kecualikan

Penargetan Browser - Sertakan

Kolom ini telah diperbarui untuk menggunakan nilai targetingOptionId dari resource TargetingOption Display & Video 360 API di bagian jenis penargetan TARGETING_TYPE_BROWSER.

Ambil resource TargetingOption satu per satu atau dalam daftar yang dipaginasi menggunakan layanan targetingTypes.targetingOptions.

Penargetan Operator - Kecualikan

Penargetan Operator - Sertakan

Kolom ini telah diperbarui untuk menggunakan nilai targetingOptionId dari resource TargetingOption Display & Video 360 API di bagian jenis penargetan TARGETING_TYPE_CARRIER_AND_ISP.

Ambil resource TargetingOption satu per satu atau dalam daftar yang dipaginasi menggunakan layanan targetingTypes.targetingOptions.

Penargetan Saluran - Kecualikan

Penargetan Saluran - Sertakan

Kolom ini telah diperbarui untuk menggunakan nilai channelId dari resource Channel Display & Video 360 API.

Ambil resource Channel satu per satu atau dalam daftar yang dipaginasi menggunakan layanan advertisers.channels dan partners.channels.

Penargetan Perangkat - Kecualikan

Penargetan Perangkat - Sertakan

Kolom ini telah diperbarui untuk menggunakan nilai targetingOptionId dari resource TargetingOption Display & Video 360 API pada jenis penargetan berikut:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

Ambil resource TargetingOption satu per satu atau dalam daftar yang dipaginasi menggunakan layanan targetingTypes.targetingOptions.

Penargetan Situs - Kecualikan

Penargetan Situs - Sertakan

Kolom ini telah diperbarui untuk mengidentifikasi situs melalui string URL.

Produk Media

Petunjuk migrasi v7 untuk kolom

Penargetan Saluran - Kecualikan

Penargetan Saluran - Sertakan

Kolom ini telah diperbarui untuk menggunakan nilai channelId dari resource Channel Display & Video 360 API.

Ambil resource Channel satu per satu atau dalam daftar yang dipaginasi menggunakan layanan advertisers.channels dan partners.channels.

Penargetan Perangkat - Sertakan

Kolom ini telah diperbarui untuk menggunakan nilai targetingOptionId dari resource TargetingOption Display & Video 360 API pada jenis penargetan berikut:

  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DEVICE_MAKE_MODEL
  • TARGETING_TYPE_OPERATING_SYSTEM

Ambil resource TargetingOption satu per satu atau dalam daftar yang dipaginasi menggunakan layanan targetingTypes.targetingOptions.

Menambahkan integrasi dengan kolom yang ditambahkan sejak v6

Jika bermigrasi dari v6 ke v7, Anda harus menambahkan kolom berikut ke file yang relevan:

Jenis file Kolom
Item Baris Jumlah Target Frekuensi Target TrueView
Item Baris Periode Waktu Target Frekuensi Target TrueView
Grup iklan YouTube Penargetan yang Dioptimalkan

Jika Anda bermigrasi dari versi File Data Terstruktur sebelumnya, lihat catatan rilis File Data Terstruktur untuk mengetahui informasi tentang kolom tambahan yang ditambahkan antara versi saat ini dan SDF v6.

Perubahan lainnya

Pada v7, kami juga telah menerapkan beberapa perubahan kecil yang akan membantu Anda menyederhanakan integrasi dan beralih dari penggunaan File Baca Entity yang tidak digunakan lagi sebagai referensi.

Penyusunan daftar baru untuk subset kolom

SDF v7 menjamin pengurutan yang stabil untuk kolom daftar tertentu pada saat pembuatan file. Hal ini menghasilkan perilaku yang lebih konsisten dan peninjauan yang lebih mudah. Pengurutan ini tidak diterapkan pada saat upload file, tetapi diterapkan selanjutnya saat membuat file yang diperbarui.

Tinjau catatan rilis v7 untuk melihat daftar lengkap kolom yang kini dibuat dalam urutan numerik atau abjad menaik.

Rekomendasi referensi ID baru

Kami telah memperbarui definisi sejumlah kolom untuk menghapus referensi ke File Bacaan Entity yang tidak digunakan lagi dan merekomendasikan cara lain untuk pencarian ID.

Nilai yang ditampilkan oleh kolom berikut tidak berbeda dengan di SDF v6, tetapi sebaiknya perbarui integrasi untuk mengambil ID menggunakan metode baru yang direkomendasikan, yang dapat ditemukan dalam deskripsi kolom v7.

Jenis file dan kolomnya
Kampanye
Penargetan Geografi - Kecualikan
Penargetan Geografi - Sertakan
Penargetan Sumber Inventaris - Kecualikan
Penargetan Sumber Inventaris - Sertakan
Penargetan Bahasa - Kecualikan
Penargetan Bahasa - Sertakan
Perjanjian Pemasangan Iklan
Penargetan Minat & Berniat Beli - Kecualikan
Penargetan Minat & Berniat Beli - Sertakan
Penargetan Koleksi Aplikasi - Kecualikan
Penargetan Koleksi Aplikasi - Sertakan
Penargetan Audiens - Kecualikan
Penargetan Audiens - Sertakan
Penargetan Kategori - Kecualikan
Penargetan Kategori - Sertakan
Penargetan Genre Konten - Kecualikan
Penargetan Genre Konten - Sertakan
Penargetan Daftar Kustom
Penargetan Geografi - Kecualikan
Penargetan Geografi - Sertakan
Penargetan Sumber Inventaris - Kecualikan
Penargetan Sumber Inventaris - Sertakan
Penargetan Daftar Kata Kunci - Kecualikan
Penargetan Bahasa - Kecualikan
Penargetan Bahasa - Sertakan
Item Baris
Penargetan Minat & Berniat Beli - Kecualikan
Penargetan Minat & Berniat Beli - Sertakan
Penargetan Koleksi Aplikasi - Kecualikan
Penargetan Koleksi Aplikasi - Sertakan
Penargetan Audiens - Kecualikan
Penargetan Audiens - Sertakan
Penargetan Kategori - Kecualikan
Penargetan Kategori - Sertakan
Penargetan Audiens Gabungan
Penargetan Genre Konten - Kecualikan
Penargetan Genre Konten - Sertakan
ID Aktivitas Floodlight Konversi
Penetapan Materi Iklan
Penargetan Daftar Kustom
Penargetan Geografi - Kecualikan
Penargetan Geografi - Sertakan
Penargetan Sumber Inventaris - Kecualikan
Penargetan Sumber Inventaris - Sertakan
Penargetan Daftar Kata Kunci - Kecualikan
Penargetan Bahasa - Kecualikan
Penargetan Bahasa - Sertakan
Produk Media
Penargetan Audiens - Kecualikan
Penargetan Audiens - Sertakan
Penargetan Kategori - Kecualikan
Penargetan Kategori - Sertakan
Penargetan Geografi - Sertakan
Penargetan Bahasa - Kecualikan
Penargetan Bahasa - Sertakan
Grup Iklan YouTube
Penargetan Minat & Berniat Beli - Kecualikan
Penargetan Minat & Berniat Beli - Sertakan
Penargetan Audiens - Kecualikan
Penargetan Audiens - Sertakan
Penargetan Kategori - Kecualikan
Penargetan Kategori - Sertakan
Penargetan Daftar Kustom