> 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/platform-features/reach-out-to-partners/generate-leads/create-a-custom-widget.md).

# Créer un widget personnalisé

Créez des outils dynamiques qui aident vos partenaires à promouvoir votre marque. Les widgets personnalisés vous permettent d’intégrer des outils ou des pages hébergés en externe directement dans l’interface impact.com via une iframe. Suivez ce guide pour créer et configurer un widget de contenu personnalisé qui propose des ressources personnalisées et une expérience de marque cohérente à vos partenaires.

{% stepper %}
{% step %}

## Accéder au créateur de widgets personnalisés

1. Dans le menu de navigation à gauche, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engager]** → **Contenu** → [**Widgets**](https://app.impact.com/secure/advertiser/engage/ads/list-widget-tool-flow.ihtml)**.**
2. Dans le coin supérieur droit, sélectionnez **Créer un widget** → **Personnalisé**.
   {% endstep %}

{% step %}

## Saisir les détails du widget

1. Saisissez un **Nom** pour le widget personnalisé.
2. Vous pouvez également saisir une **Description** pour le widget personnalisé.
3. Vous pouvez également saisir un **Libellé** pour le widget personnalisé.
4. Si nécessaire, ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2FiZjM1xY8o3v1iR3Zaysd%2FToggle.svg?alt=media\&token=b1550d48-bba9-4e81-8604-bc12370c5caa) **\[Activer] Restreindre l’accès des partenaires** pour spécifier les partenaires et les groupes qui doivent avoir accès au widget.
   * **Partenaires :** Saisissez le nom des partenaires qui peuvent accéder au widget personnalisé.
   * **Groupes :** Saisissez le nom des groupes qui peuvent accéder au widget personnalisé.
     {% endstep %}

{% step %}

## Configurer le widget

1. Choisissez le comportement du widget parmi les options d’affichage :
   * **Ouvrir dans un nouvel onglet :** Ouvre l’URL hébergée dans un onglet distinct.
   * **Intégrer dans impact.com :** Affiche le widget directement dans l’interface de la plateforme.
2. Vous pouvez également, dans la section **Image d’aperçu** , sélectionner **Choisir un fichier** pour téléverser une miniature. Le fichier doit être au format GIF, JPG ou PNG et ne pas dépasser 512 Ko.
3. Dans le champ **URL du widget** , saisissez l’adresse Web où votre widget est hébergé.
4. Dans le ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media)**\[Menu déroulant]**, sélectionnez le protocole (par exemple, https\://) correspondant à la sécurité de votre site.
5. Vous pouvez également sélectionner ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **\[Ajouter] Insérer des champs dynamiques** pour afficher la liste des jetons.
6. Repérez le jeton que vous souhaitez utiliser et sélectionnez **Insérer**. La plateforme ajoutera automatiquement le jeton (p. ex. {irpid}) à votre **URL du widget**. Consultez la [section Jetons de champs dynamiques](#dynamic-field-tokens) ci-dessous pour obtenir une description de chaque jeton.
   {% endstep %}

{% step %}

## Mettre à jour les paramètres avancés

Dans le menu **Langue** ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media)**\[Menu déroulant]**, sélectionnez la langue dans laquelle ce widget s’affichera.
{% endstep %}

{% step %}

## Finaliser le widget personnalisé

Sélectionnez **Créer** pour enregistrer votre widget. Les partenaires peuvent trouver ce widget dans *Widgets de contenu*.
{% endstep %}
{% endstepper %}

<details>

<summary>Jetons de champs dynamiques</summary>

| Jeton                          | Description                                                   |
| ------------------------------ | ------------------------------------------------------------- |
| `{click_url_encoded}`          | URL de clic encodée                                           |
| `{click_url}`                  | URL de clic non encodée                                       |
| `{irimpurl}`                   | Notre URL d’impression                                        |
| `{irpid}`                      | ID du partenaire                                              |
| `{subid1}`                     | Sous-ID partenaire 1                                          |
| `{subid2}`                     | Sous-ID partenaire 2                                          |
| `{subid3}`                     | Sous-ID partenaire 3                                          |
| `{sharedId}`                   | ID partagé                                                    |
| `{iradid}`                     | ID de la publicité                                            |
| `{ircid}`                      | ID du programme                                               |
| `{click_url_encoded_deeplink}` | URL de clic encodée avec un paramètre de lien profond ajouté. |

</details>

## Exemples pratiques

{% hint style="info" %}
**À propos de ces exemples :** Vous créez et hébergez les widgets personnalisés vous-même : impact.com intègre uniquement la page hébergée et y injecte les données des partenaires en temps réel. Copiez les implémentations de référence ci-dessous, hébergez-les sur votre propre domaine et adaptez-les. Les partenaires ne modifient aucun code ; ils ouvrent simplement le widget finalisé depuis *Widgets de contenu*.
{% endhint %}

### Comment les jetons de champs dynamiques sont transmis à votre widget

Lorsque vous ajoutez un jeton de champ dynamique à l’ **URL du widget**, impact.com le remplace par les valeurs réelles de chaque partenaire avant de charger votre page. Votre page lit ces valeurs dans sa chaîne de requête et les utilise pour créer des liens traçables.

Par exemple, si vous définissez l’ **URL du widget** sur `https://widgets.yourbrand.com/search?partner={irpid}&clickurl={click_url_encoded}`, impact.com charge l’URL suivante pour un partenaire dont l’ID est `123456`:

{% code overflow="wrap" %}

```
https://widgets.yourbrand.com/search?partner=123456&clickurl=https%3A%2F%2Facme.sjv.io%2Fc%2F123456%2F789012%2F3456
```

{% endcode %}

{% hint style="warning" %}
Transmettez l’URL de clic sous la forme `{click_url_encoded}`, et non `{click_url}` — une URL de clic brute contient son propre `?` et `&` caractères, qui cassent votre chaîne de requête. Décodez-la dans votre page avant de l’utiliser.
{% endhint %}

### Exemple 1 : widget de recherche

Permet à un partenaire de rechercher dans votre catalogue et de copier un lien traçable vers n’importe quel produit sans quitter impact.com. Vous hébergez la page de recherche ; impact.com transmet l’ID du partenaire et l’URL de clic afin que chaque lien de résultat lui soit attribué.

1. Hébergez la page de recherche sur un domaine que vous contrôlez, en HTTPS (par ex., `https://widgets.yourbrand.com/search`). Remplacez le tableau de démonstration `CATALOG` par un appel à votre propre catalogue de produits ou API de recherche.
2. Créez le widget personnalisé en suivant les cinq étapes ci-dessus. Dans **Configurer le widget**, définissez l’ **URL du widget** sur votre page avec les jetons `{irpid}` et `{click_url_encoded}` (illustrés ci-dessous).
3. Testez avec **Ouvrir dans un nouvel onglet**, effectuez une recherche en tant que partenaire de test et vérifiez que les liens de résultat renvoient vers votre site et enregistrent un clic. Passez ensuite le widget sur **Intégrer dans impact.com**.

**URL du widget**

{% code overflow="wrap" %}

```
https://widgets.yourbrand.com/search?partner={irpid}&clickurl={click_url_encoded}
```

{% endcode %}

<details>

<summary>search-widget.html</summary>

```html
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1" />
  <title>Product search</title>
  <style>
    body { font-family: Arial, sans-serif; margin: 0; padding: 16px; }
    .search-bar { display: flex; gap: 8px; margin-bottom: 16px; }
    .search-bar input { flex: 1; padding: 10px; font-size: 16px; }
    .search-bar button { padding: 10px 16px; font-size: 16px; cursor: pointer; }
    .result { padding: 12px; border: 1px solid #ddd; border-radius: 6px; margin-bottom: 8px; }
    .result a { text-decoration: none; font-weight: bold; }
    .copy { margin-left: 8px; font-size: 13px; color: #2b6cb0; cursor: pointer; }
  </style>
</head>
<body>
  <div class="search-bar">
    <input id="q" type="text" placeholder="Search products..." />
    <button id="go">Search</button>
  </div>
  <div id="results"></div>

  <script>
    // 1. Read the values impact.com injected into the Widget URL.
    var params    = new URLSearchParams(window.location.search);
    var partnerId = params.get('partner') || '';
    var clickUrl  = decodeURIComponent(params.get('clickurl') || '');

    // 2. Replace this demo array with a call to your own product catalog / search API.
    var CATALOG = [
      { name: 'Trail Runner Shoe',   url: 'https://www.yourbrand.com/products/trail-runner' },
      { name: 'Waterproof Jacket',   url: 'https://www.yourbrand.com/products/waterproof-jacket' },
      { name: 'Merino Hiking Socks', url: 'https://www.yourbrand.com/products/merino-socks' }
    ];

    // 3. Construire un lien profond traçable : l'URL de clic du partenaire + la page de destination.
    //    Confirmez le format exact des liens profonds de votre programme avant la publication (voir « Avant la publication »).
    function buildTrackingLink(destinationUrl) {
      if (!clickUrl) return destinationUrl;            // repli : aucun suivi si le jeton est manquant
      return clickUrl + encodeURIComponent(destinationUrl);
    }

    function search() {
      var term = document.getElementById('q').value.toLowerCase();
      var matches = CATALOG.filter(function (p) {
        return p.name.toLowerCase().indexOf(term) !== -1;
      });
      var container = document.getElementById('results');
      container.innerHTML = matches.length ? '' : '<p>Aucun produit trouvé.</p>';
      matches.forEach(function (p) {
        var link = buildTrackingLink(p.url);
        var row = document.createElement('div');
        row.className = 'result';
        row.innerHTML =
          ' <a href="' + link + '" target="_blank" rel="noopener">' + p.name + '</a>' +
          ' <span class="copy" data-link="' + link + '">Copier le lien</span>';
        container.appendChild(row);
      });
    }

    document.getElementById('go').addEventListener('click', search);
    document.getElementById('q').addEventListener('keyup', function (e) {
      if (e.key === 'Enter') search();
    });
    document.addEventListener('click', function (e) {
      if (e.target.classList.contains('copy')) {
        navigator.clipboard.writeText(e.target.getAttribute('data-link'));
      }
    });
  </script>
</body>
</html>
```

</details>

### Exemple 2 : publicité rich media dynamique (widget de chat flottant)

Une publicité rich media dynamique est tout élément HTML interactif que vous hébergez et intégrez sous forme de widget. Dans cet exemple, vous allez créer une bulle de chat flottante qui se déploie pour afficher un message promotionnel et un appel à l'action. Lorsque le visiteur sélectionne le bouton, il est redirigé via l'URL de clic du partenaire, ce qui permet de suivre le clic et de l'attribuer.

1. Hébergez la page sur un domaine que vous contrôlez, en HTTPS (par exemple, `https://widgets.yourbrand.com/chat`). Personnalisez le texte, les couleurs et l'appel à l'action pour les adapter à votre campagne.
2. Créez le widget personnalisé en suivant les cinq étapes ci-dessus et définissez l' **URL du widget** avec le jeton `{click_url_encoded}` (indiqué ci-dessous).
3. Effectuez un test avec l'option **Ouvrir dans un nouvel onglet** en tant que partenaire de test, vérifiez que l'appel à l'action ouvre votre site et enregistre un clic, puis remplacez le mode du widget par **Intégrer dans impact.com**.

**URL du widget**

{% code overflow="wrap" %}

```
https://widgets.yourbrand.com/chat?clickurl={click_url_encoded}
```

{% endcode %}

Pour envoyer les visiteurs vers une page spécifique plutôt que vers votre page de destination par défaut, utilisez le jeton `{click_url_encoded_deeplink}` à la place de `{click_url_encoded}`, ou ajoutez la destination dans votre propre code, comme indiqué dans l’exemple 1.

<details>

<summary>chat-widget.html</summary>

```html
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1" />
  <title>Assistant</title>
  <style>
    html, body { margin: 0; height: 100%; background: transparent; font-family: Arial, sans-serif; }
    #bubble {
      position: fixed; bottom: 20px; right: 20px;
      width: 60px; height: 60px; border-radius: 50%;
      background: #2b6cb0; color: #fff; font-size: 26px;
      display: flex; align-items: center; justify-content: center;
      cursor: pointer; box-shadow: 0 4px 12px rgba(0,0,0,.25);
    }
    #panel {
      position: fixed; bottom: 90px; right: 20px; width: 260px;
      background: #fff; border-radius: 10px; box-shadow: 0 6px 24px rgba(0,0,0,.2);
      padding: 16px; display: none;
    }
    #panel.open { display: block; }
    #panel p { margin: 0 0 12px; font-size: 14px; color: #333; }
    #cta {
      display: block; width: 100%; padding: 10px; border: none; border-radius: 6px;
      background: #2b6cb0; color: #fff; font-size: 15px; cursor: pointer;
    }
  </style>
</head>
<body>
  <div id="bubble">&#128172;</div>
  <div id="panel">
    <p>Bonjour ! Vous cherchez nos dernières offres ? Touchez ci-dessous pour faire vos achats et économiser.</p>
    <button id="cta">Acheter maintenant</button>
  </div>

  <script>
    // impact.com injects the partner's click URL into this page.
    var params   = new URLSearchParams(window.location.search);
    var clickUrl = decodeURIComponent(params.get('clickurl') || '');

    var bubble = document.getElementById('bubble');
    var panel  = document.getElementById('panel');
    bubble.addEventListener('click', function () {
      panel.classList.toggle('open');
    });

    document.getElementById('cta').addEventListener('click', function () {
      if (!clickUrl) return;
      // Open in a new tab so the click is tracked and attributed to the partner.
      window.open(clickUrl, '_blank', 'noopener');
    });
  </script>
</body>
</html>
```

</details>

## Avant la publication

* Hébergez vous-même la page en HTTPS. impact.com intègre votre page dans une iframe ou l’ouvre dans un nouvel onglet : votre code n’est pas hébergé par impact.com. En mode intégré, votre page s’exécute dans une iframe ; ouvrez donc les liens de destination avec `target="_blank"` ou `window.open(...)` au lieu de rediriger la fenêtre parente.
* Encodez l’URL de clic. Transmettez-la sous la forme `{click_url_encoded}` et décodez-la dans votre page afin que ses caractères `?` et `&` ne perturbent pas votre chaîne de requête.
* Confirmez le format de vos liens profonds auprès de votre ingénieur d’intégration impact.com et vérifiez que les destinations sont incluses dans vos domaines autorisés pour les liens profonds.

## Ressources supplémentaires

* [Créer et partager des liens de suivi avec des partenaires](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/generate-leads/create-and-share-tracking-links-with-partners.md) — Comment créer des liens de suivi et les partager avec vos partenaires.
* [Explication des paramètres des liens de suivi](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/tracking/tracking-explained/tracking-link-parameters-explained.md) — Structure d’un lien de suivi et paramètres que vous pouvez ajouter, tels que les sous-identifiants, l’identifiant partagé et les liens profonds.
* [Configurer les domaines autorisés pour les liens profonds](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/set-up-permitted-domains-for-deep-linking.md) — Autorisez les domaines de destination vers lesquels vos partenaires peuvent créer des liens profonds sur votre site.
* [Introduction aux types de ressources](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/platform-features/ads/introduction-to-asset-types.md) — Les types de ressources que vous pouvez proposer à vos partenaires, notamment la place du widget personnalisé.
* [De Rakuten Advertising à impact.com : principales étapes de la transition](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/getting-started/rakuten-advertising-to-impact.com-key-transition-steps.md) — Découvrez ce qui change lorsque vous migrez un programme de Rakuten Advertising vers impact.com.


---

# 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/platform-features/reach-out-to-partners/generate-leads/create-a-custom-widget.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.
