Menggunakan dropbox feed Generik

Dropbox feed Generik memungkinkan beberapa jenis feed diupload ke satu dropbox per lingkungan. Panduan ini akan menjelaskan cara menggunakan Dropbox umum dan memberikan link ke panduan yang sesuai untuk masing-masing yang ingin Anda gunakan.

(Harap lihat Bagian Mengekspor Feed (end-to-end) atau Feed (starter) dalam dokumentasi).

Dropbox Generik mengandalkan adanya dua upload terpisah:

  1. File deskripsi: menjelaskan jenis feed yang akan Anda upload
  2. File feed: konten feed yang sebenarnya

Menyusun struktur kolom deskripsi

File deskriptor diupload untuk memberi tahu sistem tentang jenis feed yang Anda sedang diupload. Dengan begitu, kami dapat memvalidasi dan memproses feed dengan benar. File deskripsi harus diupload sebelum konten feed dan harus mengikuti persyaratan penamaan ini:

  • Anda harus menggunakan ekstensi file .filesetdesc.json untuk file deskriptor.
  • Setiap nama file deskripsi harus unik dan tidak dapat digunakan kembali di seluruh upload. Sebaiknya sertakan stempel waktu pembuatan dan nama feed dalam nama file.
    • Contoh: offers_1524606581.filesetdesc.json
  • Setiap file deskripsi harus mencantumkan semua file data dalam feed terbaru untuk nama feed yang relevan.
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 memungkinkan untuk kolom name meliputi:

Contoh file deskripsi 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"
  ]
}

Menyusun konten feed

Setelah mengupload file deskripsi, Anda akan mengupload semua file feed untuk jenis data feed yang sesuai dengan file konfigurasi feed yang diberi nama oleh file deskripsi Anda. Nama file dan lokasi jalur (relatif dalam dropbox) harus sama persis dengan yang disertakan dalam kolom data_file. Jika file hilang, salah dinamai, atau diupload ke lokasi berbeda, maka seluruh feed tidak akan diproses.

Konten file data feed ini harus sesuai dengan spesifikasi yang relevan feed yang telah ditentukan dalam file deskriptor.

Setiap nama file file feed harus unik dan tidak dapat digunakan kembali di semua upload. Sebaiknya sertakan stempel waktu pembuatan dan nomor shard (ID inkremental) dalam nama file.

  • Contoh: offers_1524606581_1.json

Ukuran file feed dan frekuensi upload

  • Pertahankan ukuran file feed di bawah 200 MB (setelah kompresi).
  • Setiap ukuran file data yang didekompresi harus kurang dari 2 GB.
  • Sebagian besar integrasi hanya perlu menggunakan satu shard. Sebaiknya gunakan shard sesedikit mungkin. Maksimum ada 1.000 shard per feed.
  • Masing-masing kumpulan data yang dikirim dalam satu shard tidak perlu dikirim dalam nomor shard dalam feed mendatang.
  • Untuk mendapatkan performa yang lebih baik, bagi data secara merata di antara shard sehingga semua file yang di-sharding memiliki ukuran yang 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 Partner Portal (buka Histori > Feed) untuk memantau progres penyerapan feed Anda.

Cari name yang telah Anda masukkan dalam file deskriptor di bagian "Feed name" untuk menemukan feed.

Setelah feed diserap (statusnya Success atau Fail), Anda dapat mengklik barisnya untuk melihat detail error dan peringatan.