MANUAL TCNICO

ESPECIFICAES XML - CATLOGO

COPYRIGHT 2010 CRITEO. CONFIDENTIAL

GLOSSRIO

ONDE QUE AS INFORMAES APARECEM NO BANNER?

QUAIS SO OS CAMPOS OBRIGATRIOS?

QUE SINTAXE ESPERADA?

Page 2
COPYRIGHT 2010 CRITEO. CONFIDENTIAL

ONDE QUE AS INFORMAES APARECEM NO BANNER?

Onde que a informao aparece nos banners

Localizao dos diferentes campos nos BANNERS

Quais so os campos obrigatrios?

Que sintaxe esperada?

Page 3
COPYRIGHT 2010 CRITEO. CONFIDENTIAL

QUAIS SO OS CAMPOS OBRIGATRIOS 1/2

Informao Obrigatria do Produto
Onde que a informao aparece na faixa?

Campo (sintaxe)
Quais so os campos obrigatrios?
Que sintaxe esperada?

Descrio

Exemplo

ID (id)

Identificador alfanumrico (50

caracteres no mximo) do artigo

5487

Nome (name)

Nome do produto (cadeia de dados)

Apple iPod Touch - 16Gb

URL (producturl)

URL absoluto da pgina do artigo

(cadeia de dados)

http://www.mysite.com/ap
pleipodtouche16gb.html

Informao Recomendada do Produto

Campo (sintaxe)

Descrio

Exemplo

URL de pequena
imagem (smallimage)

URL absoluto do separador do artigo (cadeia de

dados)

http://www.mysite.com/images/ipod_small.html

Preo (price)

Preo do artigo (sem moeda, nmero completo ou

de ponto varivel, ".", como separador decimal)

99.50

Descrio
(description)

Descrio do artigo (cadeia de dados)

Funcionalidades tteis do iPod iguais tecnologia de

ecr multi-ttil do iPhone. Belisque para fazer zoom
sobre uma foto

Disponibilidade
(instock)
Categoria ID 1
(categoryid1)

Bandeira que indica se o artigo est ou no em

estoque. (VERDADEIRO ou FALSO. Valor
predefinido: VERDADEIRO.)
Atributo definido pelo usurio (inteiro ou cadeia de
dados).

VERDADEIRO
Ex.: tipo de produto (1=DVD, 2=livros,) Alta Tecnologia

Page 4
COPYRIGHT 2010 CRITEO. CONFIDENTIAL

QUAIS SO OS CAMPOS OBRIGATRIOS 2/2

Onde que a informao aparece na faixa?

Quais so os campos obrigatrios?

Que sintaxe esperada?

Notas:
A informao seguinte
ser usada para
ser apresentada no banner
ou para filtrar de acordo com os
seus Objetivos de Marketing
A informao deve sempre
aparecer em ns separados

Informao Adicional do Produto

Campo (sintaxe)

Descrio

Exemplo

URL de grande
imagem
(bigimage)

URL absoluto da imagem do artigo (cadeia de

dados)

http://www.mysite.c
om/images/ipod_la
rge.html

Preo de retalho
recomendado
(retailprice)

Preo do artigo antes do desconto (sem moeda,

nmero completo ou de ponto varivel, ".", como
separador decimal)

105.50

Desconto
(discount)
Recomendvel
(recommendable)
Categoria ID2
(categoryid2)
CategoriaID3
(categoryid3)

diferena entre o preo e o preo com desconto

(sem "-" nem "%"). Ex.: "29" ir resultar em "29%".
Bandeira que indica se o artigo deve ou no ser
recomendado. (VERDADEIRO ou FALSO. Valor
predefinido: VERDADEIRO.)
Atributo definido pelo usurio (inteiro ou cadeia de
dados). Ex.: marca (1=Apple, 2=Sony,) ou
subcategorias (1= pop music, 2=electro music,)
Atributo definido pelo usurio (inteiro ou cadeia de
dados). Ex.: lngua (1= Ingls, 2=Francs,...) ou
melhores subcategorias

5.6

VERDADEIRO

Leitores Mp3

Apple

No devem existir tags HTML na descrio de alimentao do catlogo includa.

Page 5
COPYRIGHT 2010 CRITEO. CONFIDENTIAL

QUE SINTAX ESPERADA 1/3

Where does information appear in the banner?
Which fields are mandatory?

Exemplos de sintaxes possveis:

As pginas seguintes apresentam as diferentes sintaxes
aceites para os seguintes produtos:

What syntax do we expect?

Produto 1

Produto 2

Produto 3

id

B789465

P309688

HG90BK

nome

Harry Potter 7

Samsung SGH-E900

Frigideira com tampa

smallimage

http://partnersite/images/hp7small.jpg

http://partnersite/images/samsungsghe900sm
all.jpg

http://partnersite/images/panhg90
bksmall.jpg

bigimage

http://partnersite/images/hp7big.jpg

http://partnersite/images/samsungsghe900big.
jpg

http://partnersite/images/panhg90
bkbig.jpg

producturl

http://partnersite/b789465.htm

http://partnersite/p309688.htm

http://partnersite/hg90bk.htm

descrio

ltimo livro da saga Harry Potter

Descrio deste telemvel

Frigideira para todos os dias de

12"

preo

20.99

92.10

34.95

retailprice

34.99

discount

40

recommendable

instock

Page 6
COPYRIGHT 2010 CRITEO. CONFIDENTIAL

QUE SINTAX ESPERADA 2/3

Onde que a informao aparece na faixa?

Sintaxe CSV

Quais so os campos obrigatrios?

Exemplo de alimentao do CSV para 3 produtos:

Que sintaxe esperada?

id|name|smallimage|bigimage|producturl|description|price|retailprice|discount|recommendable|instock
B789465|"Harry Potter
7"|http://partnersite/images/hp7small.jpg|http://partnersite/images/hp7big.jpg|http://partnersite/b78
9465.htm|"Last book of Harry Potter saga"|20.99|34.99|40|1|1
P309688|"Samsung SGHE900"|http://partnersite/images/samsungsghe900small.jpg|http://partnersite/images/samsungsghe900big.j
pg|http://partnersite/p309688.htm|"Description of this cellular phone"|92.10|||1|1
HG90BK|"Pan with
lid"|http://partnersite/images/panhg90bksmall.jpg|http://partnersite/images/panhg90bkbig.jpg|http://p
artnersite/hg90bk.htm|"12"" everyday pan"|34.95|||1|0

Notas:
A linha de rodap obrigatria. Todas as outras linhas correspondem informao sobre o produto.
Cada dado deve ser separado com um trao vertical (|), mesmo se o campo estiver vazio.
Os campos alfanumricos tais como o nome e a descrio (eventualmente as categorias) devem estar
entre aspas ("). Se um dos campos no contiver j as aspas, deve duplic-lo (cf. descrio do produto 3)

Page 7
COPYRIGHT 2010 CRITEO. CONFIDENTIAL

QUE SINTAX ESPERADA 3/3

Onde que a informao aparece na faixa?

Sintaxe XML

Quais so os campos obrigatrios?

Exemplo de alimentao XML para 3 produtos

Que sintaxe esperada?

<products>
<product id="B789465">
<name>Harry Potter 7</name>
<smallimage>http://partnersite/images/hp7small.jpg</smallimage>
<bigimage>http://partnersite/images/hp7big.jpg</bigimage>
<producturl>http://partnersite/b789465.htm</producturl>
<description>Last book of Harry Potter saga</description>
<price>20.99</price>
<retailprice>34.99</retailprice>
<discount>40</discount>
<recommendable>1</recommendable>
<instock>1</instock>
</product>
...
</products>

Notas:
A estrutura XML deve ser vlida: Os smbolos tais como & ou < nos ns devem ser codificados (&amp;,
&lt;). Cada n deve ser corretamente fechado e deve existir um n "raiz".
A alimentao deve incluir apenas ns com informao.
Page 8
COPYRIGHT 2010 CRITEO. CONFIDENTIAL

CONTATO DE APOIO

Contato do Apoio Tcnico

das 9:00 s 18:00, de segunda a sexta-feira
SupportUS@criteo.com

Page 9
COPYRIGHT 2010 CRITEO. CONFIDENTIAL