Menggunakan dropbox feed Generik

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

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 deskripsi diupload untuk memberi tahu sistem kami jenis feed yang Anda upload. Hal ini memungkinkan kami 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 deskripsi.
  • 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;
}

Kemungkinan nilai untuk kolom name mencakup:

  • reservewithgoogle.conversion_data

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 ada file yang tidak ada, namanya tidak tepat, atau diupload ke lokasi lain, seluruh feed tidak akan diproses.

Isi file data feed ini harus sesuai dengan spesifikasi feed yang relevan yang ditentukan dalam file deskripsi.

Setiap nama file feed harus unik dan tidak dapat digunakan kembali di seluruh 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. Maksimal 1.000 shard per feed.
  • Setiap catatan 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 yang di-sharding memiliki ukuran yang serupa.
  • Jika perlu, gunakan gzip untuk mengompresi feed. Namun, lakukan hal tersebut untuk setiap shard feed.

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 deskripsi di kolom "Nama feed" untuk menemukan feed Anda.

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