Bermigrasi ke File Data Terstruktur v7

Terakhir diperbarui: 18-10-2023

Panduan ini memandu Anda melalui proses migrasi ke File Data Terstruktur (SDF) v7 dari versi sebelumnya dan perubahan, baik yang diperlukan maupun yang 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

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

Memperbarui 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 tugas download individual 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 diinginkan. Buka halaman Basic Details di bagian menu Partner Settings di navigasi sebelah kiri. Perbarui konfigurasi versi SDF di bagian File Data Terstruktur menjadi v7.

Di tingkat pengiklan

Buka pengiklan yang diinginkan. Buka halaman Detail Dasar di bagian menu Setelan Pengiklan di navigasi sebelah kiri. Perbarui konfigurasi versi SDF di bagian File Data Terstruktur menjadi 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 menjadi SDF_VERSION_7 dan, jika diperlukan, dataAccessConfig.sdfConfig.overridePartnerSdfConfig menjadi 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.

Memperbarui ID di kolom yang wajib diisi

Di v7, ruang ID yang digunakan oleh sebagian kolom telah diperbarui untuk memisahkan File Data Terstruktur dari produk File Bacaan Entitas yang tidak digunakan lagi dan lebih selaras 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 mengetahui informasi terbaru tentang ID yang harus digunakan sebelum melakukan migrasi.

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

Pemesanan Pemasangan Iklan

Petunjuk Migrasi v7 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 oleh 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.
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 diberi nomor halaman 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 diberi nomor halaman menggunakan layanan targetingTypes.targetingOptions.
Penargetan Channel - Kecualikan Penargetan Channel - 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 di-pagination 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 berdasarkan 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 diberi nomor halaman 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 di-pagination 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 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 oleh 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.
Pengganda Bid	Kolom ini telah diperbarui untuk menggunakan ID Kriteria baru untuk jenis baris aplikasi dan situs. Jenis baris aplikasi telah diperbarui untuk menggunakan nilai string yang digabungkan 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 disediakan oleh platform yang relevan, seperti ID paket dari Play Store Android atau ID Aplikasi 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 diberi nomor halaman 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 diberi nomor halaman menggunakan layanan targetingTypes.targetingOptions.
Penargetan Channel - Kecualikan Penargetan Channel - 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 di-pagination 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 berdasarkan 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 diberi nomor halaman 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 Channel - Kecualikan Penargetan Channel - 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 di-pagination 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 berdasarkan 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 diberi nomor halaman menggunakan layanan targetingTypes.targetingOptions.

Menambahkan integrasi dengan kolom yang ditambahkan sejak v6

Jika bermigrasi dari v6 ke v7, Anda perlu 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 dangkal yang akan membantu Anda menyederhanakan integrasi dan beralih dari penggunaan File Baca Entity yang tidak digunakan lagi untuk referensi.

Pengurutan daftar baru untuk subkumpulan kolom

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

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

Rekomendasi referensi ID baru

Kami telah memperbarui definisi sejumlah kolom untuk menghapus referensi ke File Baca Entitas yang tidak digunakan lagi dan sebagai gantinya merekomendasikan cara lain untuk mencari ID.

Nilai yang ditampilkan oleh kolom berikut tidak berbeda dengan di SDF v6, tetapi sebaiknya perbarui integrasi Anda 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 Kumpulan 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 Kumpulan 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
Ad Group 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