# Grundlegende Integrationsanleitung für das Cordova SDK
Dieser Abschnitt enthält Informationen zur Integration des Pushwoosh Cordova SDK in Ihre Anwendung.
## Voraussetzungen
Um das Pushwoosh Cordova SDK in Ihre App zu integrieren, benötigen Sie Folgendes:
## Integrationsschritte
### 1. Abhängigkeit des Pushwoosh Cordova SDK hinzufügen
Fügen Sie die Abhängigkeit des Pushwoosh Cordova SDK zu Ihrem Projekt hinzu:
```bash
cordova plugin add pushwoosh-cordova-plugin
```
### 2. Initialisierung des Cordova SDK
Fügen Sie in der Root-Komponente Ihrer `index.js`-Datei den folgenden Code innerhalb des `deviceready`-Event-Handlers hinzu. Befolgen Sie die Schritte in exakter Reihenfolge:
```javascript title="index.js"
document.addEventListener('deviceready', function() {
var pushwoosh = cordova.require("pushwoosh-cordova-plugin.PushNotification");
// 1. Registrieren Sie Benachrichtigungs-Callbacks vor der Initialisierung
document.addEventListener('push-receive', function(event) {
var notification = event.notification;
console.log("Push received: " + JSON.stringify(notification));
});
document.addEventListener('push-notification', function(event) {
var notification = event.notification;
console.log("Push opened: " + JSON.stringify(notification));
});
// 2. Initialisieren Sie Pushwoosh
pushwoosh.onDeviceReady({
appid: "__YOUR_APP_ID__"
});
// 3. Registrieren Sie das Gerät, um Push-Benachrichtigungen zu erhalten
pushwoosh.registerDevice(
function(status) {
var pushToken = status.pushToken;
// Erfolgreiche Registrierung handhaben
},
function(status) {
// Registrierungsfehler handhaben
}
);
}, false);
```
Wobei:
- `__YOUR_APP_ID__` der Anwendungscode aus dem Pushwoosh Control Panel ist.
### 3. Natives iOS-Setup
#### 3.1 Capabilities
Um Push-Benachrichtigungen in Ihrem Projekt zu aktivieren, müssen Sie bestimmte Capabilities hinzufügen.
Fügen Sie im Abschnitt „Signing & Capabilities“ die folgenden Capabilities hinzu:
- `Push Notifications`
- `Background Modes`. Nachdem Sie diese Capability hinzugefügt haben, aktivieren Sie das Kontrollkästchen für `Remote notifications`.
Wenn Sie Time Sensitive Notifications (iOS 15+) verwenden möchten, fügen Sie auch die Capability `Time Sensitive Notifications` hinzu.
#### 3.2 Info.plist
Setzen Sie in Ihrer `Runner/Info.plist` den Schlüssel `__PUSHWOOSH_DEVICE_API_TOKEN__` auf den [Pushwoosh Device API Token](/de/developer/api-reference/api-access-token/#device-api-token):
```swift title="info.plist"
Pushwoosh_API_TOKEN__PUSHWOOSH_DEVICE_API_TOKEN__
```
#### 3.3 Verfolgung der Nachrichtenzustellung
Sie müssen Ihrem Projekt ein Notification Service Extension Target hinzufügen. Dies ist für eine genaue Zustellungsverfolgung und Funktionen wie Rich Media auf iOS unerlässlich.
Folgen Sie den [Schritten der nativen Anleitung](/de/developer/pushwoosh-sdk/ios-sdk/setting-up-pushwoosh-ios-sdk/basic-integration-guide/#4-message-delivery-tracking), um das Extension Target und den erforderlichen Pushwoosh-Code darin hinzuzufügen.
### 4. Natives Android-Setup
#### 4.1 Abhängigkeiten installieren
Stellen Sie sicher, dass die erforderlichen Abhängigkeiten und Plugins zu Ihren Gradle-Skripten hinzugefügt werden:
Fügen Sie das Google Services Gradle-Plugin zu den Abhängigkeiten Ihrer `build.gradle`-Datei auf Projektebene hinzu:
```groovy title="android/build.gradle"
buildscript {
dependencies {
classpath 'com.google.gms:google-services:4.3.15'
}
}
```
Wenden Sie das Plugin in Ihrer `build.gradle`-Datei auf App-Ebene an:
```groovy title="app/build.gradle"
apply plugin: 'com.google.gms.google-services'
```
#### 4.2 Firebase-Konfigurationsdatei hinzufügen
Platzieren Sie die Datei `google-services.json` in den Ordner `android/app` in Ihrem Projektverzeichnis.
#### 4.3 Pushwoosh-Metadaten hinzufügen
Fügen Sie in Ihrer `main/AndroidManifest.xml` den [Pushwoosh Device API Token](/de/developer/api-reference/api-access-token/#device-api-token) innerhalb des ``-Tags hinzu:
```xml title="AndroidManifest.xml"
```
> **Wichtig:** Stellen Sie sicher, dass Sie dem Token im Pushwoosh Control Panel Zugriff auf die richtige App gewähren. [Erfahren Sie mehr](/de/developer/api-reference/api-access-token/#edit-token)
### 5. Projekt ausführen
1. Erstellen und führen Sie das Projekt aus.
2. Gehen Sie zum Pushwoosh Control Panel und [senden Sie eine Push-Benachrichtigung](/de/product/messaging-channels/push-notifications/send-push-notifications/one-time-push).
3. Sie sollten die Benachrichtigung in der App sehen.
## Erweiterte Integration
In dieser Phase haben Sie das SDK bereits integriert und können Push-Benachrichtigungen senden und empfangen. Lassen Sie uns nun die Kernfunktionalität erkunden.
### Event-Listener für Push-Benachrichtigungen
Im Pushwoosh SDK gibt es zwei Event-Listener, die für die Handhabung von Push-Benachrichtigungen konzipiert sind:
- Das `push-receive`-Event wird ausgelöst, wenn eine Push-Benachrichtigung empfangen wird, während die App im Vordergrund ist.
- Das `push-notification`-Event wird ausgelöst, wenn ein Benutzer eine Benachrichtigung öffnet.
Diese Event-Listener **müssen** registriert werden, **bevor** `onDeviceReady()` aufgerufen wird, wie im [Initialisierungsschritt oben](#2-cordova-sdk-initialization) gezeigt. Sie können die Handler-Logik an Ihre Bedürfnisse anpassen:
```javascript title="index.js"
// Vor onDeviceReady() registrieren
document.addEventListener('push-receive', function(event) {
var message = event.notification.message;
var payload = event.notification.userdata;
console.log("Push received: " + message);
// Fügen Sie hier Ihre benutzerdefinierte Logik hinzu
});
document.addEventListener('push-notification', function(event) {
var message = event.notification.message;
var payload = event.notification.userdata;
console.log("Push accepted: " + message);
// Fügen Sie hier Ihre benutzerdefinierte Logik hinzu (z. B. zu einem bestimmten Bildschirm navigieren)
});
```
### Benutzerkonfiguration
Indem Sie sich auf das individuelle Benutzerverhalten und die Vorlieben konzentrieren, können Sie personalisierte Inhalte liefern, was zu einer erhöhten Benutzerzufriedenheit und -loyalität führt.
```javascript
class Registration {
afterUserLogin(user) {
// Benutzer-ID setzen
pushwoosh.setUserId(user.getId());
// Zusätzliche Benutzerinformationen als Tags für Pushwoosh setzen
pushwoosh.setTags({
"age": user.getAge(),
"name": user.getName(),
"last_login": user.getLastLoginDate()
});
}
}
```
### Tags
Tags sind Schlüssel-Wert-Paare, die Benutzern oder Geräten zugewiesen werden und eine Segmentierung basierend auf Attributen wie Vorlieben oder Verhalten ermöglichen, was gezieltes Messaging ermöglicht.
```javascript
class UpdateUser {
afterUserUpdateProfile(user) {
// Liste der Lieblingskategorien setzen
pushwoosh.setTags({
"favorite_categories": user.getFavoriteCategoriesList()
});
// Zahlungsinformationen setzen
pushwoosh.setTags({
"is_subscribed": user.isSubscribed(),
"payment_status": user.getPaymentStatus(),
"billing_address": user.getBillingAddress()
});
}
}
```
### Events
Events sind spezifische Benutzeraktionen oder Vorkommnisse innerhalb der App, die verfolgt werden können, um das Verhalten zu analysieren und entsprechende Nachrichten oder Aktionen auszulösen.
```javascript
class Registration {
// Login-Event verfolgen
afterUserLogin(user) {
pushwoosh.postEvent("login", {
"name": user.getName(),
"last_login": user.getLastLoginDate()
});
}
// Kauf-Event verfolgen
afterUserPurchase(product) {
pushwoosh.postEvent("purchase", {
"product_id": product.getId(),
"product_name": product.getName(),
"price": product.getPrice(),
"quantity": product.getQuantity()
});
}
}
```
## Fehlerbehebung
Wenn während des Integrationsprozesses Probleme auftreten, lesen Sie bitte den Abschnitt [Support und Community](/de/developer/pushwoosh-sdk/support-and-community).