Instalar el píxel de TikTok en una tienda Qweekle V3
Es la única plataforma para la que Qweekle no proporciona módulo. Hay que construirlo todo, pero sobre unos cimientos limpios, ya que el módulo Base aporta ya las variables, los activadores y el Consent Mode.
Versión 3 — la versión actual. Te afecta si tu tienda está en una dirección .qweekle.shop.
Es la única plataforma para la que Qweekle no proporciona módulo. Hay que construirlo todo, pero sobre unos cimientos limpios, ya que el módulo Base aporta ya las variables, los activadores y el Consent Mode.
Antes de empezar
- El módulo Base está importado: sus variables y sus activadores se reutilizan tal cual.
- Un ID de píxel de TikTok, disponible en el Administrador de eventos de TikTok.
Las variables que hay que crear
ecommerce.valueecommerce.currencyecommerce.transaction_idLos activadores
view_itemadd_to_cartbegin_checkoutpurchaseLas etiquetas
Los nombres siguen la convención que usamos en producción: la función de cada etiqueta se entiende de un vistazo en la lista, incluso años después.
TikTok Ads | Main Tag
<script>
!function (w, d, t) {
w.TiktokAnalyticsObject=t;var ttq=w[t]=w[t]||[];
ttq.methods=["page","track","identify","instances","debug","on","off","once","ready","alias","group","enableCookie","disableCookie"];
ttq.setAndDefer=function(t,e){t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}};
for(var i=0;i<ttq.methods.length;i++)ttq.setAndDefer(ttq,ttq.methods[i]);
ttq.instance=function(t){for(var e=ttq._i[t]||[],n=0;n<ttq.methods.length;n++)ttq.setAndDefer(e,ttq.methods[n]);return e};
ttq.load=function(e,n){var r="https://analytics.tiktok.com/i18n/pixel/events.js";
ttq._i=ttq._i||{};ttq._i[e]=[];ttq._i[e]._u=r;ttq._t=ttq._t||{};ttq._t[e]=+new Date;
ttq._o=ttq._o||{};ttq._o[e]=n||{};
var o=d.createElement("script");o.type="text/javascript";o.async=!0;o.src=r+"?sdkid="+e+"&lib="+t;
var a=d.getElementsByTagName("script")[0];a.parentNode.insertBefore(o,a)};
ttq.load('VOTRE_PIXEL_ID');
ttq.page();
}(window, document, 'ttq');
</script>Condiciona esta etiqueta al consentimiento, como hacen los módulos del editor: el módulo Base proporciona los parámetros necesarios.
Event TikTok Ads | View Content
<script>
ttq.track('ViewContent', {
value: {{Qweekle - DLV - ecommerce.value}},
currency: {{Qweekle - DLV - ecommerce.currency}}
});
</script>Event TikTok Ads | Add To Cart
<script>
ttq.track('AddToCart', {
value: {{Qweekle - DLV - ecommerce.value}},
currency: {{Qweekle - DLV - ecommerce.currency}}
});
</script>Event TikTok Ads | Initiate Checkout
<script>
ttq.track('InitiateCheckout', {
value: {{Qweekle - DLV - ecommerce.value}},
currency: {{Qweekle - DLV - ecommerce.currency}}
});
</script>Event TikTok Ads | Complete Payment
<script>
ttq.track('CompletePayment', {
value: {{Qweekle - DLV - ecommerce.value}},
currency: {{Qweekle - DLV - ecommerce.currency}}
}, {
event_id: {{Qweekle - DLV - ecommerce.transaction_id}}
});
</script>El valor que hay que enviar es el valor del pedido, no el importe cobrado online. TikTok espera CompletePayment, no Purchase.
Lo que falla más a menudo
Olvidar condicionar las etiquetas al consentimiento
Los módulos del editor gestionan el consentimiento; tus etiquetas de TikTok no, porque las escribes tú. Es la trampa propia de esta plataforma en Qweekle: todo el resto del contenedor es conforme, y TikTok se cuela.
Usar el vocabulario de Meta
CompletePayment y no Purchase. Un evento mal nombrado no aparece en ningún informe de TikTok.
Enviar el importe cobrado en lugar del valor del pedido
En un parque que trabaja con anticipos, la diferencia es enorme. La regla es la misma que en las demás plataformas: el valor, siempre.
Olvidar ttq.page() en la etiqueta base
Sin esta llamada, las audiencias de remarketing se quedan vacías aunque las conversiones se registren.
Comprobar que funciona
- Instalar la extensión TikTok Pixel Helper y recorrer una compra completa.
- Comprobar que ninguna etiqueta de TikTok se envía antes de aceptar el banner de cookies.
- Comprobar en el Administrador de eventos de TikTok que los cuatro eventos llegan con sus valores.
- Comprobar que el valor de la compra corresponde al pedido, no al importe cobrado.
TikTok funciona como Meta en esta versión: etiquetas de HTML personalizado, los mismos activadores, pero una nomenclatura propia. Si Meta ya está instalado, cuenta con media hora.
Antes de empezar
- El contenedor de Google Tag Manager del parque está instalado en la web y en la tienda.
- Un ID de píxel de TikTok.
- Los activadores ya están creados para Meta o GA4: se reutilizan tal cual.
Las variables que hay que crear
ecommerce.valueecommerce.currencyecommerce.transaction_idLos activadores
add_to_cartbegin_checkoutpurchaseLas etiquetas
Los nombres siguen la convención que usamos en producción: la función de cada etiqueta se entiende de un vistazo en la lista, incluso años después.
TikTok Ads | Main Tag
<script>
!function (w, d, t) {
w.TiktokAnalyticsObject=t;var ttq=w[t]=w[t]||[];
ttq.methods=["page","track","identify","instances","debug","on","off","once","ready","alias","group","enableCookie","disableCookie"];
ttq.setAndDefer=function(t,e){t[e]=function(){t.push([e].concat(Array.prototype.slice.call(arguments,0)))}};
for(var i=0;i<ttq.methods.length;i++)ttq.setAndDefer(ttq,ttq.methods[i]);
ttq.instance=function(t){for(var e=ttq._i[t]||[],n=0;n<ttq.methods.length;n++)ttq.setAndDefer(e,ttq.methods[n]);return e};
ttq.load=function(e,n){var r="https://analytics.tiktok.com/i18n/pixel/events.js";
ttq._i=ttq._i||{};ttq._i[e]=[];ttq._i[e]._u=r;ttq._t=ttq._t||{};ttq._t[e]=+new Date;
ttq._o=ttq._o||{};ttq._o[e]=n||{};
var o=d.createElement("script");o.type="text/javascript";o.async=!0;o.src=r+"?sdkid="+e+"&lib="+t;
var a=d.getElementsByTagName("script")[0];a.parentNode.insertBefore(o,a)};
ttq.load('VOTRE_PIXEL_ID');
ttq.page();
}(window, document, 'ttq');
</script>Event TikTok Ads | Add To Cart
<script>
ttq.track('AddToCart', {
value: {{ecommerce.value}},
currency: {{ecommerce.currency}}
});
</script>Event TikTok Ads | Initiate Checkout
<script>
ttq.track('InitiateCheckout', {
value: {{ecommerce.value}},
currency: {{ecommerce.currency}}
});
</script>Event TikTok Ads | Complete Payment
<script>
ttq.track('CompletePayment', {
value: {{ecommerce.value}},
currency: {{ecommerce.currency}}
}, {
event_id: {{ecommerce.transaction_id}}
});
</script>TikTok espera CompletePayment, no Purchase. Una etiqueta mal nombrada no aparece en ningún informe.
Lo que falla más a menudo
Usar el vocabulario de Meta
Copiar la etiqueta de Meta sustituyendo simplemente fbq por ttq produce un evento Purchase que TikTok ignora.
Olvidar ttq.page() en la etiqueta base
Sin esta llamada, la página vista no se envía nunca: las audiencias de remarketing se quedan vacías.
Cargar el píxel dos veces
Si TikTok se instaló primero directamente en el código de la web y después se volvió a añadir en Tag Manager, cada evento se envía por duplicado.
Comprobar que funciona
- Instalar la extensión TikTok Pixel Helper y recorrer una compra completa.
- Comprobar que los tres eventos llegan con valor y moneda.
- Comprobar que la página vista se registra tanto en la web como en la tienda.
- Comprobar que ningún evento aparece duplicado.
¿Tus conversiones no cuadran con tu caja?
Es el síntoma más habitual, y casi siempre tiene una de las causas descritas arriba. Auditamos tu instalación y te decimos qué se pierde, dónde y cuánto te cuesta.
