Bermigrasi ke File Data Terstruktur v8

Terakhir diperbarui: 12-11-2024

Panduan ini memandu Anda melalui proses migrasi dari penggunaan File Data Terstruktur v7.1 ke v8 dan menjelaskan perubahan antara kedua versi yang dapat memengaruhi integrasi Anda.

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

Memigrasikan versi File Data Terstruktur

Untuk bermigrasi ke File Data Terstruktur (SDF) v8 dari versi sebelumnya:

  1. Perbarui resource dan tindakan pembuatan SDF Anda untuk menggunakan v8.
  2. Memperbarui logika resource Iklan untuk mengidentifikasi jenis saat pembuatan.
  3. Menambahkan logika baru untuk membaca, membuat, dan memperbarui resource Peningkat Permintaan.

Memperbarui versi File Data Terstruktur

Untuk menggunakan versi File Data Terstruktur baru, perbarui versi yang ditetapkan di resource Partner dan Pengiklan induk Anda, lalu gunakan versi baru saat membuat 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

  1. Buka partner yang diinginkan.
  2. Luaskan menu Partner settings di navigasi sebelah kiri, lalu buka halaman Basic details.
  3. Perbarui konfigurasi versi SDF di bagian File Data Terstruktur menjadi v8.

Di tingkat pengiklan

  1. Buka pengiklan yang dimaksud.
  2. Luaskan menu Setelan pengiklan di navigasi sebelah kiri dan buka halaman Detail dasar.
  3. Perbarui konfigurasi versi SDF di bagian File Data Terstruktur menjadi v8. Jika versi default ditetapkan di tingkat Partner, setelan ini mungkin tidak dapat diedit.
Ditetapkan di API
Di tingkat partner
Anda tidak dapat menetapkan versi SDF default di tingkat Partner di API.
Di tingkat pengiklan
Buat permintaan advertisers.patch untuk memperbarui dataAccessConfig.sdfConfig.sdfConfig.version menjadi SDF_VERSION_8 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_8.

Menentukan jenis di Resource iklan

v8 menambahkan kolom Ad Type ke file Iklan, yang menampilkan jenis Iklan yang diwakili oleh setiap baris. Kolom baru ini diperlukan dan akan diisi untuk resource yang ada saat mendownload file Iklan v8.

Saat memperbarui Iklan yang ada, nilai kolom ini tidak boleh diubah.

Saat membuat Iklan baru, Anda harus mengisi kolom ini dengan salah satu nilai yang tercantum dalam deskripsi kolom.

Memperbarui logika untuk resource Peningkat Permintaan

v8 mendukung pembuatan, pengambilan, dan pembaruan kampanye Peningkat Permintaan menggunakan file Item Baris, Grup Iklan, dan Iklan. Resource Demand Gen menggunakan logika yang berbeda untuk verifikasi stempel waktu, memerlukan pendudukan kolom tambahan, dan dibatasi oleh pembatasan baru di tiga jenis file.

Verifikasi stempel waktu

Untuk semua item baris non-Peningkat Permintaan, kolom Timestamp file Item Baris diisi saat didownload dengan waktu terakhir item baris diubah. Nilai ini digunakan saat memperbarui item baris menggunakan SDF untuk memverifikasi bahwa item baris belum diperbarui sejak file asli didownload. Jika begitu, update akan gagal.

Untuk item baris Peningkat Permintaan, kolom Timestamp dan verifikasi yang menyertainya berfungsi secara berbeda. Untuk entri item baris Peningkat Permintaan, kolom diisi dengan waktu saat ini saat didownload. Saat upload, Display & Video 360 akan memeriksa apakah sudah lebih dari 24 jam sejak stempel waktu yang diberikan. Jika sudah lebih dari 24 jam, entri file asli dianggap sudah tidak berlaku dan update akan gagal. Jika hal ini terjadi, download file lagi dan buat update berdasarkan versi yang lebih baru. Metode verifikasi baru ini tidak mencegah Anda menimpa perubahan yang dibuat dalam 24 jam terakhir. Untuk menghindari penggantian yang tidak disengaja, hanya sertakan item baris Peningkat Permintaan yang ingin Anda perbarui dalam file yang Anda upload.

Kolom wajib

Jenis file berikut memiliki kolom yang kini diperlukan untuk resource Demand Gen tertentu, selain kolom yang diperlukan untuk semua entity jenis file tersebut.

Item Baris
Kolom wajib untuk nilai kolom Item Baris Type berikut
Peningkat Permintaan
Pacing Amount
TrueView Bid Strategy Type
TrueView Bid Strategy Value
Kolom wajib untuk nilai kolom Iklan Ad Type berikut
Carousel Peningkat Permintaan
Business Name
Call to Action
Demand Gen Cards
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Gambar Peningkat Permintaan
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Marketing Image Asset Id
Produk Peningkat Permintaan
Business Name
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Video Peningkat Permintaan
Business Name
Call to Action
Description 1
Headline
In-feed Video Headline
Landing Page URL
Logo Asset IDs
Video Id

Pembatasan yang diperbarui

Selain kolom baru yang diperlukan untuk Item Baris dan Iklan Peningkat Permintaan tertentu, beberapa kolom di seluruh jenis file Item Baris, Grup Iklan, dan Iklan memiliki batasan penggunaan baru yang berlaku untuk resource Peningkat Permintaan.

Pembatasan ini banyak dan spesifik untuk kolom yang dimaksud, sehingga panduan ini tidak memberikan daftar pembatasan yang lengkap. Sebaiknya Anda membaca dengan cermat dokumentasi referensi v8 untuk jenis file Item Baris, Grup Iklan, dan Iklan sebelum membuat atau memperbarui resource Perolehan Permintaan menggunakan upload SDF.