โฆษณารถยนต์

ข้อมูลอ้างอิง

คู่มือนี้เป็นข้อมูลอ้างอิงของรูปแบบฟีดที่รองรับและช่องข้อมูลในการสร้างโฆษณารถยนต์

ช่อง enum ทั้งหมดจะไม่คำนึงถึงตัวพิมพ์ใหญ่และตัวพิมพ์เล็ก

โฆษณาคลังรถยนต์ - รูปแบบฟีดที่รองรับ

โปรดใช้รูปแบบฟีดที่ถูกต้อง ได้แก่ CSV, TSV หรือ XML เมื่อสร้างไฟล์ฟีดแล้ว คุณควรโฮสต์ไฟล์ไว้ที่ URL เพื่อดำเนินการอัพเดตตามกำหนดเวลาเป็นประจำ

รูปแบบฟีด คำอธิบายและแนวทาง ฟีดตัวอย่าง

CSV

ค่าที่คั่นด้วยเครื่องหมายจุลภาค

  • แถวแรกจะระบุส่วนหัวของคอลัมน์ แถวที่ตามมาจะแสดงค่าที่สอดคล้องกันของเส้นทางแต่ละเส้น

  • ควรใส่เครื่องหมาย “อัญประกาศคู่” คลุมช่องที่มีการเว้นวรรคหรือเครื่องหมายจุลภาค ให้เลี่ยงการใช้เครื่องหมายอัญประกาศคู่ในช่องที่มีเครื่องหมายอัญประกาศคู่คลุมอยู่ โดยใช้เครื่องหมายอัญประกาศคู่ซ้อนกันแทน

  • ช่องที่ซ้อนกันหรือมีหลายค่า เช่น รูปภาพ จะสามารถแสดงได้โดยใช้ค่าที่เข้ารหัส JSON หรือชุดคอลัมน์ข้อความธรรมดาที่ “ปรับให้เป็นระนาบเดียว” ซึ่งมีป้ายกำกับโดยใช้รูปแบบคำสั่งพาธ JSON ตัวอย่าง: (image[0].url, image[0].tag[0], image[0].tag[1])

  • รูปแบบทั้งสองสามารถใช้แทนกันได้ในไฟล์เดียวกัน

ดูตัวอย่าง CSV/TSV สำหรับฟีด, ตัวอย่าง CSV/TSV สำหรับที่อยู่

ดาวน์โหลด > คลิกขวา > บันทึกลิงก์เป็น

TSV

ค่าที่คั่นด้วยแท็บ ดูแนวทางสำหรับ CSV

ดูตัวอย่าง CSV/TSV สำหรับฟีด, ตัวอย่าง CSV/TSV สำหรับที่อยู่

ดาวน์โหลด > คลิกขวา > บันทึกลิงก์เป็น

XML

โดยทั่วไปแล้ว รูปแบบจะถูกสร้างขึ้นโดยระบบผู้ให้บริการฟีดอัตโนมัติหรือเว็บเซิร์ฟเวอร์ ชุดโหนด XML ของสินค้าจะแสดงถึงรายการสินค้าและต้องขึ้นต้นด้วยแท็กประกาศตัวแปร <?xml

ดูตัวอย่าง XML สำหรับฟีด

ดาวน์โหลด > คลิกขวา > บันทึกลิงก์เป็น

ตัวอย่าง - ไฟล์ TSV ที่คั่นด้วยแท็บ

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

ตัวอย่าง — ฟีดที่มีรูปภาพเป็นอาร์เรย์

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

ฟีดตัวอย่างนี้มีรูปแบบเป็น 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>

ตัวอย่าง - CSV/TSV สำหรับฟีด

"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/"

ตัวอย่าง - CSV/TSV สำหรับที่อยู่

"{addr1: '1 Hacker Way', city: 'Menlo Park', region: 'CA', postal_code: '94025', country: 'US'}"

ตัวอย่าง - XML สำหรับฟีด

<?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 &amp; 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>

โฆษณาคลังรถยนต์ - ช่องที่รองรับ - ยานพาหนะ

ช่องที่รองรับต่อไปนี้ออกแบบมาสำหรับรายการที่คุณเพิ่มลงในแค็ตตาล็อกสินค้า

โปรดดูช่องที่รองรับสำหรับยานพาหนะสำหรับแค็ตตาล็อกที่แปลเป็นภาษาท้องถิ่น

ชื่อคำอธิบายใช้ในชิ้นงานโฆษณาใช้เป็นตัวกรองชุดสินค้า

fb_page_id

ประเภท: จำนวนเต็ม

จำเป็นต้องระบุสำหรับโฆษณาคลังที่มีปลายทางบน Facebook

ID เพจ Facebook ของพาร์ทเนอร์หรือตัวแทนจำหน่าย ตัวแทนของ Facebook จะต้องเพิ่มแค็ตตาล็อกของคุณลงในรายการที่อนุญาตก่อนที่คุณจะส่ง ID เพจของคุณได้ ทั้งนี้ เพจจะต้องได้รับการเพิ่มลงในรายการที่อนุญาตโดยใช้ตัวจัดการธุรกิจก่อนที่จะนำเข้ามา โปรดดูการจัดการสิทธิ์การอนุญาต

ไม่ใช่

ไม่ใช่

vehicle_id

ประเภท: สตริง

จำเป็นต้องระบุ

อักขระสูงสุด: 100 ตัว

ID ที่ไม่ซ้ำกันของสินค้า อาจแตกต่างกันไปตามยานพาหนะแต่ละรายการ หาก ID เดียวกันมีหลายอินสแตนซ์ เราจะเพิกเฉยต่ออินสแตนซ์ทั้งหมด นอกจากนี้คุณสามารถใช้ VIN สำหรับทั้ง vehicle_id และ vin ได้อีกด้วย

ตัวอย่าง: 1FADP5AU6DL536022

ใช่

ใช่

title

ประเภท: สตริง

จำเป็นต้องระบุ

อักขระสูงสุด: 500 ตัว

ชื่อเต็มของยานพาหนะ ข้อมูลนี้จะเกี่ยวข้องและมีความเฉพาะเจาะจงกับยานพาหนะแต่ละคัน และควรประกอบด้วยข้อมูลที่กำหนดไว้ใน year, make, model, trim

ตัวอย่าง: $299 per month for the EndoHatch GE

ใช่

ใช่

description

ประเภท: สตริง

จำเป็นต้องระบุ

อักขระสูงสุด: 5,000 ตัว

ข้อความสั้นๆ ที่อธิบายเกี่ยวกับยานพาหนะ ห้ามใส่ข้อความโปรโมทหรือลิงก์ใดๆ ห้ามป้อนข้อความเป็นอักษรตัวพิมพ์ใหญ่ทั้งหมด ใช้ตัวแบ่งบรรทัดเพื่อกำหนดรูปแบบคำอธิบายของคุณ

ตัวอย่าง: Used 2017 Volvo XC90 in great condition, available now.

ใช่

ไม่ใช่

url

ประเภท: URL

จำเป็นต้องระบุ

ลิงก์ไปยังเว็บไซต์ภายนอกที่คุณสามารถดูรายการยานพาหนะได้

ใช่

ไม่ใช่

make

ประเภท: สตริง

จำเป็นต้องระบุ

ยี่ห้อหรือแบรนด์ของยานพาหนะ

ตัวอย่าง: Endomoto

ใช่

ใช่

model

ประเภท: สตริง

จำเป็นต้องระบุ

รุ่นของยานพาหนะ

ตัวอย่าง: EndoHatch

ใช่

ใช่

year

ประเภท: จำนวนเต็ม

จำเป็นต้องระบุ

ปีที่เปิดตัวยานพาหนะดังกล่าวในรูปแบบ yyyy

ตัวอย่าง: 2015

ใช่

ใช่

mileage.value

ประเภท: จำนวนเต็ม

จำเป็นต้องระบุ

สำหรับยานพาหนะมือสอง ระยะทางที่ยานพาหนะวิ่งไปแล้วจนถึงปัจจุบันโดยมีหน่วยเป็นกิโลเมตร (kms) หรือไมล์ (MI) สำหรับยานพาหนะใหม่ ให้ใช้เลขศูนย์ (0) สำหรับ Marketplace ยานพาหนะจะต้องวิ่งไปแล้วเป็นระยะทางเกิน 500 ไมล์/กม.

ตัวอย่าง: "1500"

ใช่

ใช่

mileage.unit

ประเภท: สตริง

จำเป็นต้องระบุ

หน่วยระยะทางวิ่ง: MI (ไมล์) หรือ KM (กิโลเมตร)

ใช่

ไม่ใช่

image[0].url

ประเภท: สตริง

จำเป็นต้องระบุ

รายการสูงสุด: 20

URL ของรูปภาพยานพาหนะ หากคุณมีรูปภาพยานพาหนะมากกว่า 1 รูป ให้ตั้งชื่อรูปภาพโดยใช้รูปแบบ image[1].url, image[2].url ไปเรื่อยๆ คุณจะต้องเพิ่มรูปภาพอย่างน้อย 1 รูป ซึ่งแต่ละรูปต้องมีขนาดไม่เกิน 4 MB สำหรับ Marketplace ต้องใช้รูปภาพอย่างน้อย 2 รูป

  • หากต้องการใช้โฆษณาแบบภาพสไลด์ — ให้เพิ่มรูปภาพสี่เหลี่ยมจัตุรัสที่มีอัตราส่วนกว้างยาว 1:1 (ขนาด 600x600 พิกเซล)

  • หากต้องการแสดงโฆษณายานพาหนะแบบเดี่ยว ให้เพิ่มรูปภาพที่มีอัตราส่วนกว้างยาว 1.91:1 (ขนาด 1200x630 พิกเซล)

เรียนรู้เพิ่มเติมเกี่ยวกับหลักปฏิบัติที่ดีที่สุดสำหรับรูปภาพบน Marketplace

ไม่ใช่

ไม่ใช่

image[0].tag[0]

ประเภท: สตริง

ระบุหรือไม่ก็ได้

รายการสูงสุด: 20

แท็กที่ต่อท้ายรูปภาพที่จะบอกว่าในรูปภาพมีอะไรอยู่ รูปภาพหนึ่งรูปสามารถมีแท็กที่เชื่อมโยงกับรูปภาพได้หลายแท็ก โปรดตั้งชื่อตามรูปแบบ image[0].tag[0], image[0].tag[1] .... image[1].tag[0], image[1].tag[1] ....

ตัวอย่าง: Exterior, Interior, StockImage

ไม่ใช่

ใช่

transmission

ประเภท: enum

ระบุหรือไม่ก็ได้

ประเภทเกียร์ของยานพาหนะ: Automatic หรือ Manual

ไม่ใช่

ใช่

body_style

ประเภท: enum

จำเป็นต้องระบุ

รูปแบบตัวถังของยานพาหนะ: CONVERTIBLE, COUPE, HATCHBACK, MINIVAN, TRUCK, SUV, SEDAN, VAN, WAGON, CROSSOVER, SMALL_CAR หรือ OTHER

ใช่

ใช่

drivetrain

ประเภท: enum

ระบุหรือไม่ก็ได้

ระบบขับเคลื่อนของยานพาหนะ ค่าที่รองรับ: 4X2, 4X4, AWD, FWD, RWD, Other

ไม่ใช่

ใช่

vin

ประเภท: สตริง

จำเป็นต้องระบุในบางประเทศ

อักขระสูงสุด: 17 ตัว

หมายเลข​ตัวถังรถ (VIN) ของยานพาหนะ นอกจากนี้คุณสามารถใช้ VIN สำหรับทั้ง vehicle_id และ vin ได้อีกด้วย หมายเหตุ: VIN จะต้องมีอักขระ 17 ตัวพอดีและไม่ต้องระบุสำหรับยานพาหนะรุ่นก่อนปี 1983 โดยเรือจะมีหลักตัวเลขน้อยกว่าและยานพาหนะบางประเภท (เช่น รถพ่วง) จะไม่จำเป็นต้องใช้ VIN

ตัวอย่าง: 1FADP5AU6DL536022

ใช่

ใช่

price

ประเภท: สตริง

จำเป็นต้องระบุ

ราคาและสกุลเงินของยานพาหนะ จัดรูปแบบราคาโดยเริ่มต้นด้วยราคา ตามด้วยรหัสสกุลเงินระบบ ISO โดยเว้นวรรคระหว่างราคากับสกุลเงิน

ตัวอย่าง: 18000 USD, 32000 USD

ใช่

ใช่

exterior_color

ประเภท: สตริง

จำเป็นต้องระบุ

สียานพาหนะ

ตัวอย่าง: Black, White, Blue, Red

ใช่

ใช่

state_of_vehicle

ประเภท: enum

จำเป็นต้องระบุ

สถานะปัจจุบันของยานพาหนะ ค่าที่รองรับ: New, Used หรือ CPO (ยานพาหนะใช้แล้วที่ผ่านการรับรอง)

ไม่ใช่

ใช่

fuel_type

ประเภท: enum

ระบุหรือไม่ก็ได้

ประเภทเชื้อเพลิงของยานพาหนะ ค่าที่รองรับ: DIESEL, ELECTRIC, FLEX, GASOLINE, HYBRID, OTHER

ไม่ใช่

ใช่

tag (แท็กรูปภาพ)

ประเภท: สตริง

ระบุหรือไม่ก็ได้

สตริงที่อธิบายรูปภาพ รูปภาพหนึ่งรูปสามารถมีแท็กที่เชื่อมโยงกับรูปภาพได้หลายแท็ก

ตัวอย่าง: Exterior, Interior, StockImage

ใช่

ไม่ใช่

chrome_id

ประเภท: จำนวนเต็ม

ระบุหรือไม่ก็ได้

คล้ายกับ autodata_id

ไม่ใช่

ไม่ใช่

condition

ประเภท: enum

ระบุหรือไม่ก็ได้

สภาพของยานพาหนะ ค่าที่รองรับ: EXCELLENT, GOOD, FAIR, POOR, OTHER

ไม่ใช่

ใช่

sale_price

ประเภท: จำนวนเต็ม

ระบุหรือไม่ก็ได้

ราคาขายหรือราคาพิเศษ จัดรูปแบบราคาโดยเริ่มต้นด้วยราคา ตามด้วยรหัสสกุลเงินระบบ ISO โดยเว้นวรรคระหว่างราคากับสกุลเงิน

ตัวอย่าง: 16000 USD

ใช่

ใช่

availability

ประเภท: enum

ระบุหรือไม่ก็ได้

ความพร้อมจำหน่ายของยานพาหนะ: available หรือ not availableเราจะไม่แสดงยานพาหนะที่ไม่มีอยู่ในโฆษณา

ไม่ใช่

ใช่

vehicle_type

ประเภท: สตริง

ระบุหรือไม่ก็ได้

ประเภทยานพาหนะ ค่าที่คาดหวัง: car_truck (หากไม่ได้ป้อนข้อมูล ค่านี้จะเป็นค่าเริ่มต้น), boat, commercial, motorcycle, powersport, rv_camper, trailer หรือ other

ไม่ใช่

ใช่

trim

ประเภท: สตริง

ระบุหรือไม่ก็ได้

อักขระสูงสุด: 50 ตัว

ชิ้นส่วนตกแต่งของยานพาหนะ

ตัวอย่าง: 5DR HB SE

ใช่

ใช่

interior_color

ประเภท: สตริง

ระบุหรือไม่ก็ได้

อักขระสูงสุด: 50 ตัว

สีภายในยานพาหนะ

ไม่ใช่

ใช่

date_first_on_lot

ประเภท: สตริง

ระบุหรือไม่ก็ได้

วันแรกที่ยานพาหนะคันนี้มาถึงที่จอดของตัวแทนจำหน่าย ใช้เพื่อระบุอายุของคลัง ใช้รูปแบบ yyyy-mm-dd

ตัวอย่าง: 2018-09-05

ไม่ใช่

ใช่

days_on_lot

ประเภท: จำนวนเต็ม

ระบุหรือไม่ก็ได้

จำนวนวันที่ยานพาหนะอยู่ในที่จอด ซึ่งควรจะเพิ่มขึ้นทุกวัน

ตัวอย่าง: 62

ไม่ใช่

ใช่

โฆษณาคลังรถยนต์ - ช่องที่รองรับ - ตัวแทนจำหน่าย

การระบุที่อยู่มีสองรูปแบบ และคุณควรใช้รูปแบบใดรูปแบบหนึ่ง แต่ไม่ควรใช้ทั้งสองรูปแบบ โดยคุณสามารถใช้รูปแบบ address หรือระบุช่องที่อยู่แต่ละรายการแยกกันก็ได้ โปรดทราบว่าการใช้ทั้งสองรูปแบบจะทำให้เกิดข้อผิดพลาด

ชื่อคำอธิบายใช้ในชิ้นงานโฆษณาใช้เป็นตัวกรองชุดสินค้า

address

ประเภท: สตริง

จำเป็นต้องระบุ

ระบุที่อยู่จริงของตัวแทนจำหน่ายให้สมบูรณ์ โดยให้อยู่ในรูปแบบดังต่อไปนี้

{addr 1: [STREET ADDRESS], city: [CITY], region: [STATE, COUNTY, REGION OR PROVINCE], country: [COUNTRY]

คุณจะระบุรหัสไปรษณีย์หรือไม่ก็ได้

ตัวอย่าง: {addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'}

ไม่ใช่

ไม่ใช่

address.city

ประเภท: สตริง

จำเป็นต้องระบุ

เมืองที่ตัวแทนจำหน่ายอยู่

ตัวอย่าง: Palo Alto

ใช่

ใช่

address.region

ประเภท: สตริง

จำเป็นต้องระบุ

รัฐ เขตปกครอง​ ภูมิภาค หรือจังหวัดที่ตัวแทนจำหน่ายอยู่

ตัวอย่าง: California

ใช่

ใช่

address.country

ประเภท: สตริง

จำเป็นต้องระบุ

ประเทศที่ตัวแทนจำหน่ายอยู่

ตัวอย่าง: United States

ไม่ใช่

ใช่

latitude

ประเภท: ทศนิยม

จำเป็นต้องระบุ

ละติจูดตำแหน่งที่ตั้งของตัวแทนจำหน่าย

ตัวอย่าง: 37.484100

ไม่ใช่

ไม่ใช่

longitude

ประเภท: ทศนิยม

จำเป็นต้องระบุ

ลองจิจูดตำแหน่งที่ตั้งของตัวแทนจำหน่าย

ตัวอย่าง: -122.148252

ไม่ใช่

ไม่ใช่

address.postal_code

ประเภท: สตริง

ระบุหรือไม่ก็ได้

รหัสไปรษณีย์สำหรับตัวแทนจำหน่าย (นอกสหรัฐอเมริกาหรือรหัสไปรษณีย์ในสหรัฐอเมริกา)

ตัวอย่าง: 75008 (ปารีส, ฝรั่งเศส) หรือ 94025 (เมนโลพาร์ค)

ไม่ใช่

ไม่ใช่

dealer_id

ประเภท: สตริง

ระบุหรือไม่ก็ได้

อักขระสูงสุด: 100 ตัว

ID ที่ประกอบด้วยตัวเลขและตัวอักษรของตัวแทนจำนาย

ใช่

ใช่

dealer_name

ประเภท: สตริง

ระบุหรือไม่ก็ได้

อักขระสูงสุด: 100 ตัว

ชื่อของตัวแทนจำหน่าย

ใช่

ใช่

dealer_phone

ประเภท: สตริง

ระบุหรือไม่ก็ได้

หมายเลขโทรศัพท์ของตัวแทนจำหน่าย หมายเลขโทรศัพท์ของตัวแทนจำหน่าย ข้อกำหนด:

  • ต้องแสดงปุ่มโทรในรายการสินค้าบน Marketplace
  • ต้องเป็นรูปแบบหมายเลขโทรศัพท์ที่ถูกต้อง
  • ต้องมีรหัสประเทศ

ตัวอย่าง: +1 3603453333, 001 (360)345-3333

ไม่ใช่

ไม่ใช่

dealer_communication_channel

ประเภท: enum

ระบุหรือไม่ก็ได้

วิธีที่ผู้ใช้ติดต่อกับตัวแทนจำหน่าย ค่าที่ใช้งานได้: CHAT หรือ LEAD_FORM


หมายเหตุ: หากคุณเลือก LEAD_FORM คุณจะต้องระบุนโยบายความเป็นส่วนตัวด้วย ดูเพิ่มเติมที่ dealer_privacy_policy_url

ไม่ใช่

ไม่ใช่

dealer_privacy_policy_url

ประเภท: URL

จำเป็นต้องระบุหากใช้วิธีติดต่อด้วยแบบฟอร์มข้อมูลลูกค้า


ระบุหรือไม่ก็ได้หากใช้วิธีติดต่อด้วย Messenger (แชท)


ลิงก์ที่เชื่อมโยงไปยัง URL ส่วนตัวของตัวแทนจำหน่ายที่ลงประกาศขายยานพาหนะ ซึ่งลิงก์นี้ควรตรงกับตัวแทนจำหน่ายของ ID เพจ Facebook (fb_page_id)

ไม่ใช่

ไม่ใช่

stock_number

ประเภท: สตริง

ระบุหรือไม่ก็ได้

หมายเลขที่ตัวแทนจำหน่ายกำหนดให้กับรถในที่จอดของตนเอง โดยหมายเลขสต็อกนี้เป็นวิธีที่ตัวแทนจำหน่ายใช้ในการจัดเก็บยานพาหนะบางรายการ

ตัวอย่าง: N8990

ใช่

ใช่

custom_label_0

ประเภท: สตริง

ระบุหรือไม่ก็ได้

อักขระสูงสุด: 100 ตัว

ข้อมูลเพิ่มเติมเกี่ยวกับยานพาหนะที่คุณต้องการเพิ่ม

ใช่

ใช่

custom_label_1

ประเภท: สตริง

ระบุหรือไม่ก็ได้

อักขระสูงสุด: 100 ตัว

ข้อมูลเพิ่มเติมเกี่ยวกับยานพาหนะที่คุณต้องการเพิ่ม

ใช่

ใช่

custom_label_2

ประเภท: สตริง

ระบุหรือไม่ก็ได้

อักขระสูงสุด: 100 ตัว

ข้อมูลเพิ่มเติมเกี่ยวกับยานพาหนะที่คุณต้องการเพิ่ม

ใช่

ใช่

โฆษณาข้อเสนอยานยนต์ — รูปแบบที่รองรับ

ฟีดสามารถอยู่ในรูปแบบ CSV, TSV และ XML

ตัวอย่าง ไฟล์ TSV โดยใช้ Tab เป็นตัวคั่น

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

โฆษณาข้อเสนอยานยนต์ — ช่องที่รองรับ

คุณสามารถอัพโหลดฟีดเหล่านี้ผ่าน UI หรือ API ได้ หากคุณต้องการจะใช้ UI โปรดระบุ ID ผู้ใช้และ ID บัญชีของคุณ เราจะได้สามารถเพิ่มคุณลงในรายการที่อนุญาตเพื่อให้ได้สิทธิ์การเข้าถึงได้

ชื่อคำอธิบายตัวกรองชุดสินค้าใช้ในชิ้นงานโฆษณาได้หรือไม่

vehicle_offer_id

ประเภท: สตริง

จำเป็นต้องระบุ

ID ที่ไม่ซ้ำกันสำหรับยานพาหนะ ซึ่งผู้ลงโฆษณาจะใช้ในการระบุข้อเสนอ นอกจากนี้ ค่านี้ยังเป็นค่าเดียวกับที่ส่งในส่วนพารามิเตอร์ content_id ในพิกเซลอีกด้วย

ตัวอย่าง: offer1

ใช่

ใช่

make

ประเภท: สตริง

จำเป็นต้องระบุ

ยี่ห้อหรือแบรนด์ของยานพาหนะ ตัวอย่าง: Endomoto

ใช่

ใช่

model

ประเภท: สตริง

จำเป็นต้องระบุ

รุ่นของยานพาหนะ

ตัวอย่าง: EndoHatch

ใช่

ใช่

year

ประเภท: จำนวนเต็ม

จำเป็นต้องระบุ

ปีที่เปิดตัวยานพาหนะดังกล่าวในรูปแบบ yyyy ตัวอย่าง: 2015

ใช่

ใช่

offer_type

ประเภท: enum

จำเป็นต้องระบุ

ประเภทของข้อเสนอ ค่าที่ใช้ได้ ได้แก่ lease, finance, cash

ใช่

ไม่ใช่

title

ประเภท: สตริง

จำเป็นต้องระบุ

ชื่อของโฆษณา/ข้อเสนอ

ตัวอย่าง: "$299 per month for the EndoHatch GE!"

ไม่ใช่

ใช่

offer_description

ประเภท: สตริง

จำเป็นต้องระบุ

คำอธิบายข้อเสนอ

ตัวอย่าง: This offer is valid only during the month of September.

ไม่ใช่

ใช่

url

ประเภท: URL

จำเป็นต้องระบุ

ลิงก์ไปยังเว็บไซต์ภายนอกที่คุณสามารถดูข้อเสนอดังกล่าวได้

ไม่ใช่

ใช่

offer_disclaimer

ประเภท: สตริง

จำเป็นต้องระบุ

ข้อจำกัดความรับผิดชอบที่เชื่อมโยงกับข้อเสนอนั้น

ไม่ใช่

ไม่ใช่

image[0].url

ประเภท: สตริง

จำเป็นต้องระบุ

URL ของรูปภาพยานพาหนะที่ใช้ในชิ้นงานโฆษณา

หมายเหตุ: หากต้องการใช้โฆษณาแบบภาพสไลด์ ให้ระบุรูปภาพแบบสี่เหลี่ยมจัตุรัสที่มีอัตราส่วนกว้างยาว 1:1 ที่ขนาด 600x600 พิกเซล หากต้องการแสดงโฆษณายานพาหนะแบบเดี่ยว ให้ระบุรูปภาพที่มีอัตราส่วนกว้างยาว 1.91:1 ที่ขนาด 1200x630 พิกเซล

โปรดดูข้อมูลเพิ่มเติมเกี่ยวกับอัตราส่วนของรูปภาพดังกล่าวที่หลักปฏิบัติที่ดีที่สุดสำหรับอัตราส่วนกว้างยาว

ไม่ใช่

ไม่ใช่

image[0].tag[0]

ประเภท: สตริง

ระบุหรือไม่ก็ได้

สตริงที่แสดงสิ่งที่อยู่ในรูปภาพ รูปภาพ 1 รูปอาจมีแท็กที่เชื่อมโยงได้หลายแท็ก เช่น ข้อเสนอให้เช่า การจัดไฟแนนซ์ และอื่นๆ

image[0].tag[m]

ประเภท: สตริง

ระบุหรือไม่ก็ได้

สตริงที่แสดงสิ่งที่อยู่ในรูปภาพ เรารองรับหลากหลายแท็ก ให้เพิ่มค่า m เพื่อเพิ่มแท็กเข้าไปเพิ่มเติม

ไม่ใช่

ไม่ใช่

image[n].url

ประเภท: สตริง

ระบุหรือไม่ก็ได้

สตริงที่แสดงสิ่งที่อยู่ในรูปภาพ คุณสามารถอัพโหลดรูปภาพมากกว่า 1 รูปได้โดยการเพิ่มหลัก n โดยเริ่มตั้งแต่ 1 ถึง 20 ค่าของ n ควรเรียงตามลำดับ เช่น หากคุณมี 0,1,2 แล้ว คุณจะต้องระบุ 3 ก่อน โดยยังไม่สามารถระบุ 4 ได้ทันที

ไม่ใช่

ไม่ใช่

image[n].tag[0]

ประเภท: สตริง

ระบุหรือไม่ก็ได้

สตริงที่แสดงสิ่งที่อยู่ในรูปภาพ เรารองรับหลากหลายแท็ก ให้เพิ่มค่า m เพื่อเพิ่มแท็กเข้าไปเพิ่มเติม

ไม่ใช่

ไม่ใช่

image[n].tag[m]

ประเภท: สตริง

ระบุหรือไม่ก็ได้

สตริงที่แสดงสิ่งที่อยู่ในรูปภาพ รูปภาพ 1 รูปอาจมีแท็กที่เชื่อมโยงได้หลายแท็ก เช่น ข้อเสนอให้เช่า การจัดไฟแนนซ์ และอื่นๆ

ไม่ใช่

ไม่ใช่

amount_price

ประเภท: สตริง

แนะนำ

จำนวนเงินของข้อเสนอแบบเช่าหรือเงินสด ให้จัดรูปแบบราคาโดยเริ่มต้นด้วยราคา ตามด้วยรหัสสกุลเงินตาม ISO โดยเว้นวรรคระหว่างราคากับสกุลเงินไว้

ตัวอย่าง: สำหรับการเช่าที่ราคา $329/เดือน หรือเงินคืนจำนวน $2,000 ค่าก็จะเป็น 329 USD หรือ 2000 USD

ไม่ใช่

ใช่

amount_percentage

ประเภท: สตริง

แนะนำ

ค่าเป็นเปอร์เซ็นต์ หากมีอยู่ในข้อเสนอ บางครั้ง ค่าจะเป็นเปอร์เซ็นต์ (ตัวอย่าง: 3.9% APR) แทนที่จะเป็นจำนวน

ไม่ใช่

ไม่ใช่

amount_qualifier

ประเภท: สตริง

แนะนำ

ส่วนขยายสำหรับมูลค่าดอลลาร์ของจำนวนหรือเปอร์เซ็นต์ของจำนวน ค่าที่ใช้ได้อาจเป็น per month หรือ APR ก็ได้

ตัวอย่าง: /mo ใน $100/เดือน สำหรับข้อเสนอให้เช่า APR ใน 1.1% APR สำหรับข้อเสนอการจัดไฟแนนซ์

ไม่ใช่

ใช่

term_length

ประเภท: จำนวนเต็ม

แนะนำ

ระยะเวลาที่ข้อเสนอดังกล่าวมีผล หากข้อเสนอคือการเช่าที่ราคา $329/เดือนเป็นเวลา 3 ปี ค่าก็จะเป็น 3 โดยค่าที่ใช้ด้วยกันใน term_qualifier จะเป็น years

ตัวอย่าง: /mo ใน $100/เดือน สำหรับข้อเสนอให้เช่า APR ใน 1.1% APR สำหรับข้อเสนอการจัดไฟแนนซ์

ไม่ใช่

ใช่

term_qualifier

ประเภท: enum

แนะนำ

หน่วยสำหรับระยะเวลาของข้อเสนอ ค่าที่ใช้ได้ ได้แก่ "months" หรือ "years"

ตัวอย่าง: months สำหรับข้อเสนอที่มีราคา $329/เดือนเป็นเวลา 36 เดือน และ year สำหรับข้อเสนอที่มีราคา $329/เดือนเป็นเวลา 3 ปี

ไม่ใช่

ใช่

downpayment

ประเภท: สตริง

แนะนำ

มูลค่าเงินดาวน์ในขณะที่มีการซื้อหรือเช่า ให้จัดรูปแบบราคาโดยเริ่มต้นด้วยราคา ตามด้วยรหัสสกุลเงินตาม ISO โดยเว้นวรรคระหว่างราคากับสกุลเงินไว้

ตัวอย่าง: ใช้ค่าเป็น 1500 USD หากเงื่อนไขเงินดาวน์คือ $1500 due at signing + 1 month payment

ไม่ใช่

ใช่

downpayment_qualifier

ประเภท: สตริง

แนะนำ

ส่วนขยายสำหรับค่า downpayment ตัวอย่าง: ใช้ค่า due at signing + 1 month payment หากเงื่อนไขเงินดาวน์คือ $1500 due at signing + 1 month payment

ใช่

trim

ประเภท: สตริง

แนะนำ

รุ่นย่อยของยานพาหนะ ตัวอย่าง: GE

ไม่ใช่

ใช่

price

ประเภท: สตริง

แนะนำ

MSRP ของยานพาหนะพร้อมสกุลเงิน ให้จัดรูปแบบราคาโดยเริ่มต้นด้วยราคา ตามด้วยรหัสสกุลเงินตาม ISO โดยเว้นวรรคระหว่างราคากับสกุลเงินไว้ ตัวอย่าง: 13,999 USD

ไม่ใช่

ไม่ใช่

body_style

ประเภท: enum

แนะนำ

รูปแบบตัวรถของยานพาหนะ ค่าที่ใช้ได้ ได้แก่ CONVERTIBLE, COUPE, HATCHBACK, MINIVAN, TRUCK, SUV, SEDAN, VAN, WAGON, CROSSOVER หรือ OTHER

ไม่ใช่

ไม่ใช่

start_date

ประเภท: สตริง

ระบุหรือไม่ก็ได้

วันที่ข้อเสนอเริ่มมีผล ควรอยู่ในรูปแบบวันที่ yyyy-mm-dd

ตัวอย่าง: 2018-09-05

ไม่ใช่

ไม่ใช่

end_date

ประเภท: สตริง

ระบุหรือไม่ก็ได้

วันที่ข้อเสนอสิ้นสุดการมีผล ควรอยู่ในรูปแบบวันที่ yyyy-mm-dd

ตัวอย่าง: 2018-09-05

ไม่ใช่

ไม่ใช่

market_name

ประเภท: สตริง

ระบุหรือไม่ก็ได้

ชื่อของตลาด/Designated Marketing Area (DMA)

ใช่

ไม่ใช่

dma_codes

ประเภท: อาร์เรย์ของสตริง

จำเป็นต้องระบุสำหรับข้อเสนอระดับภูมิภาค แต่จะระบุหรือไม่ก็ได้สำหรับข้อเสนอระดับประเทศ

รายการรหัส Designated Market Area (DMA) สำหรับแต่ละตลาดโดยเฉพาะ โดยระบุอยู่ในรูปแบบต่อไปนี้ ['502', '201'] ['516'...] หมายเหตุ: รายการนี้มีไว้สำหรับรูปแบบ CSV โปรดดูฟีดตัวอย่างด้านล่างสำหรับรูปแบบ XML โปรดดูมาตรฐานรหัส DMA ให้ปล่อยว่างไว้สำหรับข้อเสนอระดับประเทศ

ใช่

ไม่ใช่

ตัวอย่าง หากต้องการสร้างแค็ตตาล็อกสำหรับโฆษณาแค็ตตาล็อก Advantage+ โปรดดูแค็ตตาล็อก, ข้อมูลอ้างอิง

curl \
  -F 'name=catalog name' \
  -F 'access_token=<ACCESS TOKEN>' \
  -F 'vertical=vehicle_offers' \
  https://graph.facebook.com/<API_VERSION>/<BUSINESS ID>/product_catalogs