> 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/brand/fr/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.md).

# Activer les postbacks de notification d'événement pour les marques

Les notifications d’événements par rappel (webhooks) avertissent vos systèmes internes en temps réel lorsque des événements spécifiques se produisent. Les données envoyées varient selon l’événement, mais le processus de configuration est le même pour tous.

{% stepper %}
{% step %}

## Accéder aux rappels de notification d’événements

1. Dans la barre de navigation supérieure, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Profil utilisateur] → Paramètres**.
2. Dans la section *Technique* , sélectionnez [**Notifications d’événements**](https://app.impact.com/secure/advertiser/accountSettings/techintegration/view-edit-adv-pingback-settings-flow.ihtml?).
   {% endstep %}

{% step %}

## Renseigner les champs de configuration globaux

1. Pointez sur l’événement pour lequel vous souhaitez configurer un rappel de notification, puis sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fkka3dqJOx8ZhiX82RDLt%2FEdit_light.svg?alt=media\&token=f454405c-ebd8-49af-90db-22efc27476bf) **\[Modifier]**.
2. Utilisez le tableau ci-dessous pour configurer les paramètres de livraison :

<table><thead><tr><th width="225.36328125">Champ</th><th>Description</th></tr></thead><tbody><tr><td>URL</td><td>Le point de terminaison de votre serveur qui recevra les données.</td></tr><tr><td>Méthode HTTP</td><td><p><code>GET</code> : les données sont ajoutées à l’URL sous forme de paramètres de requête.</p><p><code>POST</code> : les données sont envoyées dans le corps de la requête, qui comprend divers paramètres facultatifs que vous pouvez définir.<br><br>Pour en savoir plus sur chaque événement et le contenu de sa charge utile, consultez <a href="#notification-events-and-payloads">Événements de notification et charges utiles</a> .</p></td></tr><tr><td>En-tête HTTP</td><td>(Facultatif) Ajoutez des en-têtes personnalisés pour l’authentification (par ex., <code>Authorization: Bearer token</code>).</td></tr><tr><td>Délai minimal</td><td>Définissez le <em>délai minimal</em> en secondes pour protéger votre serveur contre les pics de trafic.</td></tr><tr><td>Nombre maximal de requêtes</td><td>Définissez le <em>nombre maximal de requêtes</em> par seconde pour protéger votre serveur contre les pics de trafic.</td></tr><tr><td>Réponse de réussite</td><td>La chaîne de texte précise ou le code d’état HTTP que votre serveur renvoie lorsque le rappel est traité correctement.</td></tr><tr><td>Réponse d’erreur</td><td>La chaîne de texte ou le code d’état qui indique un échec (par ex., <code>ERROR</code> ou <code>500</code>).</td></tr></tbody></table>
{% endstep %}
{% endstepper %}

## Événements de notification et charges utiles

Chaque notification d’événement envoie un ensemble unique de points de données configurables (par ex., `{ActionId}`). Consultez les événements ci-dessous pour découvrir les points de données que vous pouvez extraire des charges utiles.

<details>

<summary>Événements du cycle de vie des actions</summary>

Les événements du cycle de vie des actions déclenchent une requête HTTP vers une URL spécifiée (ainsi que les paramètres inclus) lorsqu’une action est suivie, modifiée ou annulée.

```json
// Exemple de POST au format JSON
{
  "CampaignId": 9876, // ID du programme
  "ActionTrackerId": 12345, // ID du type d’événement
  "MediaPartnerId": 555, // ID du partenaire
  "CampaignName": "Spring Global Promotion", // Nom du programme
  "ActionTrackerName": "Standard Sale Tracker", // Nom du type d’événement
  "MediaPartnerName": "Top Tier Affiliates", // Nom du partenaire
  "ActionId": "ACT-778899", // ID de l’action
  "Status": "MODIFIED", // État de l’action
  "StatusDetail": "Retour d’article - commission ajustée", // Détails supplémentaires sur le statut de l’action
  "AdId": 44332, // Identifiant de la publicité
  "Payout": 10.50, // Commission de l’action versée au partenaire, dans la devise du partenaire
  "DeltaPayout": -5.00, // Montant de commission corrigé par rapport à l’action précédente
  "IntendedPayout": 15.50, // Montant de commission prévu pour une action dépassant la limite
  "Amount": 100.00, // Montant de l’action, dans la devise du compte
  "DeltaAmount": -50.00, // Montant corrigé par rapport à l’action précédente
  "IntendedAmount": 150.00, // Montant de vente prévu pour une action dépassant la limite
  "Currency": "USD", // Devise de l’action
  "OriginalCurrency": "USD", // Devise d’origine (c’est-à-dire celle du panier) de l’action
  "OriginalAmount": 100.00, // Montant d’origine (c’est-à-dire celui du panier) de l’action
  // Collection « items » : données des articles individuels de cette action
  "items": [{join(items, i, 
  "\{\"sku\":\"{i.sku}\",
  \"item_price\":{i.amt},
  \"category\":\"{i.cat}\",
  \"quantity\":{i.qty},
  \"cartamt\":{i.cartamt},
  \"rbt\":\"{i.rbt}\",
  \"name\":\"{i.name}\"\")}],
  "EventDate": "2026-04-08T09:00:00Z", // Date de la conversion
  "CreationDate": "2026-04-08T09:05:00Z", // Date de création dans le système
  "LockingDate": "2026-05-08T00:00:00Z", // Date à laquelle l’action sera verrouillée
  "ClearedDate": "2026-05-15T00:00:00Z", // Date prévue de validation
  "ReferringDomain": "blog.partner.com", // Domaine de référence
  "LandingPageUrl": "https://brand.com/sale", // URL de la page de destination
  "RefCustomerArea": "California", // Zone du client (déduite de l’adresse IP)
  "RefCustomerCity": "San Francisco", // Ville du client (déduite de l’adresse IP)
  "RefCustomerRegion": "CA", // Région du client (déduite de l’adresse IP)
  "RefCustomerCountry": "US", // Code du pays du client (déduit de l’adresse IP)
  "RefClickId": "CLK9988776655", // Identifiant unique du clic
  "SharedId": "social_post_01", // Identifiant partagé du partenaire
  "PromoCode": "SAVE20", // Code promotionnel général
  "CustomerStatus": "EXISTING", // Statut du client
  "Oid": "ORD-554433", // Identifiant de la commande
  "Note": "Partial return processed", // Note fournie avec l’action
  "CustomerPostCode": "94105", // Code postal du client
  "CustomerCity": "San Francisco", // Ville du client
  "CustomerCountry": "US", // Code du pays du client
  "CustomerRegion": "CA", // Région du client
  "CustomerId": "CUST-12345", // Identifiant du client
  "CustomerEmail": "a665a45920422f9d417...", // Adresse e-mail hachée du client
  "IpAddress": "192.168.1.1", // Adresse IP
  "CallerId": null, // Numéro de téléphone de l’appelant
  // Champs supplémentaires personnalisés
  "Text1": "Custom Val 1", // Texte 1
  "Date1": "2026-04-08", // Date 1
  "Money1": 10.00, // Montant 1
  "Numeric1": 1, // Valeur numérique 1
  // Métadonnées de l’appareil et de l’application
  "appPackage": "com.brand.app", // Package de l’application mobile
  "appName": "BrandStore", // Nom de l’application mobile
  "appVersion": "4.2.1", // Version de l’application mobile
  "deviceOs": "iOS", // Système d’exploitation de l’appareil
  "deviceOsVersion": "17.4", // Version du système d’exploitation de l’appareil
  "deviceManuf": "Apple", // Fabricant de l’appareil
  "deviceModel": "iPhone 15", // Modèle de l’appareil
  "macAddress": "00:1B:44:11:3A:B7", // Adresse MAC (majuscules)
  "macAddressLower": "00:1b:44:11:3a:b7", // Adresse MAC (minuscules)
  "macAddressAlpha": "001B44113AB7", // Adresse MAC (sans deux-points)
  "macAddressSha1": "47a32...", // SHA-1 de l’adresse MAC
  "iosIfa": "EA7583CD-A667-48BC-B806-42ECB2B48606", // Identifiant publicitaire iOS
  "iosAdTracking": "1", // Réglage du suivi publicitaire iOS
  "androidId": null, // Identifiant Android
  "deviceId": "D-556677", // Identifiant de l’appareil
  "deviceIp": "192.168.1.1" // Adresse IP de l’appareil
}
```

</details>

<details>

<summary>Événements de demande d’action</summary>

Les événements de demande d’action envoient une requête HTTP à une URL spécifiée (ainsi qu’à tous les paramètres inclus) lors de la création ou de la résolution de demandes d’action.

```json
// Exemple de POST au format JSON
{
  "Id": 554433, // Identifiant unique de la demande d’action dans le système
  "MediaPartnerId": 555, // ID du partenaire
  "MediaPartnerName": "Top Tier Affiliates", // Nom du partenaire
  "CampaignId": 9876, // ID du programme
  "CampaignName": "Spring Global Promotion", // Nom du programme
  "OrderId": "ORD-12345", // Identifiant de commande de l’action signalée
  "TransactionDate": "2026-04-01T14:30:00Z", // Date de la transaction à l’origine de la demande d’action
  "TransactionAmount": 250.00, // Montant de la transaction à l’origine de la demande d’action
  "InquiryType": "MISSING_ACTION", // Type de demande d’action
  "ExpectedPayout": 25.00, // Montant de la commission attendue par le partenaire
  "ResolutionDeadlineDate": "2026-05-01T00:00:00Z", // Date limite à laquelle la demande doit être acceptée ou refusée
  "TrackingLink": "https://proweb.com/click?cid=1&pid=555", // Lien de suivi fourni par le partenaire
  "ActionId": "ACT-999000", // Identifiant de l’action (si elle est associée à une action existante)
  "AutoApprovalDate": "2026-05-05T00:00:00Z", // Date à laquelle le système exécutera les règles d’approbation automatique
  "ResolutionStatus": "PENDING", // Statut final de résolution de la demande d’action
  "RejectReason": null, // Motif du rejet de la demande d’action
  "FinalPayout": 0.00, // Commission finale associée à la demande d’action
  "ResolutionDate": null, // Date à laquelle la demande a été tranchée
  "CreationDate": "2026-04-08T10:05:00Z", // Date de création de la demande dans le système
  "InquiryNotes": "Customer claims they clicked the link but no credit was shown.", // Notes de demande soumises par le partenaire
  "ResolutionNotes": null, // Notes soumises lors du traitement de la demande
  "Comments": "[{\"user\": \"support_agent\", \"text\": \"Verifying click logs now.\"}, {\"user\": \"partner\", \"text\": \"Customer provided receipt.\"}]" // Commentaires ajoutés à la demande (au format JSON)
}
```

</details>

<details>

<summary>Événements de validation des actions</summary>

Les événements de validation des actions envoient une requête HTTP à une URL spécifiée (ainsi qu’à tous les paramètres inclus) lorsque des actions sont validées.

```json
// Exemple de POST au format JSON
{
  "ActionTrackerId": 12345, // ID du type d’événement
  "ActionTrackerName": "Standard Sale Tracker", // Nom du type d’événement
  "CampaignId": 9876, // ID du programme
  "CampaignName": "Spring Global Promotion", // Nom du programme
  "MediaPartnerId": 555, // ID du partenaire
  "MediaPartnerName": "Top Tier Affiliates", // Nom du partenaire
  "OrderIds": "ORD-9921,ORD-9922", // Identifiants des commandes des actions signalées (séparés par des virgules)
  "ActionIds": "ACT-101,ACT-102", // Identifiants des actions (séparés par des virgules)
  "ClearedDate": "2026-04-15T12:00:00Z", // Date (ISO 8601) à laquelle la validation de l’action est prévue
  "LedgerDate": "2026-04-08T09:54:43Z" // Date (ISO 8601) à laquelle l’action a été validée
}
```

</details>

<details>

<summary>Événements de demande de valeur de suivi</summary>

Les événements de demande de valeur de suivi envoient une requête HTTP à une URL spécifiée (ainsi qu’à tous les paramètres inclus) lors de la création de demandes de suivi.

```json
// Exemple de POST au format JSON
{
  "CampaignId": 9876, // ID du programme
  "ActionTrackerId": 12345, // ID du type d’événement
  "MediaPartnerId": 555, // ID du partenaire
  "ActionId": "ACT-778899", // ID de l’action
  "Amount": 150.00, // Montant de l’action dans la devise du compte
  "Currency": "USD", // Devise de l’action
  "Oid": "ORD-554433", // Identifiant de la commande
  // Collection "items" : détail des produits individuels de l’action
  "items": [{join(items, i, "\{\"sku\":\"{i.sku}\",\"item_price\":{i.amt},\"category\":\"{i.cat}\",\"quantity\":{i.qty},\"cartamt\":{i.cartamt},\"rbt\":\"{i.rbt}\",\"name\":\"{i.name}\"\}")}],
  "EventDate": "2026-04-08T09:00:00Z", // Date de conversion
  "IpAddress": "192.168.1.1", // Adresse IP de l’appareil
  "RefClickId": "CLK9988776655" // Identifiant unique du clic
}
```

</details>

<details>

<summary>Événements de tâches terminées</summary>

Les événements de tâches terminées envoient une requête HTTP à une URL spécifiée (ainsi qu’à tout paramètre supplémentaire) lorsqu’une tâche a été terminée pour un [Exportation de rapport](https://integrations.impact.com/brand-api-reference/reference/report-export/report-export) ou [Cliquez sur Exporter](https://integrations.impact.com/brand-api-reference/reference/clicks/clickexport).

```json
// Exemple de POST au format JSON
{
  "JobId": 10293847, // Identifiant unique de la tâche
  "JobType": "REPORT_EXPORT", // Type de tâche
  "AccountId": 7744, // Identifiant du compte
  "StartDate": "2026-04-08T10:00:05Z", // Heure de démarrage de la tâche
  "EndDate": "2026-04-08T10:11:02Z", // Heure à laquelle la tâche s’est terminée
  "RecordsProcessed": 5240, // Nombre d’enregistrements traités ou générés
  "ApiJobDetailUri": "https://api.impact.com/jobs/10293847", // URI de l’API pour obtenir plus de détails sur la tâche
  "ApiResultUri": "https://api.impact.com/jobs/10293847/result", // URI de l’API pour obtenir le résultat de la tâche
  "ResultDownloadUrlExp5": "https://download.impact.com/file?token=a1b2...&exp=5min", // URL de téléchargement du résultat (expiration au bout de 5 minutes)
  "ResultDownloadUrlExp15": "https://download.impact.com/file?token=a1b2...&exp=15min", // URL de téléchargement du résultat (expiration au bout de 15 minutes)
  "ResultDownloadUrlExp30": "https://download.impact.com/file?token=a1b2...&exp=30min", // URL de téléchargement du résultat (expiration au bout de 30 minutes)
  "ResultDownloadUrlExp60": "https://download.impact.com/file?token=a1b2...&exp=60min" // URL de téléchargement du résultat (expiration au bout de 60 minutes)
}
```

</details>

<details>

<summary>Événements de candidature des éditeurs</summary>

{% hint style="success" %}
**Remarque :** Cette fonctionnalité est en version bêta. Contactez votre responsable de la réussite client (CSM) ou notre [équipe d’assistance](https://app.impact.com/support/portal.ihtml?createTicket=true&) si vous souhaitez tester cette fonctionnalité.
{% endhint %}

Les événements de candidature des éditeurs envoient une requête HTTP à une URL spécifiée lorsqu’un partenaire soumet une candidature, puis à chaque fois que celle-ci est approuvée, rejetée ou retirée.

Les événements de candidature des éditeurs sont également appelés rappel d’événement de contrat, webhook de traitement des candidatures ou webhook de candidature.

Si une charge utile `PENDING` est envoyée avec des points de données vides, le système est conçu pour déclencher des mises à jour à mesure que les informations deviennent disponibles. Les envois ultérieurs réussis renseigneront ces champs auparavant vides, afin que vos données restent synchronisées avec les informations les plus récentes traitées.

{% hint style="warning" %}
**Important :** Si vous avez configuré des [flux de traitement des candidatures](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/review-partner-applications/automate-partner-application-processing.md) , ils sont exécutés avant le déclenchement du webhook. Le webhook est déclenché avec le résultat *Statut*: `APPROVED` ou `REJECTED` si un flux a traité la candidature, `PENDING` si aucun flux ne s’est appliqué, ou `RETRACTED` si le partenaire a retiré sa candidature.
{% endhint %}

Pour savoir comment ce webhook fonctionne avec l’Agent de recrutement, consultez [Agent de recrutement](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/review-partner-applications/recruitment-agent.md#see-where-the-agent-fits-with-your-existing-automation).

Le contenu de la charge utile varie selon le *statut*. L’exemple ci-dessous montre un événement `PENDING` , avec des commentaires indiquant les champs présents pour les autres statuts.

```json
// Exemple de POST au format JSON
{
  "Status": "PENDING", // Statut de la candidature : PENDING, APPROVED, REJECTED, RETRACTED
  "ProgramId": "9876", // Identifiant du programme
  "TemplateTermsId": "4455", // Identifiant des conditions du modèle
  "ContractId": "112233", // ID du contrat
  "ApplicationDate": "2026-04-09T08:30:00Z", // Date de la demande
  "PublisherSignerName": "Sarah Chen", // Utilisateur de l’éditeur ayant traité la demande
  "PublisherId": "555", // ID du partenaire
  "Name": "Elite Content Creators", // Nom du partenaire
  "BusinessModel": "SOCIAL_INFLUENCER", // Modèle économique principal du partenaire
  "Address": "123 Marketing Way", // Adresse postale
  "City": "Los Angeles", // Ville
  "State": "CA", // État
  "Country": "US", // Pays

  // APPROVED, REJECTED, RETRACTED uniquement
  "DecisionDate": null, // Date de la décision

  // APPROVED uniquement
  "ContractStartDate": null, // Date de début du contrat

  // REJECTED uniquement
  "DeclineReason": null, // Motif du rejet

  // APPROVED, REJECTED uniquement
  "AdvertiserSignerName": null, // Utilisateur de l’annonceur ayant traité la demande

  // PENDING uniquement : champs du profil du partenaire
  "Description": "A premium network of lifestyle and travel influencers.", // Description du profil du partenaire
  "Language": "en-US", // Langue
  "PublisherSize": "M", // XS, S, M, L, XL
  "PastRelationship": "false", // Valeur booléenne indiquant l’existence d’un contrat antérieur
  "MarketplaceApproved": "true", // Valeur booléenne indiquant le statut sur la place de marché
  "ReceivedPayout": "true", // Valeur booléenne indiquant si un paiement a été reçu

  // PENDING uniquement : propriétés de média associées au partenaire
  "properties": [{join(properties, i, "{\"platform\":\"{i.platform}\",\"verified\":\"{i.verified}\",\"url\":\"{i.url}\",\"category\":\"{i.category}\",\"reach\":\"{i.reach}\",\"engagementRate\":\"{i.engagementRate}\",\"audienceCountryPct\":\"{i.audienceCountryPct}\",\"audienceGenderPct\":\"{i.audienceGenderPct}\",\"audienceAgeRangePct\":\"{i.audienceAgeRangePct}\"}")}],

  // PENDING uniquement : données démographiques du créateur
  "CreatorIncome": "", // Revenu du ménage
  "CreatorGender": "", // Genre
  "CreatorEthnicity": "", // Origine ethnique
  "CreatorEducation": "", // Niveau d’études
  "CreatorRelationshipStatus": "", // Situation amoureuse
  "CreatorParentalStatus": "", // Situation parentale
  "CreatorPronouns": "", // Pronoms
  "CreatorDOB": "", // Date de naissance

  // PENDING uniquement : identifiants de groupe
  "GroupIds": "1001,1002,1003" // Identifiants de groupe séparés par des virgules
}
```

</details>

## Mécanisme de nouvelle tentative des postbacks

Si un postback échoue lors de son envoi à l’URL de destination, sa livraison fait automatiquement l’objet de nouvelles tentatives selon un calendrier défini, jusqu’à 15 fois. Ces tentatives permettent de tenir compte des problèmes réseau temporaires ou de l’indisponibilité du serveur.

### Cas où aucune nouvelle tentative n’a lieu

Aucune nouvelle tentative de postback n’a lieu dans les cas suivants :

* L’URL de destination est mal formée ou invalide.
* L’URL de destination ou son hôte ne peut pas être résolu, par exemple en raison d’un échec de recherche DNS.

### Calendrier des nouvelles tentatives

Les nouvelles tentatives suivent le calendrier ci-dessous. Les tentatives 1, 2 et 3 sont ignorées si le code de réponse HTTP est compris dans la plage de `400` à `500`.

<details>

<summary>Référence du calendrier des nouvelles tentatives</summary>

<table><thead><tr><th width="180.5390625">Tentative</th><th>Délai avant la nouvelle tentative</th></tr></thead><tbody><tr><td>Nouvelle tentative 1</td><td>+15 secondes</td></tr><tr><td>Nouvelle tentative 2</td><td>+15 secondes</td></tr><tr><td>Nouvelle tentative 3</td><td>+15 secondes</td></tr><tr><td>Nouvelle tentative 4</td><td>+3 minutes</td></tr><tr><td>Nouvelle tentative 5</td><td>+3 minutes</td></tr><tr><td>Nouvelle tentative 6</td><td>+15 minutes</td></tr><tr><td>Nouvelle tentative 7</td><td>+15 minutes</td></tr><tr><td>Nouvelle tentative 8</td><td>+15 minutes</td></tr><tr><td>Nouvelle tentative 9</td><td>+2 heures</td></tr><tr><td>Nouvelle tentative 10</td><td>+2 heures</td></tr><tr><td>Nouvelle tentative 11</td><td>+2 heures</td></tr><tr><td>Nouvelle tentative 12</td><td>+6 heures</td></tr><tr><td>Nouvelle tentative 13</td><td>+6 heures</td></tr><tr><td>Nouvelle tentative 14</td><td>+6 heures</td></tr><tr><td>Nouvelle tentative 15</td><td>+6 heures</td></tr></tbody></table>

</details>


---

# 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/brand/fr/what-would-you-like-to-learn-about/account-administration/account-settings/notifications/enable-event-notification-postbacks-for-brands.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.
