> For the complete documentation index, see [llms.txt](https://help.citrusad.com/retail-media-interface/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.citrusad.com/retail-media-interface/integration/fr/data-api/api-overview/reporting-impressions-clicks.md).

# Signalement des impressions et des clics

Pour signaler efficacement les impressions et les clics, utilisez `/resource/` endpoint. Les impressions doivent être dirigées vers la `first-i` ressource, tandis que les clics doivent être signalés à la `second-c` ressource.

## Prérequis

Obtenez votre URL de base auprès de votre responsable grands comptes technique avant de signaler les impressions et les clics.

## Intégration des appels aux points de terminaison

Les appels aux points de terminaison doivent être exécutés dans votre application ou votre site web. Dans Epsilon Retail Media, le processus d'intégration est similaire pour les applications mobiles et les sites web en raison de son approche d'intégration « backend à backend ». Cette approche garantit que les demandes d'annonces sont cohérentes sur les plates-formes de bureau et mobiles. Cependant, comme les applications mobiles ne prennent pas en charge les bibliothèques JS, vous devez effectuer des requêtes backend vers nos points de terminaison de clics et d'impressions.

## Signalement des impressions

Pour signaler une impression, envoyez une requête GET au format suivant :

```
https://$BASE_URL.citrusad.com/v1/resource/first-i/AD_ID
```

Remplacer `AD_ID` avec le `adId` fourni pour l'annonce que vous signalez.

Par exemple, la requête GET suivante me signale une impression pour le `adId`, `display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT`.

```
https://$BASE_URL.citrusad.com/v1/resource/first-i/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
```

## Signalement des clics

Pour signaler un clic, envoyez une requête GET au format ci-dessous :

```
https://$BASE_URL.citrusad.com/v1/resource/second-c/AD_ID
```

Remplacer `AD_ID` avec le `adId` fourni pour l'annonce que vous signalez.

Par exemple, la requête GET suivante me signale une impression pour le `adId`, `display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT`.

```
https://$BASE_URL.citrusad.com/v1/resource/second-c/display_xw3ybbrymHT_D3VwU3Ic5ThUkbhFNkY4NVNIODU4NEVGRkdT
```

## Validation de l'API pour les identifiants d'annonces réalisés

L'API inclut la validation des identifiants d'annonces pour garantir des données précises et réduire les erreurs. Les requêtes contenant des identifiants d'annonce mal encodés ou mal préfixés renvoient une erreur 400 et un message d'erreur détaillé.

### Avantages clés

* Résolution plus rapide des problèmes : des retours rapides aident les distributeurs à résoudre les problèmes plus rapidement.
* Meilleure précision : moins d'erreurs signifie des rapports et des données plus précis.

### Exemple de message d'erreur

"Invalid ad ID. Must be properly encoded and prefixed with 'display\_', 'banner\_', or 'shotgun\_'."


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://help.citrusad.com/retail-media-interface/integration/fr/data-api/api-overview/reporting-impressions-clicks.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
