Comment configurer le pixel TikTok avec Cookiequiet

Que dépose le pixel TikTok ?

Le centre d’aide de TikTok liste les cookies qu’utilise le pixel, tous classés par TikTok comme cookies publicitaires, d’une durée de 13 mois à compter de leur dernière utilisation :

TikTok décrit leur finalité comme la mesure et l’amélioration des campagnes publicitaires et la personnalisation de l’expérience, publicités comprises, sur TikTok. Les cookies internes sont activés par défaut et peuvent être désactivés dans les réglages du pixel ; les cookies tiers sont activés par défaut. Parce que le pixel relie les visites à des personnes sur TikTok pour la publicité et les audiences, il relève de la catégorie marketing dans Cookiequiet. Les recommandations de TikTok indiquent que si vous devez obtenir un consentement, votre site doit cesser de déposer et d’utiliser des cookies quand un visiteur refuse, avec un gestionnaire de balises, une plateforme de gestion du consentement ou le mode consentement du pixel TikTok.

Option 1 : marquer le code de base

Placez le code de base juste après la balise Cookiequiet et ne changez que la balise d’ouverture :

html
<script type="text/plain" data-cq-category="marketing">
  /* code de base du pixel TikTok copié depuis Events Manager, inchangé :
     il définit ttq, puis appelle ttq.load('YOUR_PIXEL_ID') et ttq.page() */
</script>

Cookiequiet l’exécute quand le marketing est accordé : immédiatement lors des visites suivantes où le choix enregistré l’inclut, et au moment du clic quand le visiteur accepte pendant la visite. Jusque-là, rien ne se charge depuis analytics.tiktok.com et aucun cookie _ttp n’est déposé. Les appels d’événements dans le code de vos pages, comme ttq.track('CompletePayment'), vont dans des scripts marqués de la même façon. Les balises déjà marquées pour CookieYes ou Cookiebot continuent de fonctionner ; voir migrer depuis CookieYes.

Option 2 : le mode consentement du pixel TikTok

La documentation développeur de TikTok décrit un mode « default opt-out » (refus par défaut) pour les sites qui doivent demander d’abord. Ajoutez "holdConsent", "revokeConsent" et "grantConsent" au tableau ttq.methods du code de base, et appelez ttq.holdConsent() avant ttq.load(). Le pixel met alors les événements en file d’attente sans les partager. ttq.grantConsent() les envoie, y compris ceux mis en file pendant la session ; ttq.revokeConsent() les abandonne et arrête le partage. TikTok précise que la révocation n’affecte pas les données déjà partagées. Reliez-le à Cookiequiet avec l’événement cq:consent, qui porte les catégories accordées dans detail.categories et le choix enregistré, s’il existe, dans detail.state :

html
<script>
  window.addEventListener('cq:consent', function (e) {
    if (!window.ttq) return;
    if (e.detail.categories.indexOf('marketing') >= 0) ttq.grantConsent();
    else if (e.detail.state) ttq.revokeConsent();
  });
</script>

L’écouteur ne révoque qu’une fois que le visiteur a fait un choix : les événements restent donc en file d’attente tant que le bandeau est ouvert. Placez-le avant le code de base. Notez la différence avec l’option 1 : ici, le script TikTok se charge sur chaque page, et seul le partage attend le consentement. Si le bloqueur automatique est activé et que le code de base s’exécute après Cookiequiet (depuis Tag Manager, par exemple), Cookiequiet retient de toute façon analytics.tiktok.com sous marketing jusqu’au consentement : l’option 1 est donc le choix le plus simple là où vous pouvez modifier le code.

Et Google Tag Manager ?

TikTok documente une installation via Tag Manager depuis l’Events Manager. Pour la placer derrière le consentement, donnez à la balise du pixel un déclencheur Événement personnalisé sur cq_consent, certains événements personnalisés, condition cq_marketing equals true, avec les options de déclenchement des balises réglées sur une fois par page, et ajoutez ad_storage sous « Require additional consent for tag to fire ». Cookiequiet pousse cq_consent à chaque chargement de page où un choix est enregistré et après chaque choix, et accorde ad_storage avec le marketing. Le guide Google Tag Manager explique les variables.

Points propres à l’UE

• L’Events API envoie les mêmes conversions depuis votre serveur. Elle décrit le même visiteur : n’envoyez donc ces événements que pour les visiteurs dont l’entrée du registre des consentements inclut le marketing, comme avec le pixel Meta et son API Conversions.
• L’Advanced Matching envoie des adresses e-mail ou des numéros de téléphone hachés avec les événements ; cela relève de la même finalité marketing.
• Listez les cookies du pixel avec leur durée de vie de 13 mois dans votre politique cookies ; le scanner nomme le pixel TikTok quand il le trouve.

Comment tester ?

1. Ouvrez le site dans une fenêtre de navigation privée et cliquez sur Tout refuser. Aucun cookie _ttp et, avec l’option 1, aucune requête vers analytics.tiktok.com.
2. Effacez les cookies, cliquez sur Tout accepter, rechargez : le pixel se charge, _ttp apparaît, et TikTok Pixel Helper montre l’événement de page.
3. Dans l’Events Manager, les événements de test montrent la visite.
4. Consultez le registre des consentements dans le tableau de bord Cookiequiet.

Cookiequiet est gratuit pour un site, ciblage géographique compris ; Starter coûte 3 € par site et par mois, avec des pages vues illimitées.