Amplitude-Integration

Unterstützung durch Entwickler erforderlich

Sie benötigen Hilfe von Ihrem Entwicklungsteam, um die Integration einzurichten. Teilen Sie diese Anleitung mit ihnen.

Amplitude, eine robuste Produktanalyse-Plattform, ermöglicht es Unternehmen, das Nutzerverhalten in Echtzeit zu verstehen, Interaktionen im Produkt zu verfolgen und wertvolle Einblicke in das Engagement, die Bindung und den Umsatz der Nutzer zu gewinnen.

Die Integration von Amplitude mit Pushwoosh ermöglicht es Ihnen, Pushwoosh-Kampagnen mit Amplitude-Daten zu personalisieren, automatisierte Kampagnen basierend auf Nutzeraktionen auszulösen, die Leistung für kontinuierliche Verbesserungen zu analysieren und letztendlich das Engagement zu steigern, die Abwanderung zu reduzieren und den Umsatz zu erhöhen.

Integrationsübersicht

Integrationstyp

Ziel: Daten werden von Amplitude an Pushwoosh gesendet.

Voraussetzungen

Um die Event-Streaming- und Cohort-Sync-Integration von Amplitude zu Pushwoosh einzurichten, stellen Sie sicher, dass die folgenden Voraussetzungen erfüllt sind:

• Sie benötigen ein aktives Pushwoosh-Konto.
• Generieren Sie ein API Access Token in Pushwoosh, um Daten zu senden.
• Finden Sie Ihren Pushwoosh App Code, bevor Sie die Integration konfigurieren.
• Diese Integration ist nur für Amplitude-Kunden mit kostenpflichtigen Plänen verfügbar.
• Sie müssen einen kostenpflichtigen Pushwoosh-Plan haben, um diese Integration zu nutzen.

Glossar (Zuordnung von Entitätsnamen, falls sie sich unterscheiden)

Cohorts in Amplitude = Segmente in Pushwoosh

Synchronisierte Entitäten

• Events
• Tags
• Segmente

Wie funktioniert die Integration?

Die Amplitude-Integration mit Pushwoosh funktioniert durch die Synchronisierung von Daten zwischen den beiden Plattformen, um das Nutzerengagement und die Segmentierung zu verbessern. Hier ist eine detaillierte Aufschlüsselung, wie es funktioniert:

Datenübertragung

• Events: Amplitude sendet Event-Daten an Pushwoosh. Jedes Event enthält eine Nutzer-ID (external_id), einen Anwendungscode (app_id), einen Zeitstempel (created_at) und zusätzliche Attribute (attributes).

• Tags: Pushwoosh empfängt Tags, die mit Nutzerprofilen verknüpft sind. Diese Tags werden mit einer Nutzer-ID (external_id), einem Anwendungscode (app_id) und Tag-Eigenschaften (properties) gesendet.

• Segmente: Segmente werden ähnlich importiert, wie Pushwoosh CSV-Importe handhabt. Nutzer werden über Anfragen zu Segmenten hinzugefügt oder daraus entfernt.

Datenfluss

• Events und Tags: Daten werden von Amplitude an Pushwoosh gesendet, basierend auf Nutzerinteraktionen oder Attributen, die in Amplitude verfolgt werden. Events und Tags werden in Pushwoosh gemäß der in Amplitude eingerichteten Konfiguration und Zuordnungen erstellt oder aktualisiert.

• Segmente: Segmente werden in Pushwoosh erstellt, wenn Amplitude eine Anfrage stellt. Pushwoosh generiert eine eindeutige Kennung für jedes Segment, die Amplitude verwendet, um das Segment durch Hinzufügen oder Entfernen von Nutzern zu manipulieren.

Anfragen

Anfragen werden an spezifische Endpunkte in Pushwoosh gesendet, um Events, Nutzerattribute und Segmentaktualisierungen zu verarbeiten. Jede Anfrage erfordert eine Authentifizierung und hat spezifische Header- und Payload-Formate.

Anwendungsfälle

Event-Tracking

Verfolgen Sie Nutzeraktionen und -interaktionen von Amplitude und senden Sie diese Events an Pushwoosh, um Benachrichtigungen oder Aktualisierungen auszulösen.

Nutzer-Tagging

Weisen Sie Nutzern Tags basierend auf ihrem Verhalten oder ihren Attributen in Amplitude zu. Diese Tags können in Pushwoosh für gezielte Nachrichten oder Segmentierung verwendet werden.

Segmentverwaltung

Erstellen und verwalten Sie Nutzersegmente in Pushwoosh basierend auf den in Amplitude konfigurierten Daten und Segmenten. Dies hilft dabei, bestimmte Nutzergruppen mit personalisierten Nachrichten anzusprechen.

Automatisierte Nutzerverwaltung

Fügen Sie Nutzer automatisch zu Segmenten hinzu oder entfernen Sie sie basierend auf ihren Aktionen oder Attributen in Amplitude, um eine aktuelle Segmentierung in Pushwoosh sicherzustellen.

Einrichten der Integration

Cohort-Sync

Pushwoosh-Einrichtung

1. Navigieren Sie in Pushwoosh zu Einstellungen > Integrationen.

2. Klicken Sie auf Integration hinzufügen, suchen und fügen Sie dann Amplitude hinzu.

   

3. Kopieren Sie den Pushwoosh API-Schlüssel und den App-Code in Ihre Zwischenablage.

Amplitude-Einrichtung

Um Amplitude für die Integration zu konfigurieren, folgen Sie diesen Schritten:

1. Gehen Sie in Ihren Amplitude Data zum Catalog und wählen Sie Destinations.
2. Suchen und klicken Sie im Abschnitt Cohort auf Pushwoosh.

3. Klicken Sie auf Add another destination.

4. Geben Sie einen Namen an und fügen Sie den API-Schlüssel ein, den Sie aus Pushwoosh kopiert haben.

5. Ordnen Sie das Amplitude User ID-Feld dem Pushwoosh User ID-Feld zu.
6. Speichern Sie Ihre Einstellungen, wenn Sie fertig sind.

Senden einer Kohorte

Um Ihre erste Kohorte zu synchronisieren, führen Sie die folgenden Schritte aus:

1. Öffnen Sie in Amplitude die Kohorte, die Sie synchronisieren möchten, und klicken Sie dann auf Sync.

2. Wählen Sie Pushwoosh und das Konto aus, mit dem Sie synchronisieren möchten. Klicken Sie dann auf Next.

3. Entscheiden Sie sich für die Synchronisierungsfrequenz und speichern Sie Ihre Konfigurationen.

Event-Streaming

Pushwoosh-Einrichtung

1. Holen Sie sich Ihren Pushwoosh API-Schlüssel

2. Finden Sie den App-Code in Ihrem Pushwoosh-Konto.

Amplitude-Einrichtung

1. Gehen Sie in Amplitude zu Data Destinations und finden Sie Pushwoosh - Event Stream.

2. Geben Sie einen Synchronisierungsnamen ein und klicken Sie dann auf Create Sync.

3. Ändern Sie den Status von Disabled auf Enabled und fügen Sie Ihr Pushwoosh API Access Token und den App Code ein.

4. Wählen Sie aus dem linken Dropdown-Menü die Amplitude-Nutzereigenschaft aus, die Ihrer Pushwoosh UserID entspricht.
5. (Optional) Aktivieren Sie den Schalter Create & Update users, wenn Sie Nutzer und ihre Eigenschaften in Echtzeit senden möchten, wann immer Amplitude eine Nutzereigenschaft erstellt oder aktualisiert.

6. Aktivieren Sie Send Events („Events werden an Pushwoosh gesendet“), wenn Sie Events an Pushwoosh streamen möchten. Dies leitet Events automatisch an Pushwoosh weiter, sobald sie in Amplitude erfasst werden. Events werden mit dieser Integration nicht nach einem Zeitplan oder auf Abruf gesendet.

8. Wählen Sie dann im Abschnitt Select and Filter Events aus, welche Events Sie senden möchten. Wählen Sie nur die Events aus, die Sie in Pushwoosh benötigen; transformierte Events werden nicht unterstützt.
9. Wenn Sie fertig sind, aktivieren Sie das Ziel und klicken Sie auf Save.

Wie erkennen Sie, dass die Integration funktioniert?

Um zu überprüfen, ob die Integration von Amplitude und Pushwoosh ordnungsgemäß funktioniert, können Sie die folgenden Methoden verwenden:

Pushwoosh-Dashboard überwachen

• Events und Tags: Überprüfen Sie das Pushwoosh-Dashboard, um zu sehen, ob die von Amplitude gesendeten Events und Tags wie erwartet erscheinen. Suchen Sie nach aktuellen Aktivitäten oder Aktualisierungen im Zusammenhang mit Ihren Events und Tags.
• Segmente: Überprüfen Sie, ob Segmente basierend auf den Daten von Amplitude erstellt, aktualisiert oder geändert werden. Stellen Sie sicher, dass die Nutzerzahlen und Segmentmitgliedschaften die erwarteten Änderungen widerspiegeln.

API-Antworten überprüfen

• Erfolgreiche Antworten: Stellen Sie sicher, dass Sie 200 OK-Antworten von den Pushwoosh-API-Endpunkten erhalten. Obwohl es nicht immer einen Antwortkörper geben muss, zeigt der 200 OK-Status an, dass die Anfrage erfolgreich empfangen wurde.
• Fehlerantworten: Überprüfen Sie alle Fehlerantworten oder Statuscodes außer 200 OK auf Hinweise, falls etwas nicht funktioniert. Häufige Fehler können 400 Bad Request, 401 Unauthorized oder 500 Internal Server Error sein.

Anfragen und Antworten protokollieren

• Anforderungsprotokolle: Führen Sie Protokolle über ausgehende Anfragen von Amplitude und eingehende Antworten von Pushwoosh. Überprüfen Sie diese Protokolle, um sicherzustellen, dass die Anfragen korrekt formatiert sind und die Antworten den Erwartungen entsprechen.
• Fehlerprotokollierung: Implementieren Sie eine Fehlerprotokollierung, um Probleme während der Datenübertragung oder Integrationsprozesse zu erfassen.

Mit Beispieldaten testen

• Test-Events/Tags senden: Erstellen und senden Sie Test-Events und -Tags von Amplitude an Pushwoosh. Überprüfen Sie, ob diese Testeinträge in Pushwoosh korrekt erscheinen und das erwartete Verhalten auslösen.
• Nutzeraktionen simulieren: Führen Sie Aktionen in Amplitude durch, die spezifische Events oder Aktualisierungen in Pushwoosh auslösen sollten. Überprüfen Sie, ob diese Aktionen zu den erwarteten Änderungen in Pushwoosh führen.

Überwachungstools verwenden

• Integrationsüberwachung: Nutzen Sie Überwachungstools oder -dienste, die den Zustand und die Leistung der Integration verfolgen können. Diese Tools können Sie in Echtzeit auf Probleme oder Ausfälle aufmerksam machen.
• Analyse und Berichterstattung: Nutzen Sie Analysefunktionen in Amplitude und Pushwoosh, um den Datenfluss und die Integrationsleistung zu überprüfen.

Integrationsdokumentation überprüfen

• Konfigurationsüberprüfung: Überprüfen Sie die Integrationskonfiguration sowohl in Amplitude als auch in Pushwoosh, um sicherzustellen, dass alle Einstellungen und Zuordnungen korrekt angewendet wurden.
• Dokumentationsaktualisierungen: Bleiben Sie über Änderungen oder Aktualisierungen in der Integrationsdokumentation auf dem Laufenden, die die Funktionalität beeinträchtigen könnten.

Support kontaktieren

Wenn Sie auf anhaltende Probleme oder Inkonsistenzen stoßen, wenden Sie sich an die Support-Teams von Amplitude oder Pushwoosh. Geben Sie ihnen Details zur Integrationseinrichtung und alle Fehlerprotokolle für eine schnellere Lösung.

Fehlerbehebung

Integrationsprobleme

• Event erscheint nicht in Pushwoosh: Stellen Sie sicher, dass das Event korrekt zugeordnet ist, und überprüfen Sie, ob der Pushwoosh-Anwendungscode und das API-Token ordnungsgemäß konfiguriert sind.

• Tags werden nicht synchronisiert: Bestätigen Sie, dass die Tags korrekt formatiert sind und dass alle erforderlichen Authentifizierungsdetails in der Anfrage enthalten sind.

Segmentprobleme

• Segment nicht erstellt: Überprüfen Sie, ob die Anfrage zur Erstellung des Segments korrekt formatiert ist und das Pushwoosh-API-Token gültig ist.

• Nutzer nicht hinzugefügt/entfernt: Überprüfen Sie, ob die Nutzer-IDs korrekt angegeben sind und die Segment-ID gültig ist. Stellen Sie sicher, dass die Anfrage-Payload ordnungsgemäß formatiert ist.

Antwortprobleme

• Kein Antwortkörper: Wenn Sie eine 200 OK-Antwort, aber keinen Antwortkörper erhalten, überprüfen Sie, ob die Anfrage ordnungsgemäß formatiert war und die Daten korrekt gesendet wurden.

FAQ

Was soll ich tun, wenn ich einen 400 Bad Request-Fehler erhalte?

Überprüfen Sie die Anfrage-Payload auf Formatierungsfehler oder fehlende Felder. Stellen Sie sicher, dass alle erforderlichen Felder enthalten und korrekt formatiert sind.

Wie kann ich überprüfen, ob die Integration funktioniert?

Überprüfen Sie das Pushwoosh-Dashboard auf eingehende Events, Tags und Segment-Aktualisierungen. Sie können auch Protokolle oder Antworten von API-Endpunkten auf erfolgreiche Datenübertragungen überwachen.

Kann ich die an Pushwoosh gesendeten Events oder Tags anpassen?

Ja, Sie können Events und Tags in der Amplitude-Konfiguration anpassen. Stellen Sie sicher, dass die Daten dem erwarteten Pushwoosh-Format entsprechen.

Wie oft werden die Daten zwischen Amplitude und Pushwoosh synchronisiert?

Die Daten werden in Echtzeit oder nahezu in Echtzeit synchronisiert, basierend auf Anfragen von Amplitude. Stellen Sie sicher, dass Ihre Konfiguration die gewünschte Aktualisierungsfrequenz unterstützt.

Wo finde ich weitere Informationen oder Unterstützung für diese Integration?

Beziehen Sie sich auf die offizielle Dokumentation von Amplitude und Pushwoosh. Für weitere Unterstützung wenden Sie sich an die jeweiligen Support-Teams.