Entrar

Bem-vindo ao nosso Centro de Suporte

Obtenha ajuda com integração e campanhas ativas.

Bem-vindo ao nosso Centro de Suporte. Obtenha ajuda com integração e campanhas ativas.

Especificação do feed de produtos da Criteo

1 - Visão Geral

Um feed de produto é um arquivo que contém informações a respeito de todos os produtos em seu site. Utilizaremos essas informações para criar banners de produtos dinâmicos.

Neste artigo, você encontrará os detalhes sobre o que pode incluir em seu feed e como formatar cada campo.

2 - Formatos de feed suportados pela Criteo

Para garantir que a Criteo possa recuperar seu feed de produto, utilize um dos seguintes formatos:

Formato
de feed

Detalhes

Download

TSV

Este formato é baseado no valor separado por tabulação (Tab-separated Value). O cabeçalho deve ser exposto na primeira linha do arquivo. Names de campo podem conter espaços ou underlines (ex.: image_link ou image link).

Exemplo de feed

CSV

Este formato é baseado no valor separado por vírgulas (Comma-separated Value). O cabeçalho deve ser exposto na primeira linha do arquivo. Names de campo podem conter espaços ou underlines (ex.: image_link or image link)

Exemplo de feed

XML

Este formato deve respeitar os princípios básicos da estrutura XML. Os produtos são representados por um conjunto de nós XML. A lista de produtos deve começar com uma tag de declaração <?xml. 

Exemplo de feed

 

 

3 - Informações que devem ser fornecidas sobre o produto

Todos os nomes de campos devem estar em inglês. As informações de produto não devem conter tags HTML ou tags de estilo.

3.1 - Campos obrigatórios para anunciar seus produtos

3.1.1 ID

Este campo é obrigatório para todos os produtos no feed e não pode estar vazio/em branco.

The ID is a unique product identifier that represents only one product. Once an ID is assigned to a product and imported, it may not be used for a different product, nor can the ID for a particular product change. If you have item_group_id also populated, populate ID with the child ID/SKU.

Character Requirements: The ID must only contain ASCII characters, and must not contain quotation marks.

Limite: 240

Tipo: sequência de caracteres

Exemplo: abc123-black-7.5

3.1.2 title

Este campo é obrigatório para todos os produtos no feed e não pode estar vazio/em branco

O campo title é o name do produto, geralmente como ele é exibido na página de detalhe do produto. Ele será utilizado como o descritor de texto principal nos banners para um determinado produto. 

 

Requisitos de caracteres: o "name" deve começar com uma letra ou número.

Limite: 150

Tipo: sequência de caracteres

Exemplo: Botas de Proteção – Tamanho 38

3.1.3 description

The description is a short piece of text that gives more information about a product in addition to its name. Because of banners' design, shorter descriptions (under 50 characters) are more likely to fit in Criteo’s formats and layouts. However, not all formats and layouts will have a description.

Requisitos de caracteres: a description deve começar com uma letra ou um número. Remova todas as tags HTML desse campo, inclusive tags de estilo, embutidas, de objeto e âncoras.

Limite: 5.000 

Tipo: sequência de caracteres

Exemplo: excelente para uso diário

3.1.4 google_product_category

Os atributos de nível da categoria indicam a categoria do produto sendo enviado de acordo com a taxonomia de produtos do Google.

Caso seu produto possa ser relacionado a várias categorias, só queremos aquela que é a mais relevante.

Requisitos de caracteres: aceitamos tanto IDs quanto caminho de categoria completa

Tipo: sequência de caracteres

Exemplo: Feminino > Sapatos > Botas de montaria OU 2271

3.1.5 link

Este campo é obrigatório para todos os produtos no feed e não pode estar vazio/em branco

The link is the product’s dedicated detail page. The link is usually, although not necessarily, unique to a given product. The product information on this URL should match the corresponding information provided in your feed. Please specify the protocol (http:// or https://) for all URLs.

Requisitos de caracteres: o link deve começar com o protocolo (http:// ou https://), seguido pela URL completa da página de detalhe do produto. Todos os símbolos devem ser codificados. Ex.: $ deve ser substituído por %24.

Limite: 1024

Tipo: sequência de caracteres

Exemplo: http://www.exemplo.com/produto/botas-de-protecao

3.1.6 image_link

Este campo é obrigatório para todos os produtos no feed e não pode estar vazio/em branco

The image_link is a URL that specifies a file path to a given product’s image. The image_link will be used to display the product’s image in the banners. Ideally, images should be at least 800x800 pixels and under 16MB. The image must have a Content-Type header specified, either image/png, image/gif or image/jpeg. If you restrict your images from being accessible via cURL, please whitelist our user-agent so we may display your images in the Criteo banners: curl/7.15+ (x64-criteo) libcurl/7.15+ OpenSSL zlib libidn.

Requisitos de caracteres: o image_link deve começar com http:// ou https://, seguido da URL completa da imagem do produto. Todos os símbolos devem ser codificados. Eg. $ deve ser substituído por %24. 

Limite: 2000

Tipo: sequência de caracteres

Exemplo: http://www.exemplo.com/produto/botas-de-protecao.png

3.1.7 additional_image_link

 

 

The is the price the manufacturer recommends the product be sold for. If a given product is “on sale”, the price field would be populated with the higher price. The price should be in the same currency as the site. Only populate price with the numeric value using a period (.) as the decimal separator and no thousands separator.

Requisitos de caracteres: o separador decimal deve ser um ponto final (.) sem separador de milhares.

Limite: 14

Tipo: sequência de caracteres

Exemplo: 1299.99

3.1.10 sale_price

O campo sale_price é o preço pelo qual o produto está disponível pra compra no site, se determinado produto estiver 'em promoção', o sale_price deve ser preenchido com o preço mais baixo. O sale_price deve estar na mesma moeda que o site. Apenas preencha o sale_price com o preço numérico, utilizando ponto final (.) como o separador decimal e nenhum separador para os milhares.

Requisitos de caracteres: o separador decimal deve ser um ponto final (.) sem separador de milhares.

 

Tipo: sequência de caracteres

Limite: 50

Exemplo: 0001234560012

 

3.1.12  mpn 

MPN is the number that uniquely identifies the product to its manufacturer.

Limite: 70

Tipo: sequência de caracteres

Exemplo: 4060882

 

3.1.13 brand

 Este campo é exigido para Criteo Sponsored Products

O campo brand indica o name da marca do produto. Alguns produtos não estão associados de forma clara a uma marca. Nesse caso, essa informação não precisa ser fornecida.

Requisitos de caracteres: o nome deve começar com uma letra ou com um número e só pode conter caracteres ASCII. Remova todas as tags HTML desse campo, inclusive tags de estilo.

Limite: 70

Tipo: sequência de caracteres

Exemplo: Criteo

 

3.1.15 product_type

Este campo é exigido para Criteo Sponsored Products

The product_type is a category (or list of categories) to which the product belongs. The product_type field lists your merchandising category, or set of merchandising categories for this product. It must match your website categories. Each level in the hierarchy needs to be delimited by " > ". If a product is available in multiple categories, please send the different categories as comma (,) delimited with the primary category first. product_type is case-sensitive, so if you use 'women’s' for one product and 'Women’s' for another, Criteo will interpret these as two different categories.

Requisitos de caracteres: o product_type id deve começar com uma letra ou número e só pode conter caracteres ASCII. O delimitador entre categorias deve ser> (& gt; para feeds XML). Apenas o caminho completo de categoria é suportado. Se um produto estiver disponível em várias categorias, envie cada uma delas delimitadas com vírgula (,) e a categoria primária antes. Não aceitamos o ID do caminho das categorias. Os IDs devem ser preenchidos no campo product_type_key. 

Limite: 500

Tipo: sequência de caracteres

Exemplo:

  • Único: Computação & gt; Teclados e mouse & gt; Mouses & gt; Mouses sem fio
  • Múltiplo: Computação &gt; Teclados e mouse &gt; Mouse &gt; Mouses sem fio,Presentes &gt; Para o pai &gt; Mouse

3.1.16 product_type_key

Este campo é exigido para Criteo Sponsored Products

Esse campo lista o ID exclusivo e hierarquia para o product_type ou para o conjunto de product_type(s). Cada chave na hierarquia precisa ser delimitada por ">". Se um produto estiver disponível em várias categorias, envie cada uma delas delimitadas com vírgula (,) e a categoria primária em primeiro lugar.

Requisitos de caracteres: o product_type_key só pode conter caracteres ASCII. O delimitador entre categorias deve ser> (& gt; para feeds XML). Se um produto estiver disponível em várias categorias, envie cada uma delas delimitadas com vírgula (,) e a categoria primária antes.

Limite: 500

Tipo: sequência de caracteres

Exemplo:

  • Único: XY1 &gt; YZ1 &gt; Z1
  • Múltiplo: XY1 &gt; YZ1 &gt; Z1 , AB1 &gt; BC2 &gt; A

3.1.17 number_of_reviews

Este campo é recomendado para Criteo Sponsored Products

This field contains the number of reviews for the product. number_of_reviews is required if you want this information to be displayed in the ad.

Limite: 8

Tipo: total

Exemplo: 2456

3.1.18 product_rating

Este campo é recomendado para Criteo Sponsored Products

This field represents the rating of the product. product_rating is required if you want this information to be displayed in the ad.

Requisitos de caracteres: o separador decimal deve ser um ponto final (.) sem separador de milhares.

Limite: 8

Tipo: sequência de caracteres

Exemplo: 4.5

3.1.19 filters

Este campo é exigido para Criteo Sponsored Products

Os filtros são atributos associados a determinados produtos que os diferenciam dos demais produtos na mesma categoria. Os filtros devem ser fornecidos em uma lista separada por vírgulas de pares de valor com name de atributo. Eles devem combinar com a lista de filtros disponível em seu website e com o produto em questão. Esse ponto é fundamental para Criteo Sponsored Products.

Requisitos de caracteres: os pares de valor=chave devem ser separados por vírgula (,) e valores múltiplos, por barra vertical (|).

Limite: 2000

Tipo: sequência de caracteres

Exemplo: Cor=Vermelho|Preto, Tamanho=XG, Tamanho de tela = 15"

3.2 - Campos opcionais

3.2.1 mobile_link

The mobile_link is the link to the mobile-optimized version of your product landing page. This url should be different from the one that you provide in the 'link' field. By providing a mobile link: you will improve your customers’ user experience, and reduce the landing page loading latencies.

Requisitos de caracteres: o link deve começar com o protocolo (http:// ou https://), seguido pela URL completa da página de detalhe do produto. Todos os símbolos devem ser codificados. Ex.: $ deve ser substituído por %24.

Limite: 2000

Tipo: sequência de caracteres

Exemplo: http://m.exemplo.com/produto/botas-de-proteção

3.2.2 condition

O campo condition é utilizado para qualificar o produto com três valores reconhecidos diferentes: 'novo', 'reformado' e 'usado'.

Requisitos de caracteres: apenas três valores são reconhecidos:

  • 'novo' [new]
  • 'reformulado' [refurbished]
  • 'usado' [used]

Tipo: sequência de caracteres

Exemplo: novo

---

Variantes do produto

3.2.3 item_group_id

O campo item_group_id é um identificador de nível pai exclusivo de produto. Pode conter caracteres alfanuméricos que representam um produto que pode ser expresso como uma coleção de produtos filhos. Após uma item_group_id ser atribuída a um produto e importada, ela não pode ser utilizada para um produto diferente, e a item_group_id para determinado produto não pode ser alterada. Como a item_group_id pode representar uma coleção de produtos, vários produtos podem ter o mesmo valor de item_group_id

Requisitos de caracteres: o item_group_id deve conter apenas caracteres ASCII e não pode conter aspas.

Limite: 240

Tipo: sequência de caracteres

Exemplo: abc123

 

3.2.4 color

Detalhe: este atributo indicará a(s) cor(es) dominante(s) do produto.

Limite: 100

Tipo: sequência de caracteres

Exemplo: preto

3.2.5 gender

Obrigatória para todos os produtos em um grupo de itens que variam de acordo com o gênero.

Exigências de caracteres: apenas três valores são reconhecidos:

  • 'masculino' [male]
  • 'feminino' [female]
  • 'unisex' [unisex]

Tipo: sequência de caracteres

Exemplo: masculino

3.2.6 age_group

Este atributo será utilizado para indicar a idade do grupo-alvo do seu produto.

Exigências de caracteres: apenas cinco valores são aceitos:

  • 'recém-nascido' [newborn]
  • 'bebê' [infant]
  • 'criança de um a três anos' [toddler]
  • 'criança' [kids]
  • 'adulto' [adult]

Tipo: sequência de caracteres

Exemplo: adulto

3.2.7 material

Este atributo indicará o material ou tecido do qual é feito o produto. Obrigatório para todos os produtos em um grupo de itens que variam de acordo com o material.

Limite: 200

Tipo: sequência de caracteres

Exemplo: couro

3.2.8 pattern

This attribute indicates the pattern or the graphic print for the product. Required for all products in an item group that vary by pattern.

Limite: 100

Tipo: sequência de caracteres

Exemplo: listrado

3.2.9 size

Este atributo indicará o tamanho do produto. Obrigatório para todos os produtos em um grupo de itens que variam de acordo com o tamanho.

Limite: 100

Tipo: sequência de caracteres

Exemplo: L

3.2.10 size_type

Você pode especificar o corte do produto adicionando o tipo de tamanho.

Exigências de caracteres: apenas cinco valores são aceitos:

  • 'médio' [regular]
  • 'pequeno' [petite]
  • 'grande' [plus]
  • 'extra grande' [big and tall]
  • 'gestante' [maternity]

Limite: N/A

Tipo: sequência de caracteres

Exemplo: regular

3.2.11 size_system

Detalhe: você pode especificar o sistema de tamanho de produto do país adicionando o sistema de tamanho.

Requisitos de caracteres: existem 11 valores aceitos: US, UK, DE, FR, JP, CN (China), IT, BR, MEX, AU

Limite: N/A

Tipo: sequência de caracteres

Exemplo: EUA

---

Para vendedores de marketplace

 

3.2.12 cross_sellers_product_id

O preenchimento desse campo só é obrigatório se você for um marketplace e estiver revendendo um produto para vários vendedores.

O cross_sellers_product_id é um identificador de produto exclusivo que agrupa vários id referentes ao mesmo produto comercializado por diferentes vendedores. Assim que um cross_sellers_product_id é atribuído a um produto e importado, ele não pode ser usado com um produto diferente, tampouco pode-se modificar o cross_sellers_product_id de um produto específico. Como cross_sellers_product_id representa uma coleção de produtos, vários produtos podem ter o mesmo valor para cross_sellers_product_id.

Requisitos de caracteres: o cross_sellers_id deve começar com uma letra ou com um número e só pode conter caracteres ASCII.

Limite: 250

Tipo: sequência de caracteres

Exemplo: abc123

3.2.13 seller_name

O preenchimento desse campo só é obrigatório se você for um marketplace e estiver revendendo um produto para vários vendedores.

O seller_name identifica o name de exibição de um vendedor. Esse name é geralmente aquele exibido junto a um determinado produto na página de um vendedor ou na caixa de compra. Deve haver uma relação unívoca entre seller_name e seller_id.

Limite: 200

Tipo: sequência de caracteres

Exemplo: minha loja de eletrônicos

3.2.14 seller_id

O preenchimento desse campo só é obrigatório se você for um marketplace e estiver revendendo um produto para vários vendedores.

O seller_id é um identificador exclusivo que representa um vendedor em seu local de varejo. Deve haver uma relação unívoca entre seller_id e seller_name.

Limite: 200

Tipo: sequência de caracteres

Exemplo: 3265fd

---

Informações sobre envio

3.2.15 shipping

Este atributo será utilizado para especificar os detalhes sobre o envio para cada país suportado, indicando o preço e o serviço

Tipo: sequência de caracteres

Exemplo:

 <shipping>
<country>US</country>
<service>Standard</service>
<price>15.5 USD</price>
</shipping>

3.2.16 shipping_weight

O shipping_weight representa o peso do produto.

Requisitos de caracteres: apenas as unidades seguintes são aceitas: lb, oz, g, kg

Tipo: sequência de caracteres

Exemplo: 1 kg

3.2.17 shipping_height

O shipping_height representa a altura do produto.

3.2.18 shipping_width

O shipping_width representa a largura do produto.

3.2.19 shipping_length

Detalhe: o shipping_length representa o comprimento do produto.

3.2.20 shipping_label

Este atributo pode ser utilizado para atribuir rótulos a produtos específicos, utilizando valores de sua escolha, tais como perecível, volumoso ou em promoção.

Limite: 100

Tipo: sequência de caracteres

Exemplo: promoção

---

Pacote e embalagem do produto

3.2.21 multipack

Este atributo especifica um pacote de produtos idênticos.

Tipo: total

Exemplo: 2

3.2.22 is_bundle

Este atributo especifica um grupo de produtos diferentes.

Tipo: booliano

Exemplo: FALSO

3.2.23 promotion_id

Detalhe: esse atributo especifica um ID de promoção.

Limite: string

Tipo: 60

Exemplo: 123654

3.2.24 promo_text

Observação: esse campo contém o texto promocional para determinado produto.

Limite: string

Tipo: 60

Exemplo: oferta especial

---

Atributos adicionais

3.2.25 custom_label_0

Adicionar informações personalizadas extras sobre o produto.

Requisitos de caracteres: apenas 5 níveis de rótulo personalizado são autorizados (0 a 4)

Limite: 100

Tipo: sequência de caracteres

 

3.2.27 adwords_redirect

URL para rastrear separadamente todos os cliques do Google Shopping.

Limite: 200

Tipo: URL

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

3.2.28 excluded_destination

O atributo 'excluded_destination' impede um item de aparecer em certos destinos, embora ele apareça nos seus dados de produtos.

 

3.2.30 unit_pricing_measure

O atributo "unit_pricing_measure" define as medidas e dimensões de um item. Ex.: 25floz ou 15oz.

Exemplo: 15oz

3.2.31 unit_pricing_base_measure

O atributo 'unit_pricing_base_measure' especifica a preferência do denominador do preço unitário. Exemplo: 50floz.

Exemplo: 50oz

3.2.32 display_ads_title

Se desejar, esse campo pode ser usado para exibir um title diferente em anúncios de exibição (diferente de "title").

Como titles curtos cabem melhor em nossos banners de exibição e titles mais longos funcionam melhor para o Criteo Search, recomendamos o uso de titles por extenso/longos em "title" e de abreviados/curtos em "display_ads_title".

Limite: 150 (25 é o recomendado)

Tipo: string

3.2.33 display_ads_value

Contém a margem do item na mesma moeda do item price. Um múltiplo da margem também pode ser usado para esconder a margem de produto real, mas, para isso, precisa ser consistente entre produtos.

Limite de valor: 10 vezes o preço do produto

Tipo: string

Exemplo : 299,99

3.2.34 map_price

O campo map_price representa o "price mínimo do anunciante" de um produto. O valor desse campo nunca é exibido em nossos anúncios e deve ser especificado se, por algum motivo, você não for capaz de exibir nos anúncios um price inferior ao do map_price. Se o price vigente do produto for menor do que o do map_price, price não será exibido no anúncio.

Requisitos de caracteres: o separador decimal deve ser um ponto final (.) sem separador de milhares.

Tipo: string

Exemplo : 1299,99

3.2.34 model_number

O model_number é usado para diferenciar um produto em uma série de outro. O model_number é frequentemente utilizado por marcas para diferenciar produtos semelhantes da mesma categoria. Às vezes, o mesmo model_number pode aparecer em produtos de variação semelhante com diferentes valores de id.

Limite: 200

Requisitos de caracteres: o model_number pode conter apenas caracteres ASCII.

Tipo: sequência de caracteres

Exemplo: AXY27

 

Exemplo de estrutura de catálogo

Exemplo de 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>não</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>

 



Esse artigo foi útil?
Usuários que acharam isso útil: 1 de 1
Powered by Zendesk