Pinterest

Intégration de la balise Pinterest

CrowdChange prend en charge le suivi par balise Pinterest côté navigateur, la correspondance améliorée (enhanced match) et le suivi optionnel des paiements via l’API Conversions de Pinterest. Une fois connectée, votre balise Pinterest reçoit les événements page, addtocart et checkout. Si un jeton d’accès à l’API Conversions de Pinterest est configuré, CrowdChange envoie également les événements de paiement complétés depuis le serveur.

Configuration

Accédez à Admin -> Paramètres de mise en page -> Meta et analytique
Faites défiler jusqu’à la section Balise Pinterest
Entrez votre ID de balise Pinterest, par exemple 2612345678901
Facultatif : entrez votre ID de compte publicitaire Pinterest
Facultatif : entrez votre jeton d’accès à l’API Conversions de Pinterest
Cliquez sur Enregistrer

Le fragment de code de la balise pour le navigateur et le repli noscript sont automatiquement injectés une fois l’ID de balise enregistré. Les jetons de l’API Conversions sont stockés sous forme de valeurs chiffrées en écriture seule; laissez le champ du jeton vide pour conserver un jeton existant.

Événements suivis

page

Déclenché automatiquement au chargement de la page et lors de la navigation virtuelle entre les pages.

pintrk('page');

addtocart

Déclenché lorsqu’un article est ajouté au panier de paiement.

Paramètre	Type	Description
`currency`	`string`	Code de devise ISO 4217, par exemple `USD`, `CAD`
`value`	`number`	Valeur totale de la charge utile de l’article
`line_items`	`object[]`	Charges utiles des lignes d’article Pinterest

Exemple de charge utile

{
  "currency": "CAD",
  "value": 50,
  "line_items": [
    {
      "product_id": "registration",
      "product_name": "Registration",
      "product_price": 50,
      "product_quantity": 1
    }
  ]
}

checkout

Déclenché lorsqu’un donateur complète avec succès une transaction.

Paramètre	Type	Description
`currency`	`string`	Code de devise ISO 4217
`value`	`number`	Montant total de la transaction
`order_id`	`string`	ID de transaction CrowdChange
`event_id`	`string`	Identifiant de déduplication `transaction_<transaction_id>`
`order_quantity`	`number`	Nombre d’articles de la transaction
`line_items`	`object[]`	Charges utiles des lignes d’article Pinterest

Exemple de charge utile

{
  "currency": "CAD",
  "value": 100,
  "order_id": "1000",
  "event_id": "transaction_1000",
  "order_quantity": 1,
  "line_items": [
    {
      "product_id": "donation",
      "product_name": "Donation",
      "product_price": 100,
      "product_quantity": 1
    }
  ]
}

Correspondance améliorée (Enhanced Match)

Lorsqu’un utilisateur connecté est disponible, CrowdChange charge la correspondance améliorée de Pinterest avec un hachage SHA-256 normalisé du courriel. Les adresses courriel brutes ne sont pas envoyées à la balise du navigateur.

Suivi des paiements côté serveur

Lorsqu’un ID de compte publicitaire Pinterest et un jeton d’accès à l’API Conversions de Pinterest sont tous deux configurés, CrowdChange envoie un événement checkout côté serveur.

Champ	Description
`event_name`	`checkout`
`action_source`	`web`
`event_id`	`transaction_<transaction_id>`
`event_source_url`	URL de la page de paiement, si disponible
`currency`	Devise de la transaction
`value`	Total de la transaction
`order_id`	ID de transaction CrowdChange
`num_items`	Nombre d’articles achetés
`contents`	Identifiants et quantités des articles achetés
`click_id`	Valeur `epik` de Pinterest capturée, si disponible
`em`	Courriel du donateur haché en SHA-256, si disponible
`external_id`	ID d’utilisateur CrowdChange haché en SHA-256, si disponible
`client_ip_address`	Adresse IP de la requête
`client_user_agent`	Agent utilisateur de la requête

Les échecs liés au réseau publicitaire sont journalisés et n’interrompent pas le parcours de paiement du donateur.

Attribution par identifiant de clic (`epik`)

Lorsqu’un visiteur arrive via une publicité Pinterest, Pinterest peut ajouter epik à l’URL ou définir un témoin _epik. CrowdChange capture l’une ou l’autre valeur et la transmet aux événements de paiement côté serveur sous forme de click_id.

Vérifier votre configuration

Après avoir enregistré votre ID de balise :

Visitez n’importe quelle page de votre plateforme et confirmez que la balise Pinterest se charge depuis https://s.pinimg.com/ct/core.js
Naviguez entre les pages et confirmez que les événements page se déclenchent
Ajoutez un article au panier et confirmez que addtocart se déclenche
Complétez une transaction de test et confirmez que checkout se déclenche avec la valeur, la devise et l’event_id attendus

Si vous avez configuré l’API Conversions, vérifiez le paiement côté serveur dans le gestionnaire d’événements Pinterest.

Renseignements supplémentaires

Consultez la documentation de la balise Pinterest et la documentation de l’API Conversions de Pinterest pour en savoir plus.

Analyse et suivi

Widgets

Intégration de la balise Pinterest

Configuration

Événements suivis

page

addtocart

checkout

Correspondance améliorée (Enhanced Match)

Suivi des paiements côté serveur

Attribution par identifiant de clic (`epik`)

Vérifier votre configuration

Renseignements supplémentaires

​Intégration de la balise Pinterest

​Configuration

​Événements suivis

​page

​addtocart

​checkout

​Correspondance améliorée (Enhanced Match)

​Suivi des paiements côté serveur

​Attribution par identifiant de clic (epik)

​Vérifier votre configuration

​Renseignements supplémentaires

Intégration de la balise Pinterest

Configuration

Événements suivis

page

addtocart

checkout

Correspondance améliorée (Enhanced Match)

Suivi des paiements côté serveur

Attribution par identifiant de clic (`epik`)

Vérifier votre configuration

Renseignements supplémentaires