# Adapty-Integration

<Aside type="caution" icon="setting" title="Hilfe von Entwicklern benötigt">
Sie benötigen Hilfe von Ihrem Entwicklungsteam, um die Integration einzurichten. Teilen Sie diese Anleitung mit ihnen.
</Aside>

## Integrationsübersicht und Anwendungsfälle

[Adapty](https://app.adapty.io/login) ist eine Plattform für die Verwaltung und Monetarisierung von Abonnements für mobile Apps.

Durch die Integration von Adapty mit Pushwoosh können Sie alle abonnementbezogenen Ereignisse und Paywall-Interaktionen von Adapty an Pushwoosh übergeben. Dort können Sie gezielte Kampagnen starten, um Ihre Nutzerbasis anzusprechen, Upsells zu fördern und Verlängerungen anzuregen.

Dank dieser Integration können Abonnement-Unternehmen ihre Kommunikation effizienter gestalten und eine erhebliche Umsatzsteigerung erzielen.

## Einrichten der Integration

1. **Beginnen Sie in Ihrem** [**Adapty-Konto**](https://app.adapty.io/login)

Navigieren Sie zum Abschnitt „Integrationen“, wählen Sie Pushwoosh aus, aktivieren Sie es, indem Sie den Schalter von „Aus“ auf „Ein“ stellen, und füllen Sie dann die erforderlichen Felder aus.

<img src="/integrations-adapty-integration-1.webp" alt="Pushwoosh- und Adapty-Integration – Schritt 1"/>

2. **Gehen Sie zu Pushwoosh, um die erforderlichen Anmeldeinformationen einzurichten**

Stellen Sie eine Verbindung zwischen Ihren Pushwoosh- und Adapty-Konten her, indem Sie Anmeldeinformationen einrichten. Dies erfordert Ihre Pushwoosh-App-ID und Ihr Authentifizierungstoken.

<img src="/integrations-adapty-integration-2.webp" alt="Pushwoosh- und Adapty-Integration – Schritt 2"/>

3. **Finden Sie Ihre Pushwoosh-Anmeldeinformationen**

*   App-ID: Finden Sie im Pushwoosh-Dashboard.
*   Auth-Token: Befindet sich im Bereich API-Zugriff der Pushwoosh-Einstellungen.

<img src="/integrations-adapty-integration-3.webp" alt="Pushwoosh- und Adapty-Integration – Schritt 3"/>

4. **Konfigurieren Sie Ereignisse und Tags**

Unter den Einstellungen für die Anmeldeinformationen finden Sie Optionen zur Auswahl und Umbenennung verschiedener Ereignisgruppen von Adapty, die an Pushwoosh gesendet werden sollen. Überprüfen und wählen Sie die Ereignisse aus, die Sie benötigen. Eine umfassende Liste der in Adapty verfügbaren Ereignisse finden Sie in [deren ausführlicher Anleitung](https://docs.adapty.io/docs/events).

Adapty übernimmt die Übertragung von Abonnement-Ereignissen an Pushwoosh über eine Server-zu-Server-Integration, was eine vollständige Sichtbarkeit dieser Ereignisse in Ihrem Pushwoosh-Dashboard ermöglicht.

<img src="/integrations-adapty-integration-4.webp" alt="Pushwoosh- und Adapty-Integration – Schritt 4"/>

5. **Aktivieren Sie benutzerdefinierte Tags**

Verbessern Sie Ihre Pushwoosh-Integration mit Adapty, indem Sie benutzerdefinierte Tags verwenden. Diese Tags können an Ihre spezifischen Anforderungen angepasst werden, wie unten beschrieben:

*   adapty\_customer\_user\_id: Eine eindeutige Benutzerkennung von Pushwoosh.
*   adapty\_profile\_id: Eindeutige Adapty-Benutzerprofil-ID, sichtbar im Adapty-Dashboard.
*   environment: Identifiziert die Umgebung des Benutzers, entweder 'Sandbox' oder 'Produktion'.
*   store: Gibt den kaufenden Store an ('app\_store' oder 'play\_store').
*   vendor\_product\_id: Die Produkt-ID im Apple/Google Store.
*   subscription\_expires\_at: Das Ablaufdatum des letzten Abonnements in einem bestimmten Format.
*   last\_event\_type: Typ des letzten Ereignisses von Adapty.
*   purchase\_date: Datum der letzten Transaktion in einem bestimmten Format.
*   original\_purchase\_date: Datum des ersten Kaufs in einem bestimmten Format.
*   active\_subscription: Gibt den Abonnementstatus an.
*   period\_type: Letzter Periodentyp des Kaufs oder der Verlängerung.

Zusätzlich können Sie benutzerdefinierte Attribute für eine größere Flexibilität bei der Nachverfolgung integrieren. Markieren Sie auf der Integrationsseite auf der Seite von Adapty das Kontrollkästchen 'Benutzerdefinierte Benutzerattribute senden' für die automatische Übertragung an Pushwoosh.

6. **Erforderlich: SDK konfigurieren**

Um die Integration abzuschließen, senden Sie den HWID-Wert von Pushwoosh an Adapty:

<Tabs>
<TabItem label="Swift">
```
let params = AdaptyProfileParameters.Builder()
    .with(pushwooshHWID: Pushwoosh.sharedInstance().getHWID())
    .build()

Adapty.updateProfile(params: params) { error in
    // handle the error
}
```
</TabItem>

<TabItem label="Kotlin">
```
val params = AdaptyProfileParameters.Builder()
    .withPushwooshHwid(Pushwoosh.getInstance().hwid)
    .build()

Adapty.updateProfile(params) { error ->
    if (error != null) {
        // handle the error
    }
}
```
</TabItem>

<TabItem label="Java">
```
AdaptyProfileParameters params = new AdaptyProfileParameters.Builder()
    .withPushwooshHwid(Pushwoosh.getInstance().getHwid())
    .build();

Adapty.updateProfile(params, error -> {
    if (error != null) {
        // handle the error
    }
})
```
</TabItem>

<TabItem label="Flutter">
```
import 'package:pushwoosh/pushwoosh.dart';

final builder = AdaptyProfileParametersBuilder()
        ..setPushwooshHWID(
          await Pushwoosh.getInstance.getHWID,
        );
try {
    await adapty.updateProfile(builder.build());
} on AdaptyError catch (adaptyError) {
    // handle error
} catch (e) {}
```
</TabItem>

<TabItem label="TypeScript">
```
import { adapty } from 'react-native-adapty';
import Pushwoosh from 'pushwoosh-react-native-plugin';

// ...
try {
  await adapty.updateProfile({
    pushwooshHWID: hwid,
  });
} catch (error) {
  // handle `AdaptyError`
}
```
</TabItem>

<TabItem label="Unity">
```
var builder = new Adapty.ProfileParameters.Builder();
builder.SetPushwooshHWID(Pushwoosh.Instance.HWID);

Adapty.UpdateProfile(builder.Build(), (error) => {
    // handle error
});
```
</TabItem>
</Tabs>

<Aside type="note">
Lesen Sie mehr über [mögliche Anwendungsfälle der Pushwoosh- und Adapty-Integration](https://blog.pushwoosh.com/blog/adapty-integration/) in unserem Blog
</Aside>