Qu’est-ce que la Snapchat Conversions API ?
La Conversions API de Snap permet à un serveur de transmettre les événements de conversion web directement à Snapchat, par une intégration de serveur à serveur, en complément des événements que le Snap Pixel envoie depuis le navigateur du client. Snap recommande aux annonceurs web de l’utiliser avec le pixel.
Avec WeProfit, un achat Shopify arrive chez Snapchat sous la forme de l’événement PURCHASE, envoyé depuis les serveurs de WeProfit vers le Snap Pixel que vous connectez. Snapchat est inclus dans chaque forfait WeProfit, avec Meta, Google, TikTok, Pinterest, X Ads, Microsoft (programme pilote), Reddit, LinkedIn et Taboola.
Connecter Snapchat dans WeProfit
Connectez d’abord votre boutique Shopify. L’envoi vers Snapchat nécessite deux valeurs : l’ID de votre Snap Pixel et un jeton Conversions API. Seul un administrateur de l’organisation de votre entreprise Snapchat peut créer ce jeton.
- Dans le Gestionnaire de publicités Snap, ouvrez le menu en haut à gauche, sélectionnez le Gestionnaire d’événements et cliquez sur votre pixel. Copiez l’ID du pixel affiché en haut : un long code avec des tirets.
- Pour créer le jeton, ouvrez le menu du Gestionnaire de publicités et sélectionnez les informations sur l’entreprise. Allez jusqu’aux jetons Conversions API, générez un jeton, puis copiez-le.
- Utilisez bien ce jeton Conversions API. Le jeton d’accès affiché dans la configuration de la source d’événements du Gestionnaire d’événements est un autre type de jeton et ne fonctionne pas pour cette connexion.
- Dans WeProfit, ouvrez Réseaux publicitaires > Snapchat et sélectionnez « Ajouter une destination ». Saisissez l’ID du Snap Pixel et le jeton Conversions API. Le libellé est facultatif et vous aide si vous connectez plusieurs pixels.
- Laissez les conditions vides pour envoyer tous les événements éligibles, ou ajoutez des conditions, par exemple sur le pays, l’événement, la valeur de la commande ou la campagne, pour limiter ce que ce pixel reçoit. Sélectionnez ensuite « Connecter Snapchat ».
- Sélectionnez « Envoyer un test ». WeProfit envoie un événement de test à l’endpoint de validation de Snap, qui vérifie si un événement est correctement construit, et indique si Snap l’a accepté. La destination Snapchat de WeProfit n’a pas de code d’événement de test : il n’existe donc pas de mode test pour les événements réels.
Les achats et les événements de paiement envoyés à Snapchat
Depuis une boutique Shopify, WeProfit envoie à Snapchat vos achats et deux étapes du paiement que son pixel web enregistre : le début du paiement et l’ajout des informations de paiement. Les achats proviennent du webhook de commande de Shopify, et l’achat de chaque commande est envoyé au plus une fois à chaque pixel connecté.
WeProfit n’envoie un événement à Snapchat que s’il contient au moins une des clés de correspondance demandées par Snap : une adresse e-mail hachée, un numéro de téléphone haché, ou à la fois une adresse IP et un agent utilisateur. Il n’envoie un PURCHASE qu’avec une valeur et une devise. Il ignore les événements auxquels il manque ces données, et un événement ignoré n’a pas de ligne dans le journal d’envoi.
La liste des événements standard de Snap ne comporte pas d’événement de prospect : WeProfit ignore donc les prospects pour Snapchat au lieu de les envoyer sous un autre nom. Les événements personnalisés et les remboursements ne sont pas envoyés à Snapchat, et rien ne retire un achat que Snapchat a déjà reçu.
Chaque achat contient le total de la commande tel que Shopify l’indique, dans la devise de la commande, les produits avec leur ID, leur quantité et leur prix, le nombre d’articles et l’ID de commande Shopify en order_id.
| Événement de la boutique | Événement Snapchat |
|---|---|
| Checkout started | START_CHECKOUT |
| Payment information added | ADD_BILLING |
| Purchase | PURCHASE |
Les informations client envoyées avec chaque achat
Pour aider Snapchat à associer un achat à un utilisateur Snapchat, WeProfit envoie des informations tirées de la commande Shopify, hachées en SHA-256 : l’adresse e-mail et le numéro de téléphone de l’acheteur, ainsi que le prénom et le nom, la ville, l’État ou la région, le code postal et le pays de l’adresse de livraison, ou à défaut de l’adresse de facturation. L’adresse IP et l’agent utilisateur partent non hachés. Quand WeProfit en dispose, il envoie aussi un ID externe, c’est-à-dire un hachage SHA-256 de l’ID de visiteur WeProfit.
Quand WeProfit en dispose, l’achat contient aussi l’ID de clic et le cookie de Snapchat : la valeur ScCid que Snapchat ajoute à l’URL de votre page de destination quand quelqu’un clique sur votre publicité, envoyée en sc_click_id, et le cookie _scid du Snap Pixel, envoyé en sc_cookie1. WeProfit ne charge pas le Snap Pixel : le cookie _scid n’existe donc que si votre boutique l’utilise.
Snap Pixel et Conversions API : éviter le double comptage
Snap associe un événement du Snap Pixel à un événement de la Conversions API pour le même ID de pixel quand le client_dedup_id du pixel est égal à l’event_id du serveur et que les noms d’événement correspondent, dans un délai de 48 heures. Pour les événements PURCHASE, Snap peut aussi associer le transaction_id du pixel à l’order_id de l’événement serveur, pendant 30 jours au maximum.
WeProfit ne charge pas le Snap Pixel. Il envoie les événements Snapchat depuis son serveur uniquement, chacun avec son propre ID d’événement. Un achat part sous la forme pur_ suivi d’un code de boutique et de l’ID de commande Shopify, par exemple pur_a1b2c3d4-6012345678901, une fois par commande et par pixel, et une nouvelle tentative réutilise cet ID. Son order_id est l’ID numérique de la commande Shopify, par exemple 6012345678901, et non le numéro de commande que voient vos clients.
Si un Snap Pixel déclare aussi des achats pour le même ID de pixel, par exemple par une application ou par le code de votre thème, ses ID d’événement ne correspondront pas à ceux de WeProfit. Snap se rabat alors sur l’ID de commande : il ne peut associer les deux copies que si le pixel transmet le même ID de commande Shopify en transaction_id. Vérifiez comment votre pixel déclare les achats, gardez un seul émetteur d’achats par Snap Pixel tant que vous n’avez pas confirmé que les ID correspondent, et comparez un achat de test dans le Gestionnaire de publicités Snapchat avec le journal d’envoi WeProfit.
Vérifier l’envoi dans le journal d’envoi CAPI
Ouvrez Réseaux publicitaires > Snapchat dans WeProfit et faites défiler jusqu’au « Journal d’envoi CAPI ». Il liste chaque événement côté serveur envoyé à Snapchat, avec les colonnes Date, Événement, Destination, ID d’événement, Statut, Tentatives et Erreur, et vous pouvez filtrer par destination, par événement et par statut. Le filtre Purchase trouve aussi les événements PURCHASE.
Le journal affiche l’ID d’événement propre à WeProfit, par exemple pur_6012345678901 ; Snapchat le reçoit avec le code de boutique, par exemple pur_a1b2c3d4-6012345678901. Le journal n’a pas de colonne de valeur : vérifiez la valeur d’un achat sur la page Événements de WeProfit. La page Commandes indique l’envoi de chaque commande vers chaque réseau connecté dans sa colonne Réseaux.
Le statut « envoyé » signifie que Snapchat a accepté l’événement, pas qu’il a attribué la commande à une publicité. Si Snapchat refuse le jeton, WeProfit met la connexion en pause et affiche une bannière ; un nouveau jeton ou un « Envoyer un test » réussi la réactive.
| Statut | Signification |
|---|---|
| en attente | En file d’attente, pas encore envoyé. |
| envoyé | Snapchat a accepté l’événement. |
| échec | Un problème temporaire. WeProfit réessaie automatiquement pendant quelques heures, avec le même ID d’événement. |
| abandonné | WeProfit a abandonné : Snapchat a refusé l’événement, avec son message dans la colonne Erreur, ou les tentatives sont épuisées. |
| ignoré (désactivé) | La destination était désactivée ou en pause quand le tour de l’événement est venu. Les événements ignorés pendant qu’elle est désactivée ne sont pas envoyés plus tard. |
| ignoré (avant installation) | L’achat d’une commande passée avant l’installation de WeProfit. Il n’est jamais envoyé. |
Les dépenses publicitaires Snapchat : saisies à la main, pas synchronisées
WeProfit n’a pas de connexion aux comptes publicitaires Snapchat : les dépenses Snapchat ne sont donc pas synchronisées automatiquement. Ajoutez-les de l’une de ces trois façons : en saisies manuelles, sous Bénéfices > Dépenses publicitaires > Saisies manuelles, avec la date, le montant, le réseau, un ID de campagne facultatif et une note facultative ; en planification quotidienne, qui enregistre le même montant chaque jour jusqu’à ce que vous le changiez ; ou par l’API développeur.
Ajoutez l’ID de campagne à une saisie quand vous voulez le bénéfice par campagne Snapchat : la page Attribution associe les dépenses aux commandes attribuées par ID ou par nom de campagne, et les dépenses sans campagne comptent au niveau du canal. Les campagnes Snapchat affichent en général leur ID dans l’Attribution, car aucune connexion à un compte publicitaire Snapchat ne permet de retrouver leur nom. Une saisie manuelle pour un jour donné l’emporte sur une planification quotidienne.
Le détail par campagne de vos publicités Snapchat
WeProfit classe une visite dans Snapchat Ads quand elle porte l’ID de clic ScCid de Snapchat, ou utm_source=snapchat avec un support payant. Avec les Auto-UTMs de Snap, il lit aussi l’ID de la campagne et, quand il est présent, l’ID de la publicité. Pour l’ensemble de publicités, ajoutez le modèle d’URL Snapchat de WeProfit à chaque publicité, après le point d’interrogation de l’URL du site web de la création publicitaire.
Les macros respectent la casse : écrivez {{adSet.id}}, et non {{adset.id}}. Les modèles ne s’appliquent qu’aux nouveaux clics. Dans l’attribution de WeProfit, un clic sur une publicité compte pendant 30 jours et le clic le plus récent l’emporte : cela fonctionne comme une attribution au dernier clic, avec une fenêtre de 30 jours pour les clics publicitaires. Snapchat attribue les conversions selon ses propres paramètres d’attribution, donc ses chiffres et ceux de WeProfit peuvent différer pour les mêmes commandes.
utm_source=snapchat&utm_medium=paid_social&utm_campaign={{campaign.name}}&utm_term={{adSet.name}}&utm_content={{creative.name}}&wpcid={{campaign.id}}&wpasid={{adSet.id}}&wpadid={{ad.id}}