Integración a través del código de seguimiento mediante Google Tag Manager

Actualización 27 de septiembre de 2023 19:51

La integración es el proceso mediante el que se configura el envío de los datos sobre las acciones de conversión en tu sitio web al sistema de Admitad.

La acción de conversión puede ser una compra, un registro, una solicitud completada u otra acción que necesites, realizada por un usuario que ha sido llevado a tu sitio web por un publisher de Admitad.

Información general: características y recomendaciones

Solo podrás iniciar la integración si en tu programa:

ya se ha generado un enlace de seguimiento en la sección Configuración general;
ya se ha añadido una acción de conversión y se ha configurado la tarifa correspondiente en la sección "Acciones".

Si no tienes gestor, tienes que formar el enlace de seguimiento tú mismo (guía), y añadir al menos una acción y una tarifa (guía).
Si tienes un gestor personal, él/ella hará todos estos ajustes por ti.

La integración es una fase obligatoria para que puedas continuar con tu trabajo. Sin llevarla a cabo, es imposible poner en marcha un programa de afiliación en Admitad.
Para acelerar la integración, te recomendamos que involucres a tu propio especialista y le des estas instrucciones.

Una vez finalizada la integración, todos los datos sobre las acciones de conversión, como fecha de la acción, ID e importe del pedido, etc., se enviarán automáticamente a Admitad.

Qué es el código de seguimiento y cómo funciona a través de Google Tag Manager

El código de seguimiento es un código JavaScript que permite registrar las acciones de conversión realizadas por los usuarios en tu sitio web y transferir los datos correspondientes al servidor de Admitad.

Como parte de la integración a través del código de seguimiento mediante Google Tag Manager, el código de integración se coloca en un archivo especial de este servicio, y no en tu sitio web.
Dado que Google Tag Manager no es un producto de Admitad y puede ser bloqueado por las extensiones del navegador, te recomendamos instalar el código de seguimiento directamente en tu sitio web siguiendo estas instrucciones.

Cómo funciona: cuando el usuario realiza una acción de conversión en tu sitio web, en el servicio de Google Tag Manager se activa un código de seguimiento. En este momento, al servidor de Admitad se envía una solicitud GET con la información sobre la acción de conversión ( el número de pedido, el importe del pedido, la moneda de pago y otros datos).

Como resultado, la información recibida se registra y se muestra en la sección Estadísticas de la cuenta de Admitad.

Cómo se lleva a cabo la integración a través del código de seguimiento mediante Google Tag Manager

Para integrar tu sitio web a través de un código de seguimiento mediante Google Tag Manager (GTM), sigue estos pasos ( más abajo encontrarás las instrucciones para cada uno de ellos):

realiza los ajustes previos;
instala el código de seguimiento en GTM;
si es necesario, usa ajustes y herramientas adicionales:

seguimiento para un sitio web con formulario de pedido de un solo clic;
transferencia de códigos promocionales Take&Go;
transferencia del Id de usuario único como parte del seguimiento entre dispositivos.

publica etiquetas GTM con código de seguimiento en tu sitio web;
testea la integración personalizada.

Cómo configurar el código de seguimiento mediante GTM

Antes de instalar el código de seguimiento, asegúrate de que GTM (https://tagmanager.google.com/) está configurado y listo para usarse:

te has registrado, has configurado la cuenta y has instalado el gestor de etiquetas GTM (instrucciones);
has configurado las variables del nivel (DataLayer) para transmitir la información sobre las acciones de conversión (instrucciones);
has iniciado el nivel de datos (DataLayer) en la página Gracias por tu compra (instrucciones).

Echa un vistazo al siguiente ejemplo para ver si este método de integración te funciona.

El ejemplo utiliza el formato avanzado de Google Analytics ecommerce.

<script>
   window.dataLayer = window.dataLayer || [];
   dataLayer.push({
       "transactionId": "sk1006",   // número de pedido interno (máx. 100 caracteres)
       "transactionAction": "1",    // código de acción de conversión ( se determina durante la integración)
       "transactionProducts": [{
           "sku": "1354471145550",  // código interno del producto (máx. 100 caracteres)
           "tariff": "2",           // código de la tarifa ( se determina durante la integración)
           "price": "300.00",       // precio del producto
           "priceCurrency": "EUR",  // código de la moneda ISO-4217 alfa-3
           "quantity": "2"         // cantidad de producto
       }, {
           "sku": "1354471047246",
           "tariff": "2",
           "price": "500.00",
           "priceCurrency": "USD",
           "quantity": "1"
       }]
   });
</script>

Cómo colocar el código de seguimiento en GTM

El código de seguimiento se divide, básicamente, en dos partes: la primera se encarga de marcar el tráfico según el modelo de atribución Last Paid Click que los publishers de Admitad han llevado a tu sitio. La segunda es responsable directamente de enviar los datos del pedido al servidor de Admitad.

Estas partes se colocan en las dos etiquetas:

TagTag common contiene la primera parte del código de seguimiento y se ejecuta en todas las páginas del sitio web, excepto en la página de Gracias por tu compra.
TagTag conversion incluye las dos partes del código de seguimiento y se coloca en la página de Gracias por tu compra.

Para integrar tu sitio web a través del código de seguimiento mediante GTM, tienes que configurar:

desencadenantes para las etiquetas;
variables apropiadas;
etiquetas.

Después de hacerlo, podrás publicar los cambios realizados.

Configuración de los desencadenantes

Para configurar los desencadenantes:

1. En la página principal de GTM, selecciona Triggers en el menú lateral y haz clic en New en la página que se abre.

2. En la esquina superior derecha, haz clic en y selecciona el tipo de desencadenante: en el bloque Page View, haz clic en DOM Ready.

3. Elige la opción Some DOM Ready Events.

Define el atributo de la página Gracias por tu compra y especifica las siguientes condiciones para activar el desencadenante:

Page URL;
contains;
thank_you —una indicación orientativa del atributo, puedes usar tu propia opción.

En el ejemplo de la captura de pantalla, el atributo de la página Gracias por tu compra es la existencia de la sublínea de thank_you en la URL. Define un atributo adecuado para que el desencadenante se active en la página Gracias por tu compra de tu sitio web.

4. En la esquina superior izquierda de la ventana, indica el nombre del desencadenante: TagTag conversion. Después, guarda los cambios.

5. Luego, crea otro desencadenante: haz clic en New en la esquina superior derecha → → DOM Ready → Some DOM Ready Events.

6. Indica las siguientes condiciones para activar el desencadenante: todas las páginas menos la página de Gracias por tu compra:

Page URL;
does not contain
thank_you — una indicación orientativa del atributo, puedes usar tu propia opción
Ten en cuenta: usa el mismo valor que has usado al configurar el desencadenante de TagTag conversion.

7. En la esquina superior izquierda de la ventana, indica el nombre del desencadenante: TagTag common. Después, guarda los cambios.

Deberías conseguir esta lista de desencadenantes:

TagTag common;
TagTag conversion.

Para mayor comodidad, los desencadenantes tienen los mismos nombres que las etiquetas para las que se crean.

Configuración de variables en GTM

Antes de empezar a configurar las etiquetas, añade las variables para pasar la información del pedido.

Si ya tienes añadidas las variables, asegúrate de que tienes configuradas todas las variables necesarias. Para hacerlo, ve a la lista de variables recomendadas.

Para añadir las variables:

1. En la página principal de GTM, en el menú lateral, elige Variables y en la página que se abre, haz clic en New en el bloque User-Defined Variables.

2. En la esquina superior derecha, haz clic en y elige el tipo de variables: en el bloque Page Variables, haz clic en Data Layer Variable.

3. Añade las variables en función de la categoría de tu programa de afiliación y de las condiciones de la colaboración.

El número y contenido de las variables que tienes que añadir depende de la serie de datos necesarios para la transmisión a través del código de seguimiento.

Más abajo encontrarás las series de variables recomendadas.

Variable en el código de seguimiento	Función de la variable
ADMITAD.Invoice.category	Código de la acción. Ejemplo: código 1 — para el pedido de un usuario existente; código 2 — para el pedido de un nuevo usuario.
positions	Serie de datos con información sobre los productos del pedido: ID del producto, precio, moneda, cantidad de productos en el pedido.
orderNumber	Número de pedido.

Variable en el código de seguimiento	Función de la variable
positions	Serie de datos con información sobre los productos del pedido: ID del producto, precio, moneda, cantidad de productos en el pedido.
orderNumber	Número de pedido.

El esquema simplificado significa una configuración única de transferencia de datos a través de dataLayer con el importe total y el número de pedido sin otros detalles sobre su contenido.

Variable en el código de seguimiento Función de la variable

price Importe del pedido.

orderNumber Número de pedido.

Variable en el código de seguimiento	Función de la variable
orderNumber	Número de pedido.
ADMITAD.Invoice.category (acción)	Código de la acción. Ejemplo: código 1 — solicitud de préstamo de un cliente existente; código 2 — solicitud de préstamo de un cliente nuevo.
category	Código de la tarifa. Ejemplo: código 1 — la solicitud es inferior a 100$; código 2 — la solicitud es superior a 100$.

Si tu sitio web tiene un formulario de pedido de un solo clic, asegúrate de haber realizado todos los ajustes necesarios para este tipo de sitio. Más información

Variable en el código de seguimiento Función de la variable

price Precio del producto.

orderNumber Número de pedido.

productID ID del producto.

Para saber más sobre estas herramientas adicionales, consulta este apartado.

Variable en el código de seguimiento	Función de la variable
discountCode	Código de descuento único aplicado por el usuario (para los códigos de descuento Take&Go).
ADMITAD.Invoice.accountId	El identificador único del usuario para el seguimiento entre dispositivos. Por ejemplo, user_id en tu sistema.

Para añadir una variable:

En la página que se abre, rellena los campos:

Data Layer Variable Name (1) — especifica la variable de DataLayer que va a pasar el valor;
Data Layer Version (2) — elige el valor Versión 2;
Untitled Variable (3) — especifica el nombre que quieres para la variable en DataLayer.

Después, haz clic en Save.

Añade todas las variables recomendadas para tu programa o para el entorno de colaboración.

Personalización de las etiquetas

Para configurar las etiquetas TagTag comunes y TagTag conversion:

1. En la página principal, elige Tags en el menú lateral. Después, en la página que se abre, haz clic en New.

2. Indica el nombre de la etiqueta: TagTag common, y en el bloque Tag Configuration de la esquina superior derecha, haz clic en .

3. Luego, elige el tipo de etiqueta: en el bloque Custom, haz clic en Custom HTML.

4. Pega el código siguiente en la ventana que se abre.
Ten en cuenta los comentarios en los ejemplos del código. Los comentarios se añaden después de //.

Asegúrate de sustituir el valor {your_campaign_code} del código por el valor del parámetro campaign_code. Conseguirás el siguiente parámetro: campaign_code=a1b2c3d4e5, en el que la parte resaltada es el número único de tu programa de afiliación. Cómo encontrar el valor del parámetro campaign_code

<script src="https://www.artfut.com/static/tagtag.min.js?campaign_code={your_campaign_code}" async></script>
<script type="text/javascript">
// nombre de la cookie que almacena la fuente
// cámbialo si tienes otro nombre
var cookie_name = 'deduplication_cookie';
// tiempo de vida de la cookie
var days_to_store = 90;
// valor previsto de deduplication_cookie para Admitad
var deduplication_cookie_value = 'admitad';
// nombre del parámetro GET para la deduplicación
// cámbialo si tienes otro nombre
var channel_name = 'utm_source';
// la función para recibir la fuente del parámetro GET
getSourceParamFromUri = function() {
  var pattern = channel_name + '=([^&]+)';
  var re = new RegExp(pattern);
  return (re.exec(document.location.search) || [])[1] || '';
};
// la función para recibir la fuente de la cookie llamada cookie_name
getSourceCookie = function () {
  var matches = document.cookie.match(new RegExp(
    '(?:^|; )' + cookie_name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1') + '=([^;]*)'
  ));
  return matches ? decodeURIComponent(matches[1]) : undefined;
};
// la función para definir la fuente en la cookie llamada cookie_name
setSourceCookie = function () {
  var param = getSourceParamFromUri();
  var params = (new URL(document.location)).searchParams;
  if (!params.get(channel_name) && params.get('gclid')) { param = 'advAutoMarkup' }
  else if (!params.get(channel_name) && params.get('fbclid')) { param = 'facebook' }
  else if (!param) { return; }
  var period = days_to_store * 60 * 60 * 24 * 1000; // en segundos
  var expiresDate = new Date((period) + +new Date);
  var cookieString = cookie_name + '=' + param + '; path=/; expires=' + expiresDate.toGMTString();
  document.cookie = cookieString;
  document.cookie = cookieString + '; domain=.' + location.host;
};
// fijar la cookie
setSourceCookie();
</script>

5. Haz clic en el bloque Triggering que aparece más abajo en la misma página y elige el desencadenante de activación TagTag common.

Después, haz clic en Save.

6. Después, añade la segunda etiqueta: en la sección Tags, haz clic en New e indica el nombre TagTag conversion.

7. En el bloque Tag Configuration en la esquina superior derecha, haz clic en y elige el tipo de etiqueta — en el bloque Custom, haz clic en Custom HTML.

8. En la ventana que se abre, pega una de las versiones de código que aparecen abajo.

<script src="https://www.artfut.com/static/tagtag.min.js?campaign_code={your_campaign_code}" async></script>
<script type="text/javascript">
// nombre de la cookie que almacena la fuente
// cámbialo si tienes otro nombre
var cookie_name = 'deduplication_cookie';
// tiempo de vida de la cookie
var days_to_store = 90;
// valor esperado de deduplication_cookie para Admitad
var deduplication_cookie_value = 'admitad';
// nombre del parámetro GET para la deduplicación
// cámbialo si tienes otro nombre
var channel_name = 'utm_source';
// la función para recibir la fuente del parámetro GET
getSourceParamFromUri = function () {
  var pattern = channel_name + '=([^&]+)';
  var re = new RegExp(pattern);
  return (re.exec(document.location.search) || [])[1] || '';
};

// la función para recibir la fuente de la cookie llamada cookie_name
getSourceCookie = function () {
  var matches = document.cookie.match(new RegExp(
    '(?:^|; )' + cookie_name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1') + '=([^;]*)'
  ));
  return matches ? decodeURIComponent(matches[1]) : undefined;
};
// la función para definir la fuente en la cookie llamada cookie_name
setSourceCookie = function () {
  var param = getSourceParamFromUri();
  var params = (new URL(document.location)).searchParams;
  if (!params.get(channel_name) && params.get('gclid')) { param = 'advAutoMarkup' }
  else if (!param) { return; }
  var period = days_to_store * 60 * 60 * 24 * 1000; // en segundos
  var expiresDate = new Date((period) + +new Date);
  var cookieString = cookie_name + '=' + param + '; path=/; expires=' + expiresDate.toGMTString();
  document.cookie = cookieString;
  document.cookie = cookieString + '; domain=.' + location.host;
};
// fijar cookie
setSourceCookie();
</script>
<script type="text/javascript">
ADMITAD = window.ADMITAD || {};
ADMITAD.Invoice = ADMITAD.Invoice || {};
if (!getSourceCookie(cookie_name)) {
  ADMITAD.Invoice.broker = 'na';
} else if (getSourceCookie(cookie_name) != deduplication_cookie_value) {
  ADMITAD.Invoice.broker = getSourceCookie(cookie_name);
} else {
  ADMITAD.Invoice.broker = 'adm';
}
ADMITAD.Invoice.category = '{{category}}'; // lugar para colocar la variable transactionAction

var orderedItem = [];

var positions = {{transactionProducts}};     // lugar para establecer la variable transactionProducts

for (i = 0; i < positions.length; ++i) {
   orderedItem.push({
       Product: {
           productID: positions[i]['sku'],
           category: positions[i]['tariff'],
           price: positions[i]['price'],
           priceCurrency: positions[i]['priceCurrency']
       },
       orderQuantity: positions[i]['quantity'],
       additionalType: "sale"
   });
}

ADMITAD.Invoice.referencesOrder = ADMITAD.Invoice.referencesOrder || [];
ADMITAD.Invoice.referencesOrder.push({
 orderNumber: '{{orderNumber}}',          // el sitio para establecer la variable transactionId
// elimina el comentario de la siguiente línea si proporcionas códigos de descuento Take&Go a los publishers
//  discountCode: "{{promocode}}" 
 orderedItem: orderedItem
});

// ¡Importante! Si envías los datos a través de AJAX o del formulario de pedido de un solo clic, elimina el comentario de la última línea:
// ADMITAD.Tracking.processPositions();

</script>

Usa el ejemplo anterior, y fija el código de acción para que sea constante:

<script src="https://www.artfut.com/static/tagtag.min.js?campaign_code={your_campaign_code}" async></script>
<script type="text/javascript">
// nombre de la cookie que almacena la fuente
// cámbialo si tienes otro nombre
var cookie_name = 'deduplication_cookie';
// tiempo de vida de la cookie
var days_to_store = 90;
// valor esperado de deduplication_cookie para Admitad
var deduplication_cookie_value = 'admitad';
// nombre del parámetro GET para la deduplicación
// cámbialo si tienes otro nombre
var channel_name = 'utm_source';
// la función para recibir la fuente del parámetro GET
getSourceParamFromUri = function () {
  var pattern = channel_name + '=([^&]+)';
  var re = new RegExp(pattern);
  return (re.exec(document.location.search) || [])[1] || '';
};

// la función para recibir la fuente de la cookie llamada cookie_name
getSourceCookie = function () {
  var matches = document.cookie.match(new RegExp(
    '(?:^|; )' + cookie_name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1') + '=([^;]*)'
  ));
  return matches ? decodeURIComponent(matches[1]) : undefined;
};
// la función para definir la fuente en la cookie llamada cookie_name
setSourceCookie = function () {
  var param = getSourceParamFromUri();
  var params = (new URL(document.location)).searchParams;
  if (!params.get(channel_name) && params.get('gclid')) { param = 'advAutoMarkup' }
  else if (!param) { return; }
  var period = days_to_store * 60 * 60 * 24 * 1000; // en segundos
  var expiresDate = new Date((period) + +new Date);
  var cookieString = cookie_name + '=' + param + '; path=/; expires=' + expiresDate.toGMTString();
  document.cookie = cookieString;
  document.cookie = cookieString + '; domain=.' + location.host;
};
// fijar cookie
setSourceCookie();
</script>
<script type="text/javascript">
ADMITAD = window.ADMITAD || {};
ADMITAD.Invoice = ADMITAD.Invoice || {};
if (!getSourceCookie(cookie_name)) {
  ADMITAD.Invoice.broker = 'na';
} else if (getSourceCookie(cookie_name) != deduplication_cookie_value) {
  ADMITAD.Invoice.broker = getSourceCookie(cookie_name);
} else {
  ADMITAD.Invoice.broker = 'adm';
}
  ADMITAD.Invoice.category = '1';

var orderedItem = [];

var positions = {{transactionProducts}};    // lugar para establecer la variable transactionProducts

for (i = 0; i < positions.length; ++i) {
   orderedItem.push({
       Product: {
           productID: positions[i]['sku'],
           category: positions[i]['tariff'],
           price: positions[i]['price'],
           priceCurrency: positions[i]['priceCurrency']
       },
       orderQuantity: positions[i]['quantity'],
       additionalType: "sale"
   });
}

ADMITAD.Invoice.referencesOrder = ADMITAD.Invoice.referencesOrder || [];
ADMITAD.Invoice.referencesOrder.push({
 orderNumber: '{{orderNumber}}',          // el sitio para establecer la variable transactionId
// elimina el comentario de la siguiente línea si proporcionas códigos de descuento Take&Go a los publishers
//  discountCode: "{{promocode}}" 
 orderedItem: orderedItem
});

// ¡Importante! Si envías los datos a través de AJAX o del formulario de pedido de un solo clic, elimina el comentario de la última línea:
// ADMITAD.Tracking.processPositions();

</script>

<script src="https://www.artfut.com/static/tagtag.min.js?campaign_code={your_campaign_code}" async></script>
<script type="text/javascript">
// nombre de la cookie que almacena la fuente
// cámbialo si tienes otro nombre
var cookie_name = 'deduplication_cookie';
// tiempo de vida de la cookie
var days_to_store = 90;
// valor esperado de deduplication_cookie para Admitad
var deduplication_cookie_value = 'admitad';
// nombre del parámetro GET para la deduplicación
// cámbialo si tienes otro nombre
var channel_name = 'utm_source';
// la función para recibir la fuente del parámetro GET
getSourceParamFromUri = function () {
  var pattern = channel_name + '=([^&]+)';
  var re = new RegExp(pattern);
  return (re.exec(document.location.search) || [])[1] || '';
};

// la función para recibir la fuente de la cookie llamada cookie_name
getSourceCookie = function () {
  var matches = document.cookie.match(new RegExp(
    '(?:^|; )' + cookie_name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1') + '=([^;]*)'
  ));
  return matches ? decodeURIComponent(matches[1]) : undefined;
};
// la función para definir la fuente en la cookie llamada cookie_name
setSourceCookie = function () {
  var param = getSourceParamFromUri();
  var params = (new URL(document.location)).searchParams;
  if (!params.get(channel_name) && params.get('gclid')) { param = 'advAutoMarkup' }
  else if (!param) { return; }
  var period = days_to_store * 60 * 60 * 24 * 1000; // en segundos
  var expiresDate = new Date((period) + +new Date);
  var cookieString = cookie_name + '=' + param + '; path=/; expires=' + expiresDate.toGMTString();
  document.cookie = cookieString;
  document.cookie = cookieString + '; domain=.' + location.host;
};
// fijar cookie
setSourceCookie();
</script>
	<script type="text/javascript">
ADMITAD = window.ADMITAD || {};
ADMITAD.Invoice = ADMITAD.Invoice || {};
if (!getSourceCookie(cookie_name)) {
  ADMITAD.Invoice.broker = 'na';
} else if (getSourceCookie(cookie_name) != deduplication_cookie_value) {
  ADMITAD.Invoice.broker = getSourceCookie(cookie_name);
} else {
  ADMITAD.Invoice.broker = 'adm';
}
ADMITAD.Invoice.category = '1'; // el sitio para establecer la variable transactionAction

var orderedItem = [];  // selección temporal de productos

// repetir para cada artículo del carrito
orderedItem.push({
  Product: {
    productID: '1',   // el código interno del artículo (hasta 100 caracteres, coincide con el ID del feed del producto)
    category: '1',  
    price: '{{price}}',  // precio del artículo (si hay descuento, se indicará el precio con descuento)
    priceCurrency: 'USD', // código de divisa para ISO-4217 alpha-3
  },
  orderQuantity: '1',  // cantidad
  additionalType: 'sale'  // siempre en oferta
});

ADMITAD.Invoice.referencesOrder = ADMITAD.Invoice.referencesOrder || [];
// añadir más artículos
ADMITAD.Invoice.referencesOrder.push({
  orderNumber: '{{order number}}',  // ID de pedido de su CMS (hasta 100 caracteres)
 // discountCode: '{{promocode}}',  // código de descuento; este parámetro es necesario si ofreces los códigos de descuento Take&Go a los publishers
  orderedItem: orderedItem
});

// ¡Importante! Si envías los datos a través de AJAX o del formulario de pedido de un solo clic, elimina el comentario de la última línea:
// ADMITAD.Tracking.processPositions();

</script>

<script src="https://www.artfut.com/static/tagtag.min.js?campaign_code={your_campaign_code}" async></script>
<script type="text/javascript">
// nombre de la cookie que almacena la fuente
// cámbialo si tienes otro nombre
var cookie_name = 'deduplication_cookie';
// tiempo de vida de la cookie
var days_to_store = 90;
// valor esperado de deduplication_cookie para Admitad
var deduplication_cookie_value = 'admitad';
// nombre del parámetro GET para la deduplicación
// cámbialo si tienes otro nombre
var channel_name = 'utm_source';
// la función para recibir la fuente del parámetro GET
getSourceParamFromUri = function () {
  var pattern = channel_name + '=([^&]+)';
  var re = new RegExp(pattern);
  return (re.exec(document.location.search) || [])[1] || '';
};

// la función para recibir la fuente de la cookie llamada cookie_name
getSourceCookie = function () {
  var matches = document.cookie.match(new RegExp(
    '(?:^|; )' + cookie_name.replace(/([\.$?*|{}\(\)\[\]\\\/\+^])/g, '\\$1') + '=([^;]*)'
  ));
  return matches ? decodeURIComponent(matches[1]) : undefined;
};
// la función para definir la fuente en la cookie llamada cookie_name
setSourceCookie = function () {
  var param = getSourceParamFromUri();
  var params = (new URL(document.location)).searchParams;
  if (!params.get(channel_name) && params.get('gclid')) { param = 'advAutoMarkup' }
  else if (!param) { return; }
  var period = days_to_store * 60 * 60 * 24 * 1000; // en segundos
  var expiresDate = new Date((period) + +new Date);
  var cookieString = cookie_name + '=' + param + '; path=/; expires=' + expiresDate.toGMTString();
  document.cookie = cookieString;
  document.cookie = cookieString + '; domain=.' + location.host;
};
// fijar cookie
setSourceCookie();
</script>
<script type="text/javascript">
ADMITAD = window.ADMITAD || {};
ADMITAD.Invoice = ADMITAD.Invoice || {};
if (!getSourceCookie(cookie_name)) {
  ADMITAD.Invoice.broker = 'na';
} else if (getSourceCookie(cookie_name) != deduplication_cookie_value) {
  ADMITAD.Invoice.broker = getSourceCookie(cookie_name);
} else {
  ADMITAD.Invoice.broker = 'adm';
}
ADMITAD.Invoice.category = '1'; 

var orderedItem = []; // selección temporal de productos


// repetir para cada artículo del carrito
orderedItem.push({
  Product: {
    category: '1',
    price: '1',
    priceCurrency: 'USD',  // código de divisa para ISO-4217 alpha-3
  },
  orderQuantity: '1',
  additionalType: 'sale'  // siempre en oferta
});

ADMITAD.Invoice.referencesOrder = ADMITAD.Invoice.referencesOrder || [];
// añadir más artículos
ADMITAD.Invoice.referencesOrder.push({
  orderNumber: '{{order number}}',  // ID de pedido de su CMS (hasta 100 caracteres)
 //  discountCode: '{{promocode}}', // código de descuento; este parámetro es necesario si ofreces los códigos de descuento Take&Go a los publishers
  orderedItem: orderedItem
});

// ¡Importante! Si envías los datos a través de AJAX o del formulario de pedido de un solo clic, elimina el comentario de la última línea:
// ADMITAD.Tracking.processPositions();

</script>

9. Cambia las variables de la plantilla por las variables correspondientes de la sección Variables (menú lateral de la interfaz de la cuenta de GTM).

Para hacerlo, especifica las variables que has utilizado en tu variante de código para las variables del código de seguimiento.

Por ejemplo: orderNumber:{{nombre de tu variable en GTM}}.

10. Guarda los cambios.

Cómo añadir ajustes adicionales

Si no necesitas ajustes y herramientas adicionales, ve al siguiente paso.

Además de los ajustes estándar, puedes añadir los siguientes:

seguimiento para un sitio web con formulario de pedido de un solo clic;
transferencia de códigos promocionales Take&Go;
transferencia del Id de usuario único como parte del seguimiento entre dispositivos.

Configuración de seguimiento para sitio web con formulario de pedido de un solo clic

Si en tu sitio web hay un formulario de pedido de un solo clic, también deberás configurar el seguimiento de este tipo de pedidos.

1. Configura el evento en el dataLayer de GTM siguiendo las instrucciones. En este parámetro deben registrarse:

los datos sobre el producto, en la página del que se realiza el pedido;
el número único de este pedido.

Abajo tienes un ejemplo del código, pero la estructura de tu dataLayer puede ser diferente.

window.dataLayer = window.dataLayer || [];
window.dataLayer.push({
  "event": "orderPlaced",
  "price": productPrice,
  "id": "productId",
  "orderId": orderNumber
});

2. Establece un desencadenante que se activará cuando se produzca el evento Pedido en 1 clic. Especifica las siguientes condiciones para activar el desencadenante:

Event;
equals;
orderPlaced — valor aproximado del carácter, puedes utilizar tu propia variante.

Después, añade el nombre 1click conversion en la esquina superior izquierda y guarda los cambios.

3. Añade a GTM las siguientes variables que pasarán la información del pedido desde dataLayer.

Variable en el código de seguimiento	Función de la variable
price	Precio del producto.
orderNumber	Número de pedido.
productID	ID del producto.

Añade una a una todas las variables:

3.1 Ve a la sección Variables y en el bloque User-Defined Variables de la esquina superior derecha, haz clic en New.

3.2 En la página que se abre, en la esquina superior derecha, haz clic en .

3.3 En el apartado Page Variables, elige Data Layer Variable.

3.4 En la página que se abre, rellena los siguientes campos:
- Data Layer Variable Name — escribe 1cItemPrice.
- Data Layer Version — segúrate de que en el campo está seleccionado Version 2.
Después, especifica el nombre de la variable price y guarda los cambios.

Luego, añade las dos variables que faltan utilizando los datos necesarios.

4. Añade la etiqueta 1click conversion, el tipo de etiqueta es Custom HTML.

4.1 En la página principal, elige Tags en el menú lateral. Después, en la página que se abre, haz clic en New.

4.2 Indica el nombre de la etiqueta: 1click conversion, y en el bloque Tag Configuration, en la esquina superior derecha, haz clic en .

4.3 Luego, elige el tipo de etiqueta: en el bloque Custom, haz clic en Custom HTML.

Entonces, pega el código de abajo en la ventana que se abre.

<script type="text/javascript">
ADMITAD = window.ADMITAD || {};
ADMITAD.Invoice = ADMITAD.Invoice || {};
if (!getSourceCookie(cookie_name)) {
  ADMITAD.Invoice.broker = 'na';
} else if (getSourceCookie(cookie_name) != deduplication_cookie_value) {
  ADMITAD.Invoice.broker = getSourceCookie(cookie_name);
} else {
  ADMITAD.Invoice.broker = 'adm';
} // la identificación de la fuente de tráfico de pago si la deduplicación está activada
ADMITAD.Invoice.category = '1'; 

var orderedItem = [];  // selección temporal de productos

orderedItem.push({
  Product: {
    productID: '{{1cProductId}}',  // código interno del artículo (hasta 100 caracteres, coincide con el ID del feed del producto)
    category: '1',  // código de tarifa de la acción de conversión
    price: '{{1cItemPrice}}',  // precio del artículo (si hay descuento, se indicará el precio con descuento)
    priceCurrency: 'USD',  // código de divisa para ISO-4217 alpha-3
  },
  orderQuantity: '1',  // cantidad
  additionalType: 'sale'  // siempre en oferta
});

ADMITAD.Invoice.referencesOrder = ADMITAD.Invoice.referencesOrder || [];
ADMITAD.Invoice.referencesOrder.push({
  orderNumber: '{{1cOrderNumber}}',  // ID del pedido de tu CMS (hasta 100 caracteres)
  orderedItem: orderedItem
});

ADMITAD.Tracking.processPositions();

  </script>

5. Configura el desencadenante adecuado para esta etiqueta: haz clic en el bloque Triggering que aparece más abajo en la misma página y selecciona el desencadenante de activación 1click conversion.

Después, guarda los cambios.

Listo, se ha añadido el código de seguimiento para el control de los pedidos en un solo clic al archivo de tu sitio web.

Los códigos de descuento Take&Go son los que incluyen una palabra clave única. Con esta palabra se realiza el seguimiento de las acciones de conversión. Estos códigos promocionales se asignan a unos publishers concretos. Más información sobre los códigos promocionales Take&Go

Para usar los códigos promocionales Take&Go:

1. Añade la nueva variable promocode y vincúlala a la variable de nivel de datos transactionPromocode.

1.1 Ve a la sección Variables y en el bloque User-Defined Variables de la esquina superior derecha, haz clic en New.

1.2 En la página que se abre, en la esquina superior derecha, haz clic en .

1.3 En el apartado Page Variables, elige Data Layer Variable.

1.4 En la página que se abre, rellena los siguientes campos:
- Data Layer Variable Name — escribe transactionPromocode.
- Data Layer Version — asegúrate de que en el campo está seleccionado Version 2.
Después, especifica el nombre de la variable promocode y guarda los cambios.

2. En el menú lateral, elige Tags y añade la variable creada a la etiqueta de conversión.

Para hacerlo, pulsa TagTag conversion y actualiza el código en la ventana de configuración que se abre.

// añadir artículos al pedido
ADMITAD.Invoice.referencesOrder.push({
  orderNumber: "{{orderNumber}}", // número interno del pedido (máx. 100 caracteres)
//  discountCode: "{{promocode}}",  //  código de descuento único
  orderedItem: orderedItem

Después, guarda los cambios.

Listo, el código de seguimiento para rastrear los pedidos con el código de descuento Take&Go se ha añadido al archivo de tu sitio web.

Después, prueba el código añadido para asegurarte de que los pedidos con el código de descuento se rastrean de forma correcta.

Configuración de la transmisión del ID de usuario único como parte del seguimiento entre dispositivos

El seguimiento entre dispositivos permite realizar seguimiento de las acciones de conversión realizadas por el usuario desde diferentes dispositivos. Más información

El seguimiento entre dispositivos está configurado por defecto.

Cuando el usuario visita el sitio web de un anunciante, Admitad recopila un perfil de usuario anónimo único. Si el usuario realiza una acción de conversión, Admitad compara los datos del perfil y, si está disponible admitad_uid, registra la acción de conversión.

Puedes pasar de manera explícita el identificador único de usuario en el objeto del nivel de datos dataLayer. Con un identificador único, la acción de conversión se registrará correctamente aunque el usuario haga clic en el enlace de afiliación y realice la acción en diferentes dispositivos.

Un identificador único puede ser:

el correo electrónico del usuario;
o el nombre de usuario registrado en tu sitio web.

El identificador único de usuario tiene prioridad sobre el perfil anónimo: si se especifica accountId en el código de seguimiento, la solicitud pasará el identificador especificado, no los datos del perfil anónimo.

Para recibir estos datos:

1. Pasa el identificador del usuario al archivo del objeto del nivel de datos dataLayer.

  dataLayer.push({
       "transactionCustomer": "customer@email.com";     // correo electrónico del usuario
});

Admitad no almacena el valor de este parámetro y no lo transmite públicamente.

2. Añade la nueva variable accountID y vincúlala a la variable del nivel de datos transactionCustomer.

2.1 Ve a la sección Variables y en el bloque User-Defined Variables de la esquina superior derecha, haz clic en New.

2.2 En la página que se abre, en la esquina superior derecha, haz clic en .

2.3 En el apartado Page Variables, elige Data Layer Variable.

2.4 En la página que se abre, rellena los siguientes campos:
- Data Layer Variable Name — escribe transactionCustomer.
- Data Layer Version — asegúrate de que en el campo está seleccionado Version 2.
Después, especifica el nombre de la variable accountId y guarda los cambios.

3. Ve a la sección Tags y haz clic en TagTag conversion para abrir la ventana de configuración de tags. Entre las líneas con los parámetros ADMITAD.Invoice.broker y ADMITAD.Invoice.category añade la línea:

ADMITAD.Invoice.accountId = '{{accountId}}';    // sitio para la sustitución de la variable

Después, guarda los cambios.

4. Haz clic en TagTag common para abrir la ventana de configuración de etiquetas, y añade a la ventana de configuración de etiquetas que se abre, la línea:

ADMITAD.Invoice.accountId = '{{accountId}}';    // sitio para la sustitución de la variable

Después, guarda los cambios.

Listo, el código de seguimiento para pasar los parámetros únicos de usuario se ha añadido al archivo de tu sitio web.

Cómo publicar los cambios

Después de configurar los desencadenantes, las variables y las etiquetas, tienes que guardar la versión del código de seguimiento y publicar los cambios en GTM.

Para hacerlo:

1. En la página principal, pulsa Submit en la esquina superior derecha.

2. Indica el nombre de la versión del código de seguimiento, añade un comentario si es necesario y haz clic en Publish.

Listo, la integración a través del código de seguimiento utilizando GTM ha sido completada.

Después, todos los cambios se publicarán en un archivo especial de tu sitio web y podrás realizar seguimientos de las acciones de conversión de los usuarios.

Cómo testear la integración después de la configuración

Para testear la transferencia de los códigos de descuento Take&Go, ve a esta sección.

1. Copia el enlace de prueba de tu cuenta personal. Cómo encontrar el enlace de prueba

2. Haz clic en el enlace de afiliación de prueba y entra en tu sitio web. Asegúrate de que la barra de direcciones incluya todos los parámetros GET y las etiquetas UTM que necesitas.

3. Realiza una acción de conversión en el sitio web (por ejemplo, compra un producto).

4. Ve a tu cuenta personal de Admitad → Estadísticas → Por acciones y comprueba que las estadísticas muestran de forma correcta la acción de conversión y sus datos:

el nombre de la acción de conversión en la columna "Tarifa" de las estadísticas coincide con el nombre de esta acción en la sección "Acciones";
El ID de la acción en la columna ID del pedido coincide con el ID de la acción en tu sistema;
el importe del pedido en Admitad coincide con el importe del pedido de prueba.

5. Asegúrate de que puedes encontrar el pedido de prueba en tu sistema CMS por el parámetro orderNumber, ya que se utilizará para realizar la verificación en el futuro.

Si tu programa tiene varias acciones y tarifas de conversión, tienes que probar cada una de ellas.

Si todo ha ido bien, ¡enhorabuena!, la prueba ha terminado.

Si has tenido problemas durante la prueba, pasa a este apartado.

6. Avisa al especialista de Admitad del final de las pruebas: el programa entrará en fase de preparación para el lanzamiento.

1. Asegúrate de que el código promocional Take&Go esté añadido al sistema. Más información

2. Borra la cookie de tu navegador y realiza tu pedido a través del enlace directo utilizando el código promocional añadido al sistema.

3. Ve a tu cuenta personal de Admitad → Estadísticas → Por acciones y comprueba que las estadísticas muestran de forma correcta la acción de conversión y sus datos:

el nombre de la acción de conversión en la columna Tarifa de las estadísticas coincide con el nombre de esta acción en la sección Acciones;
El ID de la acción en la columna ID del pedido coincide con el ID de la acción en tu sistema;
el importe del pedido en Admitad coincide con el importe del pedido de prueba.

4. Asegúrate de que puedes encontrar el pedido de prueba en tu sistema CMS por el parámetro orderNumber, ya que se utilizará para realizar la verificación en el futuro.

Si tu programa tiene varias acciones y tarifas de conversión, tienes que probar cada una de ellas.

Si todo ha ido bien, ¡enhorabuena!, la prueba ha terminado.

Si has tenido problemas durante la prueba, pasa a este apartado.

5. Avisa al especialista de Admitad del final de las pruebas: el programa entrará en fase de preparación para el lanzamiento.

Posibles problemas durante las pruebas

Si la acción de conversión no aparece en las estadísticas, es posible que se haya producido un error al instalar o configurar el código de seguimiento.

Problema	Posible solución
El código de seguimiento no se activa: no hay solicitudes en la pestaña Network del navegador.	El script está mal conectado. Sigue los pasos indicados en la sección Integración a través del código de seguimiento mediante Google Tag Manager.
El script no funciona. Hay errores en el cuadro de mandos del navegador.	Sigue los pasos indicados en la sección Integración a través del código de seguimiento mediante Google Tag Manager. Comprueba la sintaxis de JavaScript en las etiquetas TagTag common y TagTag conversion.
El script funciona. No hay errores en el cuadro de mandos del navegador. La acción no ha aparecido en las estadísticas.	El parámetro `campaign_code` tiene un valor incorrecto o no ha sido introducido. Vuelve a revisar el valor de `campaign_code` y sustitúyelo en el código si es necesario (instrucciones).
El script funciona. No hay errores en el cuadro de mandos del navegador. El parámetro `campaign_code` tiene el valor correcto. El pedido no ha aparecido en las estadísticas.	Para detectar el error, ve al registro de solicitudes (menú → Herramientas → Registro de solicitudes). El texto sobre el error se muestra en el campo Resultado. Corrige el error y vuelve a realizar la prueba.
El script funciona. No hay errores en el cuadro de mandos del navegador. El parámetro `campaign_code` tiene el valor correcto. No hay errores en el apartado Registro de solicitudes. La acción no ha aparecido en las estadísticas.	Por parte de Admitad, existen algunas dificultades técnicas temporales (retraso en el registro). Revisa si la acción ha aparecido una hora después.
El script funciona. No hay errores en el cuadro de mandos del navegador. El par��metro `campaign_code` tiene el valor correcto. No hay errores en el apartado Registro de solicitudes. Al cabo de una hora, la acción no ha aparecido en las estadísticas.	Ponte en contacto con un especialista de Admitad para que te ayude.

FAQ

¿Dónde puedo encontrar el valor del parámetro campaign_code?

1. En tu cuenta personal, ve a la sección Integración (menú → Programa → Integración).

2. Después, haz clic en Siguiente y, en la página Métodos de integración, cambia a la pestaña Integración personalizada.

3. En la pestaña Integración personalizada, selecciona Tracking code GTM y haz clic en Siguiente.

4. El valor del parámetro campaign_code se muestra en la tabla de la parte superior de la pantalla (sección Configuración de la integración: valores de parámetros exclusivos para tu programa).

¿Dónde puedo encontrar el enlace para probar la configuración del programa de afiliación?

1. En tu cuenta personal, ve a la sección Integración (menú → Programa → Integración).

2. Después, haz clic en Siguiente y, en la página Métodos de integración, cambia a la pestaña Integración personalizada.

3. En la pestaña Integración personalizada, selecciona Tracking code GTM y haz clic en Siguiente.

4. El apartado Prueba de integración se encuentra en la parte inferior de la pantalla.

Información general: características y recomendaciones

Qué es el código de seguimiento y cómo funciona a través de Google Tag Manager

Cómo se lleva a cabo la integración a través del código de seguimiento mediante Google Tag Manager

Cómo configurar el código de seguimiento mediante GTM

Cómo colocar el código de seguimiento en GTM

Configuración de los desencadenantes

Configuración de variables en GTM

Personalización de las etiquetas

Cómo añadir ajustes adicionales

Configuración de seguimiento para sitio web con formulario de pedido de un solo clic

Configuración de la transferencia de los códigos promocionales Take&Go

Configuración de la transmisión del ID de usuario único como parte del seguimiento entre dispositivos

Cómo publicar los cambios

Cómo testear la integración después de la configuración

Cómo testear la integración después de configurar la transferencia del código promocional Take&Go

Posibles problemas durante las pruebas

FAQ

¿Dónde puedo encontrar el valor del parámetro campaign_code?

¿Dónde puedo encontrar el enlace para probar la configuración del programa de afiliación?

¿Fue útil este artículo?