Stape
Rechercher
Essayer gratuitement

Snapchat CAPI expliqué et guide d'installation complet

Mis à jour
4 déc. 2024
Publié
3 avr. 2022
Egalement disponible

Les restrictions de suivi ont un effet considérable sur la précision des données d'analyse. Les mises à jour iOS ont causé le plus gros problème pour les trackers Web et d'applications. La dernière mise à jour d'Apple a causé tout un problème parmi les entreprises qui dépendent de la publicité - toutes les applications doivent demander la permission de l'utilisateur avant d'utiliser des trackers. 

Selon des recherches récentes, environ 80 % des utilisateurs se désengagent du suivi. Il est fortement affecté sur les applications dont le principal profit repose sur la publicité, telles que Facebook, TikTok et Snapchat. Ces entreprises ont commencé à demander aux annonceurs de mettre en place un suivi côté serveur pour améliorer la précision du suivi.

Nous avons déjà des articles de blog sur la configuration de CAPI Facebook et l'API événements de TikTok. Dans cet article de blog, je voudrais vous raconter de l'API conversion de Snapchat et de la façon de la configurer à l'aide du conteneur du serveur Google Tag Manager.

À propos d'API conversion de Snapchat

L'API Conversions de Snap vous permet de transmettre des événements Web, d'application et hors ligne de votre serveur au serveur Snap. La documentation officielle indique que Snap CAPI aide à optimiser les campagnes et à améliorer le suivi et le ciblage des conversions.

L'API conversion de Snapchat permet d'envoyer les mêmes événements et paramètres d'événement que les pixels Web. Il existe deux manières principales d'implémenter Snap CAPI : l'intégration directe, qui consiste à envoyer des informations côté serveur de vos serveurs directement aux serveurs de Snap, ou les intégrations de partenaires qui incluent le serveur Google Tag Manager (GTM).

L'équipe Stape a créé la balise API Conversion Snap pour le conteneur du serveur Google Tag Manager. La logique de Snap tag est plus compliquée que FB et TikTok, ce qui fait également la mise en œuvre plus difficile. Nous avons essayé de simplifier la configuration de CAPI Snap pour les utilisateurs de Stape. Dans cet article de blog, nous allons montrer comment l'utiliser. 

Déduplication des événements Snapchat. Ressemblant à Facebook et TikTok, Snapchat prend en charge la déduplication des événements, ce qui signifie que vous pouvez utiliser à la fois le suivi du navigateur et du serveur. Pour supprimer les événements redondants, vous devez utiliser le dédoublonnage d'événements. Les clés de déduplication principales sont Client_dedup_id (qui permet une fenêtre de déduplication de 48 heures) et Transaction_id (permet une fenêtre de déduplication de 30 jours).

Les cookies ne sont disponibles que via le suivi Web, ce qui signifie que si vous décidez d'implémenter uniquement CAPI Snap, il ne pourra pas utiliser de cookies. Ainsi, jusqu'à ce que les cookies soient totalement obsolètes, la plupart des plates-formes, y compris Snap, recommandent d'utiliser le suivi Web + serveur. 

La balise Snap pour le Web Google Tag Manager ne prend pas en charge event_id, ce qui signifie que vous devez utiliser une balise HTML personnalisée pour configurer la déduplication des événements.

Événements CAPI Snapchat : CAPI prend en charge tous les types de noms d'événements standard disponibles pour le pixel Web Snap. Il prend également en charge les noms d'événements personnalisés.

Paramètres d'événement . Snapchat a une documentation détaillée qui décrit les paramètres d'événement pris en charge par CAPI. Cliquez sur ce lien pour le vérifier. Tous les paramètres utilisateur (e-mail en texte brut, identifiant mobile, adresse IP et numéro de téléphone) doivent être normalisés. Une fois les paramètres normalisés, ils doivent être hachés au format hexadécimal SHA256 en minuscules.

Test d'événement serveur. Bien que Snapchat dispose d'excellentes fonctionnalités pour tester les événements de pixel à l'aide de la page de diagnostic des pixels, malheureusement, pour l'instant, Spanchat n'a pas de fonctionnalité similaire à l'ID de test de FB pour tester les événements du serveur en temps réel.

La seule façon de vérifier que Snap a reçu et traité correctement les données du serveur est de vérifier via les données de l'API de conversion dans le gestionnaire d'événements Snap.

Exigences d'authentification. Snapchat contrôle toutes les autorisations et demandes adressées à l'API marketing à l'aide de jetons d'accès. Pour configurer CAPI Snapchat, il est nécessaire d'obtenir un jeton d'accès. Les jetons d'accès Snapchat sont de courte durée. C'est pourquoi nous avons utilisé Firestore pour actualiser les jetons d'accès instantanés. Je vais montrer comment générer un jeton d'accès instantané dans cet article de blog.

Avantages de l'API conversion de Snapchat

Confidentialité. Le suivi de serveur à serveur, à la base, est un bâtiment technologique avec une politique de confidentialité à l'esprit. Contrairement au suivi des pixels Web, avec le suivi s2s, vous pouvez contrôler strictement les données que vous envoyez à chaque réseau. Ils ne recevront que les données configurées dans les requêtes du serveur.

Meilleure optimisation des annonces. CAPI aide à obtenir plus de données sur ses utilisateurs, ce qui rend les algorithmes publicitaires Snap plus suffisants. Dans la documentation officielle, Snapchat indique que la mise en œuvre de CAPI contribuera à améliorer le coût par action.

Un public plus qualitatif. CAPI améliorera le remarketing et les campagnes similaires car il enverra à Snapchat plus de données sur vos utilisateurs, et le nombre d'événements devrait augmenter. Lorsque les utilisateurs n'autorisent pas les applications ou les sites à suivre les utilisateurs, CAPI peut toujours être utilisé pour envoyer des événements. 

Amélioration du suivi des conversions. Étant donné que les événements de serveur ne peuvent pas être bloqués dans la plupart des cas, cela permettra aux utilisateurs de suivre tous les événements générés par les utilisateurs.

Fonctionnement de la balise API conversion de Snapchat sGTM

La logique de la balise Snapchat CAPI est plus compliquée que celle de Facebook et de TikTok en raison des exigences de vérification Snap. Il est nécessaire d'utiliser des jetons d'accès pour envoyer des événements de serveur à Snap. Les jetons d'accès générés par Snapchat sont de courte durée. Lorsque le jeton expire, Snapchat envoie une erreur d'expiration du jeton 401. Il est nécessaire de renouveler le jeton d'accès à l'aide de Actualiser le jeton d'accès et de renvoyer les rêquetes.

La balise Stape CAPI Snap utilise Firebase pour obtenir et stocker le jeton d'accès. La logique de cette balise est décrite sur le schéma ci-dessous.

access token

Les exigences de configuration de cette balise sont différentes pour les utilisateurs de Stape et les utilisateurs non-Stape.

Si vous utilisez Stape, vous devrez créer un compte Firebase, créer un compte Google Services et le lier à votre compte Stape. Je vais vous montrer comment le faire plus tard dans cet article de blog.

Si vous n'utilisez pas Stape, vous devrez gérer indépendamment le processus d'actualisation du jeton d'accès. Consultez la documentation de l'API Snap Marketing pour plus de détails.

De quoi avez-vous besoin pour configurer l'API conversion de Snapchat

1. Pixel de Snapchat.

Celui-ci est facile à trouver. Suivez ces étapes pour créer un pixel Snap. 

2. Applications OAuth.

Il est nécessaire de créer l'ID client, le secret du client et le jeton d'actualisation de l'API dont vous aurez besoin pour configurer une balise Snap sGTM. Pour créer une application OAuth, vous devez disposer de l'autorisation d'administrateur de l'organisation. Ouvrez Snap Business Manager -> Cliquez sur Détails de l'entreprise -> Cliquez sur +Applications OAuth -> Ajouter le nom de l'application -> Ajouter l'URI de redirection Snap. Si vous utilisez Stape pour configurer Snap CAPI, utilisez cette valeur :

https://app.stape.io/integration/snapchat/callback 

Si vous n'utilisez pas Stape, vous devez créer un URI de redirection.

snapchat api

3. ID client et Secret du client.

Celui-ci est nécessaire pour paramétrer un Snap tag. Il sera généré une fois que vous aurez créé des applications OAuth.

!

Enregistrez la clé secrète du client Snap.

Veillez à enregistrer la clé secrète Snap Client. Il ne sera plus disponible

Snap client secret key

4. Compte de service Google.

1. Ouvrez votre compte stape.io -> Ouvrez le conteneur sGTM -> Cliquez sur Power-Ups -> Cliquez sur Config sous le compte de service Google.

google service account

2. Connectez-vous au compte Google Cloud (ou créez-en un) -> Dans le menu de navigation dans le coin supérieur gauche, sélectionnez IAM & Admin -> Comptes de service -> Cliquez sur Créer un compte de service.

google service account

3. Ajouter un compte -> Cliquez sur Suivant -> Sélectionnez les Rôles BigQuery Data Editor pour l'accès à BigQuery ou le rôle Cloud Datastore User pour Firestore.

bigquery data editor

À la troisième étape, cliquez sur pas besoin de sélectionner quoi que ce soit ; cliquez simplement sur Terminé (Done).

4. Ouvrez le compte de service que vous avez récemment créé -> Ouvrez onglet Clés  -> Cliquez sur Ajouter une clé -> Sélectionnez le type JSON dans la fenêtre contextuelle -> Cliquez sur Créer. Un fichier sera téléchargé sur votre ordinateur.

private key

5. Revenez au compte stape.io -> Téléchargez la Clé que vous avez récemment générée -> Cliquez sur Enregistrer.

private key

5. Compte Firebase

1. Ouvrez https://firebase.google.com/ -> cliquez sur créer un projet -> sélectionnez le projet que vous avez utilisé sur Google Cloud -> cliquez sur continuer -> cliquez sur Ajouter Firebase à la troisième étape.

2. Cliquez sur Construire -> Base de données Firestore.

firestore database

3. Cliquez sur créer une base de données -> sélectionnez Démarrer en mode production -> Cliquez sur Suivant (Next)

production mode

4. Sélectionnez la région de votre firebase. Il doit correspondre à la région de l'emplacement de votre serveur sGTM. Vous pouvez vérifier la région en ouvrant un compte stape.io -> ouvrir le conteneur sGTM -> vérifier l'emplacement du serveur. Pour faire correspondre l'emplacement du serveur sGTM avec Firebase, veuillez consulter ce lien.

create database

5. Cliquez sur Démarrer une collection. Ici, vous devrez définir Firebase Path qui sera récemment utilisé dans la balise CAPI Snap. J'ai ajouté le chemin parent du document /stape-demo et l'ID de document Snapchat-auth -> Cliquez sur Enregistrer.

api snapchat
api snapchat
api snapchat

6. Jeton d'actualisation de l'API 

Si vous n'utilisez pas Stape, suivez la documentation Snap sur la création du jeton d'actualisation de l'API. Si vous utilisez Stape, veuillez suivre ces étapes:

1. Connectez-vous à votre compte Stape et cliquez sur Outils -> Assistant d'authentification Snapchat -> Ajouter l'ID Snap Client créé à l'étape 3 -> Démarrer l'autorisation.

client id snapchat in stape

2. Vous serez redirigé vers la page d'autorisation Snap. Terminer l'autorisation.

stape in snapchat

3. Ajoutez l'ID client, le secret client et cliquez sur Générer un jeton d'actualisation.

snapchat in stape

4. Sur l'écran suivant, vous verrez Snap Refresh Token. Vous aurez besoin de ce jeton d'actualisation pour configurer Snap Tag. Copiez le jeton d'actualisation.

snapchat in stape

Comment configurer l'API conversion de Snapchat à l'aide du serveur Google Tag Manager

2. Envoyez les données au conteneur du serveur GTM. Les deux envois de données les plus populaires vers sGTM sont Google Analytics 4 et Data Tag/Data Client.

3. Téléchargez la balise Snapchat depuis GitHub -> Ouvrez les sections des modèles dans le conteneur du serveur Google Tag Manager -> Cliquez sur Nouveau.

4. Cliquez sur les trois points dans le coin supérieur droit -> Cliquez sur Importer -> Sélectionnez le modèle de tag Snapchat que vous avez récemment téléchargé depuis GitHub -> Cliquez sur Enregistrer.

snapchat api tag

5. Créez une balise Snap dans le conteneur sGTM -> Sélectionnez le nom de l'événement.

Standard - sélectionnez l'un des noms standard. 

Hérité du client - dans ce cas, la balise essaiera d'analyser les noms d'événements sGTM et de les faire correspondre aux événements Snap standard.

Personnalisé - utilisez un nom personnalisé.

6. Ajouter Snap Pixel ID -> Ajouter un jeton d'actualisation de l'API. Nous avons décrit ci-dessus dans cet article comment le générer -> Ajouter un ID client et un secret client.

snapchat conversion api

7. Ouvrez la section Firebase Settings de la balise et ajoutez Firebase Path.

firebase path

8. Ajoutez des données d'utilisateur et d'événements.

add user and event data

9. Si vous souhaitez utiliser le suivi de la méthode hybride (web + serveur) pour Snap, vérifiez d'avoir ajouté l'ID d'événement aux balises Snap Web et serveur. Pour l'instant, la balise Web Snap ne prend pas en charge event_id, utilisez donc un code HTML personnalisé pour configurer les balises Web Snap.

snapchat api 

10. Ouvrez les débogages Web et serveur GTM et testez que les balises Snap sont déclenchées correctement.

snapchat api

11. Malheureusement, Snap ne dispose pas d'un outil permettant de dépanner les événements du serveur en temps réel. La seule option pour vérifier que Snap a reçu des événements de serveur est attendre que vous voyiez ces événements dans Snap Events Manager.

snapchat conversion api

Conclusion

La documentation officielle de Snap indique que la mise en œuvre de l'API conversion contribuera à améliorer les enchères et à réduire le coût par action. Bien que la mise en œuvre soit plus compliquée que FB ou TikTok, cela peut aider à améliorer les résultats de vos campagnes payantes.

Si vous avez besoin d'aide pour configurer le suivi côté serveur pour l'API conversion de Snapchat, n'hésitez pas à nous contacter. Notre équipe d'experts se fera un plaisir de vous aider à démarrer. Merci d'avoir lu!

Tagged with:sGTM tag

Essayez Stape pour tout ce qui concerne le côté serveurmaintenant!