Documentation TikTok Pixel & CAPI
Tout ce qu'il faut pour installer, configurer et vérifier un suivi TikTok navigateur et serveur précis sur Shopify.
Aperçu
TikTok Pixel & CAPI connecte votre boutique Shopify à TikTok pour le suivi des conversions et l'attribution publicitaire. Elle déclenche un pixel TikTok côté navigateur et envoie des événements correspondants côté serveur via l'API de conversion, en partageant un identifiant d'événement pour que TikTok les dédoublonne — capturant les conversions même au-delà des bloqueurs et sur les checkouts COD ou externes. L'application est gratuite et entièrement intégrée à l'admin Shopify.
Pixel navigateur et CAPI côté serveur pour chaque événement.
Un identifiant d'événement partagé permet à TikTok de compter chaque conversion une seule fois.
Purchase côté serveur pour les commandes COD et TikTok Shop.
Aucune facturation ni connexion externe — elle vit dans l'admin Shopify.
Démarrage
Vous pouvez suivre vos conversions en quelques minutes. Installez l'application, activez l'intégration, ajoutez un pixel et vérifiez vos événements.
-
1
Installer l'application
Ajoutez TikTok Pixel & CAPI depuis le Shopify App Store et ouvrez-le depuis votre admin Shopify — aucun compte séparé à créer.
-
2
Activer l'intégration au thème
Dans l'éditeur de thème, activez l'intégration TikTok Pixel & CAPI pour que le pixel navigateur se charge sur votre boutique.
-
3
Ajouter votre premier pixel
Saisissez l'ID de votre pixel TikTok et, pour le suivi côté serveur, votre jeton d'accès, puis choisissez les pages et les événements à suivre.
-
4
Activer le pixel
Basculez le pixel sur actif pour qu'il commence à déclencher les événements navigateur et serveur.
-
5
Vérifier avec les outils TikTok
Utilisez le TikTok Pixel Helper et Events Manager pour confirmer que les événements arrivent et se dédoublonnent correctement.
Ajouter un pixel
Chaque pixel se configure indépendamment, vous pouvez donc gérer plusieurs pixels avec des réglages différents depuis une seule application.
L'ID de votre pixel TikTok issu de TikTok Events Manager — il alimente le pixel navigateur.
Un libellé pour distinguer plusieurs pixels dans le tableau de bord.
Un jeton d'accès TikTok généré dans Events Manager, requis pour envoyer les événements de l'API de conversion côté serveur.
Un code facultatif qui dirige les événements vers un flux de test isolé pendant que vous validez la configuration.
Choisissez toutes les pages ou des types de pages sélectionnés, et activez ou désactivez chaque événement.
Activez ou suspendez le pixel à tout moment sans supprimer sa configuration.
Le pixel navigateur ne nécessite que l'ID du pixel ; ajoutez le jeton d'accès pour débloquer le suivi CAPI côté serveur.
Événements suivis
L'application suit les six événements TikTok standard tout au long du parcours d'achat. Chacun peut être activé par pixel.
Se déclenche quand un visiteur charge une page suivie.
Se déclenche quand une page produit est consultée.
Se déclenche quand un article est ajouté au panier.
Se déclenche quand un client commence le checkout.
Se déclenche quand les informations de paiement sont saisies.
Se déclenche quand une commande est finalisée — côté serveur pour le COD et le checkout externe.
CAPI côté serveur & déduplication
Le double envoi transmet chaque événement depuis le navigateur et depuis votre serveur, puis s'appuie sur un identifiant d'événement partagé pour un comptage précis.
-
1
Le pixel navigateur se déclenche
L'extension web pixel enregistre l'événement dans le navigateur et envoie une balise au backend de l'application.
-
2
Le serveur envoie à la CAPI
Le backend envoie le même événement au point de terminaison de l'API de conversion TikTok, avec les données client hachées.
-
3
TikTok dédoublonne
Comme les deux envois partagent un identifiant d'événement, TikTok les fusionne et ne compte la conversion qu'une seule fois.
Le chemin côté serveur continue de fonctionner quand le pixel navigateur est bloqué, donc les conversions sont toujours rapportées.
Checkout externe & COD
Quand le checkout a lieu hors de votre boutique — paiement à la livraison ou tiers comme TikTok Shop — le pixel navigateur ne peut pas déclencher de Purchase, donc l'application le gère côté serveur.
Activez le suivi Purchase côté serveur pour le COD et les checkouts tiers dans les paramètres.
L'événement Purchase est déclenché depuis le webhook orders/paid de Shopify quand la commande est marquée payée.
Chaque commande payée est envoyée à TikTok, même si l'acheteur n'a jamais atteint votre page de remerciement.
C'est la façon la plus fiable de suivre les conversions pour les boutiques axées COD et les vendeurs TikTok Shop.
Paramètres
Affinez la construction et l'envoi des événements grâce à quelques réglages sans code.
Choisissez si les ID de contenu utilisent l'ID de variante (recommandé) ou l'ID de produit, pour correspondre à votre catalogue TikTok.
Déclenchez des événements quand les visiteurs cliquent sur un élément que vous ciblez avec un sélecteur CSS — sans code.
Définissez le fuseau horaire de votre boutique pour que les comptes du tableau de bord et les rapports correspondent à votre journée.
Activez le hachage SHA-256 de l'e-mail, du téléphone et de l'identifiant externe par paramètre pour améliorer la qualité de correspondance.
Vérification & dépannage
Confirmez que les événements arrivent et se dédoublonnent, et utilisez la page Rapports pour diagnostiquer ce qui ne fonctionne pas.
Utilisez l'extension de navigateur pour confirmer que le pixel se charge et déclenche les événements sur votre boutique.
Vérifiez les événements entrants, et utilisez votre code d'événement test pour les inspecter d'abord dans un flux isolé.
Chaque événement s'affiche comme En file, Envoyé, Échoué ou Ignoré, avec des journaux d'erreurs pour expliquer les échecs.
Contactez notre équipe de support depuis le lien dans la barre latérale — nous répondons généralement en quelques minutes.
Si les événements serveur sont en Échoué, revérifiez le jeton d'accès ; s'il manque des événements navigateur, confirmez que l'intégration au thème est activée.
Commencez à capturer chaque conversion TikTok dès aujourd'hui
Tout ce qu'il faut pour installer, configurer et vérifier un suivi TikTok navigateur et serveur précis sur Shopify.
Ajouter à Shopify