> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.crowdchange.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Pinterest

> Ajoutez la balise Pinterest et l'API Conversions à CrowdChange pour suivre les pages vues, l'ajout au panier et les dons depuis les pubs 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

1. Accédez à **Admin -> Paramètres de mise en page -> Meta et analytique**
2. Faites défiler jusqu'à la section **Balise Pinterest**
3. Entrez votre **ID de balise Pinterest**, par exemple `2612345678901`
4. Facultatif : entrez votre **ID de compte publicitaire Pinterest**
5. Facultatif : entrez votre **jeton d'accès à l'API Conversions de Pinterest**
6. 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.

```javascript theme={null}
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**

```json theme={null}
{
  "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**

```json theme={null}
{
  "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 :

1. Visitez n'importe quelle page de votre plateforme et confirmez que la balise Pinterest se charge depuis `https://s.pinimg.com/ct/core.js`
2. Naviguez entre les pages et confirmez que les événements `page` se déclenchent
3. Ajoutez un article au panier et confirmez que `addtocart` se déclenche
4. 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](https://help.pinterest.com/en/business/article/install-the-pinterest-tag) et la [documentation de l'API Conversions de Pinterest](https://developers.pinterest.com/docs/track-conversions/track-conversions-in-the-api/) pour en savoir plus.
