이 가이드는 자동차 광고를 만들 때 지원되는 피드 형식과 필드에 관한 참고 자료입니다.
모든 enum 필드는 대소문자를 구분하지 않습니다.
피드를 올바른 형식(CSV
, TSV
또는 XML
)으로 제공하세요. 피드 파일을 생성하고 나면 URL에 호스팅하여 정기적으로 예약 업데이트를 진행해야 합니다.
피드 형식 | 설명 및 가이드라인 | 샘플 피드 |
---|---|---|
CSV | 쉼표로 구분된 값입니다.
피드 CSV/TSV 예시, 주소 CSV/TSV 예시를 참조하세요. | |
TSV | 탭으로 구분된 값입니다. CSV 가이드라인을 참조하세요. 피드 CSV/TSV 예시, 주소 CSV/TSV 예시를 참조하세요. | |
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>
"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>
다음의 지원되는 필드는 제품 카탈로그에 추가하는 항목을 위해 고안되었습니다.
현지화된 카탈로그는 차량에 지원되는 필드를 참조하세요.
이름 | 설명 | 크리에이티브에 사용 | 제품 세트 필터로 사용 |
---|---|---|---|
유형: 정수 | Facebook 내 랜딩 페이지가 포함된 인벤토리 광고에 필수 항목입니다. 파트너 또는 대리점의 Facebook 페이지 ID. 페이지 ID를 보내려면 Facebook 담당자가 카탈로그를 허용 리스트에 추가해야 합니다. 이 페이지를 비즈니스 관리자를 사용하여 허용 리스트에 추가한 후에 페이지 수집이 가능합니다. 권한 관리를 참조하세요. | N | N |
유형: 문자열 | 필수 항목. 최대 문자 수: 100 항목의 고유 ID. 차량의 에디션일 수 있습니다. 동일한 ID의 인스턴스가 여러 개 있는 경우 모든 인스턴스를 무시합니다. 또한 예: | Y | Y |
유형: 문자열 | 필수 항목. 최대 문자 수: 500 차량의 전체 이름. 각 차량과 관련이 있고 고유해야 하며 예: | Y | Y |
유형: 문자열 | 필수 항목. 최대 문자 수: 5,000 차량을 설명하는 짧은 텍스트. 홍보 텍스트나 링크를 포함하지 마세요. 텍스트를 모두 대문자로 입력하지 마세요. 줄 바꿈을 사용하여 설명의 서식을 지정하세요. 예: | Y | N |
유형: url | 필수 항목. 차량 품목을 볼 수 있는 외부 사이트 링크. | Y | N |
유형: 문자열 | 필수 항목. 차량 제조사 또는 브랜드. 예: | Y | Y |
유형: 문자열 | 필수 항목. 차량 모델. 예: | Y | Y |
유형: 정수 | 필수 항목. 차량이 출시된 연도(형식: 예: | Y | Y |
유형: 정수 | 필수 항목. 중고 차량의 경우 킬로미터( 예: '1500' | Y | Y |
유형: 문자열 | 필수 항목. 주행 거리 단위: | Y | N |
유형: 문자열 | 필수 항목. 최대 항목 수: 20 차량 이미지 URL. 차량 이미지가 두 개 이상인 경우
Marketplace 이미지 모범 사례에 대해 자세히 알아보세요. | N | N |
유형: 문자열 | 선택 사항. 최대 항목 수: 20 이미지 내용을 나타내기 위해 이미지에 붙이는 태그. 하나의 이미지에 여러 개의 태그를 연결할 수 있습니다. 다음의 이름 지정 규칙을 따르세요. 예: | N | Y |
유형: enum | 선택 사항. 차량의 변속 유형: | N | Y |
유형: enum | 필수 항목. 차체 유형: | Y | Y |
유형: enum | 선택 사항. 차량 구동 방식. 지원되는 값: | N | Y |
| 필수 항목, 일부 국가. 최대 문자 수: 17 차량의 차량 ID 번호(VIN). 또한 예: | Y | Y |
유형: 문자열 | 필수 항목. 차량의 비용 및 통화. 가격 형식은 비용 뒤에 ISO 통화 코드를 붙이고 비용과 통화 사이에 공백이 있어야 합니다. 예: | Y | Y |
유형: 문자열 | 필수 항목. 차량 색상. 예: | Y | Y |
유형: enum | 필수 항목. 차량의 현재 상태. 지원되는 값: | N | Y |
유형: enum | 선택 사항. 차량의 연료 유형. 지원되는 값: | N | Y |
유형: 문자열 | 선택 사항. 이미지를 설명하는 문자열. 하나의 이미지에 여러 개의 태그를 연결할 수 있습니다. 예: | Y | N |
유형: 정수 | 선택 사항.
| N | N |
유형: enum | 선택 사항. 차량 상태. 지원되는 값: | N | Y |
유형: 정수 | 선택 사항. 판매 가격 또는 특별 가격. 가격 형식은 비용 뒤에 ISO 통화 코드를 붙이고 비용과 통화 사이에 공백이 있어야 합니다. 예: | Y | Y |
유형: enum | 선택 사항. 차량 구매 가능 여부: | N | Y |
유형: 문자열 | 선택 사항. 차량 유형. 예상 값: | N | Y |
유형: 문자열 | 선택 사항. 최대 문자 수: 50 차량 트림. 예: | Y | Y |
유형: 문자열 | 선택 사항. 최대 문자 수: 50 차량 내부 색상. | N | Y |
유형: 문자열 | 선택 사항. 이 차량이 처음으로 대리점에 도착한 날짜. 재고 보관 기간을 나타내는 데 사용됩니다. 예: | N | Y |
유형: 정수 | 선택 사항. 대리점이 해당 차량을 보유한 기간. 일 단위로 늘어나야 합니다. 예: | N | Y |
주소를 제공하기 위한 형식에는 두 가지가 있으며 둘 중 하나만 사용해야 합니다. address
형식을 사용하거나 각 주소 필드를 개별적으로 제공할 수 있습니다. 두 가지 형식을 모두 사용하면 오류가 발생합니다.
이름 | 설명 | 크리에이티브에 사용 | 제품 세트 필터로 사용 |
---|---|---|---|
유형: 문자열 | 필수 항목. 대리점의 실제 전체 주소로, 형식은 다음과 같습니다.
우편번호는 선택 사항입니다. 예: | N | N |
유형: 문자열 | 필수 항목. 대리점이 있는 도시. 예: | Y | Y |
유형: 문자열 | 필수 항목. 대리점이 있는 주/도, 군, 지역 또는 지방. 예: | Y | Y |
유형: 문자열 | 필수 항목. 대리점이 있는 국가. 예: | N | Y |
유형: 부동 소수점 | 필수 항목. 대리점 위치의 위도. 예: | N | N |
유형: 부동 소수점 | 필수 항목. 대리점 위치의 경도. 예: | N | N |
유형: 문자열 | 선택 사항. 대리점의 우편번호(해외 또는 미국 국내). 예: | N | N |
유형: 문자열 | 선택 사항. 최대 문자 수: 100 대리점의 영숫자 ID. | Y | Y |
유형: 문자열 | 선택 사항. 최대 문자 수: 100 대리점 이름. | Y | Y |
유형: 문자열 | 선택 사항. 대리점 전화번호. 대리점 전화번호. 요구 사항:
예: | N | N |
유형: enum | 선택 사항. 사용자가 대리점에 연락할 방법. 사용 가능한 값: 참고: LEAD_FORM을 선택하는 경우 개인정보처리방침도 포함해야 합니다. 자세한 내용은 | N | N |
유형: url | 잠재 고객용 양식 연락 방법의 경우 필수 항목입니다. Messenger(채팅) 연락 방법의 경우 선택 사항입니다. 차량을 게재하는 대리점의 비공개 URL 링크. Facebook 페이지 ID( | N | N |
유형: 문자열 | 선택 사항. 대리점이 부지 내에서 지정한 차량 명칭. 재고 번호는 대리점이 특정 차량의 재고를 파악하는 방법입니다. 예: | Y | Y |
유형: 문자열 | 선택 사항. 최대 문자 수 한도: 100 포함하고자 하는 차량에 대한 추가 정보. | Y | Y |
유형: 문자열 | 선택 사항. 최대 문자 수 한도: 100 포함하고자 하는 차량에 대한 추가 정보. | Y | Y |
유형: 문자열 | 선택 사항. 최대 문자 수 한도: 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에서 액세스를 위한 허용 리스트에 추가해 드립니다.
이름 | 설명 | 제품 세트 필터 | 크리에이티브에서 사용 가능 여부 |
---|---|---|---|
유형: 문자열 | 필수 항목. 광고주가 쿠폰을 식별하는 데 사용하는 차량 고유 ID. 또한 픽셀의 예: | 예 | 예 |
유형: 문자열 | 필수 항목. 차량 제조사 또는 브랜드. 예: | 예 | 예 |
유형: 문자열 | 필수 항목. 차량 모델. 예: | 예 | 예 |
유형: 정수 | 필수 항목. 차량이 출시된 연도(yyyy 형식). 예: | 예 | 예 |
유형: enum | 필수 항목. 쿠폰 유형. 유효한 값: | 예 | 아니요 |
유형: 문자열 | 필수 항목. 광고/쿠폰 제목. 예: | 아니요 | 예 |
유형: 문자열 | 필수 항목. 쿠폰 설명. 예: | 아니요 | 예 |
유형: url | 필수 항목. 쿠폰을 볼 수 있는 외부 사이트 링크. | 아니요 | 예 |
유형: 문자열 | 필수 항목. 쿠폰과 관련된 고지 사항. | 아니요 | 아니요 |
유형: 문자열 | 필수 항목. 광고 크리에이티브에 사용된 차량 이미지의 URL. 참고: 슬라이드 광고를 사용하려면 가로세로비가 1:1인 정사각형 이미지(600x600픽셀)를 제공하세요. 단일 차량 광고를 게재하려면 가로세로비가 1.91:1인 이미지(1,200x630픽셀)를 제공하세요. 이미지 비율 정보에 대한 자세한 내용은 가로세로비 모범 사례를 참조하세요. | 아니요 | 아니요 |
유형: 문자열 | 선택 사항. 이미지의 내용을 나타내는 문자열. 이미지와 관련된 태그는 여러 개가 있을 수 있습니다(예: Lease Offer, Financing 등). | ||
유형: 문자열 | 선택 사항. 이미지의 내용을 나타내는 문자열. Facebook에서는 여러 태그를 지원합니다. 더 많은 태그를 추가하려면 | 아니요 | 아니요 |
유형: 문자열 | 선택 사항. 이미지의 내용을 나타내는 문자열. n 숫자를 1~20 범위 내에서 늘려 이미지를 2개 이상 업로드할 수 있습니다. | 아니요 | 아니요 |
유형: 문자열 | 선택 사항. 이미지의 내용을 나타내는 문자열. Facebook에서는 여러 태그를 지원합니다. 더 많은 태그를 추가하려면 | 아니요 | 아니요 |
유형: 문자열 | 선택 사항. 이미지의 내용을 나타내는 문자열. 이미지와 관련된 태그는 여러 개가 있을 수 있습니다(예: Lease Offer, Financing 등). | 아니요 | 아니요 |
유형: 문자열 | 권장 사항. 리스 또는 현금 쿠폰 금액. 가격 형식은 비용 뒤에 ISO 통화 코드를 붙이고 비용과 통화 사이에 공백이 있어야 합니다. 예: 월 $329 리스 또는 $2000 캐시백의 경우 값은 | 아니요 | 예 |
유형: 문자열 | 권장 사항. 비율 값(쿠폰에 있을 경우). 값이 금액이 아니라 비율(예: | 아니요 | 아니요 |
유형: 문자열 | 권장 사항. 달러 금액 값 또는 금액 비율에 대한 한정자. 유효한 값은 예: 리스 쿠폰에서 $100/mo의 | 아니요 | 예 |
유형: 정수 | 권장 사항. 쿠폰 적용 기간. 3년 동안 제공되는 월 $329 리스 쿠폰일 경우 값은 예: 리스 쿠폰에서 $100/mo의 | 아니요 | 예 |
유형: enum | 권장 사항. 쿠폰 기간 단위. 유효한 값은 'months' 또는 'years'입니다. 예: $329/month for 36 months 쿠폰에서 | 아니요 | 예 |
유형: 문자열 | 권장 사항. 구매 또는 리스 시점의 계약금 금액. 가격 형식은 비용 뒤에 ISO 통화 코드를 붙이고 비용과 통화 사이에 공백이 있어야 합니다. 예: 계약금 조건이 | 아니요 | 예 |
유형: 문자열 | 권장 사항.
| 예 | |
유형: 문자열 | 권장 사항. 차량 트림. 예: | 아니요 | 예 |
유형: 문자열 | 권장 사항 차량의 MSRP(통화 포함). 가격 형식은 비용 뒤에 ISO 통화 코드를 붙이고 비용과 통화 사이에 공백이 있어야 합니다. 예: | 아니요 | 아니요 |
유형: enum | 권장 사항. 차량의 차체 스타일. 유효한 값: | 아니요 | 아니요 |
유형: 문자열 | 선택 사항. 쿠폰 유효 기간 시작 날짜. yyyy-mm-dd 날짜 형식이어야 합니다. 예: | 아니요 | 아니요 |
유형: 문자열 | 선택 사항. 쿠폰 유효 기간 종료 날짜. yyyy-mm-dd 날짜 형식이어야 합니다. 예: | 아니요 | 아니요 |
유형: 문자열 | 선택 사항. 시장/DMA(Designated Market Area)의 이름. | 예 | 아니요 |
유형: 문자열 배열 | 지역 쿠폰에는 필수 항목입니다. 전국 쿠폰에는 선택 사항입니다. ['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