File Data Terstruktur (SDF) adalah file CSV dengan format khusus. API ini memungkinkan pengambilan, pembuatan, dan pengeditan resource secara massal di Display & Video 360. Lakukan pembaruan pada aset secara massal dengan mendownload, mengedit, lalu mengupload ulang SDF.
UI Display & Video 360 mendukung download dan upload SDF. Display & Video 360 API mendukung download SDF.
Format
SDF menggunakan salah satu dari dua format dasar, Standar dan QA:
- Anda dapat mendownload dan mengupload file format Standard. Data dalam file ini dapat menggunakan ID numerik untuk memastikan akurasi saat diupload. Informasi referensi mungkin diperlukan untuk menafsirkan data.
- Anda dapat mendownload file berformat QA. File ini memberikan data yang sama dengan file format Standar, tetapi menggunakan nilai yang lebih mudah dibaca. Misalnya, beberapa kolom dapat menggunakan nama tampilan sebagai pengganti ID. Kolom khusus untuk format ini menggunakan sufiks "Qa".
Jenis file
SDF mendukung tujuh jenis resource. Setiap jenis resource memiliki jenis filenya sendiri dengan struktur kolomnya sendiri. Jenis resource yang didukung adalah:
- Kampanye
- Pemesanan Pemasangan Iklan
- Item Baris
- Grup Iklan
- Iklan
- Sumber Inventaris
- Produk Media
Hanya jenis file Item Baris dan Grup Iklan yang mendukung format QA.
Versi SDF baru dirilis secara rutin dan versi sebelumnya tidak digunakan lagi. Versi baru memperbarui struktur kolom jenis file. Jika perlu, versi SDF baru akan menyertakan panduan migrasi saat peluncuran.
Download error
Download SDF dapat menyebabkan dua jenis error: error Pembuatan file dan resource Dilewati.
Error pembuatan file
Pembuatan SDF dapat berhenti karena error. Jika pembuatan gagal saat menggunakan
Display & Video 360 API, tugas yang selesai akan menetapkan kolom
error dengan objek Status. Objek
Status akan berisi pesan yang menjelaskan penyebab
error.
Baca selengkapnya tentang error ini di halaman panduan Error dan peringatan kami.
Error yang dilewati
SDF tidak mendukung semua subjenis resource. Jika resource tidak dapat disertakan dalam
SDF, file "Dilewati" (contoh: SDF-LineItems-Skipped.csv) akan disertakan dalam
download. File ini memiliki struktur dua kolom. Kolom pertama mengidentifikasi
resource yang dilewati. Kolom kedua menjelaskan pengecualiannya.
Upload file
Upload SDF menggunakan UI Display & Video 360 untuk membuat atau memperbarui resource yang ada.
Ikuti langkah-langkah berikut untuk meminimalkan error saat memperbarui atau membuat resource dengan SDF:
- Download SDF menggunakan Display & Video 360 API atau UI.
- Ubah entri file yang ada untuk melakukan pembaruan pada resource yang ada.
- Tambahkan entri file untuk membuat resource baru.
- Hapus semua entri yang tidak baru atau diperbarui. Tindakan ini mengurangi ukuran file dan menghilangkan kemungkinan update yang tidak disengaja.
- Upload file di UI Display & Video 360.
Setelah SDF diupload dan diproses, file SDF-ResultFile.zip tersedia untuk didownload. File ZIP ini dapat berisi dua kemungkinan file:
SDF-{ResourceType}-Updated-ResultFile.csv, yang mencantumkan resource yang berhasil diperbarui atau dibuat.SDF-{ResourceType}-Failed-ResultFile.csv, yang mencantumkan operasi yang gagal dan pesan error yang relevan.
File ZIP dapat berisi satu atau kedua file.