Bermigrasi ke File Data Terstruktur v7

Terakhir diperbarui: 18-10-2023

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

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

Memigrasikan versi File Data Terstruktur

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

Perbarui versi File Data Terstruktur

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

Memperbarui setelan resource induk

Versi File Data Terstruktur default ditetapkan pada level resource partner dan pengiklan. Versi ini digunakan sebagai default saat mendownload File Data Terstruktur melalui antarmuka atau API.

Menetapkan di antarmuka

Di level partner

Buka partner yang dimaksud. Buka halaman Basic Details di menu Partner Settings di navigasi sebelah kiri. Update konfigurasi versi SDF di bagian File Data Terstruktur ke v7.

Di tingkat pengiklan

Buka pengiklan yang dimaksud. Buka halaman Basic Details di bagian menu Advertiser Settings di navigasi sebelah kiri. Update konfigurasi versi SDF di bagian File Data Terstruktur ke v7. Jika versi default ditetapkan di level Partner, setelan ini mungkin tidak dapat diedit.

Ditetapkan di API

Di tingkat pengiklan

Buat permintaan advertisers.patch untuk memperbarui dataAccessConfig.sdfConfig.sdfConfig.version menjadi SDF_VERSION_7 dan, jika diperlukan, dataAccessConfig.sdfConfig.overridePartnerSdfConfig menjadi True.

Mengupdate 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

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

Peringatan: ID yang diperbarui mungkin tidak kompatibel dengan skrip bidding kustom. Sebaiknya tinjau dokumentasi referensi sinyal skrip bidding kustom untuk mendapatkan informasi terbaru tentang ID yang harus digunakan sebelum bermigrasi.

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

Perjanjian Pemasangan Iklan

v7 Petunjuk migrasi untuk kolom
Penargetan Aplikasi - Kecualikan Penargetan Aplikasi - Sertakan	Kolom ini telah diperbarui untuk menggunakan ID aplikasi dengan mengikuti format "App Platform:App ID". Contohnya meliputi: "APP:com.google.android.gm", "APP:422689480", "ANDROID_TV_APP:com.google.android.youtube.tvunplugged" Platform aplikasi diidentifikasi dengan nilai string. ID aplikasi adalah ID yang diberikan oleh platform yang relevan, seperti ID paket dari Play Store Android atau ID Aplikasi 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 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 resource Display & Video 360 API TargetingOption dalam 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 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

v7 Petunjuk migrasi untuk kolom
Penargetan Aplikasi - Kecualikan Penargetan Aplikasi - Sertakan	Kolom ini telah diperbarui untuk menggunakan ID aplikasi dengan mengikuti format "App Platform:App ID". Contohnya meliputi: "APP:com.google.android.gm", "APP:422689480", "ANDROID_TV_APP:com.google.android.youtube.tvunplugged" Platform aplikasi diidentifikasi dengan nilai string. ID aplikasi adalah ID yang diberikan oleh platform yang relevan, seperti ID paket dari Play Store Android atau ID Aplikasi dari App Store Apple.
Pengganda Bid	Kolom ini telah diperbarui untuk menggunakan ID Kriteria baru untuk jenis baris aplikasi dan situs. Jenis baris app telah diperbarui untuk menggunakan nilai string gabungan dari platform aplikasi dan ID platform aplikasi, yang dipisahkan dengan titik dua, untuk ID kriteria. Platform aplikasi diidentifikasi dengan nilai string. ID aplikasi adalah ID yang disediakan oleh platform yang relevan, seperti ID paket dari Play Store Android atau ID Aplikasi dari App Store Apple. Jenis baris site 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 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 resource Display & Video 360 API TargetingOption dalam 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

v7 Petunjuk migrasi untuk kolom
Penargetan Saluran - Kecualikan Penargetan Saluran - Sertakan	Kolom ini telah diperbarui untuk menggunakan nilai channelId 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 resource Display & Video 360 API TargetingOption dalam 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 TrueView
Item Baris	Periode Waktu Target Frekuensi 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

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

Pengurutan daftar baru untuk beberapa kolom

SDF v7 menjamin pengurutan yang stabil pada kolom daftar tertentu setelah pembuatan file. Proses ini menghasilkan perilaku yang lebih konsisten dan peninjauan yang lebih mudah. Pengurutan ini tidak diterapkan pada saat file diupload, tetapi diterapkan kemudian 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 jumlah kolom untuk menghapus referensi ke File Bacaan Entity yang tidak digunakan lagi dan sebagai gantinya merekomendasikan cara lain 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 di deskripsi kolom v7.

Jenis {i>file<i} 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