# Verbundene Inhalte

Verbundene Inhalte sind eine Funktion in [Liquid-Vorlagen](/de/product/personalization/liquid-templates/), die es Ihnen ermöglicht, Daten dynamisch aus einer externen Quelle, wie einem Webdienst, abzurufen und direkt in Ihren E-Mail- oder Push-Benachrichtigungen zu verwenden. Diese Funktion ermöglicht eine Echtzeit-Personalisierung, indem JSON-Daten von einer angegebenen URL abgerufen und in einer Variablen gespeichert werden, die in Ihrem Inhalt verwendet werden kann.

## Wichtige Anwendungsfälle

- **Produktempfehlungen**: Zeigen Sie personalisierte Produktlisten an, die auf jeden Benutzer zugeschnitten sind.

- **Promo-Codes**: Fügen Sie einzigartige Promo-Codes ein, die von einem Backend-Dienst generiert werden.

## Voraussetzungen

* Um verbundene Inhalte zu verwenden, müssen Sie über einen eigenen Backend-Dienst verfügen, der die erforderlichen Daten (z. B. Promo-Codes, Produktempfehlungen) basierend auf **User ID, HWID oder benutzerdefinierten Tags** generiert und bereitstellt. Pushwoosh ruft diese Daten dann ab, bevor eine Nachricht gesendet wird.

## Schritt-für-Schritt-Implementierungsanleitung

<Aside type="caution" icon="setting" title="Unterstützung durch Entwickler erforderlich">
Sie benötigen die Hilfe Ihres Entwicklerteams, um verbundene Inhalte zu verwenden. Teilen Sie diese Anleitung mit ihnen, um loszulegen.
</Aside>

### Schritt 1. Backend-Service einrichten

Der Backend-Dienst sollte:

* Eine Anfrage mit benutzerspezifischen Parametern (z. B. `userId`) akzeptieren. Verbundene Inhalte unterstützen `UserID`, `HWID` oder alle benutzerdefinierten Tags, die Sie in Ihrem Projekt eingerichtet haben.
* Eine JSON-Antwort mit den erforderlichen Daten zurückgeben. Dieser Inhalt kann dann dynamisch in Nachrichten eingefügt werden.

<Aside type="note" title="Wie es funktioniert">

Der Backend-Dienst fungiert als Datenanbieter und antwortet auf HTTP-Anfragen mit benutzerspezifischen Informationen.

1. Pushwoosh sendet eine Anfrage an Ihr Backend und übergibt benutzerspezifische Kennungen als Abfrageparameter.
2. Ihr Backend verarbeitet die Anfrage und ruft die angeforderten Daten ab.
3. Ihr Backend gibt eine JSON-Antwort zurück.
4. Bevor eine Nachricht gesendet wird, ruft Pushwoosh die JSON-Antwort vom Backend-Dienst ab und verwendet die zurückgegebenen Werte (z. B. den `code`) dynamisch im Nachrichteninhalt.

**Beispielantwort**

```
{ "code": "SPECIALOFFERFORUSER12345" }
```
</Aside>



### Schritt 2. Erstellen Sie eine Vorlage mit verbundenen Inhalten in Pushwoosh

1. Fügen Sie im [Push](/de/product/content/push-presets/)- oder [E-Mail-Inhaltseditor](/de/product/content/email-content/drag-and-drop-email-editor/) die Syntax für verbundene Inhalte in das Nachrichtenfeld ein.

**Beispiel**

```
{% connected_content http://your-backend-url.com?userId={{ ${userid} }} :save result %}  
```
**Syntax-Aufschlüsselung**
|  |  |
| ----- | ----- |
| `connected_content` | Ruft JSON-Daten von der angegebenen Backend-URL ab. |
|    `http://your-backend-url.com` | Der Backend-Endpunkt, der die erforderlichen Daten im JSON-Format zurückgibt. |
| `userId={{ ${userid} }}` | Ein dynamischer Abfrageparameter, der die Benutzer-ID an das Backend übergibt. Innerhalb von `connected_content` setzen Sie eine Variable in `${}`. Im Nachrichtentext schreiben Sie `{{userid}}` ohne `${}`. |
| `:save result` | Speichert die abgerufene JSON-Antwort in der Ergebnisvariablen zur Verwendung in Liquid-Vorlagen. |

![Die Syntax für verbundene Inhalte einfügen](/connectedcontent.webp)

**Authentifizierung (optional)**

Wenn Ihr Backend-Dienst eine Authentifizierung erfordert, können Sie einen API-Schlüssel oder ein Token in die Anfrage für verbundene Inhalte aufnehmen, um einen sicheren Zugriff zu gewährleisten.

```
{% connected_content http://your-backend-url.com?userId={{ ${userid} }}&auth=YOUR_API_KEY :save result %}  
```

Sie können auch Authentifizierungsdaten (oder andere Daten) als HTTP-Header mit dem optionalen `:headers`-Parameter senden – einem JSON-Objekt aus Header-Namen und -Werten.

```
{% connected_content http://your-backend-url.com?userId={{ ${userid} }} :headers {"Authorization": "Bearer YOUR_TOKEN", "X-Api-Key": "YOUR_API_KEY"} :save result %}  
```
|  |  |
| ----- | ----- |
| `:headers {...}` | Ein JSON-Objekt von HTTP-Headern, die mit der Anfrage gesendet werden, z. B. `Authorization: Bearer <token>`. |

<Aside type="caution" title="Nur statische Werte">
`${}`-Personalisierungsvariablen funktionieren nur innerhalb der URL. Werte innerhalb von `:headers` sind statisch und werden nicht interpoliert.
</Aside>

<Aside type="danger" title="Anmeldeinformationen nicht in der URL speichern">
Bevorzugen Sie `:headers` gegenüber einem URL-Abfrageparameter (z. B. `&auth=YOUR_API_KEY`) für API-Schlüssel und Token: Wenn der Abruf fehlschlägt, wird die Anfrage-URL in die Protokolle geschrieben, wodurch ein dort platzierter Schlüssel offengelegt wird. Werte innerhalb von `:headers` werden niemals protokolliert.

Verbundene Inhalte erfordern auch, dass Liquid-Inhaltsvorlagen für Ihr Konto aktiviert sind. Wenn dies nicht der Fall ist, wird das gesamte `connected_content`-Tag – einschließlich aller darin enthaltenen Schlüssel – an jeden Empfänger als literaler Text gesendet, anstatt gerendert zu werden. Kontaktieren Sie den [Pushwoosh-Support](https://help.pushwoosh.com/hc/en-us/requests/new), wenn Sie unsicher sind, ob dies für Ihr Konto aktiviert ist.
</Aside>

**Verwendung von Tags in verbundenen Inhalten**

Um einen Tag-Wert einzubeziehen, fügen Sie ihn der URL als Abfrageparameter in derselben Form `{{ ${tag_name} }}` hinzu. Wird er innerhalb des `connected_content`-Tags als `{{ tag_name }}` geschrieben, wird der Wert leer gesendet.

```
{% connected_content http://your-backend-url.com?userId={{ ${userid} }}&lang={{ ${Language} }} :save result %} 
```

2. Fügen Sie als Nächstes den Nachrichtentext hinzu, der die **abgerufenen Daten** enthält, wie folgt:

```

Hey, {{userid}}, hol dir deinen persönlichen Promo-Code - {{result.code}} 
```

![Fügen Sie den Nachrichtentext mit den **abgerufenen Daten** hinzu](/connectedcontent-1.webp)

3. Nachdem Sie den Nachrichteninhalt fertiggestellt und die Voreinstellungen konfiguriert haben, speichern Sie sie zur Wiederverwendung in Kampagnen.

<video src="/connectedcontent-2.webm" title="Senden einer Nachricht mit verbundenen Inhalten" autoplay loop muted playsinline />

### Schritt 3. Senden Sie eine Nachricht mit der konfigurierten Vorlage

Senden Sie eine Nachricht mit dieser Vorlage über den [einmaligen Push](/de/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#how-to-send-a-push-notification-using-the-one-time-push-form) oder das [E-Mail-Formular](/de/product/messaging-channels/emails/sending-emails/send-one-time-emails/) oder eine [Customer Journey](/de/product/customer-journey/pushwoosh-journey-overview/).

<Aside type="caution" title="Wichtig">
Wenn der Dienst einen anderen Status als HTTP 200 OK zurückgibt, wird die E-Mail oder Push-Benachrichtigung nicht gesendet. Dies stellt sicher, dass Ihre Kommunikation nur dann versendet wird, wenn die erforderlichen Daten erfolgreich abgerufen wurden.
</Aside>