Ce que fait l’API de conversion
Une API de conversion (CAPI) envoie les événements de conversion directement du serveur de Storeep à la plateforme publicitaire, sans passer par le navigateur de l’acheteur. Comme elle fonctionne de serveur à serveur, elle n’est pas affectée par les bloqueurs de publicité, les paramètres de confidentialité du navigateur ou les limites de suivi iOS, et elle transmet des informations client hachées pour améliorer la qualité de correspondance pour les enchères intelligentes et les audiences similaires. Pour les pixels côté navigateur, consultez l’article associé Pixels navigateur.
Vous pouvez utiliser à la fois un pixel navigateur et une CAPI pour la même plateforme. Storeep attribue aux deux un identifiant d’événement partagé, construit à partir du type d’événement et du numéro de commande, afin que la plateforme les déduplique en une seule conversion au lieu d’en compter deux.
Quelles plateformes proposent une CAPI
- Facebook / Meta Conversion API.
- TikTok Events API.
- Snapchat Conversions API.
X et Google Ads n’ont pas d’API de conversion côté serveur dans Storeep ; elles sont uniquement côté navigateur.
Ce qui est envoyé
Pour chaque commande éligible, Storeep envoie la valeur et la devise de la commande, les articles commandés et les signaux de l’acheteur : email haché, téléphone haché, identifiant client haché (external_id), adresse IP, user agent, et, pour Facebook et Snapchat, le pays du marché haché. Il transmet aussi tout identifiant de clic publicitaire trouvé dans les cookies de l’acheteur (Facebook _fbc et _fbp, TikTok ttclid, Snapchat ScCid) pour que la plateforme puisse attribuer la conversion au clic d’origine.
Types d’événements de conversion
- Facebook : uniquement Lead ou Purchase. La CAPI Facebook n’envoie pas les événements ajout au panier ou passage en caisse.
- TikTok : Lead, Purchase, Place an order ou Complete payment.
- Snapchat : Purchase ou Reserve.
Devise et commandes à valeur nulle
Chaque événement utilise la devise propre à la commande lorsque la plateforme le permet ; sinon, la valeur est convertie en USD. La CAPI Facebook ignore toute commande dont le total est 0, car Meta rejette les conversions sans valeur, ce qui la rend cohérente avec le pixel navigateur Facebook.
Filtrage des commandes abandonnées
C’est le comportement clé à comprendre. Une commande toute neuve déclenche toujours l’envoi via la CAPI. Une commande abandonnée est différente : elle n’est envoyée que si vous activez l’option Commandes abandonnées pour cette entrée CAPI, et uniquement au moment où le statut de la commande passe de abandonné à un autre statut.
- Avec Commandes abandonnées désactivé, les commandes abandonnées récupérées ne sont jamais transmises à la plateforme.
- Avec l’option activée, l’événement se déclenche lorsque la commande sort du statut abandonné, que vous changiez le statut manuellement ou que l’application Automator le fasse automatiquement.
- Si Automator n’est pas installé, vous devez changer le statut vous-même pour que l’événement soit envoyé.
- L’option est propre à chaque entrée, vous pouvez donc activer le suivi des commandes abandonnées pour un Pixel ID et le laisser désactivé pour un autre.
Installer une CAPI et ses champs
- Ouvrez Apps dans le menu de gauche.
- Trouvez l’application Conversion API souhaitée et cliquez sur Installer, puis confirmez.
- Ouvrez à nouveau l’application et cliquez sur Ajouter un nouveau pixel pour créer une entrée.
Chaque entrée comprend les champs suivants :
- Activer : si activé, les événements de conversion sont envoyés de serveur à serveur. Activé par défaut.
- Commandes abandonnées : l’option de filtrage décrite ci-dessus. Désactivée par défaut.
- Nom du compte publicitaire : un libellé pour votre usage personnel uniquement.
- Pixel ID : votre Pixel ID Meta, TikTok ou Snapchat.
- Marchés : les marchés de la boutique couverts par cette entrée. Sélectionnez-en un ou plusieurs.
- Type d’événement de conversion : les options de plateforme listées ci-dessus.
- Jeton d’accès : le jeton d’accès à l’API de conversion généré dans le gestionnaire d’événements de la plateforme. Obligatoire.
- Activer le mode test : si activé, les événements sont envoyés comme événements de test.
- Code de test : le code d’événement de test fourni par la plateforme, par exemple TEST_1234. Obligatoire si le mode test est activé.
Mode test
Avec le mode test activé, les événements apparaissent dans la vue des événements de test de la plateforme, ce qui vous permet de vérifier l’intégration sans toucher aux données réelles. Les événements de test ne servent pas à l’enchère publicitaire ni à l’optimisation, pensez donc à désactiver le mode test avant de lancer vos campagnes.
Comment les marchés ciblent une CAPI
Une entrée CAPI ne se déclenche que pour les commandes passées dans les marchés que vous avez sélectionnés. Une commande dans un marché non sélectionné ne déclenchera pas cette entrée, ce qui vous permet d’utiliser un Pixel ID et un jeton d’accès différents par pays depuis la même boutique.
Points à vérifier
- Utilisez le même Pixel ID sur votre pixel navigateur et votre CAPI pour que la plateforme déduplique les deux en une seule conversion.
- Si les événements n’apparaissent plus dans le gestionnaire d’événements de la plateforme, il se peut que votre jeton d’accès ait expiré. Générez-en un nouveau et mettez à jour l’entrée.
- Chaque entrée est indépendante. Vous pouvez ajouter plusieurs entrées par plateforme, chacune avec son propre Pixel ID, jeton d’accès, marchés, type d’événement et paramètre de commande abandonnée.
- Pensez à désactiver le mode test avant de passer en production, sinon vos conversions réelles ne seront pas comptabilisées.