# Aktionen und Einstellungen nach der Installation ermöglichen

Zusätzliche Einstellungen nach der App-Installation unterstützen.

Installiert ein/e Nutzer/in Ihre App, können Sie weitere Aktionen oder Konfigurationsschritte verlangen. Ihre App kann beispielsweise verlangen, dass der/die Nutzer/in gesonderte Anmeldedaten für den Zugriff auf externe Dienste bereitstellt. Bei Stripe-Apps werden diese Zusatzschritte als *Aktionen nach der Installation* bezeichnet. Dabei stehen verschiedene Kategorien zur Auswahl:

- Innerhalb der App mit der [SettingsView](https://docs.stripe.com/stripe-apps/components/settingsview.md)-Komponente
- Extern über einen Link zu einer externen Website

Legen Sie keine Aktionen nach der Installation fest, zeigt das Dashboard die App nach der Installation an.
 (See full diagram at https://docs.stripe.com/stripe-apps/post-install-actions)
## Aktion nach der Installation hinzufügen

So fügen Sie eine sogenannte Aktion nach der Installation hinzu:

1. Öffnen Sie Ihre [App-Manifest](https://docs.stripe.com/stripe-apps/reference/app-manifest.md)-Datei.

1. Fügen Sie das neue Feld `post_install_action` hinzu.

   ```json
   {
     "id": "com.invoicing.[YOUR_APP]",
     "version": "1.2.3",
     "name": "[YOUR APP] Shipment Invoicing",
     "icon": "./[YOUR_APP]_icon_32.png",
     "permissions": [],
     "app_backend": {},
     "ui_extension": {},"post_install_action": {}
   }
   ```

1. Fügen Sie eine [Konfigurationsoption](https://docs.stripe.com/stripe-apps/post-install-actions.md#configuration-options) für die `post_install_action` hinzu, die Ihrem Anwendungs-Setup spricht.

1. [Laden Sie Ihre App bei Stripe hoch](https://docs.stripe.com/stripe-apps/upload-install-app.md).

1. Erstellen Sie [eine neue App-Version](https://docs.stripe.com/stripe-apps/versions-and-releases.md).

1. [Veröffentlichen Sie Ihre App](https://docs.stripe.com/stripe-apps/publish-app.md) im Marketplace.

## Konfigurationsoptionen

Stripe Apps unterstützt die folgenden Aktionen nach der Installation:

- [Link zur App](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-to-app)
- [Link zum Onboarding](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-to-onboarding)
- [Link zu den Einstellungen](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-to-settings)
- [Link zu externer URL](https://docs.stripe.com/stripe-apps/post-install-actions.md#link-external)

### Link zur App (Standard)

Standardmäßig werden die Nutzer/innen nach der Installation Ihrer App zur Nutzeroberfläche der Anwendung weitergeleitet (sofern vorhanden).
![Bildschirm nach der Installation mit einem Link zum Anzeigen einer App](https://b.stripecdn.com/docs-statics-srv/assets/app.09cbbc38c50cfef0a9aaf9a92f8d1d0e.png)

Dazu sind keine weiteren Einstellungen erforderlich.

### Link zum Onboarding

Wenn Sie Ihre Nutzerin oder Ihren Nutzer anleiten möchten, Einrichtungsaufgaben auszuführen, bevor sie/er Ihre App verwendet, starten Sie den [Onboarding-Ablauf](https://docs.stripe.com/stripe-apps/patterns/onboarding-experience.md) sofort nach der App-Installation. Um diesen Ablauf zu aktivieren, aktualisieren Sie den Parameter `post_install_action` in Ihrer App-Manifestdatei.

```json
{
  "id": "com.invoicing.[YOUR_APP]",
  "version": "1.2.3",
  "name": "[YOUR APP] Shipment Invoicing",
  "icon": "./[YOUR_APP]_icon_32.png",
  "permissions": [],
  "app_backend": {},
  "ui_extension": {},"post_install_action": {
    "type": "onboarding"
  }
}
```

### Link zur externen URL

Sollen die Nutzer/innen für die App-Konfiguration auf eine externe Seite weitergeleitet werden, ändern Sie in Ihrem App-Manifest den Parameter `post_install_action` folgendermaßen:

```json
{
  "id": "com.invoicing.[YOUR_APP]",
  "version": "1.2.3",
  "name": "[YOUR APP] Shipment Invoicing",
  "icon": "./[YOUR_APP]_icon_32.png",
  "permissions": [],
  "app_backend": {},
  "ui_extension": {},"post_install_action": {
    "type": "external",
    "url": "https://[YOUR-URL]"
  }
}
```

Ersetzen Sie `[YOUR-URL]` durch die URL der externen Website.

Nach der Installation wird in der App eine Schaltfläche angezeigt, über die die Nutzer/innen zu der in der Anwendungsmanifestdatei angegebenen URL weitergeleitet werden.

Diese URL enthält den Abfragezeichenfolgenparameter `account_id`, mit dem Sie den/die Nutzer/in identifizieren können. Zum Beispiel:

```
https://www.company.com/marketplace/stripe?account_id=12345
```
![Bildschirm nach der Installation mit einem externen Link](https://b.stripecdn.com/docs-statics-srv/assets/external.565e55096589e7c7580bc5d534c1ace1.png)

### Link zu den Einstellungen

Enthält Ihre App eine [SettingsView](https://docs.stripe.com/stripe-apps/components/settingsview.md)-Komponente, können Sie eine `post_install_action` einrichten, damit diese nach der Installation geöffnet wird. Dazu ändern Sie Ihre Anwendungsmanifestdatei wie folgt:

```json
{
  "id": "com.invoicing.[YOUR_APP]",
  "version": "1.2.3",
  "name": "[YOUR APP] Shipment Invoicing",
  "icon": "./[YOUR_APP]_icon_32.png",
  "permissions": [],
  "app_backend": {},
  "ui_extension": {},"post_install_action": {
    "type": "settings"
  }
}
```

Wird Ihre Anwendung installiert, wird darin eine Schaltfläche angezeigt, über die die Nutzer/innen zur SettingsView-Komponente Ihrer App gelangen.
![Bildschirm nach der Installation mit einem Link zum Anzeigen der Einstellungen](https://b.stripecdn.com/docs-statics-srv/assets/settings.e6bc859871bc657c25d353055497c8ee.png)