Esta guía es una referencia de los formatos de fuentes y campos admitidos para crear anuncios de automóviles.
Los campos de enumeración no distinguen entre mayúsculas y minúsculas.
Proporciona la lista con el formato correcto: CSV
, TSV
o XML
. Después de crear el archivo de lista, debes hospedarlo en una URL para poder aplicar las actualizaciones programadas regulares.
Formato de lista | Descripción y directrices | Lista de ejemplo |
---|---|---|
CSV | Valor separado por comas.
Consulta el ejemplo de archivo CSV/TSV de lista o el ejemplo de archivo CSV/TSV de direcciones. | Descargar > Hacer clic con el botón derecho > Guardar enlace como |
TSV | Valor separado por tabulaciones. Consulta las instrucciones para CSV. Consulta el ejemplo de archivo CSV/TSV de lista o el ejemplo de archivo CSV/TSV de direcciones. | Descargar > Hacer clic con el botón derecho > Guardar enlace como |
XML | Formato que, normalmente, se genera mediante servidores web o sistemas de proveedores de listas automatizados. Conjunto de nodos XML del elemento que representa una lista de productos y que debe comenzar con la etiqueta de declaración Consulta el ejemplo de archivo XML de lista. | Descargar > Hacer clic con el botón derecho > Guardar enlace como |
Ejemplo: archivo TSV
con tabuladores
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
Ejemplo: lista con imágenes como una matriz
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
El siguiente es un ejemplo de lista de formato 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>
Los siguientes campos admitidos se han diseñado para los elementos que añades al catálogo de productos.
En el caso de catálogos localizados, consulta los campos admitidos para anuncios de automóviles.
Nombre | Descripción | Uso en el contenido | Uso como un filtro de conjunto de productos |
---|---|---|---|
tipo: entero | Obligatorio para anuncios de inventario con destino en-Facebook. Identificador de la página de Facebook del socio o el concesionario. Tu catálogo debe añadirse a la lista de autorizados del representante de Facebook para que puedas enviar los identificadores de páginas. La página debe añadirse a la lista de autorizados mediante Business Manager antes de poder importarla. Consulta Administración de permisos. | No | No |
tipo: cadena | Obligatorio. Máx. de caracteres: 100 identificador único del elemento. Puede ser una variante de un vehículo. Si existen varias instancias del mismo identificador, se ignoran todas. También puedes utilizar el número de bastidor para ambos campos Ejemplo: | Sí | Sí |
tipo: cadena | Obligatorio. Máx. de caracteres: 500. Nombre completo del vehículo. El título es relevante y específico para cada vehículo, y debe contener los valores definidos en los campos Ejemplo: | Sí | Sí |
tipo: cadena | Obligatorio. Máx. de caracteres: 5000 Texto breve de descripción del vehículo. No incluyas texto promocional ni enlaces. No escribas texto en mayúsculas. Utiliza saltos de línea para dar formato a la descripción. Ejemplo: | Sí | No |
tipo: url | Obligatorio. Enlace al sitio web externo donde puedes ver los anuncios de vehículos. | Sí | No |
tipo: cadena | Obligatorio. Fabricante o marca del vehículo. Ejemplo: | Sí | Sí |
tipo: cadena | Obligatorio. Modelo del vehículo. Ejemplo: | Sí | Sí |
tipo: entero | Obligatorio. Año de lanzamiento del vehículo con el formato Ejemplo: | Sí | Sí |
tipo: entero | Obligatorio. Para los vehículos de segunda mano, kilometraje actual del vehículo expresado en kilómetros ( Ejemplo: '1500' | Sí | Sí |
tipo: cadena | Obligatorio. Unidades de kilometraje: | Sí | No |
tipo: cadena | Obligatorio. Máximo de elementos: 20 URL de la imagen del vehículo. Si tienes más de una imagen del vehículo, sigue esta convención de nomenclatura:
Obtén más información sobre las prácticas recomendadas de Marketplace para las imágenes. | No | No |
tipo: cadena | Opcional. Máximo de elementos: 20 Etiqueta anexada a la imagen que indica qué contiene la imagen. Puede haber varias etiquetas asociadas a una imagen. Sigue esta convención de nomenclatura: Ejemplo: | No | Sí |
Tipo: enumeración | Opcional. Tipo de transmisión del vehículo: | No | Sí |
Tipo: enumeración | Obligatorio. Tipo de carrocería del vehículo: | Sí | Sí |
Tipo: enumeración | Opcional. Sistema de transmisión del vehículo. Valores admitidos: | No | Sí |
| Obligatorio, algunos países. Máx. de caracteres: 17 Número de bastidor del vehículo (VIN). También puedes utilizar el número de bastidor para los campos Ejemplo: | Sí | Sí |
Tipo: cadena | Obligatorio. Coste y divisa del vehículo. Formatea el precio como el coste, seguido del código de divisa ISO, con un espacio entre ambos. Ejemplo: | Sí | Sí |
tipo: cadena | Obligatorio. Color del vehículo. Ejemplo: | Sí | Sí |
tipo: enumeración | Obligatorio. Estado actual del vehículo. Valores admitidos: | No | Sí |
tipo: enumeración | Opcional. Tipo de combustible del vehículo. Valores admitidos: | No | Sí |
tipo: cadena | Opcional. Cadena que describe la imagen. Puede haber varias etiquetas asociadas a una imagen. Ejemplo: | Sí | No |
tipo: entero | Opcional. Similar a | No | No |
tipo: enumeración | Opcional. Estado del vehículo. Valores admitidos: | No | Sí |
tipo: entero | Opcional. Precio de oferta o precio especial. Formatea el precio como el coste, seguido del código de divisa ISO, con un espacio entre ambos. Ejemplo: | Sí | Sí |
tipo: enumeración | Opcional. Disponibilidad del vehículo: | No | Sí |
tipo: cadena | Opcional. Tipo de vehículo. Valores esperados: | No | Sí |
tipo: cadena | Opcional. Máx. de caracteres: 50 Tapicería del vehículo. Ejemplo: | Sí | Sí |
tipo: cadena | Opcional. Máx. de caracteres: 50 Color interior del vehículo. | No | Sí |
tipo: cadena | Opcional. Fecha en que el vehículo llegó al concesionario. Se utiliza para indicar la antigüedad del inventario. Utiliza el formato Ejemplo: | No | Sí |
tipo: entero | Opcional. Número de días que el vehículo ha estado en el concesionario. Debe aumentar a diario. Ejemplo: | No | Sí |
Existen dos formas de proporcionar direcciones; deberás usar una de las dos, pero no ambas. Puedes utilizar el formato address
o bien proporcionar cada campo de dirección de manera individual. Si usas los dos formatos, se producirá un error.
Nombre | Descripción | Uso en el contenido | Uso como un filtro de conjunto de productos |
---|---|---|---|
tipo: cadena | Obligatorio. Dirección física completa del concesionario con el formato siguiente:
El código postal es opcional. Ejemplo: | No | No |
tipo: cadena | Obligatorio. Ciudad donde se encuentra el concesionario. Ejemplo: | Sí | Sí |
tipo: cadena | Obligatorio. Estado, condado, región o provincia donde se encuentra el concesionario. Ejemplo: | Sí | Sí |
tipo: cadena | Obligatorio. País donde se encuentra el concesionario. Ejemplo: | No | Sí |
tipo: flotante | Obligatorio. Latitud de la ubicación del concesionario. Ejemplo: | No | No |
tipo: flotante | Obligatorio. Longitud de la ubicación del concesionario. Ejemplo: | No | No |
tipo: cadena | Opcional. Código postal del concesionario (dentro o fuera de EE. UU.). Ejemplo: | No | No |
tipo: cadena | Opcional. Máx. de caracteres: 100 Identificador alfanumérico del concesionario. | Sí | Sí |
tipo: cadena | Opcional. Máx. de caracteres: 100 Nombre del concesionario. | Sí | Sí |
tipo: cadena | Opcional. Número de teléfono del concesionario. Número de teléfono del concesionario. Requisitos:
Ejemplo: | No | No |
tipo: enumeración | Opcional. Método que el usuario utilizará para ponerse en contacto con el concesionario. Valores disponibles: Nota: si has seleccionado LEAD_FORM, debes incluir también una política de privacidad. Consulta | No | No |
tipo: URL | Obligatorio para el método de contacto mediante formulario para clientes potenciales. Opcional para el método de contacto por Messenger (chat). Enlace a la URL de la política de privacidad del concesionario que anuncia el vehículo. Debe coincidir con el concesionario del identificador de la página de Facebook ( | No | No |
tipo: cadena | Opcional. Designación propia del concesionario para el automóvil en su estacionamiento. El número de inventario es un método para que el concesionario pueda realizar un inventario de vehículos específicos. Ejemplo: | Sí | Sí |
tipo: cadena | Opcional. Límite máx. de caracteres: 100 Información adicional sobre el vehículo que quieres incluir. | Sí | Sí |
tipo: cadena | Opcional. Límite máx. de caracteres: 100 Información adicional sobre el vehículo que quieres incluir. | Sí | Sí |
tipo: cadena | Opcional. Límite máx. de caracteres: 100 Información adicional sobre el vehículo que quieres incluir. | Sí | Sí |
Las listas pueden estar en formato CSV, TSV o XML.
Ejemplo: archivo TSV que utiliza tabuladores para delimitar los valores.
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
Estas listas se pueden subir desde la interfaz de usuario o la API. Si prefieres usar la interfaz de usuario, proporciona tu identificador de usuario y el identificador de la cuenta para que podamos añadirte a la lista de autorizados y concederte acceso.
Nombre | Descripción | Filtro de conjunto de productos | ¿Se puede usar en el contenido? |
---|---|---|---|
Tipo: cadena | Obligatorio. Identificador único del vehículo que los anunciantes usarán para identificar una oferta. También es el mismo valor transferido con el parámetro Ejemplo: | Sí | Sí |
Tipo: cadena | Obligatorio. Marca del vehículo. Ejemplo: | Sí | Sí |
Tipo: cadena | Obligatorio. Modelo del vehículo. Ejemplo: | Sí | Sí |
Tipo: número entero | Obligatorio. Año en el que el vehículo salió a la venta en formato aaaa. Ejemplo: | Sí | Sí |
Tipo: enumeración | Obligatorio. Tipo de oferta. Valores válidos: | Sí | No |
Tipo: cadena | Obligatorio. Título del anuncio o la oferta. Ejemplo: | No | Sí |
Tipo: cadena | Obligatorio. Descripción de la oferta. Ejemplo: | No | Sí |
Tipo: URL | Obligatorio. Enlace al sitio externo donde puedes ver la oferta. | No | Sí |
Tipo: cadena | Obligatorio. Descargo de responsabilidad asociado a la oferta. | No | No |
Tipo: cadena | Obligatorio. URL de la imagen del vehículo usada en el contenido del anuncio. Nota: Para usar anuncios por secuencia, proporciona imágenes cuadradas con una relación de aspecto de 1:1 y una resolución de 600 × 600 píxeles. Para mostrar anuncios de vehículos individuales, proporciona imágenes con una relación de aspecto de 1,91:1 y una resolución de 1200 x 630 píxeles. Para obtener más información sobre la relación de aspecto de las imágenes, consulta Prácticas recomendadas para las relaciones de aspecto. | No | No |
Tipo: cadena | Opcional. Cadena que representa el contenido de la imagen. Puede haber varias etiquetas asociadas a una imagen, como “Oferta de leasing”, “Financiación”, etc. | ||
Tipo: cadena | Opcional. Cadena que representa el contenido de la imagen. Puedes incluir varias etiquetas. Aumenta el valor de | No | No |
Tipo: cadena | Opcional. Cadena que representa el contenido de la imagen. Si quieres subir más de una imagen, aumenta el dígito n entre 1 y 20. El valor de | No | No |
Tipo: cadena | Opcional. Cadena que representa el contenido de la imagen. Puedes incluir varias etiquetas. Aumenta el valor de | No | No |
Tipo: cadena | Opcional. Cadena que representa el contenido de la imagen. Puede haber varias etiquetas asociadas a una imagen, como “Oferta de leasing”, “Financiación”, etc. | No | No |
Tipo: cadena | Recomendado. Importe de la oferta de efectivo o leasing. Asigna al precio el mismo formato que al coste, seguido del código de divisa ISO, con un espacio entre el coste y la divisa. Ejemplo: En el caso de un leasing de 329 USD/mes o un reembolso de 2000 USD, los valores son | No | Sí |
Tipo: cadena | Recomendado. Valor porcentual, si está presente en la oferta. En algunas ocasiones, el valor es un porcentaje (por ejemplo: | No | No |
Tipo: cadena | Recomendado. Calificador del porcentaje o valor en dólares del importe. Los valores válidos pueden ser Ejemplo: | No | Sí |
Tipo: número entero | Recomendado. Duración de la aplicación de la oferta. Si la oferta es un leasing de 329 USD/mes durante tres años, el valor es Ejemplo: | No | Sí |
Tipo: enumeración | Recomendado. Unidades para la duración de la oferta. Los valores válidos son “months” o “years”. Ejemplo: | No | Sí |
Tipo: cadena | Recomendado. Valor del pago inicial en el momento de la compra o el alquiler. Asigna al precio el mismo formato que al coste, seguido del código de divisa ISO, con un espacio entre el coste y la divisa. Ejemplo: Usa | No | Sí |
Tipo: cadena | Recomendado. Calificador del valor de | Sí | |
Tipo: cadena | Recomendado. Tapicería del vehículo. Ejemplo: | No | Sí |
Tipo: cadena | Recomendado. Precio de venta recomendado por el fabricante del vehículo con la divisa. Asigna al precio el mismo formato que al coste, seguido del código de divisa ISO, con un espacio entre el coste y la divisa. Ejemplo: | No | No |
Tipo: enumeración | Recomendado. Estilo de la carrocería de los vehículos. Valores válidos: | No | No |
Tipo: cadena | Opcional. Fecha de inicio de la validez de una oferta. Debe tener el formato de fecha aaaa-mm-dd. Ejemplo: | No | No |
Tipo: cadena | Opcional. Fecha de finalización de la validez de una oferta. Debe tener el formato de fecha aaaa-mm-dd. Ejemplo: | No | No |
Tipo: cadena | Opcional. Nombre del mercado o Designated Marketing Area (DMA). | Sí | No |
Tipo: matriz de cadenas | Obligatorio para las ofertas regionales. Opcional para las ofertas nacionales. Lista de códigos de Designated Marketing Area (DMA) del mercado específico indicados en el siguiente formato: ['502', '201'] ['516'...]. Nota: Este ejemplo es para el formato CSV; consulta las listas de ejemplo incluidas a continuación para el formato XML. Consulta esta información sobre el estándar de los códigos de DMA. En el caso de las ofertas nacionales, debe quedar en blanco. | Sí | No |
curl \ -F 'name=catalog name' \ -F 'access_token=<ACCESS TOKEN>' \ -F 'vertical=vehicle_offers' \ https://graph.facebook.com/<API_VERSION>/<BUSINESS ID>/product_catalogs