Integration für Event-Streaming

Hilfe von Entwicklern benötigt

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

Integrationsübersicht

Integrationstyp

Quelle: Daten werden von Pushwoosh basierend auf konfigurierten Ereignis-Triggern über HTTP oder gRPC an Ihr System gesendet.

Wie funktioniert die Integration?

Pushwoosh übermittelt Kommunikationsereignisdaten (z. B. Push-/E-Mail-Aktivitäten) an einen vom Kunden definierten Endpunkt. Die Daten werden in Batch-Streams zu geplanten Intervallen oder beim Erreichen einer minimalen Batch-Größe gesendet.

Daten werden nur gesendet, wenn sie mit den ausgewählten Ereignissen, Plattformen und optionalen Filtern (Kampagnen-/Nachrichtencodes, Live-Aktivität) übereinstimmen. Der Client-Endpunkt muss bereit sein, die Daten zu empfangen und optional mit einem Status zu antworten.

Glossar

Endpunkt-URL: Serverseitiger Endpunkt, der den Empfang von Anfragen ermöglicht. Der Client kann bei Bedarf einen Port angeben.

Beispiele:

• https://clientdomainname.com/webhook_endpoint
• https://clientdomainname.com:8081/webhook_endpoint

Liste der synchronisierten Entitäten

• Ereignisse der Kommunikationsstatistik (z. B. Push gesendet, E-Mail zugestellt)

Anwendungsfälle

• Echtzeit-Engagement-Tracking

  Überwachen Sie Benutzerinteraktionen wie gesendete Push-Nachrichten, geöffnete E-Mails oder zugestellte Nachrichten in Echtzeit, um sofortige Einblicke in die Kampagnenleistung zu erhalten.

• Integration externer Analysen

  Streamen Sie Ereignisse an Analyseplattformen von Drittanbietern für zentralisierte Berichterstattung und Analyse.

• Automatisierte Benutzer-Workflows

  Lösen Sie Aktionen in externen Systemen (wie CRMs oder Marketing-Automatisierungstools) basierend auf dem Benutzerverhalten aus, z. B. das Senden einer Follow-up-Nachricht, wenn ein Benutzer eine E-Mail öffnet.

Einrichten der Integration

Um die Integration einzurichten:

1. Gehen Sie in Ihrem Pushwoosh-Konto zu Settings > 3rd party Integrations, finden Sie Event streaming integration und klicken Sie auf Configure.

2. Füllen Sie in dem sich öffnenden Fenster die erforderlichen Felder aus.

Endpunkt-URL eingeben

Geben Sie im Feld Endpoint URL die vollständige URL ein, an die Ereignisse gesendet werden sollen, einschließlich des Protokolls und des Ports, falls zutreffend.

Beispiel

• https://clientdomainname.com/webhook_endpoint
• https://clientdomainname.com:8081/webhook\_endpoint

Ereignisse auswählen

Wählen Sie aus dem Dropdown-Menü Events mindestens ein Ereignis aus. Wenn keines ausgewählt ist, schlägt die Validierung fehl. Die Liste der Ereignisse wird vom Backend verwaltet und kann sich im Laufe der Zeit ändern.

Autorisierungsdaten bereitstellen

Wenn Ihr Server dies erfordert, geben Sie den vollständigen Wert für den Authorization-Header in das Feld Authorization ein.

Beispiele:

• Bearer your_token_here
• Basic base64encoded_credentials

Hinweis

Der Wert wird unverändert in den Authorization-Header (HTTP) oder die gRPC-Metadaten eingefügt. Stellen Sie sicher, dass zwischen dem Authentifizierungsschema und dem Token ein Leerzeichen steht.

Transporttyp auswählen

Wählen Sie aus dem Dropdown-Menü Transport type das Übertragungsprotokoll für die Ereignisübertragung: HTTP oder gRPC. Jedes hat ein spezifisches Verhalten und eine spezifische Konfiguration.

HTTP

Mit dem HTTP-Transporttyp sendet Pushwoosh Daten in Batches basierend auf einer der folgenden Bedingungen:

• Mindestens 100 Ereignisse sind zum Senden bereit, oder
• Eine Stunde ist seit der letzten Übertragung vergangen.

Nach dem Senden der Daten wird die Verbindung geschlossen, sobald eine erfolgreiche Antwort empfangen wird.

Wenn der Server mit einem 5xx-Fehler antwortet, wird Pushwoosh die Anfrage gemäß der definierten Wiederholungsrichtlinie erneut versuchen.

Wiederholungsmechanismus

Versuch	Verzögerung
1.	1 Sekunde
2.	3 Sekunden nach dem 1. Versuch
3.	8 Sekunden nach dem 2. Versuch

Wenn alle Wiederholungsversuche fehlschlagen, wird die Anfrage verworfen.

Zeitüberschreitung

Die standardmäßige Zeitüberschreitung für eine Anfrage beträgt 30 Sekunden. Dies kann auf Anfrage über den Support angepasst werden.

Beispiel ansehen

gRPC

Der gRPC-Transporttyp verwendet bidirektionales Streaming für die Datenübertragung. Erfahren Sie mehr in der gRPC-Dokumentation.

Ein Stream wird geöffnet, wenn eine der folgenden Bedingungen erfüllt ist:

• Mindestens 1.000 Ereignisse sind zur Zustellung bereit
• Eine Stunde ist seit dem letzten Öffnen eines Streams vergangen

Der Stream wird geschlossen, nachdem die Ereignisse gesendet wurden. Dies stellt sicher, dass nicht für jedes einzelne Ereignis in kurzer Zeit ein neuer Stream geöffnet wird.

Protobuf-Spezifikation ansehen

Wiederholungsmechanismus
Jedes Ereignis enthält eine eindeutige uuid. Wenn ein Ereignis fehlschlägt:

1. Die Antwort muss einen status enthalten, der nicht gleich "Success" ist
2. Die ursprüngliche uuid aus der Anfrage muss enthalten sein

Pushwoosh wird die Zustellung basierend auf dieser Antwort erneut versuchen.

Verbindungseinstellungen

Erweiterte Optionen wie TLS, Keep-Alive oder Wiederholungsrichtlinien werden manuell über den Support konfiguriert und erfordern möglicherweise die Beteiligung von Entwicklern.

Plattformen auswählen

Wählen Sie im Abschnitt Platforms mindestens eine Plattform aus, um das Event-Streaming zu aktivieren.

Unterstützte Plattformen umfassen:

• iOS, Android, macOS, Windows, Amazon, Safari
• Chrome, Firefox, Internet Explorer, Baidu, Huawei
• Email, SMS, Line, Xiaomi, WhatsApp

Erweiterte Filter konfigurieren

Verfeinern Sie im Abschnitt Advanced filters die Kriterien für die Ereigniszustellung mithilfe von Filtern:

• Live activity events: Aktivieren Sie diese Option, um Live-Aktivitätsereignisse zu erhalten. Diese Ereignisse enthalten nur Metadaten, einschließlich live_activity_id.
• Campaign filters: Filtern Sie nach Kampagnencode. Nur Ereignisse, die mit diesen Kampagnen verknüpft sind, werden zugestellt.
• Message filters: Filtern Sie nach Nachrichtencode. Nur Ereignisse, die mit diesen Nachrichten verknüpft sind, werden zugestellt.

Nachdem Sie alle erforderlichen Felder ausgefüllt haben, klicken Sie auf die Schaltfläche Apply, um Ihre Integration zu speichern und zu aktivieren.

Hinweis

Konfigurationsänderungen werden innerhalb von 15 Minuten nach der Übermittlung wirksam.

Tipp

Für erweiterte Einstellungen wie benutzerdefinierte Zeitüberschreitungen oder gRPC-Konfigurationen kontaktieren Sie bitte den Support.

Anfragedetails und Beispiel

Endpunkt	https://exampleclientendpoint.com/webhook_endpoint
HTTP-Anfrage	POST
Authentifizierung	Nein
Anfragetyp	Quelle
Bedeutung der Anfrage	Anfragen an den Webhook-Endpunkt senden
Header	Content-Type: application/json

Beispiel für den Anfragekörper

{
  "event_name": "Email Opened",
  "message_code": "E682-E6D92B9A-53E24868",
  "campaign_id": 961048,
  "platform": "Email",
  "payload": "Welcome to Headway! 👋",
  "application_code": "32E5A-9B411",
  "hwid": "irun4716@gmail.com",
  "user_id": "1894410",
  "timestamp": 1723799271,
  "journey_title": "",
  "journey_point_title": "5_Welcome_ID_new"
}

Antwort
Im Moment werden der Antwortcode und der Körper ignoriert.

Woher wissen Sie, dass die Integration funktioniert?

Sie werden an Ihrem konfigurierten Endpunkt Anfragen von Pushwoosh erhalten.