Dropbox feed umum memungkinkan beberapa jenis feed diupload ke satu dropbox per lingkungan. Panduan ini akan memandu Anda mempelajari cara menggunakan dropbox Generik dan memberikan link ke panduan yang sesuai untuk masing-masing feed yang akan Anda gunakan.
(Lihat bagian Mengekspor Feed (dari awal) atau Feed (starter) dalam dokumentasi).Dropbox generik mengandalkan dua upload terpisah:
- File deskriptor: yang menjelaskan jenis feed yang akan Anda upload
- File feed: konten feed yang sebenarnya
Membuat struktur kolom deskripsi
File deskriptor diupload untuk memberi tahu sistem kami tentang jenis feed yang Anda upload. Hal ini memungkinkan kami memvalidasi dan memproses feed dengan benar. File deskriptor harus diupload sebelum konten feed dan harus mengikuti persyaratan penamaan ini:
- Menggunakan ekstensi file .filesetdesc.json
- Setiap nama file deskriptor harus unik dan tidak dapat digunakan kembali di seluruh upload. Sebaiknya
sertakan stempel waktu pembuatan dalam nama file.
- Contoh: offer_1524606581.filesetdesc.json
message FilesetDescriptor {
// The timestamp at which this feed was generated, in Unix time format
// (seconds since the epoch). (required)
int64 generation_timestamp = 1;
// Identifies the name of this feed. (required)
string name = 2;
// Paths (relative to the dropbox root) specifying data files included in this
// feed. (required)
repeated string data_file = 3;
}
Nilai yang mungkin untuk kolom name mencakup:
Contoh file deskriptor JSON untuk feed penawaran dengan dua shard tersedia di bawah:
{
"generation_timestamp": 1524606581,
"name": "promote.offer",
"data_file": [
"offers_1524606581_1.json",
"offers_1524606581_2.json"
]
}
Membuat struktur konten feed
Setelah mengupload file deskriptor, Anda harus mengupload semua file feed untuk jenis data feed yang sesuai dengan file konfigurasi feed yang diberi nama oleh file deskriptor Anda. Nama file dan lokasi jalur (relatif dalam
dropbox) harus sama persis dengan yang disertakan dalam kolom
data_file. Jika file tidak ada, tidak diberi nama dengan benar, atau diupload ke lokasi yang berbeda, seluruh feed tidak akan diproses.
Konten file data feed ini harus sesuai dengan spesifikasi feed yang relevan yang ditentukan dalam file deskriptor.
Setiap nama file file feed harus unik dan tidak dapat digunakan kembali untuk berbagai upload. Sebaiknya sertakan stempel waktu pembuatan dan nomor shard (ID inkremental) dalam nama file.
- Contoh: offer_1524606581_1.json
Ukuran file feed dan frekuensi upload
- Pertahankan ukuran file feed di bawah 200 MB (setelah kompresi).
- Sebagian besar integrasi hanya perlu menggunakan satu shard. Anda harus menggunakan shard sesedikit mungkin. Maksimal ada 1000 shard per feed.
- Setiap data yang dikirim dalam satu shard tidak perlu dikirim dalam nomor shard yang sama di feed mendatang.
- Untuk mendapatkan performa yang lebih baik, bagi data secara merata di antara shard untuk membuat semua file shard berukuran serupa.
- Jika perlu, gunakan gzip untuk mengompresi feed. Namun, lakukan hal tersebut untuk setiap shard feed individual.
Pemecahan masalah dan proses debug
Setelah mengupload file (file deskripsi dan feed) buka dasbor Histori Feed (dokumentasi) di Portal Partner (buka Histori > Feed) untuk mengikuti progres penyerapan feed.
Cari name yang Anda masukkan dalam file deskriptor di kolom "Nama feed" untuk menemukan feed Anda.
Setelah feed diserap (statusnya adalah Success atau Fail), Anda dapat mengklik barisnya untuk melihat detail error dan peringatan.