Iniciar sesión

Bienvenido al Centro de soporte técnico

Obtenga ayuda con la integración y las campañas en vivo.

Bienvenido al Centro de soporte técnico. Obtenga ayuda con la integración y las campañas en vivo.

Especificaciones del feed de Criteo

1 - Visión general

Un feed es un archivo que contiene información sobre todos los productos en su sitio web. Utilizaremos esta información para construir los banners de los productos dinámicos.

En este artículo encontrará detalles acerca de qué puede incluir en su feed y cómo dar formato a cada campo.

2 - Formatos de feed compatibles con Criteo

Para asegurarse de que Criteo pueda recuperar su feed, use uno de estos formatos:

Formato de feed

Detalles

Descargar

TSV

Este formato se basa en el valor separado por tabulación. El encabezado se debe declarar en la primera fila del archivo. Los nombres de campo pueden contener espacios o guion bajo (p. ej. image_link o image link).

Ejemplo de feed

CSV

Este formato se basa en el valor separado por coma. El encabezado se debe declarar en la primera fila del archivo. Los nombres de campo pueden contener espacios o guion bajo (p. ej. image_link o image link).

Ejemplo de feed

XML

Este formato debe respetar los aspectos básicos de la estructura XML. Los productos están representados por un conjunto de nodos XML. La lista de productos debe comenzar por la etiqueta de declaración <?xml. 

Ejemplo de feed

 

 

3 - Información del producto para proporcionar

Todos los nombres de los campos deben estar en inglés. La información del producto no debe contener etiquetas HTML o etiquetas de estilo.

3.1 - Campos requeridos para publicitar sus productos

3.1.1 Id.

Se requiere este campo para todos los productos del feed y no puede dejarse vacío o en blanco.

El ID es un identificador de producto único que representa solo un producto. Una vez que se ha asignado un ID a un producto y se ha importado, no se puede usar el ID para un producto diferente, ni se puede cambiar el ID de un producto en particular. Si item_group_id también se ha rellenado, rellene el ID con el ID/SKU secundario.

Requerimientos de caracteres:  el id solo debe contener caracteres ASCII y no debe contener comillas.

Límite: 240

Tipo: string

Ejemplo: abc123-black-7.5

3.1.2 title

Se requiere este campo para todos los productos del feed y no puede dejarse vacío o en blanco

El title es el nombre del producto, generalmente como se muestra en la página de detalles del producto. Se utilizará como el descriptor del texto principal en los banners de un producto determinado. 

 

Requerimientos de caracteres: el nombre debe empezar con una letra o un número.

Límite: 150

Tipo: string

Ejemplo: Botas de trabajo – Tamaño 7.5

3.1.3 description

La descripción es un texto pequeño que brinda más información del producto además del nombre. Debido al diseño de los banners, las descripciones más cortas (inferiores a 50 caracteres) tienen más probabilidades de adaptarse a los formatos y diseños de Criteo. No obstante, no todos los formatos ni diseños tendrán una descripción.

Requerimientos de caracteres: la descripción debe empezar con una letra o un número. Elimine todos las etiquetas de este campo, incluidas las etiquetas de style, embed, object y anchor.

Límite: 5000 

Tipo: string

Ejemplo: Ideal para el uso diario

3.1.4 google_product_category

Los atributos de los niveles de categoría indican la categoría del producto enviado, de acuerdo con la taxonomía de productos de Google.

Si su producto puede vincularse a múltiples categorías, necesitaremos solo aquella que sea la más relevante.

Requerimientos de caracteres: aceptamos ambos id. y la ruta de categoría completa.

Tipo: string

Ejemplo:  Mujer > Zapatos > Botas de trabajo O 2271

3.1.5 link

Se requiere este campo para todos los productos del feed y no puede dejarse vacío o en blanco

El link es la página de detalles dedicada del producto. El link generalmente es, aunque no necesariamente, único para un determinado producto. La información del producto que se incluye en esta URL debe coincidir con la información que se provee en el feed. Especifica el protocolo (http:// o https://) para todas las URL.

Requerimientos de caracteres: el link debe comenzar con el protocolo (http:// o https://) seguido por el URL de la página de detalles del producto. Todos los símbolos deben estar codificados. P. ej., $ debe reemplazarse por %24.

Límite de caracteres: 1024

Tipo: string

Ejemplo: http://www.example.com/product/working-boots

3.1.6 image_link

Se requiere este campo para todos los productos del feed y no puede dejarse vacío o en blanco

El image_link es un URL que especifica una ruta de archivo a la imagen de un producto determinado. El image_link se usará para mostrar la imagen del producto en los banners. Idealmente, las imágenes deberían tener entre 800 y 800 píxeles y pesar menos de 16 MB. La imagen debe tener un encabezado de tipo de contenido específico, ya sea image/png, image/gif o image/jpeg. Si impides el acceso a tus imágenes de vía cURL, introdúcelas en la lista blanca de nuestro agente de usuarios para que podamos mostrar tus imágenes en los banners de Criteo: curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn.

Requerimientos de caracteres:  el image_link debe empezar con http:// o https:// seguido del URL completo de la imagen del producto. Todos los símbolos deben estar codificados. Por ejemplo, $ debe ser reemplazado por %24. 

Límite de caracteres: 2000

Tipo: string

Ejemplo: http://www.example.com/product/image/working-boots.png

3.1.7 additional_image_link

El additional_image_link es una URL que especifica una ruta de archivo a la imagen de un producto determinado. El additional_image_link se usará para mostrar la imagen del producto en los banners. Idealmente, las imágenes deberían tener entre 800 y 800 píxeles y pesar menos de 16 MB. La imagen debe tener un encabezado de tipo de contenido específico, ya sea image/png, image/gif o image/jpeg. Si impides el acceso a tus imágenes de vía cURL, introdúcelas en la lista blanca de nuestro agente de usuarios para que podamos mostrar tus imágenes en los banners de Criteo: curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn.

Requerimientos de caracteres: el additional_image_link debe comenzar con http:// (no con https://) seguido por el URL completo de la imagen del producto. Todos los símbolos deben estar codificados. Por ejemplo, $ debe reemplazarse por %24. Sin embargo, additional_image_link no puede contener ningún símbolo en el URL (ningún carácter después del ?).

Límite de caracteres: 2000

Tipo: string

Ejemplo: http://www.example.com/product/image/working-boots-side.png

3.1.10 sale_price

El sale_price es el precio con el que el producto está disponible para su compra en el sitio web, si un producto determinado está "on sale", el sale_price será rellenado con el precio más bajo. El sale_price debe estar en la misma moneda que el sitio web. Solo rellene el sale_price con un valor numérico utilizando un punto (.) como separador decimal y sin separador de miles.

Requerimientos de caracteres: el separador decimal debe ser un punto (.) sin separador de millares.

 

Tipo: string

Límite de caracteres: 50

Ejemplo: 99,99

 

3.1.12  mpn 

MPN es el número que identifica de manera única el producto a su fabricante.

Límite de caracteres: 70

Tipo: string

Ejemplo: 4060882

 

3.1.13 brand

 Este campo es requerido para los productos auspiciados por Criteo

La marca indica el nombre de la marca del producto. Algunos productos no tienen una marca clara asociada. En este caso, esta información no tiene que ser proporcionada.

Requerimientos de caracteres: el nombre debe comenzar con una letra o un número, y puede contener solo caracteres ASCII. Elimine todas las etiquetas HTML de este campo, incluidas las etiquetas de estilo.

Límite de caracteres: 70

Tipo: string

Ejemplo: Criteo

 

3.1.15 product_type

Este campo es requerido para los productos auspiciados por Criteo

El product_type es una categoría (o lista de categorías) a la que pertenece el producto. El product_type registra la categoría de tu merchandising o el conjunto de categorías de merchandising de este producto. Debe coincidir con las categorías de tu sitio web. Cada nivel en la jerarquía debe estar delimitado por " > ". Si un producto está disponible en múltiples categorías, envía las diferentes categorías como coma (,) delimitadas con la categoría primaria al inicio. Product_type identifica mayúsculas y minúsculas, por lo que si usas «mujeres» para un producto y «Mujeres» para otro, Criteo los interpretará como dos categorías diferentes.

Requerimientos de caracteres: el product_type debe comenzar con una letra o un número y solo puede contener caracteres ASCII. El delimitador entre categorías debe ser > (&gt; para feeds con formato XML). Solo somos compatibles con la ruta de categoría completa. Si un producto está disponible en múltiples categorías, envíe las diferentes categorías como coma (,) delimitadas con la categoría primaria al inicio. No aceptamos los id. de categorías de la ruta. Los id. deben llenarse en el campo product_type_key. 

Límite de caracteres: 500

Tipo: string

Ejemplo:

  • Individual: Computación<Teclados y mouse<Mouse<Mouse inalámbrico
  • Múltiple: Computación<Teclados y mouse<Mouse<Mouse inalámbrico &gt; Regalos<Para papá<Mouse

3.1.16 product_type_key

Este campo es requerido para los productos auspiciados por Criteo

Este campo registra el id. exclusivo y la jerarquía para el product_type o el conjunto de product_type(s). Cada key en la jerarquía debe estar delimitada por " > ". Si un producto está disponible en múltiples categorías, envíelas como coma (,) delimitadas con la categoría primaria al inicio del despliegue.

Requerimientos de caracteres: el product_type_key solo puede contener caracteres ASCII. El delimitador entre categorías debe ser > (&gt; para feeds con formato XML). Si un producto está disponible en múltiples categorías, envíe las diferentes categorías como coma (,) delimitadas con la categoría primaria al inicio.

Límite de caracteres: 500

Tipo: string

Ejemplo:

  • Individual: XY1 &gt; YZ1 &gt; Z1
  • Múltiple: XY1 &gt; YZ1 &gt; Z1, AB1 &gt; BC2 &gt; A

3.1.17 number_of_reviews

Este campo es recomendado para los productos auspiciados por Criteo

Este campo contiene el número de reseñas para este producto. Se requiere el number_of_reviews si deseas que esta información se muestre en el anuncio.

Límite de caracteres: 8

Tipo: entero

Ejemplo: 2456

3.1.18 product_rating

Este campo es recomendado para los productos auspiciados por Criteo

Este campo representa la clasificación de este producto. Se requiere el product_rating si deseas que esta información se muestre en el anuncio.

Requirimientos de caracteres: el separador decimal debe ser un punto (.) sin separador de millares.

Límite de caracteres: 8

Tipo: string

Ejemplo: 4.5

3.1.19 filters

Este campo es requerido para los productos auspiciados por Criteo

Los filtros son atributos que designan las diferencias entre productos de la misma categoría. Los filtros se deben proporcionar como una lista de pares de valores de nombres de atributos separada por comas. Deben coincidir con la lista de filtros disponible en su sitio web y con este producto. Esto es fundamental para los productos auspiciados por Criteo.

Requerimientos de caracteres: los pares Key=Value se deben separar por una coma (,) y los valores múltiples se deben separar por una barra vertical (|).

Límite de caracteres: 2000

Tipo: string

Ejemplo: Color = Rojo|Negro, Talla = XL, Tamaño de pantalla = 15 in

3.1.20 adult

El atributo adult indica si el producto es seguro para mostrarse a todos los usuarios y a todas las audiencias. Los productos para adultos no pueden mostrarse en los banners de Criteo y podrían ser motivo para que tu campaña entrara en una blacklist en las redes de publishers. También puedes utilizar este campo con el valor «sí» si deseas que este producto sea no recomendable y no se muestre en los banners.

 

Requerimientos de caracteres: el valor debe ser "sí" o "no".

Tipo: booleano

Ejemplo: no

3.2 - Campos opcionales

3.2.1 mobile_link

El mobile_link es el link a tu versión optimizada para móviles de tu página de destino del producto. Esta URL debe ser distinta a la que proporciona en el campo "link". Al proporcionar un link de móvil mejorará la experiencia de usuario de tus clientes y reducirá las latencias de carga de la página de destino.

Requerimientos de caracteres: el link debe comenzar con el protocolo (http:// o https://) seguido por el URL de la página de detalles del producto. Todos los símbolos deben estar codificados. P. ej., $ debe reemplazarse por %24.

Límite de caracteres: 2000

Tipo: string

Ejemplo: http://m.example.com/product/working-boots

3.2.2 condition

La condición se utiliza para calificar el producto con tres diferentes valores aceptados: "new", "refurbished" y "used".

Requerimientos de caracteres: solo se aceptan 3 valores:

  • "new" [nuevo]
  • "refurbished" [reformado]
  • "used" [usado]

Tipo: string

Ejemplo: nuevo

---

Variantes del producto

3.2.3 item_group_id

El item_group_id es un identificador de producto primario único. Puede contener caracteres alfanuméricos que representan un solo producto que puede ser expresado como una colección de productos secundarios. Una vez que se ha asignado un item_group_id a un producto y se ha importado, el item_group_id no puede ser utilizado para un producto diferente ni puede cambiarse el item_group_id de un producto en particular. Debido a que el item_group_id puede representar una colección de productos, es posible que varios productos tengan el mismo valor de item_group_id.

Requerimientos de caracteres: el item_group_id solo puede contener caracteres ASCII y no debe contener comillas.

Límite: 240

Tipo: string

Ejemplo: abc123

 

3.2.4 color

Detalles: este atributo indicará los colores predominantes del producto.

Límite de caracteres: 100

Tipo: string

Ejemplo: negro

3.2.5 gender

Requerido para todos los productos de un grupo de artículos que varían según el género.

Requerimientos de caracteres: solo se aceptan 3 valores:

  • "male" [masculino]
  • "female" [femenino]
  • "unisex" [unisex]

Tipo: string

Ejemplo: masculino

3.2.6 age_group

Este atributo se utilizará para indicar el grupo de edades al que se dirige su producto.

Requerimientos de caracteres: solo se aceptan 5 valores:

  • "newborn" [recién nacido]
  • "infant" [infante]
  • "toddler" [niños]
  • "kids" [juvenil]
  • "adult" [adulto]

Tipo: string

Ejemplo: adulto

3.2.7 material

Este atributo indicará el material o tela del que está hecho el producto. Requerido para todos los productos en un grupo de artículos que varían según el material.

Límite de caracteres: 200

Tipo: string

Ejemplo: cuero

3.2.8 pattern

Este atributo indica el estampado o la impresión gráfica para el producto. Requerido para todos los productos en un grupo de artículos que varían según el estampado.

Límite de caracteres: 100

Tipo: string

Ejemplo: de rayas

3.2.9 pattern

Este atributo indicará el tamaño del producto. Requerido para todos los productos de un grupo de artículos que varían según el tamaño.

Límite de caracteres: 100

Tipo: string

Ejemplo: L

3.2.10 size_type

Puede especificar el corte del producto al agregar el tipo de tamaño.

Requerimientos de caracteres: solo se aceptan 5 valores:

  • "regular" [regular]
  • "petite" [pequeño]
  • "plus" [grande]
  • "big and tall" [grande y alto]
  • "maternity" [maternidad]

Límite: N/C

Tipo: string

Ejemplo: regular

3.2.11 size_system

Detalles: puede especificar el sistema de tamaños de productos del país al agregar el sistema de tamaño.

Requerimientos de caracteres: se aceptan 11 valores: US, UK, EU, DE, FR, JP, CN (China), IT, BR, MEX, AU

Límite: N/C

Tipo: string

Ejemplo: US

---

Para los vendedores del mercado

 

3.2.12 cross_sellers_product_id

Este campo solo es necesario si es un mercado y revende un producto a varios vendedores.

El cross_sellers_product_id es un identificador de producto exclusivo que agrupa varios id que se refieren al mismo producto vendido por diferentes vendedores. Una vez que se ha asignado un cross_sellers_product_id a un producto y se ha importado, el cross_sellers_product_id no puede ser utilizado para un producto diferente, ni se puede cambiar el cross_sellers_product_id de un producto en particular. Debido a que el cross_sellers_product_id representa una colección de productos, varios productos pueden tener el mismo valor de cross_sellers_product_id.

Requerimientos de caracteres: el cross_sellers_id debe comenzar con una letra o un número y solo puede contener caracteres ASCII.

Límite de caracteres: 250

Tipo: string

Ejemplo: abc123

3.2.13 seller_name

Este campo solo es necesario si es un mercado y revende un producto a varios vendedores.

El seller_name identifica el nombre para mostrar de un vendedor. Este nombre es generalmente el nombre que se muestra junto con un producto en particular en la página de un vendedor o en la caja de compra. Debe haber una relación directa entre el seller_name y el seller_id.

Límite de caracteres: 200

Tipo: string

Ejemplo: Mi tienda electrónica

3.2.14 seller_id

Este campo solo es necesario si es un mercado y revende un producto a varios vendedores.

El seller_id es un identificador exclusivo que representa a un vendedor en su página minorista. Debe haber una relación directa entre el seller_id y el seller_name.

Límite de caracteres: 200

Tipo: string

Ejemplo: 3265fd

---

Información de envío

3.2.15 shipping

Este atributo se utilizará para especificar los detalles de envío para cada país compatible, e indicará el precio y el servicio.

Tipo: string

Ejemplo:

 <envío>
<país>US</país>
<servicio>Estándar</servicio>
<precio>15.5 USD</precio>
</>envío

3.2.16 shipping_weight

El shipping_weight representa el peso del producto.

Requerimientos de caracteres: solo se aceptan las siguientes unidades: lb, oz, g, kg.

Tipo: string

Ejemplo: 1 kg

3.2.17 shipping_height

El shipping_height representa la altura del producto.

3.2.18 shipping_width

El shipping_width representa el ancho del producto.

3.2.19 shipping_length

Detalles: el shipping_length representa el largo del producto.

3.2.20 shipping_label

Este atributo puede utilizarse para asignar etiquetas a productos específicos con los valores de su preferencia, como: perecedero, voluminoso o promoción.

Límite de caracteres: 100

Tipo: string

Ejemplo: promoción

---

Paquetes de productos

3.2.21 multipack

Este atributo especifica paquetes de productos idénticos.

Tipo: entero

Ejemplo: 2

3.2.22 is_bundle

Este atributo especifica un grupo de productos diferentes.

Tipo: booleano

Ejemplo: FALSO

3.2.23 promotion_id

Detalles: este atributo especifica un id. de promoción.

Límite: String

Tipo: 60

Ejemplo: 123654

3.2.24 promo_text

Detalle: este campo contiene el texto promocional de este producto.

Límite: String

Tipo: 60

Ejemplo: compra especial

---

Atributos adicionales

3.2.25 custom_label_0

Agregue información personalizada adicional acerca del producto.

Requerimientos de caracteres: solo hay 5 niveles de etiquetas personalizadas autorizados (0 a 4).

Límite de caracteres: 100

Tipo: string

 

3.2.27 adwords_redirect

La URL rastrea todos los links del Google Shopping por separado.

Límite de caracteres: 200

Tipo: URL

Ejemplo: http://www.mywebsite.com/productpage.html

3.2.28 excluded_destination

El atributo excluded_destination evita que un artículo aparezca en determinadas ubicaciones, aunque aparezca en la información de su producto.

 

3.2.30 unit_pricing_measure

El atributo unit_pricing_measure define la medida y dimensión de un artículo. P. ej., 25 fl oz o 15 oz.

Ejemplo: 15 oz

3.2.31 unit_pricing_base_measure

El atributo unit_pricing_base_measure especifica su preferencia por el denominador del precio de unidad. Por ejemplo: 50 floz.

Ejemplo: 50 oz

3.2.32 display_ads_title

Este campo se puede usar para mostrar un título diferente en la sección Mostrar anuncios (diferente al "title") si desea.

Debido a que los títulos más cortos son más propensos a encajar en nuestros banners para mostrar, pero los títulos más largos funcionan mejor para Criteo Search, recomendamos usar títulos completos o largos en "title" y títulos más cortos en "display_ads_title".

Límite: 150 (se recomiendan 25)

Tipo: string

3.2.33 display_ads_value

Contiene el margen del artículo en la misma moneda que la del precio del artículo. También se puede usar un múltiplo del margen para ocultar el margen del producto actual, pero debe ser consistente en todos los productos.

Límite de valor : 10 veces el precio del producto

Tipo: string

Ejemplo : 299.99

3.2.34 map_price

El campo map_price representa el "Minimum Advertiser Price (precio mínimo del anunciante)" de un producto. El valor de este campo nunca se muestra en nuestros anuncios y se debe especificar si, por alguna razón, no puede mostrar un precio menor al map_price en los anuncios. Si el precio actual del producto es menor que el map_price, el precio no se mostrará en el anuncio.

Requirimientos de caracteres: el separador decimal debe ser un punto (.) sin separador de millares.

Tipo: string

Ejemplo : 1299.99

3.2.34 model_number

El model_number se usa para diferenciar un producto en una serie de otro. El model_number es utilizado frecuentemente por marcas para diferenciar productos similares en la misma categoría. Algunas veces puede aparecer el mismo model_number en variaciones de productos similares con distintos valores de id.

Límite de caracteres: 200

Requerimientos de caracteres: el model_number solo puede contener caracteres ASCII.

Tipo: string

Ejemplo: AXY27

 

Ejemplo de la estructura del feed

Ejemplo del feed XML

XML

<rss xmlns:g="http://base.google.com/ns/1.0"version="2.0">

    <channel>

        <title>Your Website</title>

        <link>http://www.yoursite.com/us/</link>

        <description>Your Website</description>

        <item>

            <g:id>abc123-black-7.5</g:id>

            <g:title>Working Boots Size 7.5</g:title>

            <g:description>Excellent for daily use</g:description>

            <g:google_product_category>Women’s > Shoes > Working Boots</g:google_product_category>

            <g:link>http://www.example.com/product/working-boots</g:link>

            <g:image_link>http://www.example/com/product/image/working-boots.png</g:image_link>

            <g:additional_image_link>http://www.example.com/product/image/working-boots-side.png</g:additional_image_link>

            <g:additional_image_link>http://www.example.com/product/image/working-boots-side_2.png</g:additional_image_link>

            <g:availability>in stock</g:availability>

            <g:price>1299.99</g:price>

            <g:sale_price>1199.99</g:sale_price>

            <g:gtin>0001234560012</g:gtin>

            <g:brand>Criteo</g:brand>

            <g:adult>no</g:adult>

            <g:product_type>Women’s &gt; Shoes &gt; Working Boots</g:product_type>

            <g:mobile_link>http://m.example.com/product/working-boots</g:mobile_link>

            <g:condition>new</g:condition>

            <g:availability>in stock</g:availability>

            <g:availability_date>2016-06-25T13:00-0800</g:availability_date>

            <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date>

            <g:item_group_id>abc123</g:item_group_id>

            <g:color>Black</g:color>

            <g:gender>male</g:gender>

            <g:age_group>adult</g:age_group>

            <g:material>leather</g:material>

            <g:pattern>Striped</g:pattern>

            <g:size>L</g:size>

            <g:size_type>regular</g:size_type>

            <g:size_system>US</g:size_system>

            <g:shipping>

                <g:country>US</g:country>

                <g:service>Standard</g:service>

                <g:price>5.5 USD</g:price>

            </g:shipping>

            <g:shipping_weight>1 kg</g:shipping_weight>

            <g:shipping_label>promotion</g:shipping_label>

            <g:multipack>2</g:multipack>

            <g:is_bundle>FALSE</g:is_bundle>

            <g:custom_label_0>custom data 0</g:custom_label_0>

            <g:custom_label_1>custom data 1</g:custom_label_1>

            <g:custom_label_2>custom data 2</g:custom_label_2>

            <g:custom_label_3>custom data 3</g:custom_label_3>

            <g:custom_label_4>custom data 4</g:custom_label_4>

            <g:sale_price_effective_date>2016-03-01T13:00-0800/2016-03-11T15:30-0800</g:sale_price_effective_date>

            <g:adwords_redirect>http://www.mywebsite.com/productpage.html</g:adwords_redirect>

            <g:excluded_destination>Shopping</g:excluded_destination>

            <g:expiration_date>2016-07-24</g:expiration_date>

            <g:unit_pricing_measure>15oz</g:unit_pricing_measure>

            <g:unit_pricing_base_measure>50oz</g:unit_pricing_base_measure>

        </item>

    </channel>

</rss>

 



¿Fue útil este artículo?
Usuarios a los que les pareció útil: 1 de 1
Tecnología de Zendesk