Menggunakan dropbox feed Generik

Dengan dropbox feed Generik, beberapa jenis feed dapat diupload ke satu dropbox per lingkungan. Panduan ini berisi penjelasan mengenai cara menggunakan dropbox Generik dan memberikan link ke panduan yang sesuai untuk masing-masing feed yang ingin Anda gunakan.

(Lihat bagian Mengekspor Feed (end-to-end) atau Feed (starter) pada dokumentasi).

Dropbox Generik bergantung pada adanya dua upload terpisah:

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

Membuat struktur kolom deskriptor

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

  • Menggunakan ekstensi file .filesetdesc.json
  • Setiap nama file deskriptor harus unik dan tidak dapat digunakan kembali untuk 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 memungkinkan untuk kolom name meliputi:

Contoh file deskripsi JSON untuk feed penawaran dengan dua shard tersedia di bawah ini:

{
  "generation_timestamp": 1524606581,
  "name": "promote.offer",
  "data_file": [
    "offers_1524606581_1.json",
    "offers_1524606581_2.json"
  ]
}

Menyusun konten feed

Setelah mengupload file deskriptor, Anda akan 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, salah diberi nama, atau diupload ke lokasi yang berbeda, seluruh feed tidak akan diproses.

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

Setiap nama file feed harus unik dan tidak dapat digunakan kembali pada 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

  • Usahakan agar ukuran file feed di bawah 200 MB (setelah kompresi).
  • Sebagian besar integrasi hanya perlu menggunakan satu shard. Gunakan sharding sesedikit mungkin. Maksimum 1.000 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 sehingga semua file sharding memiliki ukuran yang sama.
  • Jika perlu, gunakan gzip untuk mengompresi feed. Namun, lakukan hal ini untuk setiap shard feed.

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 Anda.

Cari name yang Anda masukkan dalam file deskripsi 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.