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 memperbaruidataAccessConfig.sdfConfig.sdfConfig.version
keSDF_VERSION_7
dan, jika diperlukan,dataAccessConfig.sdfConfig.overridePartnerSdfConfig
keTrue
.
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 " 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
Ambil
resource |
Penargetan Operator - Kecualikan Penargetan Operator - Sertakan |
Kolom ini telah diperbarui untuk menggunakan nilai
Ambil
resource |
Penargetan Saluran - Kecualikan Penargetan Saluran - Sertakan |
Kolom ini telah diperbarui untuk menggunakan nilai
Ambil
resource |
Penargetan Perangkat - Kecualikan Penargetan Perangkat - Sertakan |
Kolom ini telah diperbarui untuk menggunakan nilai
Ambil
resource |
Mengukur Saluran DAR |
Kolom ini telah diperbarui untuk menggunakan nilai
Ambil
resource |
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 " 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
Ambil
resource |
Penargetan Operator - Kecualikan Penargetan Operator - Sertakan |
Kolom ini telah diperbarui untuk menggunakan nilai
Ambil
resource |
Penargetan Saluran - Kecualikan Penargetan Saluran - Sertakan |
Kolom ini telah diperbarui untuk menggunakan nilai
Ambil
resource |
Penargetan Perangkat - Kecualikan Penargetan Perangkat - Sertakan |
Kolom ini telah diperbarui untuk menggunakan nilai
Ambil
resource |
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
Ambil
resource |
Penargetan Perangkat - Sertakan |
Kolom ini telah diperbarui untuk menggunakan nilai
Ambil
resource |
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 |
|
|||||||||||||||||||||
Perjanjian Pemasangan Iklan |
|
|||||||||||||||||||||
Item Baris |
|
|||||||||||||||||||||
Produk Media |
|
|||||||||||||||||||||
Grup Iklan YouTube |
|