참고 자료

이 가이드는 자동차 광고를 만들 때 지원되는 피드 형식과 필드에 관한 참고 자료입니다.

모든 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 내 랜딩 페이지가 포함된 인벤토리 광고에 필수 항목입니다.

파트너 또는 대리점의 Facebook 페이지 ID. 페이지 ID를 보내려면 Facebook 담당자가 카탈로그를 허용 리스트에 추가해야 합니다. 이 페이지를 비즈니스 관리자를 사용하여 허용 리스트에 추가한 후에 페이지 수집이 가능합니다. 권한 관리를 참조하세요.

N

N

vehicle_id

유형: 문자열

필수 항목.

최대 문자 수: 100

항목의 고유 ID. 차량의 에디션일 수 있습니다. 동일한 ID의 인스턴스가 여러 개 있는 경우 모든 인스턴스를 무시합니다. 또한 vehicle_idvin에 모두 VIN을 사용할 수 있습니다.

예: 1FADP5AU6DL536022

Y

Y

title

유형: 문자열

필수 항목.

최대 문자 수: 500

차량의 전체 이름. 각 차량과 관련이 있고 고유해야 하며 year, make, modeltrim에 설정된 값을 포함해야 합니다.

예: $299 per month for the EndoHatch GE

Y

Y

description

유형: 문자열

필수 항목.

최대 문자 수: 5,000

차량을 설명하는 짧은 텍스트. 홍보 텍스트나 링크를 포함하지 마세요. 텍스트를 모두 대문자로 입력하지 마세요. 줄 바꿈을 사용하여 설명의 서식을 지정하세요.

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

Y

N

url

유형: url

필수 항목.

차량 품목을 볼 수 있는 외부 사이트 링크.

Y

N

make

유형: 문자열

필수 항목.

차량 제조사 또는 브랜드.

예: Endomoto

Y

Y

model

유형: 문자열

필수 항목.

차량 모델.

예: EndoHatch

Y

Y

year

유형: 정수

필수 항목.

차량이 출시된 연도(형식: yyyy).

예: 2015

Y

Y

mileage.value

유형: 정수

필수 항목.

중고 차량의 경우 킬로미터(kms) 또는 마일(MI)로 표시한 차량의 현재 주행 거리. 신차의 경우 영(0)을 사용합니다. Marketplace에 등록된 차량의 주행 거리는 500마일/km 이상이어야 합니다.

예: '1500'

Y

Y

mileage.unit

유형: 문자열

필수 항목.

주행 거리 단위: MI(마일) 또는 KM(킬로미터)

Y

N

image[0].url

유형: 문자열

필수 항목.

최대 항목 수: 20

차량 이미지 URL. 차량 이미지가 두 개 이상인 경우 image[1].url, image[2].url 등의 이름 지정 규칙을 따르세요. 이미지를 하나 이상 제공해야 합니다. 각 이미지의 최대 크기는 4MB입니다. Marketplace에 등록된 차량의 경우 이미지가 2개 이상 필요합니다.

  • 슬라이드 광고 사용 — 가로세로비가 1:1 인 정사각형 이미지(600x600픽셀)를 제공하세요.

  • 단일 차량 광고 게재 — 가로세로비가 1.91:1인 이미지(1200x630픽셀)를 제공하세요.

Marketplace 이미지 모범 사례에 대해 자세히 알아보세요.

N

N

image[0].tag[0]

유형: 문자열

선택 사항.

최대 항목 수: 20

이미지 내용을 나타내기 위해 이미지에 붙이는 태그. 하나의 이미지에 여러 개의 태그를 연결할 수 있습니다. 다음의 이름 지정 규칙을 따르세요. image[0].tag[0], image[0].tag[1] .... image[1].tag[0], image[1].tag[1] ....

예: Exterior, Interior, StockImage

N

Y

transmission

유형: enum

선택 사항.

차량의 변속 유형: Automatic 또는 Manual.

N

Y

body_style

유형: enum

필수 항목.

차체 유형: CONVERTIBLE, COUPE, HATCHBACK, MINIVAN, TRUCK, SUV, SEDAN, VAN, WAGON, CROSSOVER, SMALL_CAR 또는 OTHER.

Y

Y

drivetrain

유형: enum

선택 사항.

차량 구동 방식. 지원되는 값: 4X2, 4X4, AWD, FWD, RWD, Other.

N

Y

vin

유형: 문자열

필수 항목, 일부 국가.

최대 문자 수: 17

차량의 차량 ID 번호(VIN). 또한 vehicle_idvin에 모두 VIN을 사용할 수 있습니다. 참고: VIN은 정확히 17자여야 하지만, 1983년 이전에 생산된 차량에는 필요하지 않습니다. 보트는 자릿수가 그보다 적으며 일부 차량(예: 트레일러)은 VIN이 필요하지 않습니다.

예: 1FADP5AU6DL536022

Y

Y

price

유형: 문자열

필수 항목.

차량의 비용 및 통화. 가격 형식은 비용 뒤에 ISO 통화 코드를 붙이고 비용과 통화 사이에 공백이 있어야 합니다.

예: 18000 USD, 32000 USD

Y

Y

exterior_color

유형: 문자열

필수 항목.

차량 색상.

예: Black, White, Blue, Red

Y

Y

state_of_vehicle

유형: enum

필수 항목.

차량의 현재 상태. 지원되는 값: New, Used 또는 CPO(인증된 중고차).

N

Y

fuel_type

유형: enum

선택 사항.

차량의 연료 유형. 지원되는 값: DIESEL, ELECTRIC, FLEX, GASOLINE, HYBRID, OTHER.

N

Y

tag(이미지 태그)

유형: 문자열

선택 사항.

이미지를 설명하는 문자열. 하나의 이미지에 여러 개의 태그를 연결할 수 있습니다.

예: Exterior, Interior, StockImage

Y

N

chrome_id

유형: 정수

선택 사항.

autodata_id와 유사합니다.

N

N

condition

유형: enum

선택 사항.

차량 상태. 지원되는 값: EXCELLENT, GOOD, FAIR, POOR, OTHER.

N

Y

sale_price

유형: 정수

선택 사항.

판매 가격 또는 특별 가격. 가격 형식은 비용 뒤에 ISO 통화 코드를 붙이고 비용과 통화 사이에 공백이 있어야 합니다.

예: 16000 USD

Y

Y

availability

유형: enum

선택 사항.

차량 구매 가능 여부: available 또는 not available. 구매할 수 없는 차량은 광고에 표시되지 않습니다.

N

Y

vehicle_type

유형: 문자열

선택 사항.

차량 유형. 예상 값: car_truck(값을 입력하지 않은 경우의 기본값), boat, commercial, motorcycle, powersport, rv_camper, trailer 또는 other.

N

Y

trim

유형: 문자열

선택 사항.

최대 문자 수: 50

차량 트림.

예: 5DR HB SE

Y

Y

interior_color

유형: 문자열

선택 사항.

최대 문자 수: 50

차량 내부 색상.

N

Y

date_first_on_lot

유형: 문자열

선택 사항.

이 차량이 처음으로 대리점에 도착한 날짜. 재고 보관 기간을 나타내는 데 사용됩니다. yyyy-mm-dd 형식을 사용하세요.

예: 2018-09-05

N

Y

days_on_lot

유형: 정수

선택 사항.

대리점이 해당 차량을 보유한 기간. 일 단위로 늘어나야 합니다.

예: 62

N

Y

자동차 인벤토리 광고 - 지원되는 필드 - 대리점

주소를 제공하기 위한 형식에는 두 가지가 있으며 둘 중 하나만 사용해야 합니다. 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'}

N

N

address.city

유형: 문자열

필수 항목.

대리점이 있는 도시.

예: Palo Alto

Y

Y

address.region

유형: 문자열

필수 항목.

대리점이 있는 주/도, 군, 지역 또는 지방.

예: California

Y

Y

address.country

유형: 문자열

필수 항목.

대리점이 있는 국가.

예: United States

N

Y

latitude

유형: 부동 소수점

필수 항목.

대리점 위치의 위도.

예: 37.484100

N

N

longitude

유형: 부동 소수점

필수 항목.

대리점 위치의 경도.

예: -122.148252

N

N

address.postal_code

유형: 문자열

선택 사항.

대리점의 우편번호(해외 또는 미국 국내).

예: 75008(프랑스 파리) 또는 94025(멘로 파크)

N

N

dealer_id

유형: 문자열

선택 사항.

최대 문자 수: 100

대리점의 영숫자 ID.

Y

Y

dealer_name

유형: 문자열

선택 사항.

최대 문자 수: 100

대리점 이름.

Y

Y

dealer_phone

유형: 문자열

선택 사항.

대리점 전화번호. 대리점 전화번호. 요구 사항:

  • Marketplace 품목에 전화 버튼을 표시해야 합니다.
  • 유효한 전화번호 형식이어야 합니다.
  • 국가 번호를 포함해야 합니다.

예: +1 3603453333, 001 (360)345-3333

N

N

dealer_communication_channel

유형: enum

선택 사항.

사용자가 대리점에 연락할 방법. 사용 가능한 값: CHAT 또는 LEAD_FORM.


참고: LEAD_FORM을 선택하는 경우 개인정보처리방침도 포함해야 합니다. 자세한 내용은 dealer_privacy_policy_url을 참조하세요.

N

N

dealer_privacy_policy_url

유형: url

잠재 고객용 양식 연락 방법의 경우 필수 항목입니다.


Messenger(채팅) 연락 방법의 경우 선택 사항입니다.


차량을 게재하는 대리점의 비공개 URL 링크. Facebook 페이지 ID(fb_page_id)의 대리점과 일치해야 합니다.

N

N

stock_number

유형: 문자열

선택 사항.

대리점이 부지 내에서 지정한 차량 명칭. 재고 번호는 대리점이 특정 차량의 재고를 파악하는 방법입니다.

예: N8990

Y

Y

custom_label_0

유형: 문자열

선택 사항.

최대 문자 수 한도: 100

포함하고자 하는 차량에 대한 추가 정보.

Y

Y

custom_label_1

유형: 문자열

선택 사항.

최대 문자 수 한도: 100

포함하고자 하는 차량에 대한 추가 정보.

Y

Y

custom_label_2

유형: 문자열

선택 사항.

최대 문자 수 한도: 100

포함하고자 하는 차량에 대한 추가 정보.

Y

Y

자동차 쿠폰 광고 — 지원되는 형식

피드는 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

자동차 쿠폰 광고 — 지원되는 필드

이러한 피드는 UI 또는 API를 통해 업로드할 수 있습니다. UI를 선호하는 경우 사용자 ID와 계정 ID를 제공해 주세요. Facebook에서 액세스를 위한 허용 리스트에 추가해 드립니다.

이름설명제품 세트 필터크리에이티브에서 사용 가능 여부

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인 이미지(1,200x630픽셀)를 제공하세요.

이미지 비율 정보에 대한 자세한 내용은 가로세로비 모범 사례를 참조하세요.

아니요

아니요

image[0].tag[0]

유형: 문자열

선택 사항.

이미지의 내용을 나타내는 문자열. 이미지와 관련된 태그는 여러 개가 있을 수 있습니다(예: Lease Offer, Financing 등).

image[0].tag[m]

유형: 문자열

선택 사항.

이미지의 내용을 나타내는 문자열. Facebook에서는 여러 태그를 지원합니다. 더 많은 태그를 추가하려면 m 값을 높이세요.

아니요

아니요

image[n].url

유형: 문자열

선택 사항.

이미지의 내용을 나타내는 문자열. n 숫자를 1~20 범위 내에서 늘려 이미지를 2개 이상 업로드할 수 있습니다. n 값은 순차적이어야 합니다. 예를 들어 0, 1, 2가 있을 경우 다음에 3이 와야 하고 바로 4가 올 수 없습니다.

아니요

아니요

image[n].tag[0]

유형: 문자열

선택 사항.

이미지의 내용을 나타내는 문자열. Facebook에서는 여러 태그를 지원합니다. 더 많은 태그를 추가하려면 m 값을 높이세요.

아니요

아니요

image[n].tag[m]

유형: 문자열

선택 사항.

이미지의 내용을 나타내는 문자열. 이미지와 관련된 태그는 여러 개가 있을 수 있습니다(예: Lease Offer, Financing 등).

아니요

아니요

amount_price

유형: 문자열

권장 사항.

리스 또는 현금 쿠폰 금액. 가격 형식은 비용 뒤에 ISO 통화 코드를 붙이고 비용과 통화 사이에 공백이 있어야 합니다.

예: 월 $329 리스 또는 $2000 캐시백의 경우 값은 329 USD 또는 2000 USD입니다.

아니요

amount_percentage

유형: 문자열

권장 사항.

비율 값(쿠폰에 있을 경우). 값이 금액이 아니라 비율(예: 3.9% APR)일 경우가 있습니다.

아니요

아니요

amount_qualifier

유형: 문자열

권장 사항.

달러 금액 값 또는 금액 비율에 대한 한정자. 유효한 값은 per month 또는 APR입니다.

예: 리스 쿠폰에서 $100/mo의 /mo. 파이낸스 쿠폰에서 1.1% APR의 APR.

아니요

term_length

유형: 정수

권장 사항.

쿠폰 적용 기간. 3년 동안 제공되는 월 $329 리스 쿠폰일 경우 값은 3이고 term_qualifier에서 상응하는 값은 years입니다.

예: 리스 쿠폰에서 $100/mo의 /mo. 파이낸스 쿠폰에서 1.1% APR의 APR.

아니요

term_qualifier

유형: enum

권장 사항.

쿠폰 기간 단위. 유효한 값은 'months' 또는 'years'입니다.

예: $329/month for 36 months 쿠폰에서 months , $329/month for 3 years 쿠폰에서 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

유형: 문자열

권장 사항

차량의 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

유형: 문자열

선택 사항.

시장/DMA(Designated Market Area)의 이름.

아니요

dma_codes

유형: 문자열 배열

지역 쿠폰에는 필수 항목입니다. 전국 쿠폰에는 선택 사항입니다.

['502', '201'] ['516'...]과 같은 형식으로 제공되는 특정 시장에 대한 DMA(Designated Market Area) 코드 리스트. 참고: 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