# Customer Journeys über API-basierten Einstieg auslösen

Der API-basierte Einstieg ermöglicht es Ihnen, eine Customer Journey in dem Moment zu starten, in dem ein bestimmtes Geschäftsereignis eintritt. Um eine Kampagne zu starten, müssen Sie eine spezielle API-Anfrage senden.

## Einrichtung

1. Erstellen Sie eine Journey mit einem API-basierten Einstieg

<video src="/customer-journey-api-based-entry-1.webm" alt="Oberfläche des Customer Journey Builders, die zeigt, wie eine neue Journey mit dem Element API-basierter Einstieg erstellt wird" autoplay loop muted playsinline />

2. Doppelklicken Sie auf den Schritt des API-basierten Einstiegs. Das Konfigurationsfenster für den Einstieg wird geöffnet.

3. Sie können den Inhalt von Push-Benachrichtigungen und E-Mails bei jedem Start der Journey mithilfe von Inhaltsplatzhaltern ändern. Der Wert jedes Platzhalters kann in der Anfrage geändert werden. Wenn Sie diese Option nicht benötigen, können Sie diesen Schritt überspringen.

> Wenn Sie beispielsweise eine Journey erstellen, um Abonnenten über die Veröffentlichung einer neuen Podcast-Episode zu informieren, können Sie mithilfe eines Inhaltsplatzhalters den Podcast-Titel bei jedem Start der Journey ändern.

Fügen Sie zunächst im Einrichtungsfenster für den API-basierten Einstieg Platzhalternamen hinzu. Sie können beliebige Namen verwenden, die für Sie praktisch sind.

<video src="/customer-journey-api-based-entry-2.webm" alt="Konfigurationsfenster für den API-basierten Einstieg, das zeigt, wie Platzhalternamen für dynamische Inhalte hinzugefügt werden" autoplay loop muted playsinline />

Erstellen Sie nun ein Push- oder E-Mail-[Preset](/de/product/content/presets/) und fügen Sie den Platzhalter anstelle des Textes ein, den Sie ändern möchten. Der Platzhalter muss je nach Ihren Anforderungen in einem der folgenden Formate vorliegen:

*   `{placeholder_name|format_modifier|}` – wenn der Wert des Platzhalters beim Start der Kampagne nicht angegeben wird, sehen die Benutzer an seiner Stelle einen leeren Bereich.
*   `{placeholder_name|format_modifier}` – wenn der Wert des Platzhalters nicht angegeben ist und noch keinem Benutzer zugewiesen wurde (falls Sie einen Tag als Platzhalter verwendet haben), wird die Nachricht nicht gesendet.

<details>

<summary>Formatmodifikatoren</summary>

*   CapitalizeFirst – schreibt den ersten Buchstaben im Wert eines Platzhalters groß;
*   CapitalizeAllFirst – schreibt die ersten Buchstaben aller Wörter im Wert eines Platzhalters groß, wenn der Wert aus mehr als einem Wort besteht;
*   UPPERCASE – wandelt alle Buchstaben in Großbuchstaben um;
*   lowercase – wandelt alle Buchstaben in Kleinbuchstaben um;
*   regular – fügt den Wert eines Platzhalters genau wie in der Anfrage angegeben ein, ohne Änderungen.

</details>

<img src="/customer-journey-api-based-entry-3.webp" alt="Editor für Push-Presets, der ein Beispiel für die Platzhaltersyntax mit Formatmodifikatoren im Nachrichteninhalt zeigt"/>

<Aside type="note">
Sie können auch einen bestehenden Tag-Namen anstelle eines Platzhalternamens verwenden. In diesem Fall müssen Sie das Überschreiben dieses Tag-Wertes durch den in der Anfrage angegebenen Wert wie unten beschrieben konfigurieren.
</Aside>

Wählen Sie bei der Konfiguration des Push- oder E-Mail-Schritts in Ihrer Journey das erstellte Preset aus und aktivieren Sie die Option **Nachricht mit Ereignisattributen personalisieren**. Wählen Sie die Platzhalter aus, die Sie in der Anfrage beim Start der Journey ändern möchten. Wählen Sie einen **API-basierten Einstieg** als Quelle und den Platzhalternamen als dynamisches Attribut:

<video src="/customer-journey-api-based-entry-4.webm" title="Konfiguration des Push- oder E-Mail-Schritts, die die Option 'Nachricht mit Ereignisattributen personalisieren' und die Auswahl der Quelle 'API-basierter Einstieg' zeigt" autoplay loop muted playsinline />

Klicken Sie auf **Anwenden**, um die Änderungen zu speichern.

4. Kopieren Sie im Konfigurationsfenster für den Einstieg die Anfragevorlage, um sie zu ändern:

<img src="/customer-journey-api-based-entry-5.webp" alt="Konfigurationsfenster für den API-basierten Einstieg, das die API-Anfragevorlage mit dem Format des Authorization-Headers anzeigt"/>
<Aside>
Um eine Journey über die API zu starten, müssen Sie ein gültiges Autorisierungstoken in den Authorization-Header aufnehmen.

**Erforderliches Header-Format**

 ```http
 Authorization: Api <your_api_token>
 ```
 **Beispiel**

 ```http
 Authorization: Api c8dc6435-xxxxxxxxxxxxxxx
 ```
</Aside>

5. Fügen Sie dem Parameter "filter" Zielgruppenfilter hinzu, indem Sie die [Segmentierungssprache](/de/developer/api-reference/segmentation-filters-api/segmentation-language/) verwenden. Bitte beachten Sie, dass Sie die erforderlichen [Tags](/de/developer/guides/audience-and-segmentation/tags/) im Voraus einrichten müssen.

Wenn Sie die Journey beispielsweise auf Benutzer ausrichten möchten, die den Artikel _Socken_ zu ihrer _Wunschliste_ hinzugefügt haben, muss der Wert für "filter" wie folgt aussehen:

```
    "filter": "A("12345-12345") * "T("Wishlist", EQ, "Socks")"
```

In diesem Beispiel müssen Sie einen _Wunschliste_-Tag in Ihrer App konfiguriert haben.

<Aside type="note">
Ihr Anwendungscode wird automatisch im Format `A(\"12345-12345\")` zum Parameter "filter" hinzugefügt. Bitte entfernen oder ändern Sie ihn nicht.

Bitte beachten Sie auch, dass Anführungszeichen ("") und Backslashes (\\) in JSON-Abfragen mit einem Backslash (\\) escaped werden müssen.
</Aside>

6. Wenn Sie Platzhalter eingerichtet haben, geben Sie den gewünschten Inhalt als deren Werte an:

<img src="/customer-journey-api-based-entry-6.webp" alt="API-Anfragevorlage, die die Konfiguration von Platzhalterwerten für dynamische Inhalte beim Start der Journey zeigt"/>

7. Wenn die Option **Nachrichtenratenbegrenzung** aktiviert ist, wird die Anzahl der Benutzer, die pro Sekunde gleichzeitig in die Journey eintreten, begrenzt. Sie können den Standardwert von 5000 Benutzern pro Sekunde verwenden oder eine andere Zahl festlegen.

<img src="/customer-journey-api-based-entry-7.webp" alt="Konfiguration des API-basierten Einstiegs, die die Option 'Nachrichtenratenbegrenzung' mit einem Standardwert von 5000 Benutzern pro Sekunde zeigt"/>

<Aside type="tip">
Wir empfehlen, den Wert zwischen 5000 und 10000 Benutzern pro Sekunde zu halten. Wenn der Wert zu niedrig ist, kann es länger dauern, bis Ihre Zielgruppe in die Journey eintritt. Wenn der Wert zu hoch ist, kann der Dienst, der Ihre Daten verarbeitet, überlastet werden.
</Aside>

8. Wenn Sie planen, Ihre Kampagne häufig neu zu starten und nicht möchten, dass dieselben Benutzer mehrmals in die Journey eintreten, richten Sie [Frequency Capping](/de/product/customer-journey/journey-settings#frequency-capping) ein.

> Sie haben beispielsweise eine Kampagne erstellt, um Benutzer über eine Preissenkung für ein bestimmtes Produkt zu informieren. Sie möchten die Journey einige Male neu starten, indem Sie mehrere Anfragen mit unterschiedlichen Zielgruppenfiltern senden. In diesem Fall können Sie Frequency Capping hinzufügen, damit die Benachrichtigung nicht wiederholt an Benutzer gesendet wird, die auf mehrere Filter passen.

9. Wenn Sie möchten, dass eine Journey immer dann gestartet wird, wenn ein bestimmtes Geschäftsereignis eintritt, automatisieren Sie die Anfrage mithilfe des Webhooks. Sobald das Ereignis eintritt, sollte der Webhook automatisch die Anfrage zum Starten der Journey senden.

Sie können die Anfrage auch manuell senden, wenn Sie keine Automatisierung benötigen.

<Aside type="note">
*   Wenn Sie die Segmentierungsbedingungen beim Senden einer neuen Anfrage ändern, hat dies keine Auswirkungen auf Benutzer, die bereits in die Journey eingetreten sind.
*   Wenn Sie den Nachrichteninhalt beim Senden einer neuen Anfrage ändern, erhalten alle Benutzer die neue Version der Nachricht (einschließlich derer, die bereits in die Journey eingetreten sind, diese Nachricht aber noch nicht erhalten haben).
</Aside>