Panduan ini merupakan referensi untuk format beranda yang didukung dan kolom untuk membuat iklan otomotif.
Semua kolom enum tidak peka huruf besar/kecil.
Sediakan beranda Anda dalam format yang benar: CSV
, TSV
, atau XML
. Setelah Anda membuat file beranda, Anda harus meng-host file tersebut di URL untuk pembaruan terjadwal berkala.
Format Beranda | Deskripsi & Panduan | Contoh Beranda |
---|---|---|
CSV | Nilai yang dipisah dengan koma.
| |
TSV | Nilai yang dipisahkan dengan tab. Lihat pedoman untuk CSV. | |
XML | Format biasanya dibuat oleh sistem penyedia beranda otomatis atau server web. Set node XML item mewakili daftar produk dan harus dimulai dengan tanda deklarasi Lihat Contoh XML beranda. |
Contoh - file TSV
dengan pembatas tab
vehicle_id title description url make model year mileage.value mileage.unit image[0].url image[0].tag[0] transmission fuel_type body_style drivetrain vin condition price address exterior_color sale_price availability date_first_on_lot state_of_vehicle latitude longitude i2 EndoHatch GE. Turbocharged! Gasoline! http://www.example.com/test g GE http://www.facebook.com/teapic.jpg Gym AUTOMATIC GASOLINE SEDAN FWD 1FADP5AU6DL536022 EXCELLENT 18000 USD {addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'} white 16000 USD AVAILABLE 2018-02-21 NEW 52.35 42.10
Contoh — Beranda dengan gambar sebagai array
auto_listing_id title description url make model year mileage.value mileage.unit image transmission fuel_type body_style drivetrain vin condition price address exterior_color sale_price availability date_first_on_lot state_of_vehicle latitude longitude "i2" $299 per month for the EndoHatch GE. Turbocharged! Gasoline! http://www.example.com/test Endomoto "[{""url"":""https://images.trvl-media.com/hotels/3000000/2260000/2250400/2250336/2250336_1_y.jpg""}]" AUTOMATIC GASOLINE SEDAN FWD 1FADP5AU6DL536022 EXCELLENT 18000 USD {addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'} white 16000 USD AVAILABLE 2018-09-15 NEW 52.35 42.10
Contoh beranda ini adalah sebagai XML
:
<?xml version="1.0" encoding="UTF-8"?> <listings> <title>Vehicles Feed</title> <link rel="self" href="http://www.example.com"/> <listing> <vehicle_id>SED1234</vehicle_id> <title>$299 per month for the EndoHatch GE</title> <description>EndoHatch GE. Turbocharged! Gasoline!</description> <url>http://www.example.com/test</url> <make>Endomoto</make> <image> <url>http://example.com/some.image_1.jpg</url> <tag>Exterior</tag> </image> <model>EndoHatch</model> <year>2017</year> <mileage> <value>10</value> <unit>MI</unit> </mileage> <drivetrain>FWD</drivetrain> <vin>1FADP5AU6DL536022</vin> <body_style>SEDAN</body_style> <fuel_type>GASOLINE</fuel_type> <transmission>AUTOMATIC</transmission> <condition>EXCELLENT</condition> <price>18000 USD</price> <address format="simple"> <component name="addr1">550 Auto Center Dr</component> <component name="city">Watsonville</component> <component name="region">CA</component> <component name="postal_code">95076</component> <component name="country">US</component> </address> <latitude>52.35</latitude> <longitude>42.10</longitude> <exterior_color>white</exterior_color> <sale_price>16000 USD</sale_price> <availability>AVAILABLE</availability> <date_first_on_lot>2018-02-21</date_first_on_lot> <state_of_vehicle>NEW</state_of_vehicle> <dealer_id>ABC1234</dealer_id> </listing> </listings>
"vehicle_id","vehicle_registration_plate","vin","make","model","year","transmission","body_style","fuel_type","drivetrain","description","image[0].url", "image[1].url","image[2].url","mileage.value","mileage.unit","url","title","price","state_of_vehicle","exterior_color","address","latitude","longitude","trim","interior_colour","dealer_id","dealer_name","postal_code","dealer_phone","fb_page_id","dealer_communication_channel","dealer_privacy_policy_url" "56345636","AB12CDE","YV1DZ8256F2693747","Volvo","XC60","2014","AUTOMATIC","OTHER","DIESEL","OTHER","Volvo XC60 2.4 TD D5 R-Design Lux Geartronic 5dr (Nav)","http://website.com/images/stock/car1.jpg","http://website.com/images/stock/car2.jpg","http://website.com/images/stock/car3.jpg","12950","MI","http://www.dealership.co.uk","Volvo XC60 2.4 TD D5 R-Design Lux Geartronic 5dr (Nav)","22495.00 GBP","Used","White","{""addr1"":""Sample Road"",""city"":""London"",""region"":""Greater London"",""postal_code"":""SW31 3EW"",""country"":""United Kingdom""}","52.7445867","-2.7337375","2.4 TD D5 R-Design Lux Geartronic 5dr (Nav)","Black","436456435347346","Dealer Group","SSW31 3EW","","3562564376375","CHAT","https://www.dealership.co.uk/site/privacy-and-legal/"
"{addr1: '1 Hacker Way', city: 'Menlo Park', region: 'CA', postal_code: '94025', country: 'US'}"
<?xml version="1.0" encoding="UTF-8"?> <listings> <title>Sample Vehicles Feed</title> <link rel="self" href="https://www.example.com/dealers/cars/1234/?r=vddn" /> <listing> <vehicle_id>3456553</vehicle_id> <title>$299 per month for the EndoHatch GE</title> <description>Adjustable Steering Column, Adjustable Steering Wheel, Air Bags, Air Conditioning, Alloy Wheels, Anti Lock Brakes, Bluetooth Preparation (Phone), CD Player, CD Radio, Driver Airbag, Electric & Heated Door Mirrors, Electric Windows, Electronic Stability Programme (ESP), Front Electric Windows, Front Fog Lights, Height Adjustable Drivers Seat, Passenger Airbag, Power Assisted Steering (PAS), Power Fold & Heated DoorMirrors, Rear Parking Sensor, Remote Boot Release, Remote Central Locking, Solid Paint,LOW MILEAGE WITH A FULL FORD HISTORY, SUPPLIED FROM US,</description> <url>https://www.example.com/car-1234> <make>Endomoto</make> <image> <url>https://www.example.com/1234/image_1.jpg</url> </image> <image> <url>https://www.example.com/1234/image_2.jpg</url> </image> <image> <url>https://www.example.com/1234/image_3.jpg</url> </image> <model>B-MAX</model> <year>2015</year> <mileage> <value>15617</value> <unit>MI</unit> </mileage> <drivetrain>Other</drivetrain> <vin>1A2BCDEF3GH456789</vin> <body_style>OTHER</body_style> <fuel_type>Gasoline</fuel_type> <transmission>Manual</transmission> <price>9490 GBP</price> <address format="simple"> <component name="addr1">Sample Road</component> <component name="city">Carland</component> <component name="region">North Test</component> <component name="country">United States of America</component> <component name="postal_code">12345</component> </address> <latitude>37.484419</latitude> <longitude>-122.148406</longitude> <exterior_color>White</exterior_color> <state_of_vehicle>Used</state_of_vehicle> <dealer_id>453356</dealer_id> <vehicle_registration_plate>AB12CD</vehicle_registration_plate> <fb_page_id>5636367576574</fb_page_id> <dealer_communication_channel>LEAD_FORM</dealer_communication_channel> <dealer_privacy_policy_url>https://www.example.com/privacy/</dealer_privacy_policy_url> </listing> </listings>
Kolom yang didukung berikut ini dirancang untuk item yang Anda tambahkan ke katalog produk Anda.
Untuk katalog yang dilokalkan, lihat kolom yang didukung untuk kendaraan.
Nama | Deskripsi | Gunakan dalam Materi Iklan | Gunakan sebagai filter set produk |
---|---|---|---|
jenis: int | Wajib untuk iklan inventaris dengan destinasi di Facebook. ID halaman Facebook dari partner atau dealer. Katalog Anda harus ditambahkan ke daftar yang diizinkan oleh perwakilan Facebook Anda sebelum Anda dapat mengirim ID halaman Anda. Halaman harus dimasukkan ke daftar yang diizinkan menggunakan Pengelola Bisnis sebelum dapat digunakan. Lihat Mengelola Izin. | T | T |
jenis: string | Wajib. Maks 100 karakter ID unik untuk barang. Dapat bervariasi untuk sebuah kendaraan. Jika terdapat beberapa contoh ID yang sama, kami akan mengabaikan semua instance. Anda juga dapat menggunakan VIN untuk Contoh: | Y | Y |
jenis: string | Wajib. Maks 500 karakter. Nama lengkap kendaraan. Ini relevan dan spesifik untuk setiap kendaraan dan harus berisi apa yang diatur di Contoh: | Y | Y |
jenis: string | Wajib. Maks 5.000 karakter Teks pendek yang menjelaskan kendaraan. Jangan sertakan teks atau tautan promosi apa pun. Jangan masukkan teks dalam huruf kapital semua. Gunakan ganti baris untuk memformat deskripsi. Contoh: | Y | T |
jenis: URL | Wajib. Tautkan ke situs eksternal tempat Anda dapat melihat daftar kendaraan. | Y | T |
jenis: string | Wajib. Tipe atau merek kendaraan. Contoh: | Y | Y |
jenis: string | Wajib. Model kendaraan. Contoh: | Y | Y |
jenis: int | Wajib. Tahun kendaraan diluncurkan dalam format Contoh: | Y | Y |
jenis: int | Wajib. Untuk kendaraan bekas, jarak tempuh kendaraan dalam kilometer ( Contoh: '1500' | Y | Y |
jenis: string | Wajib. Satuan jarak tempuh: | Y | T |
jenis: string | Wajib. Barang maks: 20 URL gambar kendaraan. Jika Anda memiliki lebih dari satu foto kendaraan, ikuti aturan penamaan ini:
Pelajari selengkapnya tentang Praktik Terbaik Marketplace untuk gambar. | T | T |
jenis: string | Opsional. Barang maks: 20 Tanda yang ditambahkan ke gambar dan menunjukkan apa yang ada di gambar. Beberapa tanda bisa dikaitkan dengan sebuah gambar. Ikuti aturan penamaan ini: Contoh: | T | Y |
Jenis: enum | Opsional. Jenis transmisi kendaraan: | T | Y |
Jenis: enum | Wajib. Jenis bodi kendaraan: | Y | Y |
Jenis: enum | Opsional. Jenis penggerak roda kendaraan. Nilai yang didukung: | T | Y |
| Wajib, beberapa negara. Maks 17 karakter Nomor ID Kendaraan (VIN) kendaraan. Anda juga bisa menggunakan VIN untuk Contoh: | Y | Y |
Jenis: string | Wajib. Biaya dan mata uang kendaraan. Format harga sebagai biaya, diikuti dengan kode mata uang ISO, dengan spasi di antara biaya dan mata uang. Contoh: | Y | Y |
jenis: string | Wajib. Warna kendaraan. Contoh: | Y | Y |
jenis: enum | Wajib. Status kendaraan saat ini. Nilai yang didukung: | T | Y |
jenis: enum | Opsional. Jenis BBM kendaraan. Nilai yang didukung: | T | Y |
jenis: string | Opsional. String yang menjelaskan gambar. Beberapa tanda bisa dikaitkan dengan sebuah gambar. Contoh: | Y | T |
jenis: int | Opsional. Serupa | T | T |
jenis: enum | Opsional. Kondisi kendaraan. Nilai yang didukung: | T | Y |
jenis: bilangan bulat | Opsional. Harga diskon atau harga khusus. Format harga sebagai biaya, diikuti kode mata uang ISO, dengan spasi di antara biaya dan mata uang. Contoh: | Y | Y |
jenis: enum | Opsional. Ketersediaan kendaraan: | T | Y |
jenis: string | Opsional. Jenis kendaraan. Nilai yang diharapkan: | T | Y |
jenis: string | Opsional. Maks 50 karakter Versi kendaraan. Contoh: | Y | Y |
jenis: string | Opsional. Maks 50 karakter Warna interior kendaraan. | T | Y |
jenis: string | Opsional. Tanggal saat kendaraan ini pertama kali sampai di parkiran dealer. Digunakan untuk menunjukkan usia inventaris. Gunakan format Contoh: | T | Y |
jenis: int | Opsional. Jumlah hari kendaraan telah berada di parkiran. Harus bertambah setiap hari. Contoh: | T | Y |
Ada dua format untuk menyediakan alamat dan Anda harus menggunakan salah satu saja, bukan keduanya . Anda dapat menggunakan format address
atau Anda dapat memberikan setiap kolom alamat satu per satu. Ingat bahwa menggunakan kedua format akan memunculkan kesalahan.
Nama | Deskripsi | Gunakan dalam Materi Iklan | Gunakan sebagai filter set produk |
---|---|---|---|
jenis: string | Wajib. Alamat fisik dealer yang lengkap, dengan format:
Kode pos bersifat optional. Contoh: | T | T |
jenis: string | Wajib. Kota tempat dealer berada. Contoh: | Y | Y |
jenis: string | Wajib. Negara bagian, kabupaten, wilayah, atau provinsi tempat dealer berada. Contoh: | Y | Y |
jenis: string | Wajib. Negara lokasi dealer. Contoh: | T | Y |
jenis: float | Wajib. Garis lintang lokasi dealer. Contoh: | T | T |
jenis: float | Wajib. Garis bujur lokasi dealer. Contoh: | T | T |
jenis: string | Opsional. Kode pos untuk dealer (di luar AS atau kode pos di AS). Contoh: | T | T |
jenis: string | Opsional. Maks 100 karakter ID alfanumerik dealer. | Y | Y |
jenis: string | Opsional. Maks 100 karakter Nama dealer. | Y | Y |
jenis: string | Opsional. Nomor telepon dealer. Nomor telepon dealer. Persyaratan:
Contoh: | T | T |
jenis: enum | Opsional. Metode pengguna menghubungi dealer. Nilai yang tersedia: Catatan: Jika Anda memilih LEAD_FORM, Anda juga harus menyertakan kebijakan privasi. Lihat | T | T |
jenis: URL | Wajib untuk metode kontak Formulir Prospek. Opsional untuk metode kontak Messenger (Obrolan). Tautan ke URL privasi dealer yang mencantumkan kendaraan. Ini harus cocok dengan dealer di ID halaman Facebook ( | T | T |
jenis: string | Opsional. Penunjukan mobil sendiri oleh dealer di tempat parkir mereka. Nomor stok adalah cara dealer untuk menginventarisasi kendaraan tertentu. Contoh: | Y | Y |
jenis: string | Opsional. Maks 100 karakter Informasi tambahan tentang kendaraan yang ingin Anda sertakan. | Y | Y |
jenis: string | Opsional. Maks 100 karakter Informasi tambahan tentang kendaraan yang ingin Anda sertakan. | Y | Y |
jenis: string | Opsional. Maks 100 karakter Informasi tambahan tentang kendaraan yang ingin Anda sertakan. | Y | Y |
Beranda dapat dalam format CSV, TSV, XML.
Contoh—File TSV, menggunakan tab sebagai delimiter
vehicle_offer_id market_name make model trim year offer_disclaimer offer_type amount amount_percentage amount_qualifier term_length term_qualifier downpayment downpayment_qualifier offer_description url image[0].url start_date end_date offer34220 market1234 MakeA ModelA E3 2017 *Available on approved credit to very well qualified customers lease USD 419 a month 36 months USD 0 due at signing. Expires 09/05/2017. Excludes official fees, taxes and dealer charges. No security deposit required. 10,000 mile/year limit. https://test123.com/offers1 http://www.test123.com/cm-img/facebook/offer1.jpg 2018-09-05 2018-12-31 offer34221 market1234 MakeB ModelB E4 2017 *Available on approved credit to very well qualified customers cash USD 1500 cash Expires 09/05/2017. https://test123.com/offers2 http://www.test123.com/cm-img/facebook/offer2.jpg 2018-09-05 2018-12-31 offer34222 market2345 MakeC ModelC E5 2017 *Available on approved credit to very well qualified customers finance 4.9 APR 60 months Expires 09/05/2017. Excludes official fees, taxes and dealer charges. https://test123.com/offers3 http://www.test123.com/cm-img/facebook/offer3.jpg 2018-09-05 2018-12-31
Beranda ini dapat diunggah melalui UI atau API. Jika Anda memilih UI, berikan ID pengguna dan ID akun Anda, dan kami dapat menambahkan Anda ke daftar yang diizinkan untuk akses.
Nama | Deskripsi | Filter Set Produk | Dapat digunakan dalam Materi Iklan? |
---|---|---|---|
jenis: string | Wajib. ID unik untuk kendaraan yang akan digunakan oleh iklan untuk mengidentifikasi promo. Ini juga nilai yang sama yang diteruskan di bawah parameter Contoh: | Y | Y |
jenis: string | Wajib. Tipe atau merek kendaraan. Contoh: | Y | Y |
jenis: string | Wajib. Model kendaraan. Contoh: | Y | Y |
jenis: bilangan bulat | Wajib. Tahun kendaraan diluncurkan dalam format tttt. Contoh: | Y | Y |
jenis: enum | Wajib. Jenis promo. Nilai yang valid: | Y | T |
jenis: string | Wajib. Judul iklan/promo. Contoh: | T | Y |
jenis: string | Wajib. Deskripsi promo. Contoh: | T | Y |
jenis: URL | Wajib. Tautkan ke situs eksternal tempat Anda dapat melihat detail promo. | T | Y |
jenis: string | Wajib. Penafian terkait promo. | T | T |
jenis: string | Wajib. URL gambar kendaraan yang digunakan dalam materi iklan. Catatan: Untuk menggunakan iklan carousel, sediakan gambar persegi dengan rasio aspek 1:1 berukuran 600x600 piksel. Untuk menampilkan iklan kendaraan tunggal, sediakan gambar dengan aspek rasio 1,91:1 berukuran 1200x630 piksel. Untuk informasi rasio gambar selengkapnya, lihat Praktik Terbaik untuk Rasio Aspek. | T | T |
jenis: string | Opsional. String yang mewakili apa yang ada di gambar. Ada beberapa tanda yang terkait dengan gambar, seperti Promo Sewa, Pembiayaan, dan sebagainya. | ||
jenis: string | Opsional. String yang mewakili apa yang ada di gambar. Kami mendukung banyak tanda. Naikkan nilai | T | T |
jenis: string | Opsional. String yang mewakili apa yang ada di gambar. Anda dapat mengunggah lebih dari 1 gambar dengan menambah digit dan mulai dari 1 hingga 20. Nilai | T | T |
jenis: string | Opsional. String yang mewakili apa yang ada di gambar. Kami mendukung banyak tanda. Naikkan nilai | T | T |
jenis: string | Opsional. String yang mewakili apa yang ada di gambar. Ada beberapa tanda yang terkait dengan gambar, seperti Promo Sewa, Pembiayaan, dan sebagainya. | T | T |
jenis: string | Direkomendasikan. Jumlah promo sewa guna atau promo tunai. Format harga sebagai biaya, diikuti kode mata uang ISO, dengan spasi di antara biaya dan mata uang. Contoh: Untuk sewa guna $329/bulan atau cashback $2000, nilainya | T | Y |
jenis: string | Direkomendasikan. Nilai persentase, jika ada dalam promo. Terkadang nilainya adalah persentase (contoh: | T | T |
jenis: string | Direkomendasikan. Kualifikasi untuk nilai dolar atau persentase jumlah. Nilai yang valid dapat berupa Contoh: | T | Y |
jenis: bilangan bulat | Direkomendasikan. Durasi berlakunya promo. Jika promonya adalah sewa guna $329/bulan selama 3 tahun, maka nilainya adalah Contoh: | T | Y |
jenis: enum | Direkomendasikan. Unit untuk jangka waktu penawaran. Nilai yang valid adalah "bulan" atau "tahun". Contoh: | T | Y |
jenis: string | Direkomendasikan. Nilai uang muka saat pembelian atau sewa guna. Format harga sebagai biaya, diikuti kode mata uang ISO, dengan spasi di antara biaya dan mata uang. Contoh: Gunakan | T | Y |
jenis: string | Direkomendasikan. Kualifikasi untuk nilai | Y | |
jenis: string | Direkomendasikan. Versi kendaraan. Contoh: | T | Y |
jenis: string | Direkomendasikan. MSRP kendaraan dengan mata uang. Format harga sebagai biaya, diikuti kode mata uang ISO, dengan spasi di antara biaya dan mata uang. Contoh: | T | T |
jenis: enum | Direkomendasikan. Model bodi kendaraan. Nilai yang valid: | T | T |
jenis: string | Opsional. Tanggal mulai berlakunya promo. Harus dalam format tttt-bb-hh. Contoh: | T | T |
jenis: string | Opsional. Tanggal akhir berlakunya promo. Harus dalam format tttt-bb-hh. Contoh: | T | T |
jenis: string | Opsional. Nama pasar/Designated Marketing Area (DMA). | Y | T |
jenis: array string | Wajib untuk promo regional. Opsional untuk promo nasional. Daftar kode Designated Market Area (DMA) untuk pasar tertentu diberikan dalam format berikut ['502', '201'] ['516'...]. Catatan: Ini untuk format CSV, lihat contoh feed di bawah untuk format XML. Lihat Standar kode DMA. Biarkan kosong untuk promo nasional. | Y | T |
curl \ -F 'name=catalog name' \ -F 'access_token=<ACCESS TOKEN>' \ -F 'vertical=vehicle_offers' \ https://graph.facebook.com/<API_VERSION>/<BUSINESS ID>/product_catalogs