TikTok Ads

Installer le pixel TikTok sur une boutique Qweekle V3

C'est la seule plateforme pour laquelle Qweekle ne fournit pas de module. Tout est à construire — mais sur des fondations propres, puisque le module Base apporte déjà les variables, les déclencheurs et le Consent Mode.

Version 3 — la version actuelle. Vous êtes concerné si votre boutique est sur une adresse en .qweekle.shop.

Avant de commencer

Le module Base est importé : ses variables et ses déclencheurs se réutilisent tels quels.
Un identifiant de pixel TikTok, disponible dans le Gestionnaire d'événements TikTok.

Étape 1

Les variables à créer

Qweekle - DLV - ecommerce.valueVariable de couche de données — fournie par le module Base

ecommerce.value

Qweekle - DLV - ecommerce.currencyVariable de couche de données — fournie par le module Base

ecommerce.currency

Qweekle - DLV - ecommerce.transaction_idVariable de couche de données — fournie par le module Base

ecommerce.transaction_id

Étape 2

Les déclencheurs

Qweekle - CE - view_itemÉvénement personnalisé — fourni par le module Base

view_item

Qweekle - CE - add_to_cartÉvénement personnalisé — fourni par le module Base

add_to_cart

Qweekle - CE - begin_checkoutÉvénement personnalisé — fourni par le module Base

begin_checkout

Qweekle - CE - purchaseÉvénement personnalisé — fourni par le module Base

purchase

Étape 3

Les balises

Les noms suivent la convention que nous utilisons en production : le rôle de la balise se lit d'un coup d'œil dans la liste, même après plusieurs années.

TikTok Ads | Main Tag

Type — HTML personnaliséDéclencheur — All Pages

<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>

Conditionnez cette balise au consentement, comme le font les modules de l'éditeur : le module Base fournit les paramètres nécessaires.

Event TikTok Ads | View Content

Type — HTML personnaliséDéclencheur — Qweekle - CE - view_item

<script>
  ttq.track('ViewContent', {
    value: {{Qweekle - DLV - ecommerce.value}},
    currency: {{Qweekle - DLV - ecommerce.currency}}
  });
</script>

Event TikTok Ads | Add To Cart

Type — HTML personnaliséDéclencheur — Qweekle - CE - add_to_cart

<script>
  ttq.track('AddToCart', {
    value: {{Qweekle - DLV - ecommerce.value}},
    currency: {{Qweekle - DLV - ecommerce.currency}}
  });
</script>

Event TikTok Ads | Initiate Checkout

Type — HTML personnaliséDéclencheur — Qweekle - CE - begin_checkout

<script>
  ttq.track('InitiateCheckout', {
    value: {{Qweekle - DLV - ecommerce.value}},
    currency: {{Qweekle - DLV - ecommerce.currency}}
  });
</script>

Event TikTok Ads | Complete Payment

Type — HTML personnaliséDéclencheur — Qweekle - CE - purchase

<script>
  ttq.track('CompletePayment', {
    value: {{Qweekle - DLV - ecommerce.value}},
    currency: {{Qweekle - DLV - ecommerce.currency}}
  }, {
    event_id: {{Qweekle - DLV - ecommerce.transaction_id}}
  });
</script>

La valeur à envoyer est bien la valeur de commande, pas le montant encaissé en ligne. TikTok attend CompletePayment, pas Purchase.

Pièges

Ce qui casse le plus souvent

Oublier de conditionner les balises au consentement

Les modules de l'éditeur gèrent le consentement ; vos balises TikTok, non, puisque vous les écrivez. C'est le piège propre à cette plateforme sur Qweekle : tout le reste du conteneur est conforme, et TikTok passe à travers.

Utiliser le vocabulaire de Meta

CompletePayment et non Purchase. Un événement mal nommé ne remonte dans aucun rapport TikTok.

Envoyer le montant encaissé plutôt que la valeur de commande

Sur un parc qui pratique l'acompte, l'écart est massif. La règle est la même que pour les autres plateformes : la valeur, toujours.

Oublier ttq.page() dans la balise de socle

Sans cet appel, les audiences de remarketing restent vides même si les conversions remontent.

Recette

Vérifier que ça fonctionne

Installer l'extension TikTok Pixel Helper et parcourir un achat complet.
Vérifier qu'aucune balise TikTok ne part avant acceptation du bandeau cookies.
Contrôler dans le Gestionnaire d'événements TikTok que les quatre événements arrivent avec leurs valeurs.
Vérifier que la valeur de l'achat correspond à la commande, pas au montant encaissé.

TikTok fonctionne comme Meta sur cette version : balises HTML personnalisées, mêmes déclencheurs, mais une nomenclature propre. Si Meta est déjà posé, comptez une demi-heure.

Avant de commencer

Le conteneur Google Tag Manager du parc est installé sur le site et sur la boutique.
Un identifiant de pixel TikTok.
Les déclencheurs sont déjà créés pour Meta ou GA4 — ils se réutilisent tels quels.

Étape 1

Les variables à créer

ecommerce.valueVariable de couche de données

ecommerce.value

ecommerce.currencyVariable de couche de données

ecommerce.currency

ecommerce.transaction_idVariable de couche de données

ecommerce.transaction_id

Étape 2

Les déclencheurs

Event | Add To CartÉvénement personnalisé

add_to_cart

Event | Begin CheckoutÉvénement personnalisé

begin_checkout

Event | PurchaseÉvénement personnalisé

purchase

Étape 3

Les balises

Les noms suivent la convention que nous utilisons en production : le rôle de la balise se lit d'un coup d'œil dans la liste, même après plusieurs années.

TikTok Ads | Main Tag

Type — HTML personnaliséDéclencheur — Toutes les pages

<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

Type — HTML personnaliséDéclencheur — Event | Add To Cart

<script>
  ttq.track('AddToCart', {
    value: {{ecommerce.value}},
    currency: {{ecommerce.currency}}
  });
</script>

Event TikTok Ads | Initiate Checkout

Type — HTML personnaliséDéclencheur — Event | Begin Checkout

<script>
  ttq.track('InitiateCheckout', {
    value: {{ecommerce.value}},
    currency: {{ecommerce.currency}}
  });
</script>

Event TikTok Ads | Complete Payment

Type — HTML personnaliséDéclencheur — Event | Purchase

<script>
  ttq.track('CompletePayment', {
    value: {{ecommerce.value}},
    currency: {{ecommerce.currency}}
  }, {
    event_id: {{ecommerce.transaction_id}}
  });
</script>

TikTok attend CompletePayment, pas Purchase. Une balise mal nommée ne remonte dans aucun rapport.

Pièges

Ce qui casse le plus souvent

Utiliser le vocabulaire de Meta

Copier la balise Meta en remplaçant simplement fbq par ttq produit un événement Purchase que TikTok ignore.

Oublier ttq.page() dans la balise de socle

Sans cet appel, la vue de page n'est jamais envoyée : les audiences de remarketing restent vides.

Charger le pixel deux fois

Si TikTok a d'abord été posé en dur dans le code du site puis rajouté dans Tag Manager, chaque événement part en double.

Recette

Vérifier que ça fonctionne

Installer l'extension TikTok Pixel Helper et parcourir un achat complet.
Vérifier que les trois événements arrivent avec valeur et devise.
Contrôler que la vue de page remonte sur le site comme sur la boutique.
Vérifier qu'aucun événement n'apparaît en double.

Les autres plateformes sur Qweekle

Google Analytics 4Installer Google Analytics 4 sur une boutique Qweekle V3

Google AdsSuivi des conversions Google Ads sur une boutique Qweekle V3

Meta AdsInstaller le pixel Meta sur une boutique Qweekle V3

Vos conversions ne collent pas avec votre caisse ?

C'est le symptôme le plus courant, et il a presque toujours l'une des causes listées ci-dessus. Nous auditons votre installation et vous disons ce qui se perd, où, et combien ça coûte.

Réserver mon audit