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.

Criteo OneTag para Sponsored Products com API

Este guia de implementação da Criteo OneTag para Sponsored Products com API foi criado para as equipes de desenvolvimento e/ou monetização das organizações de varejo explorarem todas as vantagens da nossa solução enquanto você a implementa no seu site. A implementação completa leva normalmente de 4 a 8 semanas. Depois que a OneTag para Criteo Sponsored Products estiver implementada no seu site, você terá rápido acesso a todos os novos recursos quando eles forem disponibilizados. Lembre-se de que o seu Engenheiro de Soluções Técnicas da Criteo está disponível para ajudá-lo com qualquer dúvida enquanto você implementa a Criteo OneTag no seu site.

Comece a usar a Criteo OneTag para Sponsored Products com API.

Etapa 1: Compartilhar o catálogo de produtos e configurar o feed

Para começar com os anúncios do Criteo Sponsored Products, trabalhe com o seu Engenheiro de Soluções Técnicas da Criteo para configurar o feed do catálogo de produtos. A Criteo aceita a ingestão de feeds em vários formatos, como .tsv, .csv e .xml.

 Detalhes da especificação de feed são fornecidos aqui.

 

Etapa 2: Registro de página e posicionamento

A segunda etapa é registrar suas páginas e posicionamentos na Criteo Retailer Network. Seu Engenheiro de Soluções Técnicas da Criteo configurará essa etapa para você e lhe fornecerá os detalhes do registro a serem usados na sua configuração da OneTag. O parâmetro Event Name na JavaScript OneTag está relacionado ao tipo de página que está sendo integrado com a Criteo OneTag. Todos os tipos de página padrão listados na Etapa 3.2 têm um nome de evento padrão. Caso você pretenda integrar o Criteo Sponsored Products em um tipo de página não listado nos tipos de página padrão da Etapa 3.2, consulte o seu Engenheiro de Soluções Técnicas da Criteo para saber como proceder.

step2.png

Depois que os posicionamentos forem configurados, o Engenheiro de Soluções Técnicas da Criteo compartilhará o ID de posicionamento do anúncio da página.

step2.2.png

Consulte o Apêndice B para entender como a Criteo configura esses posicionamentos.

 

Etapa 3: Inserindo tags no seu site

A Criteo OneTag para Sponsored Products é uma tag JavaScript que permite à Criteo rastrear as interações dos usuários enquanto eles navegam no seu site de e-commerce. Dessa forma, podemos implementar o Criteo Sponsored Products nas suas páginas. 

Nossa OneTag contém dois elementos:

  1. O Criteo Loader é uma biblioteca JavaScript específica para a configuração da sua conta no sistema Criteo e deve ser declarado no cabeçalho de toda página em que você implementar a Criteo OneTag para ajudar a minimizar atrasos no retorno do Criteo Sponsored Products. O Criteo Loader está encarregado de criar e disparar chamadas para os servidores do Criteo Sponsored Products.

step33.png

  1. Os eventos de rastreamento nos permitem coletar os eventos de navegação do seu visitante e mostrar anúncios relevantes a ele. Entender as ações do usuário e o contexto do site é importante para garantir que a Criteo forneça os melhores posicionamentos quando os anúncios forem mostrados. O uso de tags é diferente para cada tipo de página. Estas são as principais páginas que são importantes rastrear (com ou sem anúncio):
  • Páginas:
    • Página inicial
    • Páginas de listas de categorias
    • Páginas de listas de pesquisa
    • Páginas de detalhes do produto
    • Páginas de carrinho de compras
    • Páginas de confirmação do pedido

O exemplo abaixo mostra uma tag com todos os parâmetros universais que são necessários a todas as solicitações de rastreamento. Um parâmetro universal é aquele que é adicionado a todo tipo de página, com ou sem anúncio.

 Exemplo

step4.png

Parâmetros universais

Os parâmetros a seguir são necessários a todas as solicitações de rastreamento, independentemente do tipo de página em que o anúncio é mostrado:

Evento

Parâmetro

Valor de exemplo

Descrição

tipo

Obrigatório

 

 

 

 

setAccount

 

 

 

 

account

 

 

 

 

123456

ID da Conta do Parceiro da Criteo. Esse valor será fornecido pelo seu Engenheiro de Soluções Técnicas.

 

 

 

 

String

 

 

 

 

Sim

 

 

 

 

setRetailerVisitorId

 

 

 

 

id

 

 

 

53e20ea700424f7bbdd7 93b02abcb5d7

Um userId exclusivo e não autenticado consistente durante as sessões no mesmo dispositivo

 

 

 

 

String

 

 

 

 

Sim

 

 

 

 

 

 

setEmail

 

 

 

 

 

 

email

 

 

 

 

 

3e0a83febcf74ba6a08e 684534100773

O endereço de email do usuário, se disponível, em formato MD5 OU SHA256

Formato de criptografia MD5. Também aceitamos email com texto sem formatação. Nesse caso, a Criteo vai criptografá-lo para você.

 

 

 

 

 

 

String

 

 

 

 

 

 

Sim, se disponível

 

 

 

 

setCustomerId

 

 

 

 

id

 

 

 

53e20ea700424f7bbdd7 93b02abcb5d7

O id do usuário autenticado que é consistente durante todas as sessões

 

 

 

 

String

 

 

 

Sim, se o email do usuário não for fornecido

 

 Como rastrear na página inicial

Ao adicionar rastreadores à página inicial, especifique apenas os parâmetros universais.

 

Evento

Parâmetro

Descrição

tipo

Obrigatório

 

 

viewHome

 

 

N/A

Este é o evento que identifica o tipo de página "Home Page" (página inicial).

 

 

String

 

 

Sim

 

Exemplo

11.png 

Como rastrear nas páginas de listas de categorias

Para todas as páginas de listas de categorias ou taxonomias que exibam uma lista de produtos (páginas de listas), ou se você exibir uma coleção personalizada de produtos, especifique na tag os parâmetros universais e também os seguintes parâmetros adicionais: 

Evento

Parâmetro

Descrição

tipo

Obrigatório

 

 

viewCategory

 

item, category, page_number, filters

Este é o evento que identifica o tipo de página

 

 

String

 

 

Sim

 

Aqui você encontrará os detalhes sobre os parâmetros específicos ao evento "viewCategory":

 

Parâmetro

Valor de exemplo

Descrição

tipo

Obrigatório

 

 

 

 

 

 

item

 

 

 

 

 

["1-9835530","1-

9835432”,”1-9866287”]

 

A lista de produtos que são organicamente mostrados na grade da página. Trata-se dos IDs de produtos (do tipo) filho que devem ser passados com um máximo de 100 itens. Os IDs devem ser iguais àqueles especificados no feed de produtos.

 

 

 

 

 

 

String

 

 

 

 

 

 

Sim

 

 

 

 

 

Categoria

 

 

 

 

Eletrônicos>Áudio>Fones de ouvido

A categoria ou taxonomia da página em que o usuário está navegando. Esse valor deve ser igual aos valores de taxonomia que são enviados no feed do catálogo no campo product_type ou product_type_key para a Criteo.

 

 

 

 

 

String

 

 

 

 

 

Sim

 

 

 

 

page_number

 

 

 

 

1

 

Se você dá suporte à paginação, esse valor representa o número da página. No caso de uma única página sem fim, esse valor deve ser definido como 1.

 

 

 

 

String

Sim, somente se você estiver usando paginação. No caso de uma única página, você não pode passar esse valor

 

 

 

 

 

 

 

filters

 

 

 

 

 

{nome: “marca”, operador: “eq”, valor:”Nikon, Sony”}

Estes são todos os filtros aplicados na página os quais você quer utilizar para mostrar o anúncio. Eles são agrupados em uma lista separada por vírgulas quando há várias seleções de um único filtro (por exemplo, Brand). Uma linha separada deve ser adicionada para cada seleção de filtro. Consulte a seção "Filtros" a seguir para mais detalhes.

 

 

 

 

 

 

 

String

 

 

 

 

 

 

 

Não

Exemplo

01.png

Como rastrar nas páginas de listas de pesquisa

Para todas as páginas de resultados da pesquisa que exibam uma lista de produtos (páginas de lista de resultados da pesquisa), independentemente de haver ou não resultados orgânicos da pesquisa a serem exibidos, especifique na tag os parâmetros universais e também os parâmetros adicionais a seguir.

 

Evento

Valor de exemplo

Descrição

tipo

Obrigatório

 

 

viewSearchResult

item, keyword, category, page_number, filters

 

Este é o evento que identifica o tipo de página

 

 

String

 

 

Sim

 

 

Aqui você encontrará detalhes sobre os parâmetros específicos ao evento "viewSearchResult".

Parâmetro

Valor de exemplo

Descrição

tipo

Obrigatório

 

 

 

 

 

item

 

 

 

 

 

["1-9835530","1-9835432”,”1-9866287”]

A lista de produtos que são organicamente mostrados na grade da página. Trata-se dos IDs de produtos (do tipo) filho que devem ser passados com um máximo de 100 itens.

 

 

 

 

 

String

 

 

 

 

 

Sim

 

keywords

 

fones de ouvido

A palavra-chave inserida pelo usuário para a pesquisa.

 

String

 

Sim

 

 

 

 

 

 

Categoria

 

 

 

 

 

 

Eletrônicos>Áudio>Fones de ouvido

 

A categoria ou taxonomia da página em que o usuário está navegando. Esse valor deve ser igual aos valores de taxonomia que são enviados no feed do catálogo no campo product_type ou product_type_key para a Criteo.

 

 

 

 

 

 

String

 

 

 

 

 

 

Opcional

 

 

 

 

page_number

 

 

 

 

1

 

 

Se você dá suporte à paginação, esse valor representa o número da página. No caso de uma única página sem fim, esse valor deve ser definido como 1.

 

 

 

 

String

Sim, somente se você estiver usando paginação. No caso de uma única página, você não pode passar esse valor

 

 

 

 

 

 

 

 

filters

 

 

 

 

 

 

 

{nome: “marca”, operador: “eq”, valor:”Nikon, Sony”}

 

Estes são todos os filtros aplicados na página, os quais você quer utilizar para mostrar o anúncio. Eles são agrupados em uma lista separada por vírgulas quando há várias seleções de um único filtro (por exemplo, Brand). Uma linha separada deve ser adicionada a cada seleção de filtro.

Consulte a seção "Filtros" a seguir para mais detalhes.

 

 

 

 

 

 

 

 

String

 

 

 

 

 

 

 

 

Não

 

Exemplo

03.png 

Filtros

Quando o usuário filtra uma lista de produtos por filtro ou faceta individual, ou por vários filtros, eles podem ser incluídos como filtros. Três filtros específicos são palavras reservadas para a Criteo, que vai mapeá-las explicitamente nos campos de dados do feed de produtos: “brand” (marca), “price” (preço) e “rating” (classificação). Todos os outros filtros podem ser usados com flexibilidade.

Um filtro totalmente qualificado consiste em três propriedades:

  1. Filter Name: nome do filtro
  2. Operator: o operador
  3. Value: o valor pode ser uma lista de valores dependendo do caso. Por exemplo, se você usar o operador ‘in’, poderá especificar uma lista de valores delimitados por vírgulas.

 Para especificar filtros nas tags, você utilizaria a função "filters" dentro da função "event". 

 

A Criteo dá suporte à seguinte lista de operadores:

Operator: o operador

Descrição

eq

Igual a

gt

Maior que

lt

Menor que

ge

Maior ou igual a

le

Menor ou igual a

in

Associação em uma lista

 

Exemplos: 

filtros:[("price","le","500")]

Definiria um filtro de preço para skus "menor que/igual a" $500.

  

filtros:[("color","eq","blue")]

Definiria um filtro de cor para "skus" cuja cor é "azul".

 

filtros:[("brand","eq","sony,hp,dell")]

Definiria um filtro de marca que retornaria skus de qualquer marca: "sony", "hp" ou "dell".

Alternativamente, o operador "in" poderia ser usado no lugar de "eq" com o mesmo resultado final.

 

Como rastrear páginas de detalhes do produto

A página do produto contém detalhes de um produto específico. A instalação da Criteo OneTag na página de detalhes do produto é essencial para o processo de rastreamento. Além disso, a tag abaixo permite atualizar tanto o preço quanto a disponibilidade em tempo quase real sempre que a página é visitada enquanto o processamento do feed é executado. Por exemplo, se um produto ficar fora de estoque durante o dia após a Criteo ter processado a execução diária do seu feed de produtos, a tag abaixo informará nosso sistema para marcar esse produto como fora de estoque, evitando que ele seja mostrado em um anúncio no seu site. Especifique na tag os parâmetros universais, bem como os seguintes parâmetros adicionais:

 

Evento

Parâmetro

Descrição

tipo

Obrigatório

 

 

 

 

viewItem

 

 

 

 

item, price, availability

 

 

 

Este é o evento que identifica o tipo de página

 

 

 

 

String

 

 

 

 

Sim

 

Aqui você encontrará os detalhes sobre os parâmetros específicos ao evento "viewItem":

  

Parâmetro

Valor de exemplo

Descrição

tipo

Obrigatório

 

 

 

 

item

 

 

 

 

1-9835530

O ID filho do produto específico que está sendo visualizado. O ID de produto filho é preferencial, mas o ID pai também pode ser usado. No entanto, o uso do ID pai apresenta algumas limitações de funcionalidade.

 

 

 

 

String

 

 

 

 

Sim

preço

475

O preço atual do produto exibido

Decimal

Sim

 

availability

 

1

1 se o produto está em estoque e 0 se está fora de estoque

 

Boolean

 

Sim

 

Exemplo

05.png

Como rastrear páginas de carrinho de compras

Ao adicionar rastreadores às páginas de carrinho de compras, especifique na tag os parâmetros universais, bem como os seguintes parâmetros adicionais:

 

Evento

Parâmetro

Descrição

tipo

Obrigatório

 

viewBasket

 

item

Este é o evento que identifica o tipo de página

 

String

 

Sim

 

Uma tag totalmente preenchida para uma página de carrinho de compras teria a seguinte aparência:

 

 

Parâmetro

Valor de exemplo

Descrição

tipo

Obrigatório

 

 

 

 

item

 

 

{id: “productid123”, price: “100.00”, quantity: “4”}

 

A lista de IDs de produtos (do tipo) filho que são exibidos no carrinho. Adicione um novo elemento à matriz JSON para cada produto no carrinho. O preço contém o preço unitário do produto.

 

 

 

 

String

 

 

 

 

Sim

 

Exemplo

06.png

Como rastrear páginas de venda ou confirmação

A página de confirmação da venda é aquela exibida ao usuário após a conclusão da compra no site e normalmente tem o ID e um resumo do pedido. 

A Criteo OneTag deve ser integrada na página de confirmação da venda para rastrear os produtos comprados pelos seus usuários. Rastrear o que o usuário compra permite à Criteo fornecer relatórios de conversão a você. Especifique na tag os parâmetros universais, bem como os seguintes parâmetros adicionais:

 

Evento

Parâmetro

Descrição

tipo

Obrigatório

 

trackTransaction

 

id , item

Este é o evento que identifica o tipo de página

 

String

 

Sim

 

Aqui você encontrará os detalhes sobre os parâmetros específicos ao evento "trackTransaction":

Parâmetro

Valor de exemplo

Descrição

tipo

Obrigatório

 

id

 

97234735

O ID de transação ou pedido do seu sistema de e-commerce

 

String

 

Sim

 

 

item

{id: “productid123”, price: “100.00”, quantity: “4”}

A lista de IDs de produtos (do tipo) filho que são exibidos no carrinho. Adicione uma nova linha para cada item no carrinho.

 

 

String

 

 

Sim

 

Exemplo

Como rastrear eventos AddToCart

Um evento AddToCart (adicionar ao carrinho) contém os detalhes de um produto específico adicionado ao carrinho de um consumidor. A integração da Criteo OneTag em eventos AddToCart para varejistas BCE (bens de consumo embalados) é essencial para o processo de rastreamento. Especifique na tag os parâmetros universais, bem como os seguintes parâmetros adicionais:

 

Evento

Parâmetro

Descrição

tipo

Obrigatório

 

addToCart

item, price, quantity

Este é o evento que identifica o tipo de página

 

String

 

Sim

 

Aqui você encontrará os detalhes sobre os parâmetros específicos ao evento "addToCart":

 

Parâmetro

Valor de exemplo

Descrição

tipo

Obrigatório

 

 

 

 

item

 

 

 

 

1-9835530

O ID filho do produto específico que está sendo visualizado. O ID de produto filho é preferencial, mas o ID pai também pode ser usado. No entanto, o uso do ID pai apresenta algumas limitações de funcionalidade.

 

 

 

 

String

 

 

 

 

Sim

preço

12

O preço atual do produto exibido

Decimal

Sim

 

quantidade

 

3

O número desse item especificado que o consumidor adicionou ao carrinho

 

String

 

Sim

 

zipcode

 

10012

O CEP da loja em que o cliente está comprando

 

String

 

Sim

 

store_id

 

123456

O ID da loja em que o usuário está comprando o produto

 

String

 

Sim

 

 

Etapa 4: Como solicitar anúncios no seu site

Como solicitar anúncios na página inicial

Para adicionar anúncios à página inicial, basta especificar os parâmetros universais.

Parâmetro

Valor de exemplo

Descrição

tipo

Obrigatório

 

 

account

 

 

51511

A chave que corresponde ao seu ID de cliente específico que é criado pela equipe de suporte técnico.

 

 

String

 

 

Sim

 

page-id

 

HomePageDemo

O ID da página no sistema Criteo

 

String

 

Sim

 

 

customer-id

 

324fdbb21e3344beb2078413 cea04a06

O id do usuário autenticado que é consistente durante todas as sessões

 

 

String

 

 

Sim

 

 

retailer-visitor-id

 

53e20ea700424f7bbdd7 93b02abcb5d7

Um userId exclusivo e não autenticado consistente durante todas as sessões no mesmo dispositivo

 

 

String

 

 

Sim

 

 

device-id

 

3e0a83febcf74ba6a08e 684534100773

Isso é necessário para tags em apps e sites mobile. Representa o ID do dispositivo do usuário.

 

 

String

 

 

Não

 

 

 

 

json

 

 

 

 

hljson

 

Transforma a solicitação da Criteo em JSONP, permitindo à Criteo solicitar dados de um servidor que reside em um domínio diferente daquele do cliente.

 

 

 

 

String

 

 

 

 

Sim

 

Exemplo

 

 

Como solicitar anúncios nas páginas de listas de categorias

Independentemente de a página aceitar listas de categorias e pesquisas por palavra-chave, ou mostrar uma coleção personalizada de produtos, os parâmetros a seguir são relevantes.

 

Parâmetro

Valor de exemplo

Descrição

tipo

Obrigatório

 

 

account

 

 

51511

 

A chave que corresponde ao seu ID de cliente específico que é criado pela equipe de suporte técnico.

 

 

String

 

 

Sim

 

page-id

 

BrowsePageDemo

O ID da página no sistema Criteo

 

String

 

Sim

 

 

 

Categoria

 

 

 

Eletrônicos Áudio Fones de ouvido

A categoria ou taxonomia da página em que o usuário está navegando. Esse valor deve ser igual aos valores de taxonomia que são enviados no feed do catálogo para a Criteo.

 

 

 

String

 

 

 

Sim

 

customer-id

324fdbb21e3344beb2078413cea 04a06

O ID do usuário autenticado que é consistente durante todas as sessões.

 

String

 

Sim

 

 

retailer-visitor-id

 

53e20ea700424f7bbdd7 93b02abcb5d7

Um ID de usuário exclusivo e não autenticado consistente durante todas as sessões no mesmo dispositivo.

 

 

String

 

 

Sim

 

 

device-id

 

3e0a83febcf74ba6a08e 684534100773

Necessário para apps mobile (por exemplo, para iOS ou Android). Representa o ID do dispositivo do usuário.

 

 

String

 

 

Não

 

 

filters

 

 

'color,eq,blue)

Estes são todos os filtros aplicados na página os quais você deseja utilizar para mostrar o anúncio. Consulte a seção "Filtros" a seguir para mais detalhes.

 

 

String

 

 

Não

 

list-size

 

24

Representa o número total de resultados orgânicos na página de lista.

 

String

 

Sim

 

 

page-number

 

 

1

Se você dá suporte à paginação, esse valor representa o número da página. No caso de uma única página sem fim, esse valor deve ser definido como 1.

 

 

String

 

 

Sim

 

 

item

 

 

123%7( 456%7(7 89

A lista de skus que são organicamente mostradas na grade da página. Trata-se dos ids de skus que devem ser passados com um máximo de 100 itens. 

 

 

String

 

 

Sim

 

sort

 

price asc

Classificação definida pelo usuário na página. Se nenhuma classificação for usada, esse valor poderá ser deixado vazio ou como "default" (padrão).

 

String

 

Sim

 

 

 

 

lison

 

 

 

hljson

 

Transforma a solicitação da Criteo em JSONP, permitindo à Criteo solicitar dados de um servidor que reside em um domínio diferente daquele do cliente.

 

 

 

String

 

 

 

Sim

 

 Exemplo

*Nota: o delimitador pipe (|) deve ser passado com a codificação da URL como %7C

 

Filtros

Quando o usuário filtra uma lista de produtos por filtro ou faceta individual, ou por vários filtros, eles podem ser incluídos como filtros. Três filtros específicos são palavras reservadas para a Criteo, que vai mapeá-las explicitamente nos campos de dados do feed de produtos: “brand” (marca), “price” (preço) e “rating” (classificação). Todos os outros filtros podem ser usados com flexibilidade. 

Um filtro totalmente qualificado consiste em três propriedades:

  • Filter Name: nome do filtro
  • Operator: o operador
  • Value: o valor pode ser uma lista de valores dependendo do caso. Por exemplo, se você usar o operador ‘in’, poderá especificar uma lista de valores delimitados por vírgulas.

 

A Criteo dá suporte à seguinte lista de operadores:

 

Operator: o operador

Descrição

eq

Igual a

gt

Maior que

lt

Menor que

ge

Maior ou igual a

le

Menor ou igual a

in

Associação em uma lista

 

Por exemplo, um usuário aplica os filtros cor=blue, marca 'sony', 'hp' ou 'dell' e preço entre 10 e 100 dólares. Os filtros seriam os seguintes: filtros=(color,eq,blue),(brand,eq,sony,hp,dell),(price,gt,10),(price,lt,100)

Veja a seguir um exemplo de uma chamada totalmente qualificada à API com filtros:

Exemplo:

 

 

Como solicitar anúncios nas páginas de listas de pesquisa

Independentemente de a página aceitar listas de categorias e pesquisas por palavra-chave, ou mostrar uma coleção personalizada de produtos, os parâmetros a seguir são relevantes.

 

Veja a seguir um exemplo de uma chamada totalmente qualificada de serviço web à API para uma página de lista.

Exemplo

*Nota: o delimitador pipe (|) deve ser passado com a codificação da URL como %7C

Filtros

Quando o usuário filtra uma lista de produtos por filtro ou faceta individual, ou por vários filtros, eles podem ser incluídos como filtros. Três filtros específicos são palavras reservadas para a Criteo, que vai mapeá-las explicitamente nos campos de dados do feed de produtos: “brand” (marca), “price” (preço) e “rating” (classificação). Todos os outros filtros podem ser usados com flexibilidade.

Um filtro totalmente qualificado consiste em três propriedades:

  1. Filter Name: nome do filtro
  2. Operator: o operador
  3. Value: o valor pode ser uma lista de valores dependendo do caso. Por exemplo, se você usar o operador ‘in’, poderá especificar uma lista de valores delimitados por vírgulas.

A Criteo dá suporte à seguinte lista de operadores: 

Operator: o operador

Descrição

eq

Igual a

gt

Maior que

lt

Menor que

ge

Maior ou igual a

 

le

Menor ou igual a

in

Associação em uma lista

 

Por exemplo, um usuário aplica os filtros cor=blue, marca 'sony', 'hp' ou 'dell' e preço entre 10 e 100 dólares. Os filtros seriam os seguintes: filtros=(color,eq,blue),(brand,eq,sony,hp,dell),(price,gt,10),(price,lt,100)

Exemplo

Como solicitar anúncios nas páginas de detalhes do produto

Os seguintes parâmetros devem ser observados ao rastrear uma página de detalhes do produto ou qualquer outra página específica a um produto:

 

 

Como adicionar um posicionamento de anúncio

Em qualquer página com rastreadores da Criteo, você pode adicionar um posicionamento de anúncio. Basta incluir um divmarker para indicar onde a unidade de anúncio deverá ser renderizada na página.

 

O nome desse <div> deve ser adicionado exatamente como fornecido pelo seu Engenheiro de Soluções Técnicas.

 

Apêndice A: Perguntas Frequentes

P. Meu site é responsivo. Preciso de tags separadas para a versão mobile do site?

Para todos os sites responsivos, o seu Engenheiro de Soluções Técnicas da Criteo registrará suas páginas e posicionamentos com uma plataforma do tipo "mista". Você só deverá especificar "mobile" se o site tiver uma versão mobile otimizada separadamente que não seja responsiva. Você deverá informar isso ao Engenheiro de Soluções Técnicas da Criteo para garantir o registro adequado.

 

P. Meu site aceita várias moedas. Como eu defino a moeda de compra?

Uma moeda só deverá ser especificada no carrinho e nas páginas de confirmação do pedido/transação se o usuário tiver selecionado outra moeda que não a sua moeda padrão. Se você não tiver certeza da sua moeda padrão no sistema Criteo, consulte o seu Engenheiro de Soluções Técnicas da Criteo. A função de moeda é uma subfunção das funções viewBasket ou trackTransation. Um exemplo de cada função é fornecido a seguir para referência. O código de moeda usado deve corresponder ao padrão ISO 4217.

http://www.hlserve.com/delivery/v2/api/page?account=51511&page- id=ListingPageDemo&customer-id=324fdbb21e3344beb2078413cea04a06&retailer-visitor- id=53e20ea700424f7bbdd793b02abcb5d7&list-size=20&page- number=1&ampitem=123%7C456%7C789&category=45879&sort=price_asc&json=hlson 

Ver exemplo de carrinho de compras

 

 

Exemplo de rastrear transação/confirmação do pedido

 

 

Apêndice B: Registro de página e posicionamento

Sua equipe de Soluções Técnicas da Criteo registrará as páginas e os posicionamentos no seu nome e dará a você um ID de posicionamento registrado para usar nas suas tags div para solicitações de anúncio.

Veja a seguir os campos de entrada que a Criteo usa para registrar as suas páginas.

Parâmetro

Descrição

Event Name

O ID definido pelo Engenheiro de Soluções Técnicas conforme o tipo de página.

Page Type

Classificação de página padrão

Classificações não padrão (trabalhe com o seu Engenheiro de Soluções Técnicas para obter orientação sobre essas páginas)

•     Página inicial (a landing page do seu site)

•     Página de pesquisa (qualquer página que inclua um termo de pesquisa do usuário)

•     Página de Lista (qualquer página que inclua uma categoria e uma grade de produtos)

•     Página de detalhes do produto (qualquer página que contenha os detalhes de determinado produto)

•     Página de carrinho/checkout (inclui da visualização do carrinho ao pagamento, não incluindo a configuração do pedido)

•     Página de confirmação do pedido (a página de confirmação final do pedido)

•     Página de tópico (qualquer página que contenha um conjunto selecionado de SKUs, como um destino de SEO ou um destino de link de campanha)

•     Página de merchandising (Ocorre como resultado da navegação por taxonomia ou filtro, mas não inclui uma lista de produtos (lista ou grade) na página.

•     Página de registro/lista de desejos

•     Outra página de varejo

•     Página de transação

Plataforma

Selecione a plataforma em que a página é mostrada

Desktop

App mobile

Mista (site responsivo)

 

Um ID de página registrada será criado no sistema. Para todas as integrações JavaScript da Criteo OneTag, o builder de tags usará esse ID para identificar uma página.

Exemplo:

Event Name

viewHome

Page Type

Página inicial

Plataforma

Mista

 

Depois que uma página é registrada, o seu Engenheiro de Soluções Técnicas da Criteo configurará os posicionamentos em que os anúncios patrocinados serão mostrados no seu site. Veja a seguir informações para registrar posicionamentos de anúncio.

Parâmetro

Descrição

Event Name

O ID definido pelo Engenheiro de Soluções Técnicas conforme o tipo de página.

ID de Posicionamento

O ID definido pelo Engenheiro de Soluções Técnicas conforme o tipo de conteúdo exibido na página.

Page Type

Classificação de página padrão

Classificações não padrão (trabalhe com o seu Engenheiro de Soluções Técnicas para obter orientação sobre essas páginas)

•     Página inicial (a landing page do seu site)

•     Página de pesquisa (qualquer página que inclua um termo de pesquisa do usuário)

•     Página de Lista (qualquer página que inclua uma categoria e uma grade de produtos)

•     Página de detalhes do produto (qualquer página que contenha os detalhes de determinado produto)

•     Página de carrinho/checkout (inclui da visualização do carrinho ao pagamento, não incluindo a configuração do pedido)

•     Página de confirmação do pedido (a página de confirmação final do pedido)

•     Página de tópico (qualquer página que contenha um conjunto selecionado de SKUs, como um destino de SEO ou um destino de link de campanha)

•     Página de merchandising (Ocorre como resultado da navegação por taxonomia ou filtro, mas não inclui uma lista de produtos (lista ou grade) na página.

•     Página de registro/lista de desejos

•     Outra página de varejo

•     Página de transação

Plataforma

Selecione a plataforma em que a página é mostrada Desktop

App mobile

Mista (site responsivo)

Posicionamento - horizontal

O posicionamento horizontal dos anúncios renderizados na página. Possíveis posicionamentos: esquerda, centro, direita.

Posicionamento - vertical

O posicionamento vertical dos anúncios renderizados na página. Possíveis posicionamentos: superior, centro, inferior.

Posicionamento - grade

Se os anúncios serão renderizados dentro da grade orgânica de produtos ou fora da grade.

Tamanho

A largura e altura do anúncio.

Conteúdo - segmentação

A relevância dos anúncios retornados em relação ao contexto recebido.

Máx. de anúncios

O número máximo de anúncios para exibição. Se o sistema Criteo tiver mais anúncios disponíveis, eles não serão renderizados na página.

Mín. de anúncios

O número mínimo de anúncios para exibição. A Criteo deve ter, pelo menos, o número de anúncios especificado para renderização na página. Caso contrário, o div especificado para os anúncios da Criteo será recolhido.

 

Depois que os posicionamentos forem configurados, o Engenheiro de Soluções Técnicas da Criteo compartilhará o ID de posicionamento.

Exemplo:

ID da página:

viewHome

ID de Posicionamento

viewHome-viewHomeAds

Posicionamento - horizontal

Inferior

Posicionamento - vertical

Centro

Posicionamento - grade:

Fora da grade

Tamanho:

300x150

Conteúdo - segmentação

Run-of-Site

Máx. de anúncios

15

Mín. de anúncios

5

 

Apêndice C: Integração Criteo Brand Spotlight

O Criteo Brand Spotlight corresponde à função Headline Search da Amazon. Ele permite aos anunciantes acessar inventários premium exclusivos para promover suas marcas. Esses posicionamentos oferecem um mix de conteúdos nativos e elementos de branding, pois permitem aos anunciantes exibir o logotipo e a tagline que acompanham os produtos patrocinados.

Se você estiver adicionando um inventário BrandSpotlight a uma página que não tem tag, você utilizará as tags de lista documentadas acima, que poderão ser adicionadas a qualquer página no seu site. Se você já tiver tags na página, será fácil adicionar um posicionamento Brand Spotlight. 

Exemplo

O "placement-id" é configurado pelo seu Engenheiro de Soluções Técnicas, como documentado no Apêndice B. Caberá a ele configurar um BrandSpotlight PlacementID específico para você. Você precisará adicionar um <div id> à página em que o posicionamento Brand Spotlight será renderizado. 

Apêndice D: Brand Store 360

Para usar a tecnologia Brand Store 360 na sua conta, entre em contato com o seu Engenheiro de Soluções Técnicas da Criteo, que poderá habilitar esse recurso de relatório para você. Depois que a sua conta estiver habilitada, o Engenheiro de Soluções Técnicas da Criteo poderá fornecer suporte técnico, se necessário.

Os mesmos requisitos de tags existem para integrações do Brand Store 360, conforme listado nos detalhes de tags acima. No entanto, há uma nova função que deve ser adicionada à Criteo OneTag em cada página do site da sua marca.



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