Panduan Criteo Feed¶
Panduan ini berisi informasi tentang product feed berdasarkan spesifikasi Criteo Product Feed.
Overview¶
Criteo Product Feed adalah file yang mangandung informasi tentang semua produk di dalam website anda. Criteo menggunakan informasi tersebut untuk mambangun banner produk dynamis.
Panduan ini akan membantu anda memberikan informasi minimum yang diperlukan untuk membuat product feed untuk Criteo campaign anda.
Format yang didukung¶
Untuk memastikan bahwa Criteo dapat menedukung product feed anda, mohon gunakan salah satu format di bawah. Anda dapat mengunduh contoh-contoh feed di link yang terdapat di tabel di bawah ini.
| Format feed | Perincian | Contoh |
|---|---|---|
| TSV | Format ini berdasarkan pada value yang dipisahkan tab. Headers harus dideklarasikan di baris pertama file tersebut. Nama field dapat berisi spasi dan garis bawah (contoh: image_link atau image link) | Contoh feed |
| CSV | Format ini berdasarkan pada value yang dipisahkan koma. Headers harus dideklarasikan di baris pertama file tersebut. Nama field dapat berisi spasi dan garis bawah (contoh: image_link atau image link) | Contoh feed |
| XML | Format ini harus sesuai dengan dasar-dasar struktur XML. Daftar product harus dimulai dengan tag deklarasi <?xml | Contoh feed |
Fields yang diperlukan¶
Informasi produk tidak boleh mengandung tag HTML atau style tags.
| Field | Perincian | Requirements | Contoh |
|---|---|---|---|
| id | Id adalah pengenal produk unik yang mewakili satu, dan hanya satu, produk. Setelah id ditentukan ke suatu produk dan diimpor, id tersebut tidak boleh digunakan untuk produk yang berbeda, begitu juga id untuk perubahan produk tertentu. Jika Anda memiliki item_group_id di dalam feed, isi id dengan ID / SKU variant | Persyaratan huruf: d harus hanya berisi huruf ASCII, dan tidak boleh mengandung tanda kutip Batas: 240 Tipe: String |
Contoh:: abc123-black-7.5 |
| title | Judul adalah nama produk, biasanya seperti yang ditampilkan di halaman detail produk. Ini akan digunakan sebagai deskriptor teks utama di spanduk untuk produk tertentu | Persyaratan huruf: Judul harus dimulai dengan huruf atau angka Limit: 150 Tipe: String |
Contoh: Working Boots – Size 7.5 |
| description | Deskripsi adalah bagian teks pendek yang memberikan informasi lebih lanjut tentang suatu produk selain nama. Dikarenakan desain spanduk, deskripsi yang lebih pendek (di bawah 50 karakter) akan lebih cocok dengan format dan tata letak Criteo, tetapi tidak semua format dan tata letak memiliki deskripsi |
Persyaratan huruf: Deskripsi harus dimulai dengan huruf atau angka. Hapus semua tag HTML dari bidang ini, termasuk style, embed, object, dan anchor tags | Limit: 5000 Tipe: String |
| link | Link adalah halaman detail khusus produk. Link biasanya, meskipun tidak selalu unik untuk produk tertentu. Informasi produk di URL ini harus sesuai dengan informasi terkait yang disediakan di feed Anda. Harap tentukan protokol (http: // atau https: //) untuk semua URL Jika Anda menjalankan Criteo Predictive Search, nama domain di bidang ini harus cocok dengan domain yang diklaim di Google Merchant Center |
Persyaratan huruf: Link harus dimulai dengan protokol (http: // atau https: //) diikuti oleh URL lengkap dari halaman detail produk. Semua simbol harus diencode. Misalnya. $ harus diganti dengan %24 Limit: 1024 Tipe: String |
Contoh: http://www.example.com/product/working-boots |
| image_link | Image_link adalah URL yang menentukan jalur file ke gambar produk yang diberikan. Image_link akan digunakan untuk menampilkan gambar produk di spanduk. Idealnya, gambar harus setidaknya 800x800 piksel dan beratnya di bawah 16MB. Gambar harus memiliki header Content-Type yang ditentukan, baik gambar / png, gambar / gif atau gambar / jpeg. Jika Anda membatasi gambar Anda agar tidak dapat diakses melalui cURL, silakan masukkan ke daftar putih agen pengguna kami sehingga kami dapat menampilkan gambar Anda di banner Criteo: curl / 7.15 + (x64-criteo) libcurl / 7.15 + OpenSSL zlib libidn | Persyaratan huruf: Image_link harus diawali dengan http: // atau https: // diikuti oleh URL lengkap dari gambar produk. Semua simbol harus diencode. Misalnya. $ harus diganti dengan %24 Limit: 2000 Tipe: String |
Contoh: http://www.example.com/product/image/working-boots.png |
| availability | Availability menunjukkan apakah produk dapat dibeli di situs. Anda dapat mengisi ketersediaan dengan 3 nilai yang mungkin: preorder (saat ini barang belum dikirim, tetapi masih dapat dibeli), out of stock (item tidak dikirim dan Anda tidak menerima pesanan untuk item ini), dan in stock (item pengiriman dan pesanan dapat ditempatkan untuk item ini). Item yang ditandai sebagai stok habis akan dikeluarkan dari yang ditampilkan di spanduk | Persyaratan huruf: Availability harus diisi dengan salah satu dari tiga nilai berikut: - preorder - out of stock - in stock Limit: 16 Tipe: String |
Contoh: in stock |
| price | Harga yang di rekomendasikan oleh produsen. Jika produk yang diberikan "on sale", harga akan diisi dengan harga yang lebih tinggi. Harga harus dalam mata uang yang sama dengan website. Populasikan harga dengan nilai numerik menggunakan periode (.) Sebagai pemisah desimal dan pemisah ribuan | Persyaratan huruf: Pemisah desimal harus berupa titik (.) Tanpa pemisah ribuan Limit: 14 Tipe: String |
Contoh: 1299.99 |
| sale_price | Sale_price adalah harga saat produk tersedia untuk dibeli di situs, jika produk tertentu adalah ‘on sale’, sale_price akan diisi dengan harga yang lebih rendah. Sale_price harus dalam mata uang yang sama dengan situs. Hanya populasikan sale_price dengan harga numerik menggunakan periode (.) Sebagai pemisah desimal dan tanpa pemisah ribuan. | Persyaratan huruf: Pemisah desimal harus berupa titik (.) Tanpa pemisah ribuan Limit: 14 Tipe: String |
Contoh: 1099.99 |
| google_product_category | Atribut level kategori menunjukkan kategori produk yang dikirim, sesuai dengan taksonomi produk Google. Jika produk Anda dapat dihubungkan ke beberapa kategori, kami hanya menginginkan yang paling relevan. | Persyaratan huruf: Kami menerima ID dan jalur kategori lengkap Limit: 500 Tipe: String |
Contoh: Women’s > Shoes > Working Boots OR 2271 |
| product_type | Product_type adalah kategori (atau daftar kategori) yang merupakan bagian dari produk. Bidang Product_type mencantumkan kategori merchandising Anda, atau sekumpulan kategori merchandising untuk produk ini. Itu harus cocok dengan kategori situs web Anda. Setiap tingkat dalam hirarki perlu dibatasi oleh ">". Jika suatu produk tersedia dalam beberapa kategori, harap kirimkan kategori yang berbeda sebagai koma (,) yang dipisahkan dengan kategori utama terlebih dahulu. product_type case-sensitive, jadi jika Anda menggunakan wanita untuk satu produk dan untuk yang lain, Criteo akan menafsirkannya sebagai dua kategori berbeda | Persyaratan huruf: Product_type harus dimulai dengan huruf atau angka, dan hanya dapat berisi karakter ASCII. Pembatas di antara kategori harus> (& gt; untuk feed XML). Kami hanya mendukung jalur kategori penuh. Jika suatu produk tersedia dalam beberapa kategori, harap kirimkan kategori yang berbeda sebagai koma (,) yang dipisahkan dengan kategori utama terlebih dahulu. Kami tidak menerima ID kategori jalan. ID harus diisi dalam bidang product_type_key Limit: 500 Tipe: String |
Contoh: Single: Computing > Keyboards and Mice > Mice > Wireless Mice Multiple: Computing > Keyboards and Mice > Mice > Wireless Mice, Gifts > For Dad > Mice |
| brand | Merek menunjukkan nama merek produk. Beberapa produk tidak memiliki merek yang jelas terkait. Dalam hal ini info ini tidak perlu disediakan. | Persyaratan huruf: Nama harus dimulai dengan huruf atau angka, dan hanya boleh berisi karakter ASCII. Hapus semua tag HTML dari bidang ini, termasuk tag gaya. Limit: 70 Tipe: String |
Contoh: My Brand |
| gtin | Global Trade Item Number (GTIN) adalah id produk unik yang digunakan untuk mengidentifikasi produk, layanan, atau item di pasar global. GTIN termasuk: - GTIN-12 (UPC-A): ini adalah angka 12-digit yang digunakan terutama di Amerika - GTIN-8 (EAN/UCC-8): ini adalah angka 8-digit yang digunakan terutama di luar Amerika. - GTIN-13 (EAN/UCC-13): ini adalah angka 13-digit yang digunakan terutama di luar Amerika. - GTIN-14 (EAN/UCC-14 or ITF-14): ini adalah angka 14-digit yang digunakan untuk mengidentifikasi item-item perdagangan pada berbagai tingkat pengemasan |
Persyaratan huruf: The value must be a 8-, 12-, 13-, or 14-digit number (UPC, EAN, JAN, or ISBN). Limit: 50 Tipe: String |
Contoh: 0001234560012 |
| mpn | Manufacturer Part Number (MPN) adalah nomor yang secara unik mengidentifikasi produk ke produsennya | Limit: 70 Tipe: String |
Contoh: 4060882 |
Upload¶
Criteo dapat mengambil feed produk menggunakan salah satu dari protokol berikut
- HTTP or HTTPS
- FTP (File Transfer Protocol)
- Criteo FTP Server
Anda dapat mengunggah feed produk yang telah diselesaikan ke server Criteo FTP kami. Untuk melakukannya, silakan merujuk keCriteo FTP guide here
