参考文档

创建汽车广告时,可参考本指南以了解支持的数据源格式和字段。

所有枚举字段不区分大小写。

汽车库存广告 - 支持的信息库格式

请以正确格式提供信息库:CSVTSVXML。创建信息库文件后,您应将其托管到网址,以便安排定期更新。

信息库格式 说明和指南 信息库示例

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 站内目标位置库存广告的必要项

合作伙伴或经销商的 Facebook 公共主页编号。只有在 Facebook 代表将您的目录加入白名单后,您才可以发送公共主页编号。必须使用商务管理平台将公共主页加入白名单,才能引入该公共主页。请参阅管理权限

vehicle_id

类型:字符串

必要

字符数上限:100

商品的唯一编号。可以是汽车的一个变量。如果同一个编号对应多个实例,则系统将忽略所有实例。您也可以将 VIN 用于 vehicle_idvin

示例:1FADP5AU6DL536022

title

类型:字符串

必要

字符数上限:500。

汽车全名。此字段与每辆汽车相关且因车而异,应包含 yearmakemodeltrim 中设置的内容。

示例:$299 per month for the EndoHatch GE

description

类型:字符串

必要

字符数上限:5000

描述汽车的一小段文字。不要包含推广文本或任何链接。不要以全部大写的形式输入文本。使用换行符调整描述的格式。

示例:Used 2017 Volvo XC90 in great condition, available now.

url

类型:网址

必要

可用于查看汽车交易帖的外部网站链接。

make

类型:字符串

必要

汽车制造商或品牌。

示例:Endomoto

model

类型:字符串

必要

汽车型号。

示例:EndoHatch

year

类型:整数

必要

汽车上市年份,格式为 yyyy

示例:2015

mileage.value

类型:整数

必要

若是二手车,此字段为汽车目前行驶过的里程,以公里 (kms) 或英里 (MI) 为单位。若是新车,则使用零 (0)。若用于 Marketplace,则汽车的行驶里程必须超过 500 英里/公里。

示例:“1500”

mileage.unit

类型:字符串

必要

里程单位:MI(英里)或 KM(公里)

image[0].url

类型:字符串

必要

项目数上限:20

汽车图片的网址。如果您有多张汽车图片,请按照以下规则命名:image[1].urlimage[2].url,以此类推。您必须至少提供一张图片。每张图片最大不得超过 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] ...。

示例:ExteriorInteriorStockImage

transmission

类型:枚举

可选

汽车的变速器类型:AutomaticManual

body_style

类型:枚举

必要

车身样式:CONVERTIBLECOUPEHATCHBACKMINIVANTRUCKSUVSEDANVANWAGONCROSSOVERSMALL_CAROTHER

drivetrain

类型:枚举

可选

汽车的传动系统。支持的值:4X24X4AWDFWDRWDOther

vin

类型:字符串

对于某些国家/地区为必要项

字符数上限:17

汽车的车辆识别编号 (VIN)。您也可以将 VIN 用于 vehicle_idvin。请注意:VIN 必须为 17 个字符,1983 年以前的汽车不需要 VIN。船只的 VIN 位数较少,部分汽车(如拖车)不需要 VIN。

示例:1FADP5AU6DL536022

price

类型:字符串

必要

汽车的价格和货币。按费用设置价格格式,后接 ISO 货币代码,费用与货币单位之间应留一个空格。

示例:18000 USD32000 USD

exterior_color

类型:字符串

必要

汽车颜色。

示例:BlackWhiteBlueRed

state_of_vehicle

类型:枚举

必要

汽车的当前状态。支持的值:NewUsedCPO(认证二手车)。

fuel_type

类型:枚举

可选

汽车的燃料类型。支持的值:DIESELELECTRICFLEXGASOLINEHYBRIDOTHER

tag(图片标签)

类型:字符串

可选

描述图片的字符串。一张图片可以与多个标签相关联。

示例:ExteriorInteriorStockImage

chrome_id

类型:整数

可选

类似 autodata_id

condition

类型:枚举

可选

汽车状况。支持的值:EXCELLENTGOODFAIRPOOROTHER

sale_price

类型:整数

可选

促销价或特价。按费用设置价格格式,后接 ISO 货币代码,费用与货币单位之间应留一个空格。

示例:16000 USD

availability

类型:枚举

可选

汽车库存情况:availablenot available我们不会在广告中展示无库存的汽车。

vehicle_type

类型:字符串

可选

汽车类型。预期值:car_truck(未指定时的默认值)、boatcommercialmotorcyclepowersportrv_campertrailerother

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

经销商的字母数字编号。

dealer_name

类型:字符串

可选

字符数上限:100

经销商的名称。

dealer_phone

类型:字符串

可选

经销商的电话号码。经销商的电话号码。要求:

  • 必须在 Marketplace 上的交易帖中显示通话按钮。
  • 必须是有效的电话号码格式。
  • 必须包含国家/地区代码。

示例:+1 3603453333001 (360)345-3333

dealer_communication_channel

类型:枚举

可选

用户联系经销商的方法。可用的值:CHATLEAD_FORM


注意:如果您选择 LEAD_FORM,还必须包含隐私权政策。详情请参阅 dealer_privacy_policy_url

dealer_privacy_policy_url

类型:网址

若使用线索表单联系方法,则为必要项。


若使用 Messenger(聊天)联系方法,则为可选项。


发布汽车的经销商的隐私权政策网址链接。必须与上述 Facebook 公共主页编号对应的经销商相匹配 (fb_page_id)。

stock_number

类型:字符串

可选

经销商自行为车场汽车指定的编号。库存编号是经销商用于管理特定汽车库存的一种方式。

示例:N8990

custom_label_0

类型:字符串

可选

字符数上限:100

有关待添加汽车的其他信息。

custom_label_1

类型:字符串

可选

字符数上限:100

有关待添加汽车的其他信息。

custom_label_2

类型:字符串

可选

字符数上限:100

有关待添加汽车的其他信息。

汽车优惠广告 — 支持的格式

数据源可以采用 CSV、TSV、XML 格式。

示例:使用制表符作为分隔符的 TSV 文件

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

汽车优惠广告 — 支持的字段

这些信息库可以通过用户界面或 API 上传。如果您倾向使用用户界面,请提供您的用户编号和帐户编号,我们可以将您添加到访问白名单中。

名称描述商品系列筛选条件是否可在创意中使用?

vehicle_offer_id

类型:字符串

必要

汽车的唯一编号,广告主可用它来查找优惠。此编号与 Pixel 像素代码中 content_id 参数所传递的值相同。

示例:offer1

make

类型:字符串

必要

汽车制造商或品牌。示例:Endomoto

model

类型:字符串

必要

汽车型号。

示例:EndoHatch

year

类型:整数

必要

汽车上市年份,格式为 yyyy。示例:2015

offer_type

类型:枚举

必要

优惠类型。有效的值:leasefinancecash

title

类型:字符串

必要

广告/优惠的标题。

示例:"$299 per month for the EndoHatch GE!"

offer_description

类型:字符串

必要

优惠描述。

示例:This offer is valid only during the month of September.

url

类型:网址

必要

可用于查看优惠的外部网站链接。

offer_disclaimer

类型:字符串

必要

与优惠相关的免责声明。

image[0].url

类型:字符串

必要

广告创意中所用汽车图片的网址。

注意:若要使用轮播广告,需提供宽高比为 1:1 的正方形图片(600x600 像素)。若要投放单图片汽车广告,则需要提供宽高比为 1.91:1 的图片(1200x630 像素)。

如需了解图片宽高比的更多信息,请参阅宽高比最佳实践

image[0].tag[0]

类型:字符串

可选

描述图片内容的字符串。可以有多个与图片关联的标签,如 Lease Offer、Financing 等。

image[0].tag[m]

类型:字符串

可选

描述图片内容的字符串。支持使用多个标签。调高 m 值可以添加更多标签。

image[n].url

类型:字符串

可选

描述图片内容的字符串。您可以上传多张图片,方法是在 1 到 20 的范围内调高数字 n。n 的值应为连续自然数。例如,如果选择了 0、1、2,则必须选择 3,不能直接调到 4。

image[n].tag[0]

类型:字符串

可选

描述图片内容的字符串。支持使用多个标签。调高 m 值可以添加更多标签。

image[n].tag[m]

类型:字符串

可选

描述图片内容的字符串。可以有多个与图片关联的标签,如 Lease Offer、Financing 等。

amount_price

类型:字符串

推荐

租赁或现金优惠的金额。按费用设置价格格式,后接 ISO 货币代码,费用与货币单位之间应留一个空格。

示例:对于 $329 美元/月的租赁价格或 $2000 美元的返现金额,值应为 329 USD2000 USD

amount_percentage

类型:字符串

推荐

优惠中出现的百分比值。有时,此值为百分比(示例:3.9% APR),而非金额。

amount_qualifier

类型:字符串

推荐

美元金额值或金额百分比的限定词。有效的值可以是 per monthAPR

示例:租赁优惠 $100 美元/月中的 /mo,贷款优惠 1.1% APR 中的 APR

term_length

类型:整数

推荐

优惠适用期限。如果优惠为租赁 3 年,每月 329 美元,则值为 3term_qualifier 中相应的值为 years

示例:租赁优惠 $100 美元/月中的 /mo,贷款优惠 1.1% APR 中的 APR

term_qualifier

类型:枚举

推荐

优惠期限的单位。有效的值为“月”或“年”。

示例:对于 $329 美元/月且为期 36 个月的优惠,值为 months,对于 $329 美元/月且为期 3 年的优惠,值为 year

downpayment

类型:字符串

推荐

购买或租赁时首付款的值。按费用设置价格格式,后接 ISO 货币代码,费用与货币单位之间应留一个空格。

示例:如果首付款条件为 $1500 due at signing + 1 month payment,则使用 1500 USD 作为值。

downpayment_qualifier

类型:字符串

推荐

downpayment 值的限定词。示例:如果首付款条件为 $1500 due at signing + 1 month payment,则使用 due at signing + 1 month payment 作为值。

trim

类型:字符串

推荐

汽车配置。示例:GE

price

类型:字符串

推荐

汽车的建议零售价,含货币单位。按费用设置价格格式,后接 ISO 货币代码,费用与货币单位之间应留一个空格。示例:13,999 USD

body_style

类型:枚举

推荐

车身样式。有效的值:CONVERTIBLECOUPEHATCHBACKMINIVANTRUCKSUVSEDANVANWAGONCROSSOVEROTHER

start_date

类型:字符串

可选

优惠生效日期。应使用 yyyy-mm-dd 的日期格式。

示例:2018-09-05

end_date

类型:字符串

可选

优惠结束日期。应使用 yyyy-mm-dd 的日期格式。

示例:2018-09-05

market_name

类型:字符串

可选

市场/指定营销地区 (DMA) 的名称。

dma_codes

类型:字符串数组

区域性优惠为必要项。全国性优惠为可选项

采用 ['502', '201'] ['516'...] 格式提供的特定市场中指定营销地区 (DMA) 代码的列表。注意:此列表适用于 CSV 格式;如需了解 XML 格式,请参阅下方示例信息库。请参阅 DMA 代码标准。全国性优惠可留空。

示例:如要创建进阶赋能型目录广告的目录,请参阅目录 > 参考文档

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