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.

Dropbox Generik bergantung pada ada dua upload terpisah:

  1. File deskriptor: mendeskripsikan jenis feed yang akan Anda mengupload
  2. File feed: konten feed yang sebenarnya

Menyusun kolom deskriptor

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

  • Menggunakan ekstensi file .filesetdesc.json
  • Setiap nama file deskriptor harus unik dan tidak dapat digunakan kembali di berbagai upload. Rab 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:

  • reservewithgoogle.conversion_data

Contoh file deskriptor JSON untuk feed penawaran dengan dua shard adalah yang 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 kemudian 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 apa 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. Saran dari kami termasuk 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).
  • Sebagian besar integrasi hanya perlu menggunakan satu shard. Sebaiknya Anda menggunakan sharding 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 performa yang lebih baik, bagi data secara merata di antara shard agar semua file sharding dengan 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 deskriptor dan feed) buka Dasbor Histori Feed (dokumentasi) di Portal Partner (buka Histori > Feed) untuk mengikuti progres penyerapan feed Anda.

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

Setelah feed ditransfer (statusnya adalah Success atau Fail), Anda dapat mengklik barisnya untuk melihat detail dari {i>error<i} dan peringatan.