> 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/de/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/generate-leads/create-a-custom-widget.md).

# Ein benutzerdefiniertes Widget erstellen

Entwickeln Sie dynamische Tools, mit denen Partner Ihre Marke bewerben können. Mit benutzerdefinierten Widgets können Sie extern gehostete Tools oder Seiten per iFrame direkt in die impact.com-Oberfläche einbetten. In dieser Anleitung erfahren Sie, wie Sie ein benutzerdefiniertes Inhalts-Widget erstellen und konfigurieren, das Ihren Partnern personalisierte Ressourcen und ein einheitliches Markenerlebnis bietet.

{% stepper %}
{% step %}

## Den Creator für benutzerdefinierte Widgets öffnen

1. Wählen Sie im linken Navigationsmenü ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-230534471fef5f40808e921e41ee44e4a06ded03%2Fe6cb9548999afdc1ed3ce4942e4cb5b45b5cecbd323267aac2a7cd1915fccc09.svg?alt=media) **\[Engage]** → **Inhalte** → [**Widgets**](https://app.impact.com/secure/advertiser/engage/ads/list-widget-tool-flow.ihtml)**.**
2. Wählen Sie oben rechts **Widget erstellen** → **Benutzerdefiniert**.
   {% endstep %}

{% step %}

## Widget-Details eingeben

1. Geben Sie einen **Namen** für das benutzerdefinierte Widget ein.
2. Geben Sie optional eine **Beschreibung** für das benutzerdefinierte Widget ein.
3. Geben Sie optional eine **Bezeichnung** für das benutzerdefinierte Widget ein.
4. Aktivieren Sie bei Bedarf ![](https://1698965099-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) **\[Partnerzugriff einschränken]**  , um einzelne Partner und Gruppen anzugeben, die Zugriff auf das Widget haben sollen.
   * **Partner:** Geben Sie die Namen der Partner ein, die auf das benutzerdefinierte Widget zugreifen können.
   * **Gruppen:** Geben Sie die Namen der Gruppen ein, die auf das benutzerdefinierte Widget zugreifen können.
     {% endstep %}

{% step %}

## Widget konfigurieren

1. Wählen Sie in den Anzeigeoptionen aus, wie sich das Widget verhalten soll:
   * **In neuem Tab öffnen:** Öffnet die gehostete URL in einem separaten Tab.
   * **In impact.com einbetten:** Zeigt das Widget direkt in der Plattformoberfläche an.
2. Wählen Sie optional im Abschnitt **Vorschaubild** die Option **Datei auswählen** aus, um ein Vorschaubild hochzuladen. Die Datei muss im GIF-, JPG- oder PNG-Format vorliegen und darf 512 KB nicht überschreiten.
3. Geben Sie im Feld **Widget-URL** die Webadresse ein, unter der Ihr Widget gehostet wird.
4. Wählen Sie im ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media)**\[Dropdown-Menü]**&#x64;as Protokoll (z. B. https\://) aus, das der Sicherheitskonfiguration Ihrer Website entspricht.
5. Wählen Sie optional ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-6282f271b7521383385339243690b303086736d9%2F3b5a585dd2895bdf1c30d1236c72ba590dddd18717863b27074c8d313d05ae20.svg?alt=media) **\[Hinzufügen] Dynamische Felder einfügen** aus, um die Tokenliste zu erweitern.
6. Suchen Sie das gewünschte Token und wählen Sie **Einfügen**. Die Plattform hängt das Token (z. B. {irpid}) automatisch an deine **Widget-URL** an. Eine Beschreibung der einzelnen Tokens findest du im Abschnitt [Dynamische Feld-Tokens](#dynamic-field-tokens) weiter unten.
   {% endstep %}

{% step %}

## Erweiterte Einstellungen aktualisieren

Wähle im **Sprache** ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2Fgit-blob-c2cb550b55c51ea1eeff0acbd6f437a03b621a2c%2F60d033ae8a04c14498d5229c3c0160ac05feea7f605dbd770741793c900469f0.svg?alt=media)**\[Dropdown-Menü]** die Sprache aus, in der dieses Widget angezeigt werden soll.
{% endstep %}

{% step %}

## Benutzerdefiniertes Widget fertigstellen

Wähle **Erstellen**  aus, um dein Widget zu speichern. Partner finden dieses Widget unter *Content-Widgets*.
{% endstep %}
{% endstepper %}

<details>

<summary>Dynamische Feld-Tokens</summary>

| Token                          | Beschreibung                                            |
| ------------------------------ | ------------------------------------------------------- |
| `{click_url_encoded}`          | Klick-URL codiert                                       |
| `{click_url}`                  | Klick-URL nicht codiert                                 |
| `{irimpurl}`                   | Unsere Impression-URL                                   |
| `{irpid}`                      | Partner-ID                                              |
| `{subid1}`                     | Partner-Sub-ID 1                                        |
| `{subid2}`                     | Partner-Sub-ID 2                                        |
| `{subid3}`                     | Partner-Sub-ID 3                                        |
| `{sharedId}`                   | Geteilte ID                                             |
| `{iradid}`                     | Anzeigen-ID                                             |
| `{ircid}`                      | Programm-ID                                             |
| `{click_url_encoded_deeplink}` | Codierte Klick-URL mit angehängtem Deep-Link-Parameter. |

</details>

## Praxisbeispiele

{% hint style="info" %}
**Zu diesen Beispielen:** Benutzerdefinierte Widgets werden von dir erstellt und gehostet – impact.com bindet lediglich die gehostete Seite ein und fügt ihr aktuelle Partnerdaten hinzu. Kopiere die nachstehenden Beispielimplementierungen, hoste sie auf deiner eigenen Domain und passe sie an. Partner bearbeiten keinen Code, sondern öffnen einfach das fertige Widget unter *Content-Widgets*.
{% endhint %}

### So gelangen dynamische Feld-Tokens zu deinem Widget

Wenn du der **Widget-URL** ein dynamisches Feld-Token hinzufügst, ersetzt impact.com dieses vor dem Laden deiner Seite durch die tatsächlichen Werte des jeweiligen Partners. Deine Seite liest diese Werte aus der Abfragezeichenfolge und verwendet sie, um nachverfolgbare Links zu erstellen.

Wenn du beispielsweise die **Widget-URL**  auf `https://widgets.yourbrand.com/search?partner={irpid}&clickurl={click_url_encoded}`setzt, lädt impact.com für einen Partner mit der ID `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" %}
Übergib die Klick-URL als `{click_url_encoded}`und nicht als `{click_url}` – eine unformatierte Klick-URL enthält selbst ein `?` und `&` Zeichen, die Ihre Abfragezeichenfolge beschädigen. Dekodieren Sie sie vor der Verwendung auf Ihrer Seite.
{% endhint %}

### Beispiel 1: Such-Widget

Ermöglicht einem Partner, Ihren Produktkatalog zu durchsuchen und für jedes Produkt einen nachverfolgbaren Link zu kopieren, ohne impact.com zu verlassen. Sie hosten die Suchseite; impact.com übergibt die ID des Partners und die Klick-URL, sodass jeder Ergebnislink diesem Partner zugeordnet wird.

1. Hosten Sie die Suchseite über HTTPS auf einer von Ihnen kontrollierten Domain (z. B. `https://widgets.yourbrand.com/search`). Ersetzen Sie das Demo- `CATALOG` -Array durch einen Aufruf Ihres eigenen Produktkatalogs oder Ihrer Such-API.
2. Erstellen Sie das benutzerdefinierte Widget mithilfe der fünf oben genannten Schritte. Legen Sie unter **Widget konfigurieren**die **Widget-URL** auf Ihre Seite fest, mit den `{irpid}` - und `{click_url_encoded}` -Tokens (siehe unten).
3. Testen Sie mit **In neuem Tab öffnen**, führen Sie eine Suche als Testpartner durch und überprüfen Sie, ob die Ergebnislinks auf Ihre Website verweisen und ein Klick erfasst wird. Stellen Sie das Widget anschließend auf **In impact.com einbetten**.

**Widget-URL**

{% 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>Produktsuche</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="Produkte suchen..." />
    <button id="go">Suchen</button>
  </div>
  <div id="results"></div>

  <script>
    // 1. Die Werte auslesen, die impact.com in die Widget-URL eingefügt hat.
    var params    = new URLSearchParams(window.location.search);
    var partnerId = params.get('partner') || '';
    var clickUrl  = decodeURIComponent(params.get('clickurl') || '');

    // 2. Dieses Demo-Array durch einen Aufruf Ihres eigenen Produktkatalogs / Ihrer Such-API ersetzen.
    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. Build a trackable deep link: the partner's click URL + the destination page.
    //    Confirm your program's exact deep-link format before publishing (see "Before you publish").
    function buildTrackingLink(destinationUrl) {
      if (!clickUrl) return destinationUrl;            // fallback: no tracking if the token is missing
      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>No products found.</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 + '">Copy link</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>

### Beispiel 2: Dynamische Rich-Media-Anzeige (schwebendes Chat-Widget)

Eine dynamische Rich-Media-Anzeige ist jedes interaktive HTML-Asset, das Sie hosten und als Widget einbetten. In diesem Beispiel erstellen Sie eine schwebende Chat-Sprechblase, die sich zu einer Werbebotschaft mit Call-to-Action erweitert. Wenn Besucherinnen oder Besucher die Schaltfläche auswählen, werden sie über die Klick-URL des Partners weitergeleitet. So wird der Klick erfasst und zugeordnet.

1. Hosten Sie die Seite über HTTPS auf einer Domain, die Sie kontrollieren (z. B. `https://widgets.yourbrand.com/chat`). Passen Sie Text, Farben und Call-to-Action an Ihre Kampagne an.
2. Erstellen Sie das benutzerdefinierte Widget anhand der fünf obigen Schritte und legen Sie dabei die **Widget-URL** mit dem Token `{click_url_encoded}` fest (siehe unten).
3. Testen Sie mit **In neuem Tab öffnen** als Testpartner. Vergewissern Sie sich, dass der Call-to-Action Ihre Website öffnet und einen Klick erfasst. Stellen Sie das Widget anschließend auf **In impact.com einbetten**.

**Widget-URL**

{% code overflow="wrap" %}

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

{% endcode %}

Wenn Besucherinnen und Besucher statt auf Ihrer Standard-Landingpage auf einer bestimmten Seite landen sollen, verwenden Sie das Token `{click_url_encoded_deeplink}` anstelle von `{click_url_encoded}`oder fügen Sie das Ziel wie in Beispiel 1 gezeigt in Ihrem eigenen Code hinzu.

<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>Hallo! Möchten Sie unsere neuesten Angebote entdecken? Tippen Sie unten, um einzukaufen und zu sparen.</p>
    <button id="cta">Jetzt einkaufen</button>
  </div>

  <script>
    // impact.com fügt die Klick-URL des Partners in diese Seite ein.
    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;
      // In einem neuen Tab öffnen, damit der Klick erfasst und dem Partner zugeordnet wird.
      window.open(clickUrl, '_blank', 'noopener');
    });
  </script>
</body>
</html>
```

</details>

## Vor der Veröffentlichung

* Hosten Sie die Seite selbst über HTTPS. impact.com bindet Ihre Seite per iFrame ein oder öffnet sie in einem neuen Tab – Ihr Code wird nicht von impact.com gehostet. Im Einbettungsmodus wird Ihre Seite in einem iFrame ausgeführt. Öffnen Sie Ziel-Links daher mit `target="_blank"` oder `window.open(...)` anstatt das übergeordnete Fenster weiterzuleiten.
* Kodieren Sie die Klick-URL. Übergeben Sie sie als `{click_url_encoded}` und dekodieren Sie sie auf Ihrer Seite, damit ihre eigenen `?` und `&` -Zeichen die Abfragezeichenfolge nicht beschädigen.
* Klären Sie das Format für Deep Links mit Ihrem Integration Engineer bei impact.com ab und stellen Sie sicher, dass die Ziele von Ihren zulässigen Domains für Deep Linking abgedeckt sind.

## Weitere Ressourcen

* [Tracking-Links erstellen und mit Partnern teilen](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/platform-features/reach-out-to-partners/generate-leads/create-and-share-tracking-links-with-partners.md) – So erstellen Sie Tracking-Links und teilen sie mit Ihren Partnern.
* [Tracking-Link-Parameter erklärt](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/platform-features/tracking/tracking-explained/tracking-link-parameters-explained.md) – Aufbau eines Tracking-Links und Parameter, die Sie hinzufügen können, z. B. Sub-IDs, Shared ID und Deep Links.
* [Zulässige Domains für Deep Links einrichten](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/account-administration/program-settings/tracking-settings/set-up-permitted-domains-for-deep-linking.md) — Autorisieren Sie die Zieldomains, auf die Partner auf Ihrer Website Deep Links setzen dürfen.
* [Einführung in Asset-Typen](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/platform-features/ads/introduction-to-asset-types.md) — Die Asset-Typen, die Sie Partnern anbieten können, einschließlich der Einordnung des benutzerdefinierten Widgets.
* [Von Rakuten Advertising zu impact.com: Wichtige Schritte beim Übergang](https://help.impact.com/brand/de/what-would-you-like-to-learn-about/getting-started/rakuten-advertising-to-impact.com-key-transition-steps.md) — Was sich ändert, wenn Sie ein Programm von Rakuten Advertising zu impact.com migrieren.


---

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