> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/partner/fr/que-souhaitez-vous-apprendre/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.md).

# Configurer les postbacks du cycle de vie des actions

Il existe deux principaux types de postbacks du cycle de vie des actions. **Niveau global** crée des postbacks pour l'ensemble de votre compte et **niveau événement** crée des postbacks pour des types d'événements spécifiques. Sélectionnez celui qui répond le mieux à vos besoins pour en savoir plus sur le processus de configuration.

{% hint style="warning" %}
**Avertissement :** Pour les postbacks au niveau global, vous devriez recevoir un postback chaque fois qu'un événement « non standard » se produit, comme une modification ou une annulation. Notez que les postbacks au niveau événement ne déclencheront pas d'événements non standard du cycle de vie des actions.
{% endhint %}

## Configurer un postback du cycle de vie des actions

<details>

<summary>Configurer un postback du cycle de vie des actions au niveau global</summary>

Cette section explique comment créer des postbacks pour l'ensemble de votre compte en une seule fois. Les partenaires qui n'ont qu'un seul système pouvant recevoir et exploiter ces postbacks, ou qui souhaitent recevoir des notifications pour tous les événements non standard, doivent configurer des postbacks du cycle de vie des actions au niveau global.

{% hint style="success" %}
**Remarque :** Si vous souhaitez être plus sélectif sur les types d'événements pour lesquels vous recevrez des postbacks, consultez la section ci-dessous pour configurer *des postbacks du cycle de vie des actions au niveau événement*.
{% endhint %}

1. Dans la barre de navigation supérieure, sélectionnez ![](https://4271519271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FhyR4iWDS0fO9ZcKFGf82%2FUser%20profile.svg?alt=media\&token=281d8f1b-b9c5-4208-a0a2-a078f54e0eb6) **\[Profil utilisateur] → Paramètres**.
2. Sous *Technique*, sélectionnez [**Notifications d'événements**](https://app.impact.com/secure/mediapartner/accountSettings/view-edit-pingback-settings-flow.ihtml).
3. À côté de *Événements du cycle de vie des actions*, sélectionnez ![](https://4271519271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FZMLVDhHLGefqRDHaIWTm%2FEdit.svg?alt=media\&token=1f1168ae-5bd3-456c-a366-904d0ecf00cb) **\[Modifier]**.
4. Saisissez l'URL de votre serveur. C'est l'URL vers laquelle impact.com enverra les postbacks.
5. Sélectionnez la méthode HTTP de votre choix.
   * Consultez certains des [paramètres de corps disponibles](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
   * Si vous sélectionnez **POST**, vous saisirez ensuite le corps de la requête et sélectionnerez un **Format du corps**. Voici un exemple de la manière dont vous pouvez vouloir associer chaque point de données pour un format JSON. Les clés de chaque paire clé-valeur doivent provenir de la configuration de votre propre système, et les valeurs seront le point de données correspondant choisi que impact.com fournit et qui doit être saisi entre crochets `{ }`.

     <div data-with-frame="true"><figure><img src="https://4271519271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FFNWShmuaxZ5VpP14AlWv%2FScreenshot%202026-05-23%20at%2010.58.15.png?alt=media&amp;token=00e80c87-6c12-4f6d-8ca5-3885c9002533" alt="" width="563"><figcaption></figcaption></figure></div>
   * Vous ne voyez pas la valeur dont vous avez besoin ? Contactez votre gestionnaire de compte (ou [contactez le support](https://app.impact.com/support/portal.ihtml)).
6. Sélectionnez **Événements du cycle de vie des actions**. Ces paramètres sont facultatifs.
   * Saisissez un **En-tête HTTP**. Si plusieurs paires sont nécessaires, séparez-les par un point-virgule.
   * Saisissez un **Délai minimum** entre le moment où un événement non standard se produit et celui où le postback est généré et envoyé à votre système.
   * Saisissez une limite de débit pour les **Requêtes maximales** qu'impact.com peut envoyer à votre système par seconde.
   * Saisissez ce que vous voulez que la **Réponse de succès** à un postback soit.
   * Saisissez ce que vous voulez que la **Réponse d'erreur** à un postback soit.
7. Sélectionnez **Enregistrer**.

Maintenant que vous avez configuré des postbacks au niveau global, votre système devrait commencer à recevoir des postbacks chaque fois que des événements non standard se produisent, quelle que soit la marque qui effectue les actions non standard. Pour savoir comment tester votre nouvelle configuration de postback, consultez la section *Tester un postback du cycle de vie des actions* ci-dessous.

### Exemple de valeurs dynamiques

Si vous avez configuré des variables dynamiques pour vos liens de suivi, vous pouvez configurer une URL de postback vers votre propre serveur afin d'être averti lorsqu'une action se produit et de récupérer la ou les valeurs renseignées dynamiquement associées à l'action.

Cet exemple montre comment transmettre une valeur `SharedId` (une valeur que vous souhaitez partager avec les marques) à un paramètre dans un postback (`MyParam`). Certaines marques peuvent exiger que vous configuriez cela.

<div data-with-frame="true"><figure><img src="https://4271519271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-b7c6cf339a60877d5823e6b9a080e8e153aa6386%2F8ec14f7b9f75bc6065c6310d30d43ae0f8256c7e075757d03ce64a5fe16476ae.png?alt=media" alt=""><figcaption></figcaption></figure></div>

Une URL de postback ressemblerait à ceci :

`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`

L'URL de postback renseignera le `MyParam` paramètre avec la valeur récupérée de `SharedId`.

</details>

<details>

<summary>Configurer des postbacks du cycle de vie des actions au niveau événement</summary>

Cette section explique comment créer des postbacks pour des types d'événements spécifiques qui suivent le moment où vous générez des actions. Si vous souhaitez être plus sélectif sur les types d'événements pour lesquels vous recevez des postbacks, vous devez configurer des postbacks du cycle de vie des actions au niveau événement.

{% hint style="success" %}
**Remarque :** Si vous avez configuré des postbacks du cycle de vie des actions au niveau global, vous n'avez pas besoin de configurer ceux au niveau événement.
{% endhint %}

1. Dans la barre de navigation supérieure, sélectionnez **Découvrir →** [**Marques**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml).
2. Sélectionnez la carte de la marque qui possède le postback que vous souhaitez tester.
3. Sous le nom de la marque, sélectionnez ![](https://4271519271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **\[Plus]** → **Intégration du suivi**.
4. Près du coin supérieur droit de la page, sélectionnez **Ajouter un postback**.
5. Sélectionnez le type d'événement (anciennement *tracker d'actions*) pour lequel vous souhaitez configurer des postbacks du cycle de vie des actions.
6. Saisissez l'URL de votre serveur. C'est l'URL vers laquelle impact.com enverra les postbacks.
7. Sélectionnez la méthode HTTP de votre choix.
   * Si vous sélectionnez **POST**, vous saisirez ensuite le corps de la requête et sélectionnerez un **Format du corps**. Voici un exemple de la manière dont vous pouvez vouloir associer chaque point de données pour un format JSON. Les clés de chaque paire clé-valeur doivent provenir de la configuration de votre propre système, et les valeurs seront le point de données correspondant choisi que impact.com fournit et qui doit être saisi entre crochets { }.

     <div data-with-frame="true"><figure><img src="https://4271519271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FwVvNFu7iuPM0eAwyMk6L%2FScreenshot%202026-05-23%20at%2013.07.16.png?alt=media&amp;token=f33b091a-cead-4e1b-80f2-0ebd97810835" alt="" width="563"><figcaption></figcaption></figure></div>
   * Consultez certains des [paramètres de corps disponibles](https://docs.google.com/spreadsheets/d/1420vz0__zjit30O_jU959L600LigsUN5iFf2oYwU-RU/edit?usp=sharing).
   * Vous ne voyez pas la valeur dont vous avez besoin ? Contactez votre gestionnaire de compte (ou [contactez le support](https://app.impact.com/support/portal.ihtml)).
8. Sélectionnez **Afficher les paramètres avancés**. Ces paramètres sont facultatifs.
   * Saisissez un **Délai minimum** entre le moment où un événement non standard se produit et celui où le postback est généré et envoyé à votre système.
   * Saisissez une limite de débit pour les **Requêtes maximales** qu'impact.com peut envoyer à votre système par seconde.
   * Saisissez ce que vous voulez que la **Réponse de succès** à un postback soit.
   * Saisissez ce que vous voulez que la **Réponse d'erreur** à un postback soit.
9. Sélectionnez **Enregistrer**.

Maintenant que vous avez configuré des postbacks au niveau événement, votre système devrait commencer à recevoir des postbacks pour le type d'événement que vous avez sélectionné à l' *Étape 5*. Pour savoir comment tester votre nouvelle configuration de postback, consultez la section *Tester un postback du cycle de vie des actions* ci-dessous.

### Exemple de valeurs dynamiques

Si vous avez configuré des variables dynamiques pour vos liens de suivi, vous pouvez configurer une URL de postback vers votre propre serveur afin d'être averti lorsqu'une action se produit et de récupérer la ou les valeurs renseignées dynamiquement associées à l'action.

Cet exemple montre comment transmettre une valeur `SharedId` (une valeur que vous souhaitez partager avec les marques) à un paramètre dans un postback (`MyParam`). Certaines marques peuvent exiger que vous configuriez cela.

<div data-with-frame="true"><figure><img src="https://4271519271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-b7c6cf339a60877d5823e6b9a080e8e153aa6386%2F8ec14f7b9f75bc6065c6310d30d43ae0f8256c7e075757d03ce64a5fe16476ae.png?alt=media" alt=""><figcaption></figcaption></figure></div>

Une URL de postback ressemblerait à ceci :

`https://postback.example.com/postback?secure=ed7e46f&MyParam={SharedId}`

L'URL de postback renseignera le `MyParam` paramètre avec la valeur récupérée de `SharedId`.

</details>

## Tester un postback du cycle de vie des actions

Une fois que vous avez configuré un postback du cycle de vie des actions, quel que soit le niveau auquel il s'applique, vous devez le tester. Vous pouvez soit exécuter un postback de test dans impact.com (disponible uniquement pour les postbacks au niveau événement), soit effectuer une conversion.

Si un postback échoue lorsque impact.com l'envoie à l'URL de destination, impact.com tente automatiquement de le renvoyer. impact.com réessaie un postback ayant échoué jusqu'à 15 fois au total. impact.com ignore les 3 premières nouvelles tentatives pour les réponses HTTP de `400` à `500`. Pour le calendrier complet des tentatives et les détails de dépannage, consultez [Tester et dépanner une URL de postback](/partner/fr/que-souhaitez-vous-apprendre/platform-features/action-management/event-notifications-and-postbacks/test-and-troubleshoot-a-postback-url.md).

<details>

<summary>Exécuter un postback de test dans impact.com</summary>

Si vous avez configuré un postback au niveau événement, vous pouvez alors le tester dans votre compte impact.com.

1. Dans la barre de navigation supérieure, sélectionnez **Découvrir →** [**Marques**](https://app.impact.com/secure/mediapartner/marketplace/new-campaign-marketplace-flow.ihtml).
2. Sélectionnez la carte de la marque qui possède le postback que vous souhaitez tester.
3. Sous le nom de la marque, sélectionnez ![](https://4271519271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-8ec3e877b1397045c61d394485e72ac4d93120ee%2Fc6ddb46c637059f06e86c790a911217a9428f5c47b5efef046f90555e85b03cd.svg?alt=media) **Plus** → **Intégration du suivi**.
4. Depuis la *Postback* section, sélectionnez ![](https://4271519271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2Fgit-blob-df93ac0f80fc5cece7983980a5ce3fbcf19aabce%2F3ef9d737089bc07dbb7e4fd41a97edfbaec261e4f55ab3a1666f3daf957f69c3.svg?alt=media) **\[Flèche vers le bas] Actions**, puis sélectionnez **Lancer le test**.
5. Confirmez que l'URL du postback est correcte, puis sélectionnez **Démarrer le test**.

</details>

<details>

<summary>Créer une conversion de test</summary>

Ce test ne sera pas effectué dans l'application web impact.com. À la place, vous effectuerez un test de bout en bout qui suit un parcours utilisateur typique. Veillez à informer la marque partenaire que vous allez effectuer le test.

1. Dans la barre de navigation supérieure, sélectionnez **Gérer →** [**Créatifs de la marque**](https://app.impact.com/secure/mediapartner/ads/searchAdsDirectoryMP.ihtml#adType=all).
2. Sélectionnez une publicité.
3. Sous le nom de la publicité, sélectionnez **Obtenir le lien de suivi**.
4. Sélectionnez ![](https://4271519271-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fb2rE79d9UhOKZQLgzSqx%2Fuploads%2FEv341AdIiPndQSb7uGMI%2FToggle%20on.svg?alt=media\&token=4ae8972d-c510-4ee2-adc5-e7170981650b) **\[Activer]** **Paramètres de suivi**.
5. Saisissez **Sous-IDs** ou un **ID partagé** selon les besoins. Chaque champ nécessite au moins une entrée.
   * Ignorez cette étape si vous avez déjà des valeurs dans ces champs.
6. Facultativement, sélectionnez une **Propriété** dans la liste déroulante.
7. Sélectionnez **Enregistrer**.
8. Sélectionnez **Copier le lien de suivi**.
9. **Collez** le lien dans une nouvelle fenêtre du navigateur.
10. Effectuez l'action.
11. Après environ 15 minutes, vérifiez dans votre système le postback généré à partir de cette action de test.
    * 15 minutes est généralement le temps nécessaire au traitement de l'action.
    * Vous pourrez également voir cette nouvelle action en attente sur l'écran [Actions en attente](https://app.impact.com/secure/mediapartner/actionworkflows/mp-pending-actions-flow.ihtml) . Si vous voyez l'action sur l' *Actions en attente* écran mais que vous n'avez pas encore reçu de postback, vérifiez à nouveau votre configuration de postback.
12. Demandez à votre marque d'annuler l'action.
13. Vérifiez dans votre système le postback généré à partir de cette annulation.
    * Si vous voyez l'action annulée sur l' [Actions annulées](https://app.impact.com/secure/mediapartner/MP_Performance_Report/action-workflows/mp-reversed-actions-flow.ihtml) écran, mais que vous n'avez pas reçu de postback, vérifiez à nouveau votre configuration de postback.

</details>

### Résoudre les erreurs

Utilisez le tableau de référence ci-dessous pour identifier et résoudre les problèmes courants rencontrés lors de la configuration de vos postbacks du cycle de vie des actions.

<table><thead><tr><th width="199.859375">Erreur</th><th>Description</th></tr></thead><tbody><tr><td>Paramètre obligatoire manquant</td><td>Votre serveur attend probablement une valeur plutôt qu'une variable. Modifiez votre URL de postback pour transmettre une valeur de test (par exemple, « 12345678 » au lieu de <code>{SubId1}</code>) et voyez s'il accepte la valeur codée en dur.</td></tr><tr><td>Variables sensibles à la casse</td><td>Les variables dynamiques sont sensibles à la casse et doivent être exactes, ce qui signifie que <code>{SubId1}</code> n'est pas identique à <code>{subid1}</code>. Vérifiez bien que vos variables respectent la casse correcte.</td></tr><tr><td>Accès refusé</td><td>La plupart des serveurs de postback disposent d'un jeton ou d'une valeur de sécurité qui doit être transmis avec les variables dynamiques. Travaillez avec l'équipe technique de votre site Web (ou consultez la documentation de votre fournisseur de site Web) pour connaître le jeton ou la valeur de sécurité nécessaire pour accéder au serveur.</td></tr></tbody></table>

{% hint style="success" icon="circle-info" %}
**Remarque :** Si vous ne trouvez aucun problème avec votre configuration de postback mais que vous ne les recevez toujours pas, [contactez le support](https://app.impact.com/support/portal.ihtml)impact.com peut vérifier si des postbacks sont générés, quel est le code de réponse pour chacun et le corps de chaque postback. Ces informations peuvent vous aider à déboguer votre configuration.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/partner/fr/que-souhaitez-vous-apprendre/platform-features/action-management/event-notifications-and-postbacks/set-up-action-lifecycle-postbacks.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
