# Entwickler-Ressourcen

Source: https://help.epilot.cloud/de/journeys/erweiterte-funktionen-entwickler/entwickler-ressourcen
Last updated: 2026-10-19

Auf dieser Seite findest du die wichtigsten **Entwickler-Ressourcen** rund um Journeys: von eigenen Blöcken über das Einbetten per SDK bis zur technischen Dokumentation auf [docs.epilot.io](https://docs.epilot.io/).

Dieser Artikel richtet sich an Entwickler und technisch versierte Admins. Er zeigt dir, welcher Weg für welche Anforderung passt, und wo du die Details findest.

<Callout type="info">
  **Hinweis**

  Die technische Dokumentation auf docs.epilot.io ist auf Englisch. Für die Arbeit damit brauchst du Kenntnisse in JavaScript und Web-Entwicklung.
</Callout>

***

## So funktioniert's [#so-funktionierts]

Je nachdem, was du vorhast, gibt es drei Wege:

* **Eigene Funktion in der Journey**: Du baust einen eigenen Block, zum Beispiel einen Tarifrechner oder eine Anbindung an dein System. Dafür nutzt du eine **epilot App** oder den Block **Eigener API & SDK Block**.

* **Journey auf deiner Website steuern**: Du bindest eine Journey mit dem **Journey Embed SDK** oder als **Web Component** ein und übergibst ihr Daten.

* **Daten und Design anpassen**: Du nutzt die **Journey API**, Kontextparameter, vorausgefüllte Journeys oder Custom CSS.

## Eigene Blöcke entwickeln [#eigene-blöcke-entwickeln]

### Mit einer epilot App (empfohlen) [#mit-einer-epilot-app-empfohlen]

Eine App bündelt deinen Block mit Konfiguration, Berechtigungen und Versionen. Du entwickelst den Block als Web Component, installierst die App in deiner Organisation und richtest den Block danach wie jeden anderen App-Block ein, siehe [App-Blöcke in Journeys](https://help.epilot.cloud/de/journeys/erweiterte-funktionen-entwickler/app-blocke-in-journeys).

* **Start**: Unter **Konfiguration** > **Apps** > **Deine erstellten Apps** legst du mit **App erstellen** eine neue App an. **Zur Dokumentation** führt dich direkt zur Entwickler-Doku.

* **Einstellungen im Block**: In der App legst du fest, welche Felder im Journey Builder unter **Von der App verwendete Konfiguration** erscheinen, zum Beispiel Text, Ja/Nein, Auswahllisten oder einen Referenzblock.

* **Externe Systeme**: Über die Komponente **API-Proxy** ruft dein Block externe Schnittstellen auf, ohne dass Zugangsdaten im Browser landen.

* **Veröffentlichen**: Du nutzt die App nur in deiner Organisation oder bietest sie nach einer Prüfung im Marktplatz an.

<Screenshot src="https://help.epilot.cloud/img/confluence/2ad0b0c428-er-01-deine-erstellten-apps.webp" alt="er-01-deine-erstellten-apps.png" width="1568" height="508" maxWidth="760" />

Dokumentation auf docs.epilot.io:

* [Building Apps for epilot](https://docs.epilot.io/docs/apps/): Überblick über Apps und Komponenten

* [Quick Start](https://docs.epilot.io/docs/apps/getting-started/quick-start/): erste App anlegen

* [Custom journey block](https://docs.epilot.io/docs/apps/components/custom-journey-block) und [Build a custom journey block](https://docs.epilot.io/docs/apps/how-to-guides/build-a-custom-jb): eigenen Journey-Block bauen

* [API proxy](https://docs.epilot.io/docs/apps/components/api-proxy): externe Schnittstellen sicher anbinden

* [Private vs. Public Apps](https://docs.epilot.io/docs/apps/getting-started/private-vs-public): App nur für deine Organisation oder im Marktplatz

### Mit dem Block „Eigener API & SDK Block“ [#mit-dem-block-eigener-api--sdk-block]

Für einfache Fälle bindest du eine eigene Web Component direkt im Journey Builder ein. Du gibst den **Tag-Name** und die **Bündel-URL** deines Skripts an und übergibst Werte über **Args**. Alles Weitere steht in [Eigener API & SDK Block](https://help.epilot.cloud/de/journeys/konfigurieren-von-blocken/eigener-api-sdk-block). Eine Vorlage findest du auf GitHub unter [epilot-dev/custom-journey-block-react](https://github.com/epilot-dev/custom-journey-block-react).

<Callout type="info">
  **Tipp**

  Brauchst du deinen Block in mehreren Journeys oder Organisationen, nimm eine App. Updates verteilst du dann zentral über neue Versionen.
</Callout>

## Journeys einbetten und steuern [#journeys-einbetten-und-steuern]

Wie du eine Journey ohne Programmierung auf deiner Website einbindest, steht in [Journeys auf deiner Website einbinden](https://help.epilot.cloud/de/journeys/einbetten-tracking/journeys-auf-deiner-website-einbinden). Für mehr Kontrolle gibt es zwei technische Wege:

* **Journey Embed SDK**: JavaScript-Schnittstelle zum Einbetten. Du wählst Darstellung (inline oder Vollbild), übergibst Kontextdaten, füllst Felder vor, legst den Startschritt fest und reagierst auf Ereignisse wie das Laden oder Schließen der Journey. Siehe [Journey Embed SDK](https://docs.epilot.io/docs/journeys/sdk).

* **Web Component**: Du bindest die Journey als HTML-Element `<epilot-journey>` direkt in deine Seite ein. Siehe [Journeys als Web Components einbetten](https://help.epilot.cloud/de/journeys/einbetten-tracking/journeys-als-web-components-einbetten) und [Web Components](https://docs.epilot.io/docs/journeys/web-components).

Allgemeine Infos zum Einbetten stehen unter [Embedding Journeys](https://docs.epilot.io/docs/journeys/embedding). Laden deine Seite strenge Sicherheitsregeln, hilft [Content-Security-Policy (CSP)](https://docs.epilot.io/docs/journeys/content-security-policy).

## Daten übergeben und Design anpassen [#daten-übergeben-und-design-anpassen]

* **Kontextparameter**: Werte aus der URL oder dem Einbettungscode übernehmen, zum Beispiel eine Kampagnen-ID. Siehe [Kontextparameter](https://help.epilot.cloud/de/journeys/kontextparameter-nachqualifizierungen/kontextparameter).

* **Vorausgefüllte Journeys**: Felder mit bekannten Daten befüllen. Siehe [Vorausgefüllte Journeys](https://help.epilot.cloud/de/journeys/vorausgefullte-journeys).

* **Tracking**: Ereignisse an dein Analyse-Tool senden. Siehe [Journey-Tracking auf deiner Website](https://help.epilot.cloud/de/journeys/einbetten-tracking/journey-tracking).

* **Custom CSS**: Darstellung über das Design hinaus anpassen. Siehe [Custom CSS für Journeys](https://help.epilot.cloud/de/journeys/design-darstellung/design-builder-erweiterte-design-custom-css) und [Custom CSS](https://docs.epilot.io/docs/journeys/custom-css).

* **Journey API**: Journeys per Schnittstelle lesen und verwalten. Siehe [Journey API](https://docs.epilot.io/api/journey).

<Callout type="warning">
  **Wichtig**

  Eigener Code läuft in der Journey deiner Kunden. Teste ihn gründlich, bevor du die Journey veröffentlichst, und halte externe Skripte aktuell. Für Fehler in eigenem Code ist der epilot Support nicht zuständig.
</Callout>

## Häufige Fragen [#häufige-fragen]

**Brauche ich für eigene Blöcke einen Entwickler?**

Ja. Eigene Blöcke sind Web Components, die in JavaScript programmiert werden. Fertige Blöcke von Partnern findest du ohne Programmierung im Marktplatz.

**Was ist der Unterschied zwischen App-Block und „Eigener API & SDK Block“?**

Ein App-Block kommt aus einer installierten App und bringt Konfiguration, Versionen und Berechtigungen mit. Beim Eigenen API & SDK Block hinterlegst du das Skript direkt im Journey Builder und kümmerst dich selbst um Hosting und Updates.

**Wo finde ich die API-Referenz?**

Alle Schnittstellen stehen auf [docs.epilot.io](https://docs.epilot.io/), die Journey-Schnittstelle unter [Journey API](https://docs.epilot.io/api/journey).
