Zum Inhalt springen

RudderStack-Integration

RudderStack ist eine Customer Data Platform, die Events aus Ihren Apps, Websites, Servern und Data Warehouses sammelt und an andere Tools weiterleitet. Mit der Pushwoosh-Destination in RudderStack gelangen die Daten, die Sie dort bereits sammeln, ohne zusätzlichen Code in Ihrer App zu Pushwoosh:

  • Track-Events werden zu Pushwoosh-Events. Nutzen Sie sie, um Segmente zu erstellen und Customer Journeys zu starten oder zu verzweigen.
  • Identify-Traits werden zu benutzerspezifischen Tags. Nutzen Sie sie, um Push-Benachrichtigungen, In-App-Nachrichten und E-Mails gezielt auszuspielen und zu personalisieren.

Bevor Sie beginnen

Anchor link to

Die Destination ordnet alle Daten über die User ID zu. Prüfen Sie daher zuerst diese Voraussetzungen:

  • Das Pushwoosh SDK ist in Ihre App integriert.
  • Ihre App ruft setUserId mit demselben Wert auf, den RudderStack als userId sendet. Pushwoosh ordnet eingehende Events und Traits den Benutzern über diesen Wert zu.
  • Das Gerät jedes Benutzers ist mit dieser User ID registriert, bevor RudderStack identify-Aufrufe für den Benutzer sendet. Traits für eine User ID, die Pushwoosh noch nicht kennt, werden verworfen.
  • Sie haben in Pushwoosh Zugriff auf Settings → API Access, um ein API-Token zu erstellen.
  • Sie haben einen RudderStack-Workspace mit mindestens einer Quelle, die track- oder identify-Aufrufe sendet.

Die Pushwoosh-Destination in RudderStack einrichten

Anchor link to

Die Einrichtung besteht aus zwei Teilen: Sie holen sich zwei Werte in Pushwoosh und erstellen dann die Destination in RudderStack.

Application Code und Device API Token abrufen

Anchor link to

RudderStack benötigt zwei Werte, um Daten an Ihre Anwendung zu senden: ihren Application Code und ein Device API Token.

  1. Öffnen Sie in Pushwoosh die Anwendung, an die Sie Daten senden möchten.
  2. Kopieren Sie den Application Code. Er wird unter dem Anwendungsnamen in der oberen linken Ecke angezeigt und sieht so aus: XXXXX-XXXXX.
  3. Gehen Sie zu Settings → API Access und klicken Sie auf Generate New Token.
  4. Wählen Sie unter Token type die Option device.
  5. Geben Sie unter Name einen Namen für das Token ein, zum Beispiel RudderStack.
  6. Klicken Sie auf Generate.
  7. Klicken Sie in der Token-Liste auf das Drei-Punkte-Menü neben dem neuen Token und wählen Sie Edit token….
  8. Wählen Sie unter Applications die Anwendung aus Schritt 1 aus und klicken Sie auf Save.
  9. Kopieren Sie den Token-Wert aus der Token-Liste.

Ein Device API Token reicht für die Destination aus. Sie benötigen kein Server API Token.

Die Destination in RudderStack hinzufügen

Anchor link to

Die Pushwoosh-Destination verbindet Ihre RudderStack-Quellen mit Ihrer Pushwoosh-Anwendung.

  1. Gehen Sie im RudderStack-Dashboard zu Collect → Destinations.
  2. Klicken Sie auf New destination.
  3. Wählen Sie Pushwoosh aus der Liste aus.
  4. Geben Sie einen Namen für die Destination ein und klicken Sie auf Continue.
  5. Wählen Sie die Quellen aus, deren Daten Sie an Pushwoosh senden möchten.
  6. Fügen Sie unter Application Code den Application Code ein.
  7. Fügen Sie unter API Token das Device API Token ein.
  8. Schließen Sie die Einrichtung ab, um die Destination zu speichern.

RudderStack sendet die Daten von seinen eigenen Servern an Pushwoosh (Cloud Mode), für jeden Quelltyp, den die Destination unterstützt.

Informationen zur Einrichtung auf RudderStack-Seite finden Sie in der Anleitung zur Pushwoosh-Destination in der RudderStack-Dokumentation.

Welche Daten RudderStack an Pushwoosh sendet

Anchor link to

Die Destination unterstützt zwei Aufruftypen: track und identify. Jeden anderen Aufruftyp, etwa page, screen, group oder alias, lehnt RudderStack für diese Destination ab.

Jeder Aufruf muss eine userId haben. RudderStack sendet keine Aufrufe ohne sie, da Pushwoosh einen anonymen Aufruf keinem Benutzer zuordnen kann.

Track-Aufrufe werden zu Pushwoosh-Events

Anchor link to

Jeder track-Aufruf wird zu einem Pushwoosh-Event mit demselben Namen wie das RudderStack-Event:

RudderStack-FeldPushwoosh
eventEvent-Name
propertiesEvent-Attribute
userIdUser ID
timestamp (oder originalTimestamp)Zeitpunkt des Events
context.device.idDevice ID, falls vorhanden
context.device.type oder context.os.namePlattform: android; ios für iOS, iPadOS, watchOS und tvOS; web für jeden anderen Wert oder wenn kein Wert vorhanden ist

Wenn das Event oder ein Attribut in der Anwendung noch nicht existiert, erstellt Pushwoosh es automatisch.

In diesen Fällen verwirft Pushwoosh das gesamte Event. Es wird kein Fehler zurückgegeben, daher meldet RudderStack das Event als zugestellt:

  • Der Aufruf hat mehr als 100 Properties.
  • Ein Property-Wert ist länger als 10 KB.
  • Der Event-Name ist länger als 255 Zeichen.
  • Das Event ist neu, und sein Name ist länger als 128 Zeichen oder enthält Steuerzeichen.

Ein Event behält bis zu 100 Attribute. Sobald ein Event 100 bekannte Attribute hat, zeichnet Pushwoosh neue Aufrufe weiterhin auf, aber neue Property-Namen werden nicht als Attribute hinzugefügt.

Verschachtelte Objekte in properties kommen als JSON-Strings an, und Properties mit dem Wert null werden verworfen.

Identify-Aufrufe werden zu benutzerspezifischen Tags

Anchor link to

Jeder identify-Aufruf setzt seine Traits als Tags für den Benutzer mit der angegebenen userId. Die Traits stammen aus traits oder aus context.traits, wenn traits leer ist.

  • Es werden nur benutzerspezifische Tags geschrieben. Wenn die automatische Tag-Erstellung für Ihr Konto aktiviert ist, erstellt ein Trait mit einem neuen Namen ein benutzerspezifisches Tag. Wenn bereits ein General-Tag mit demselben Namen existiert, überspringt Pushwoosh dieses Trait ohne Fehler.
  • Ein Wert muss zum Tag-Typ passen. Wenn ein Tag bereits existiert und der Trait-Wert nicht zu seinem Typ passt, etwa Text für ein Integer-Tag, überspringt Pushwoosh dieses Trait ohne Fehler.
  • Der Benutzer muss in Pushwoosh bereits existieren. Tags werden nur angewendet, wenn das Pushwoosh SDK ein Gerät registriert hat, bei dem setUserId auf dieselbe userId gesetzt ist. Traits für einen unbekannten Benutzer werden ohne Fehler verworfen.
  • Identitäts- und Kontakt-Traits werden nicht in Tags kopiert. email, phone, firstName, lastName, name, address, id, userId und anonymousId werden nie als Tags gesendet. Ein identify-Aufruf, der nur diese Traits enthält, schlägt mit No traits left to send as Pushwoosh tags fehl.
  • Ein leerer Wert löscht das Tag. Ein Trait mit einem leeren String oder einer leeren Liste löscht den aktuellen Wert dieses Tags beim Benutzer.
  • Verschachtelte Objekte kommen als JSON-Strings an. Traits mit dem Wert null werden verworfen.

Was die Destination nicht tut

Anchor link to

Die Destination sendet nur track- und identify-Daten. Diese Aufgaben liegen außerhalb ihres Umfangs:

  • Sie registriert keine Geräte oder E-Mail-Adressen. Geräte kommen aus dem Pushwoosh SDK.
  • Sie löscht keine Benutzer. Anfragen zur Benutzerlöschung aus RudderStack werden für diese Destination nicht unterstützt.

Prüfen, ob die Integration funktioniert

Anchor link to

Nachdem die Destination gespeichert ist, senden Sie einen track- und einen identify-Testaufruf aus einer Quelle mit einer userId, die in Pushwoosh bereits ein Gerät hat.

  • Events: Gehen Sie in Pushwoosh zu Audience → Events, öffnen Sie das Event und prüfen Sie, ob es gezählt wurde.
  • Tags: Gehen Sie zu Audience → User Explorer, suchen Sie den Benutzer über die User ID und prüfen Sie die Tag-Werte.

Zustellungsfehler für jeden Aufruf werden in der RudderStack-Ansicht Live Events der Destination angezeigt.

Fehlerbehebung

Anchor link to

Suchen Sie die Fehlermeldung, die RudderStack für die Destination in Live Events anzeigt, um Ursache und Lösung zu finden.

Track-Aufrufe schlagen mit unauthorized fehl

Anchor link to

Das API-Token passt nicht zum Application Code. Prüfen Sie, ob das Token zum selben Pushwoosh-Konto gehört wie die Anwendung.

identify-Aufrufe prüfen das Token nicht, daher sind sie auch mit einem falschen Token weiterhin erfolgreich. Verwenden Sie einen track-Aufruf, um das Token zu testen.

Aufrufe schlagen mit application not found oder application code is not valid fehl

Anchor link to

Der Application Code ist falsch, oder das Konto wird nicht auf app.pushwoosh.com gehostet. track-Aufrufe schlagen mit application not found fehl, identify-Aufrufe mit application code is not valid. Prüfen Sie den Code im Pushwoosh Control Panel. Wenn der Code richtig ist, wenden Sie sich an Ihren Customer Success Manager oder den Support.

Aufrufe schlagen mit Missing required value from userId fehl

Anchor link to

Der Aufruf hat keine userId. Anonyme Aufrufe werden nicht an Pushwoosh gesendet. Rufen Sie identify in Ihrer RudderStack-Quelle auf, nachdem sich der Benutzer angemeldet hat, damit spätere Aufrufe die userId enthalten.

Aufrufe schlagen mit Invalid enum value fehl

Anchor link to

Der Aufruftyp ist weder track noch identify. Pushwoosh akzeptiert nur diese beiden Typen. Verbinden Sie entweder keine Quellen, die nur page-, screen-, group- oder alias-Aufrufe senden, oder ignorieren Sie diese Fehler.

Identify-Aufrufe schlagen mit No traits left to send as Pushwoosh tags fehl

Anchor link to

Alle Traits im Aufruf sind Identitäts- oder Kontakt-Traits wie email oder phone, die nie in Tags kopiert werden. Fügen Sie mindestens ein anderes Trait hinzu oder überspringen Sie den Aufruf.

Identify-Aufrufe sind erfolgreich, aber keine Tags erscheinen

Anchor link to

Prüfen Sie Folgendes der Reihe nach:

  1. Ein Gerät mit dieser User ID ist in Pushwoosh registriert. Suchen Sie den Benutzer unter Audience → User Explorer.
  2. Die App ruft setUserId mit genau demselben Wert auf, den RudderStack als userId sendet.
  3. Das Tag mit diesem Namen ist User-specific. Ein Trait für ein bestehendes General-Tag wird übersprungen. Ändern Sie den Tag-Bereich oder benennen Sie das Trait um.
  4. Der Trait-Wert passt zum Typ des bestehenden Tags.
  5. Das Trait gehört nicht zu den Identitäts- oder Kontakt-Traits, die nie kopiert werden, wie email oder phone.