> ## 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.

# Reddit

> Ajoutez le Pixel Reddit et l'API Conversions à CrowdChange pour suivre les pages vues, l'ajout au panier et les dons provenant des publicités Reddit.

## Intégration du Pixel Reddit

CrowdChange prend en charge le suivi par Pixel Reddit côté navigateur ainsi que le suivi des achats optionnel via l'API Conversions de Reddit.

Une fois connecté, votre Pixel Reddit reçoit les événements `PageVisit`, `AddToCart` et `Purchase`.

Si un jeton d'accès à l'API Conversions de Reddit est configuré, CrowdChange envoie également les achats 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 **Pixel Reddit**
3. Entrez votre **ID de Pixel Reddit**, par exemple `t2_xxxxxxx`
4. Facultatif : entrez votre **ID de compte publicitaire Reddit**
5. Facultatif : entrez votre **jeton d'accès à l'API Conversions de Reddit**
6. Cliquez sur **Enregistrer**

Le fragment de code du Pixel pour le navigateur est automatiquement injecté dans chaque page une fois l'ID de Pixel 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

### PageVisit

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

```javascript theme={null}
rdt('track', 'PageVisit');
```

***

### 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     |
| `itemCount` | `number`   | Somme des quantités d'articles                    |
| `products`  | `object[]` | Tableau d'objets `{ id, name, category }`         |

**Exemple de charge utile**

```json theme={null}
{
  "currency": "CAD",
  "value": 50,
  "itemCount": 1,
  "products": [
    {
      "id": "registration",
      "name": "Registration",
      "category": "registration"
    }
  ]
}
```

***

### Purchase

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                             |
| `transactionId` | `string`   | ID de transaction CrowdChange                               |
| `conversionId`  | `string`   | Identifiant de déduplication `transaction_<transaction_id>` |
| `products`      | `object[]` | Tableau d'objets `{ id, name, category }`                   |

**Exemple de charge utile**

```json theme={null}
{
  "currency": "CAD",
  "value": 100,
  "transactionId": "1000",
  "conversionId": "transaction_1000",
  "products": [
    {
      "id": "donation",
      "name": "Donation",
      "category": "donation"
    }
  ]
}
```

***

## Suivi des achats côté serveur

Lorsqu'un ID de compte publicitaire Reddit et un jeton d'accès à l'API Conversions de Reddit sont tous deux configurés, CrowdChange envoie une conversion `Purchase` côté serveur.

| Champ            | Description                                                  |
| ---------------- | ------------------------------------------------------------ |
| `click_id`       | Paramètre URL `rdt_cid` capturé, si disponible               |
| `conversion_id`  | `transaction_<transaction_id>`                               |
| `transaction_id` | ID de transaction CrowdChange                                |
| `item_count`     | Nombre d'articles achetés                                    |
| `currency`       | Devise de la transaction                                     |
| `value`          | Valeur de la transaction en unités mineures de devise        |
| `value_decimal`  | Valeur décimale de la transaction                            |
| `email`          | Courriel du donateur haché en SHA-256, si disponible         |
| `external_id`    | ID d'utilisateur CrowdChange haché en SHA-256, si disponible |
| `ip_address`     | Adresse IP de la requête                                     |
| `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 (`rdt_cid`)

Lorsqu'un visiteur arrive via une publicité Reddit, Reddit peut ajouter `rdt_cid` à l'URL. CrowdChange capture cette valeur dans la session du navigateur et la transmet à la conversion côté serveur sous forme de `click_id`. CrowdChange lit également le témoin `_rdt_uuid` lorsqu'il est présent, en prévision d'une future prise en charge de l'attribution côté serveur.

***

## Vérifier votre configuration

Après avoir enregistré votre ID de Pixel :

1. Visitez n'importe quelle page de votre plateforme et confirmez que le Pixel Reddit se charge depuis `https://www.redditstatic.com/ads/pixel.js`
2. Naviguez entre les pages et confirmez que les événements `PageVisit` 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 `Purchase` se déclenche avec la valeur, la devise et le `conversionId` attendus

Si vous avez configuré l'API Conversions, vérifiez l'achat côté serveur dans les rapports ou les diagnostics de Reddit Ads.

***

## Renseignements supplémentaires

Consultez la [documentation du Pixel Reddit](https://business.reddithelp.com/s/article/Reddit-Pixel-Set-Up-Guide) et la [documentation de l'API Conversions de Reddit](https://www.postman.com/reddit-ads-api/documentation/15705402-bf943e0e-521e-47dd-ae2e-2525568a8368) pour en savoir plus.