A variável purchase-details dá informações sobre os produtos vendidos em uma determinada transação. Você pode adicionar essa variável a um snippet de evento ou a uma tag do Floodlight, à camada de dados ou a uma macro do Gerenciador de tags do Google.
Dependendo de como você adicionar a variável, use um dos seguintes formatos:
-
Se você usar a tag do Google, formate a variável "purchase-details" como um objeto JSON diretamente no snippet de evento do Floodlight.
- Se você usar uma tag de iframe ou de imagem do Floodlight ou transmitir dados ao Gerenciador de tags do Google como uma macro, formate a variável "purchase-details" como uma string dividida em um conjunto de campos.
-
Se você enviar as informações à camada de dados do Gerenciador de tags do Google, formate a variável como um objeto JSON com campos de detalhes da compra.
Requisitos para o formato JSON em snippets de evento do Floodlight
Se você usar a tag do Google, especifique os detalhes da compra no snippet de evento como uma matriz JSON items
, além dos campos country
e language
. Cada item da matriz inclui os seguintes campos:
id
price
-
quantity
Exemplo:
<!--
Event snippet for Thank You on http://www.example.com/thanks: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 11/01/2017
-->
<script>
gtag('event', 'purchase',
{
'allow_custom_scripts': true,
'send_to': 'DC-1234567/group1/thank123+transactions',
'transaction_id': '012345',
'value': 129.97,
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
],
'country': 'us',
'language': 'en'
}
);
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=1234567;type=group1;cat=thank123;
qty=1;cost=129.97;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;npa=;
ord=012345;prd=i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2|c:us|l:en?" width="1" height="1" alt="">
</noscript>
<!-- End of event snippet: Please do not remove -->
Observação: Os snippets de evento gerados pelo Search Ads 360 incluem uma tag <noscript>
opcional com uma tag de imagem do Floodlight. Ela é usada para registrar conversões em navegadores incompatíveis com JavaScript.
Requisitos para o formato JSON na camada de dados
Se você usa o Gerenciador de tags do Google, os campos de detalhes da compra precisam ser especificados como elementos em uma matriz JSON ecommerce.purchase.products
:
'ecommerce':{
'purchase':{
'products': [{
'id': 'String',
'price': 'Floating point',
'quantity': Integer,
'country': 'String', // Optional
'language': 'String', // Optional
'accountId': 'String' // Optional
},
{
… // Each SKU (product) in the transaction
// is in its own array item.
}]
}
}'
Os nomes dos campos desse objeto JSON são diferentes daqueles do objeto usado quando a variável "purchase-details" é adicionada a um snippet de evento do Floodlight.
Se você enviar os dados da compra à camada de dados, essas informações serão armazenadas no mesmo objeto usado pelo Google Analytics para gerar relatórios sobre os produtos comprados no seu site. Isso significa que, ao utilizar o Search Ads 360 e o Google Analytics no registro de dados da compra, o desenvolvedor da Web poderá usar o mesmo objeto para armazenar informações dos dois produtos.
Requisitos para o formato "String"
No formato "String", cada campo de detalhes da compra deve ser especificado como um par de chave-valor no seguinte formato:
[ID do campo][índice]:[valor]
- [ID do campo] identifica o tipo de valor informado.
- [índice] indica o item cujo valor é relatado.
- [valor] fornece informações sobre a venda do produto.
Separe cada campo com uma | (barra vertical). Exemplo:
i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2
Campos de detalhes da compra
Campo |
Código no formato "String" |
Tipo |
Obrigatório |
Descrição |
|
|
Sequência |
Sim |
O código do produto que foi vendido. Ele deve corresponder ao código de item do Google Merchant Center. |
|
|
Ponto flutuante |
Sim |
Preço por unidade de produto que foi vendido. Não inclui um símbolo de moeda. |
|
|
Número inteiro |
Sim |
A quantidade de unidades do produto que foi vendido. |
|
|
String (código de país ISO 3166) |
Não |
O país registrado no feed do Google Merchant Center que contém dados sobre o produto. Esse campo será necessário apenas quando os códigos de itens não forem exclusivos em vários feeds do Merchant Center. Especifique o país uma só vez para cada produto (não é um campo repetido). Se o campo não for especificado, o Search Ads 360 vai escolher um feed do Google Merchant Center que contenha o ID do produto e use os atributos desse feed para as dimensões de produtos vendidos. |
|
|
String (código de país ISO 639) |
Não |
O idioma registrado no feed do Google Merchant Center que contém dados sobre o produto. Esse campo será necessário apenas quando os códigos de itens não forem exclusivos em vários feeds do Merchant Center. Se o campo não for especificado, o Search Ads 360 vai escolher um feed do Google Merchant Center que contenha o ID do produto e use os atributos desse feed para as dimensões de produtos vendidos. |
Caracteres especiais e codificação de URLs
Os símbolos :
(dois-pontos) e |
(barra vertical) são usados como delimitadores de campo no formato String. O Search Ads 360 não aceita dados que incluem esses caracteres como valores em um campo, mesmo que você use um dos formatos JSON.
Assim como em todos os dados do Floodlight, os caracteres a seguir não são aceitos:
;
, <
, >
, ?
Digamos que uma transação inclua os seguintes itens:
-
Item 1
- Nome: m-dress-orange-xl
- UPC: 123456755559
- Preço por item: US$ 19,99
- Quantidade: 1
-
Item 2
- Nome: m-polo-green-l
- UPC: 123456788889
- Preço por item: US$ 54
- Quantidade: 2
A variável "purchase-details" em um snippet de evento incluiria os seguintes campos:
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
]
Confira como a variável "purchase-details" aparece em uma tag de iframe do Floodlight:
i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2
Além da variável de "purchase details", a tag ou o snippet de evento do Floodlight também especificaria os seguintes dados:
-
código do grupo de atividades do Floodlight
-
código da atividade do Floodlight
-
código da transação (código do pedido)
-
valor total da transação: US$ 129,97 = (1*US$ 19,99 + 2*US$ 54)
-
quantidade: 3. É possível definir o significado exato desse campo. Considere usá-lo para informar sobre o tamanho total do carrinho.
-
Outras variáveis personalizadas do Floodlight
A tag do Google com o snippet de evento seria assim:
<!--
Start of global snippet: Please do not remove
Place this snippet between the <head> and </head> tags on every page of your site.
-->
<!-- Google Tag (gtag.js) - DoubleClick -->
<script async src="https://www.googletagmanager.com/gtag/js?id=DC-1234567"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments)};
gtag('js', new Date());
gtag('config', 'DC-1234567');
</script>
<!-- End of global snippet: Please do not remove -->
<!--
Event snippet for Thank You on http://www.example.com/thanks: Please do not remove.
Place this snippet on pages with events you’re tracking.
Creation date: 11/01/2017
-->
<script>
gtag('event', 'purchase',
{
'allow_custom_scripts': true,
'send_to': 'DC-1234567/group1/thank123+transactions',
'transaction_id': '012345',
'value': 129.97,
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
],
'country': 'us',
'language': 'en'
}
);
</script>
<noscript>
<img src="https://ad.doubleclick.net/ddm/activity/src=1234567;type=group1;cat=thank123;
qty=1;cost=129.97;dc_lat=;dc_rdid=;tag_for_child_directed_treatment=;tfua=;npa=;
ord=012345;prd=i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2|c:us|l:en?" width="1" height="1" alt="">
</noscript>
<!-- End of event snippet: Please do not remove -->
Confira o exemplo de uma tag de iframe do Floodlight com a variável "purchase-details":
É possível usar o Merchant Center para enviar seus produtos em vários feeds, cada um segmentado para um idioma e um país específico. Por exemplo, ao vender o mesmo grupo de produtos nos EUA e no Canadá, será possível configurar um feed com preços e descrições para os EUA, outro com preços do Canadá e descrições em francês e um terceiro com preços do Canadá e descrições em inglês.
Ao enviar feeds com os mesmos IDs de produtos, mas com diferentes idiomas ou países de segmentação, você precisa incluir o código de idioma e de país na variável "purchase-details". Por exemplo, esta matriz items
e os campos country
e language
no snippet de evento registram uma compra do feed segmentado para franco-canadenses:
'items': [
{ 'id': '123456788889',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456755559',
'price': '54.00',
'quantity': 2
}
],
'country': 'ca',
'language': 'fr'
Use os códigos ISO de dois dígitos do país e do idioma.