La variable purchase-details proporciona información sobre los productos vendidos en una transacción determinada. Puede añadir la variable a un fragmento de evento de Floodlight, a una etiqueta de Floodlight, a la capa de datos de Google Tag Manager o a una macro de Google Tag Manager.
Dependiendo de cómo añada la variable, use uno de los siguientes formatos:
-
Si utiliza la etiqueta de Google, aplique a la variable purchase-details el formato de un objeto JSON directamente en el fragmento de evento de Floodlight.
- Si utiliza una etiqueta iframe o una etiqueta de imagen de Floodlight, o si transfiere los datos a Google Tag Manager como una macro, aplique a la variable purchase-details el formato de una cadena dividida en un conjunto de campos.
-
Si pretende transferir los datos a la capa de datos de Google Tag Manager, dé a la variable el formato de un objeto JSON con campos purchase-detail.
Requisitos del formato JSON en un fragmento de evento de Floodlight
Si usa la etiqueta de Google, deberá especificar los campos purchase-details en el fragmento de evento como una matriz items JSON, además de los campos country y language. Todos los elementos de la matriz contienen los siguientes campos:
idprice-
quantity
Por ejemplo:
<!--
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 -->
Nota: Los fragmentos de evento generados por Search Ads 360 incluyen una etiqueta opcional <noscript> que contiene una etiqueta de imagen de Floodlight. Esta etiqueta opcional se usa para registrar conversiones en los navegadores que no admiten JavaScript.
Requisitos del formato JSON en la capa de datos
Si usa Google Tag Manager, los campos purchase-detail deberán especificarse como elementos de una matriz ecommerce.purchase.products JSON:
'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.
}]
}
}'
Tenga en cuenta que los nombres de campo de este objeto JSON son diferentes del objeto JSON que usa si añade la variable purchase-details a un fragmento de evento de Floodlight.
Si envía detalles de compra a la capa de datos, en realidad estará almacenando los datos en el mismo objeto que Google Analytics puede usar para registrar los productos que se han comprado en su sitio web. Es decir, si usa Search Ads 360 y Google Analytics para registrar los detalles de las compras, su desarrollador web puede usar el mismo objeto para almacenar los datos de ambos productos de Google.
Requisitos del formato de cadena
En el formato de cadena, cada campo purchase-detail debe especificarse como un par clave-valor con el siguiente formato:
[ID de campo][índice]:[valor]
- [ID de campo] identifica el tipo de valor del que se informa.
- [índice] indica el producto de cuyo valor se informa.
- [valor] proporciona información sobre la venta de un producto determinado.
Separe cada campo con una | (barra vertical). Por ejemplo,
i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2
Campos purchase-detail
|
Campo |
ID en el formato de cadena |
Tipo |
Obligatorio |
Descripción |
|
|
|
Cadena |
Sí |
El ID del producto que se ha vendido. Dicho ID debe coincidir con el del producto de Google Merchant Center. |
|
|
|
Coma flotante |
Sí |
Precio por unidad del producto que se ha vendido. No incluya ningún símbolo de moneda. |
|
|
|
Número entero |
Sí |
La cantidad de unidades del producto que se ha vendido. |
|
|
|
No |
El país registrado en el feed de Merchant Center que contiene datos sobre el producto en cuestión. Este campo solo es necesario cuando los ID de producto no son únicos en diversos feeds de Merchant Center. Especifique el país una sola vez en cada producto (no es un campo repetido). Si no se especifica ningún valor en este campo, Search Ads 360 seleccionará un feed de Merchant Center que contenga el ID de producto y utilizará los atributos de ese feed en los parámetros relativos a la cantidad de productos vendidos. |
|
|
|
|
Cadena (código de idioma según ISO 639) |
No |
El idioma registrado en el feed de Merchant Center que contiene datos sobre el producto. Este campo solo es necesario cuando los ID de producto no son únicos en diversos feeds de Merchant Center. Si no se especifica ningún valor en este campo, Search Ads 360 seleccionará un feed de Merchant Center que contenga el ID de producto y utilizará los atributos de ese feed en los parámetros relativos a la cantidad de productos vendidos. |
Caracteres especiales y codificación de URL
Los : (dos puntos) y la | (barra vertical) se emplean como delimitadores de campos en el formato de cadena. Search Ads 360 no puede aceptar datos que incluyan estos caracteres como valores en un campo, incluso si utiliza uno de los formatos JSON.
Al igual que ocurre con todos los datos de Floodlight, tampoco se aceptan los siguientes caracteres:
;, <, > ni ?
Imagine una transacción que incluya los siguientes productos:
-
Producto 1
- Nombre: m-dress-orange-xl
- UPC: 123456755559
- Precio por producto: 19,99 $
- Cantidad: 1
-
Producto 2
- Nombre: m-polo-green-l
- UPC: 123456788889
- Precio por producto: 54 $
- Cantidad: 2
La variable purchase-details de un fragmento de evento contendría los siguientes campos:
'items': [
{ 'id': '123456755559',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456788889',
'price': '54.00',
'quantity': 2
}
]
A continuación, le mostramos cómo aparece la variable purchase-details en una etiqueta iframe de Floodlight:
i1:123456755559|p1:19.99|q1:1|i2:123456788889|p2:54.0|q2:2
Además de la variable purchase-details, la etiqueta de Floodlight o el fragmento de evento también especificaría los siguientes datos:
-
ID del grupo de actividades de Floodlight
-
ID de la actividad de Floodlight
-
ID de la transacción (ID de pedido)
-
Valor total de la transacción: 129,97 $ = (1 * 19,99 $ + 2 * 54 $)
-
Cantidad: 3 (puede definir el significado exacto de este campo; por ejemplo, para informar del tamaño total del carrito).
-
Cualquier otra variable personalizada de Floodlight
La etiqueta de Google final con el fragmento de evento tendría un aspecto similar a este:
<!--
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 -->
A continuación se muestra un ejemplo de la etiqueta iframe de Floodlight con una variable purchase-details:
Puede utilizar Merchant Center para enviar sus productos en varios feeds, cada uno segmentado a un país e idioma concretos. Por ejemplo, si vende el mismo grupo de productos en EE. UU. y Canadá, puede configurar un feed con precios y descripciones para EE. UU., otro con precios canadienses y descripciones en francés, y un tercero con precios canadienses y descripciones en inglés.
Si envía feeds con los mismos ID de productos, pero distintos países o idiomas de destino, tendrá que incluir el código de país y de idioma en la variable purchase-details. Por ejemplo, esta matriz items y los campos country y language del fragmento de evento registran una compra a partir del feed orientado a los canadienses franceses:
'items': [
{ 'id': '123456788889',
'price': '19.99',
'quantity': 1
},
{ 'id': '123456755559',
'price': '54.00',
'quantity': 2
}
],
'country': 'ca',
'language': 'fr'
Simplemente, asegúrese de usar los códigos de país e idioma de dos dígitos según la ISO.