Referencia

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.

Anuncios de inventario de automóviles - Formatos de lista admitidos

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.

  • La primera fila especifica el encabezado de columna. En las filas siguientes se proporcionan los valores correspondientes de cada ruta.

  • Los campos que contienen espacios en blanco o comas deben ir entre comillas dobles (" "). Una comilla doble dentro de un campo entre comillas dobles debe convertirse a la secuencia de escape de dos comillas dobles consecutivas.

  • Los campos anidados o con varios valores, como los de imagen, se pueden representar con valores cifrados mediante JSON o con un conjunto de columnas “aplanadas” de texto sin formato, etiquetadas con sintaxis de ruta JSON. Ejemplo: (image[0].url, image[0].tag[0], image[0].tag[1])

  • Se pueden utilizar ambas convenciones indistintamente en el mismo archivo.

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 <?xml.

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>

Ejemplo: CSV/TSV de lista

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

Ejemplo: CSV/TSV de direcciones

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

Ejemplo: XML de lista

<?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>

Anuncios de inventario de automóviles - Campos admitidos - Vehículo

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.

NombreDescripciónUso en el contenidoUso como un filtro de conjunto de productos

fb_page_id

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

vehicle_id

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 vehicle_id y vin.

Ejemplo: 1FADP5AU6DL536022

title

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 year, make, model y trim.

Ejemplo: $299 per month for the EndoHatch GE

description

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: Used 2017 Volvo XC90 in great condition, available now.

No

url

tipo: url

Obligatorio.

Enlace al sitio web externo donde puedes ver los anuncios de vehículos.

No

make

tipo: cadena

Obligatorio.

Fabricante o marca del vehículo.

Ejemplo: Endomoto

model

tipo: cadena

Obligatorio.

Modelo del vehículo.

Ejemplo: EndoHatch

year

tipo: entero

Obligatorio.

Año de lanzamiento del vehículo con el formato yyyy.

Ejemplo: 2015

mileage.value

tipo: entero

Obligatorio.

Para los vehículos de segunda mano, kilometraje actual del vehículo expresado en kilómetros (kms) o millas (MI). Para los vehículos nuevos, utiliza cero 0. Para Marketplace, los vehículos deben tener más de 500 millas o kilómetros.

Ejemplo: '1500'

mileage.unit

tipo: cadena

Obligatorio.

Unidades de kilometraje: MI (millas) o KM (kilómetros).

No

image[0].url

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: image[1].url, image[2].url, etc. Debes proporcionar al menos una imagen. Tamaño máximo de cada imagen: 4 MB. En el caso de Marketplace, se requiere un mínimo de dos imágenes.

  • Para usar anuncios por secuencia: proporciona imágenes cuadradas con una relación de aspecto de 1:1 (600 x 600 píxeles).

  • Si utilizas anuncios individuales de vehículos: proporciona imágenes con una relación de aspecto de 1,91:1 (1200 x 630 píxeles).

Obtén más información sobre las prácticas recomendadas de Marketplace para las imágenes.

No

No

image[0].tag[0]

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: image[0].tag[0], image[0].tag[1] .... image[1].tag[0], image[1].tag[1] ....

Ejemplo: Exterior, Interior, StockImage

No

transmission

Tipo: enumeración

Opcional.

Tipo de transmisión del vehículo: Automatic o Manual.

No

body_style

Tipo: enumeración

Obligatorio.

Tipo de carrocería del vehículo: CONVERTIBLE, COUPE, HATCHBACK, MINIVAN, TRUCK, SUV, SEDAN, VAN, WAGON, CROSSOVER, SMALL_CAR o OTHER.

drivetrain

Tipo: enumeración

Opcional.

Sistema de transmisión del vehículo. Valores admitidos: 4X2, 4X4, AWD, FWD, RWD, Other.

No

vin

Tipo: cadena

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 vehicle_id y vin. Nota: El número de bastidor debe tener exactamente 17 caracteres y no es necesario para vehículos de antes de 1983. Los barcos tienen menos dígitos y algunos vehículos (como los tráileres) no tienen números de bastidor.

Ejemplo: 1FADP5AU6DL536022

price

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: 18000 USD, 32000 USD

exterior_color

tipo: cadena

Obligatorio.

Color del vehículo.

Ejemplo: Black, White, Blue, Red

state_of_vehicle

tipo: enumeración

Obligatorio.

Estado actual del vehículo. Valores admitidos: New, Used o CPO (vehículo de ocasión certificado).

No

fuel_type

tipo: enumeración

Opcional.

Tipo de combustible del vehículo. Valores admitidos: DIESEL, ELECTRIC, FLEX, GASOLINE, HYBRID, OTHER.

No

tag (etiqueta de imagen)

tipo: cadena

Opcional.

Cadena que describe la imagen. Puede haber varias etiquetas asociadas a una imagen.

Ejemplo: Exterior, Interior, StockImage

No

chrome_id

tipo: entero

Opcional.

Similar a autodata_id.

No

No

condition

tipo: enumeración

Opcional.

Estado del vehículo. Valores admitidos: EXCELLENT, GOOD, FAIR, POOR, OTHER.

No

sale_price

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: 16000 USD

availability

tipo: enumeración

Opcional.

Disponibilidad del vehículo: available o not available. No se muestran vehículos que no están disponibles en el anuncio.

No

vehicle_type

tipo: cadena

Opcional.

Tipo de vehículo. Valores esperados: car_truck (predeterminado si no se indica), boat, commercial, motorcycle, powersport, rv_camper, trailer o other.

No

trim

tipo: cadena

Opcional.

Máx. de caracteres: 50

Tapicería del vehículo.

Ejemplo: 5DR HB SE

interior_color

tipo: cadena

Opcional.

Máx. de caracteres: 50

Color interior del vehículo.

No

date_first_on_lot

tipo: cadena

Opcional.

Fecha en que el vehículo llegó al concesionario. Se utiliza para indicar la antigüedad del inventario. Utiliza el formato yyyy-mm-dd.

Ejemplo: 2018-09-05

No

days_on_lot

tipo: entero

Opcional.

Número de días que el vehículo ha estado en el concesionario. Debe aumentar a diario.

Ejemplo: 62

No

Anuncios de inventario de automóviles - Campos admitidos - Concesionario

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.

NombreDescripciónUso en el contenidoUso como un filtro de conjunto de productos

address

tipo: cadena

Obligatorio.

Dirección física completa del concesionario con el formato siguiente:

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

El código postal es opcional.

Ejemplo: {addr1: '550 Auto Center Dr', city: 'Watsonville', region: 'CA', postal_code: '96075', country: 'US'}

No

No

address.city

tipo: cadena

Obligatorio.

Ciudad donde se encuentra el concesionario.

Ejemplo: Palo Alto

address.region

tipo: cadena

Obligatorio.

Estado, condado, región o provincia donde se encuentra el concesionario.

Ejemplo: California

address.country

tipo: cadena

Obligatorio.

País donde se encuentra el concesionario.

Ejemplo: United States

No

latitude

tipo: flotante

Obligatorio.

Latitud de la ubicación del concesionario.

Ejemplo: 37.484100

No

No

longitude

tipo: flotante

Obligatorio.

Longitud de la ubicación del concesionario.

Ejemplo: -122.148252

No

No

address.postal_code

tipo: cadena

Opcional.

Código postal del concesionario (dentro o fuera de EE. UU.).

Ejemplo: 75008 (París, Francia) o 94025 (Menlo Park)

No

No

dealer_id

tipo: cadena

Opcional.

Máx. de caracteres: 100

Identificador alfanumérico del concesionario.

dealer_name

tipo: cadena

Opcional.

Máx. de caracteres: 100

Nombre del concesionario.

dealer_phone

tipo: cadena

Opcional.

Número de teléfono del concesionario. Número de teléfono del concesionario. Requisitos:

  • Debe mostrarse el botón Llamar en un anuncio de Marketplace.
  • El formato del número de teléfono debe ser válido.
  • Debe incluir el código de país.

Ejemplo: +1 3603453333 o 001 (360)345-3333

No

No

dealer_communication_channel

tipo: enumeración

Opcional.

Método que el usuario utilizará para ponerse en contacto con el concesionario. Valores disponibles: CHAT o LEAD_FORM.


Nota: si has seleccionado LEAD_FORM, debes incluir también una política de privacidad. Consulta dealer_privacy_policy_url para obtener más información.

No

No

dealer_privacy_policy_url

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 (fb_page_id).

No

No

stock_number

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: N8990

custom_label_0

tipo: cadena

Opcional.

Límite máx. de caracteres: 100

Información adicional sobre el vehículo que quieres incluir.

custom_label_1

tipo: cadena

Opcional.

Límite máx. de caracteres: 100

Información adicional sobre el vehículo que quieres incluir.

custom_label_2

tipo: cadena

Opcional.

Límite máx. de caracteres: 100

Información adicional sobre el vehículo que quieres incluir.

Anuncios sobre ofertas de vehículos: formatos admitidos

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

Anuncio sobre ofertas de vehículos: campos admitidos

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.

NombreDescripciónFiltro de conjunto de productos¿Se puede usar en el contenido?

vehicle_offer_id

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 content_id en el píxel.

Ejemplo: offer1.

make

Tipo: cadena

Obligatorio.

Marca del vehículo. Ejemplo: Endomoto.

model

Tipo: cadena

Obligatorio.

Modelo del vehículo.

Ejemplo: EndoHatch.

year

Tipo: número entero

Obligatorio.

Año en el que el vehículo salió a la venta en formato aaaa. Ejemplo: 2015.

offer_type

Tipo: enumeración

Obligatorio.

Tipo de oferta. Valores válidos: lease, finance y cash.

No

title

Tipo: cadena

Obligatorio.

Título del anuncio o la oferta.

Ejemplo: "$299 per month for the EndoHatch GE!".

No

offer_description

Tipo: cadena

Obligatorio.

Descripción de la oferta.

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

No

url

Tipo: URL

Obligatorio.

Enlace al sitio externo donde puedes ver la oferta.

No

offer_disclaimer

Tipo: cadena

Obligatorio.

Descargo de responsabilidad asociado a la oferta.

No

No

image[0].url

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

image[0].tag[0]

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.

image[0].tag[m]

Tipo: cadena

Opcional.

Cadena que representa el contenido de la imagen. Puedes incluir varias etiquetas. Aumenta el valor de m para añadir más etiquetas.

No

No

image[n].url

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 n debe seguir un orden correlativo. Por ejemplo, si tienes 0, 1 y 2, debes tener 3 y no puedes tener directamente 4.

No

No

image[n].tag[0]

Tipo: cadena

Opcional.

Cadena que representa el contenido de la imagen. Puedes incluir varias etiquetas. Aumenta el valor de m para añadir más etiquetas.

No

No

image[n].tag[m]

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

amount_price

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 329 USD o 2000 USD.

No

amount_percentage

Tipo: cadena

Recomendado.

Valor porcentual, si está presente en la oferta. En algunas ocasiones, el valor es un porcentaje (por ejemplo: 3.9% APR) en lugar de una cantidad.

No

No

amount_qualifier

Tipo: cadena

Recomendado.

Calificador del porcentaje o valor en dólares del importe. Los valores válidos pueden ser per month o APR.

Ejemplo: /mo en el caso de ofertas de leasing de 100 USD/mes y APR en el caso de una tasa porcentual anual de 1,1 % para ofertas financieras.

No

term_length

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 3 y el valor correspondiente de term_qualifier es years.

Ejemplo: /mo en el caso de ofertas de leasing de 100 USD/mes y APR en el caso de una tasa porcentual anual de 1,1 % para ofertas financieras.

No

term_qualifier

Tipo: enumeración

Recomendado.

Unidades para la duración de la oferta. Los valores válidos son “months” o “years”.

Ejemplo: months en el caso de una oferta de 329 USD/mes durante 36 meses y year en el caso de una oferta de 329 USD/mes durante tres años.

No

downpayment

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 1500 USD como valor si las condiciones del pago inicial son $1500 due at signing + 1 month payment.

No

downpayment_qualifier

Tipo: cadena

Recomendado.

Calificador del valor de downpayment. Ejemplo: Usa el valor due at signing + 1 month payment si las condiciones del pago inicial son $1500 due at signing + 1 month payment.

trim

Tipo: cadena

Recomendado.

Tapicería del vehículo. Ejemplo: GE.

No

price

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: 13,999 USD.

No

No

body_style

Tipo: enumeración

Recomendado.

Estilo de la carrocería de los vehículos. Valores válidos: CONVERTIBLE, COUPE, HATCHBACK, MINIVAN, TRUCK, SUV, SEDAN, VAN, WAGON, CROSSOVER u OTHER.

No

No

start_date

Tipo: cadena

Opcional.

Fecha de inicio de la validez de una oferta. Debe tener el formato de fecha aaaa-mm-dd.

Ejemplo: 2018-09-05.

No

No

end_date

Tipo: cadena

Opcional.

Fecha de finalización de la validez de una oferta. Debe tener el formato de fecha aaaa-mm-dd.

Ejemplo: 2018-09-05.

No

No

market_name

Tipo: cadena

Opcional.

Nombre del mercado o Designated Marketing Area (DMA).

No

dma_codes

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.

No

Ejemplo: A fin de crear un catálogo para anuncios de catálogo de Advantage+, consulta Catálogo, Referencia.

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