Skip to main
← Sommaire

Connecter Snapchat Conversions API

Envoyer vos conversions à Snapchat côté serveur avec un Pixel ID + token d'accès, avec déduplication face au Snap Pixel navigateur.

Walityk envoie vos events à la Snapchat Conversions API (v3), côté serveur, avec déduplication event_id face au Snap Pixel navigateur. Les données personnelles (e-mail, téléphone, ID utilisateur) sont hachées en SHA-256 avant l’envoi.

Compter 5 minutes.

Prérequis

  • Un compte Snapchat Ads avec un Snap Pixel créé dans le Gestionnaire d’événements.

1. Récupérer les identifiants

  1. Pixel ID : Snapchat Ads Manager → Gestionnaire d’événements → votre Snap Pixel. L’ID est un UUID (format b1234567-89ab-cdef-0123-456789abcdef).
  2. Access Token : générez un token avec le scope snapchat-marketing-api (Snapchat Business → Conversions API → génération de token). C’est ce token qui autorise l’envoi server-side.

2. Configurer la destination

  1. Dashboard Walityk → Destinations → votre site → carte Snapchat Conversions API.
  2. Collez le Pixel ID et l’Access Token.
  3. Enregistrer.

3. Ce que Walityk envoie

  • Les events sont mappés vers le jeu d’événements standard Snapchat : PAGE_VIEW, VIEW_CONTENT, ADD_CART, START_CHECKOUT, PURCHASE, SIGN_UP, SEARCH. Un event custom non reconnu part en CUSTOM_EVENT_1.
  • Correspondance utilisateur : e-mail et téléphone (s’ils sont captés) sont hachés en SHA-256 ; l’ID visiteur part comme external_id haché ; le User-Agent est transmis tel quel.
  • Le clic Snapchat (ScCid) est capturé automatiquement dans les URLs d’atterrissage et transmis non haché comme sc_click_id : aucune configuration côté tag.
  • La valeur et la devise de la commande, l’order_id et les content_ids sont transmis dans custom_data.

4. Déduplication avec le Snap Pixel navigateur

  • Si vous gardez votre Snap Pixel sur le site, Walityk envoie la copie serveur avec le même event_id → Snapchat déduplique automatiquement les deux signaux.
  • Sans pixel navigateur, seule la Conversions API server-side tourne — suffisant pour le tracking des campagnes (et résistant aux bloqueurs).

5. Vérifier

  1. Destinations → votre site → Snapchat : journal des envois.
  2. Côté Snapchat : Ads Manager → Gestionnaire d’événements → l’historique des events reçus via l’API.

Erreurs fréquentes

  • HTTP 401/403 : token sans le scope snapchat-marketing-api ou expiré → régénérez-le.
  • HTTP 400 : Pixel ID mal copié (vérifiez le format UUID).
  • Le consentement publicitaire est respecté : si le visiteur refuse ad_user_data, l’event n’est pas envoyé à Snapchat.

Pour aller plus loin

Besoin d’aide ? hi@walityk.com.