Standard-Events

Hinweis

Verfügbar ab SDK 5.2.2

Was sind Standard-Events?

Standard-Events sind grundlegende Interaktionen, die Benutzer in Apps oder auf Websites durchführen, unabhängig von deren Branche oder Funktionalität. Diese wichtigen Benutzeraktionen bilden den Kern der Kundenkommunikation und können für jedes Produkt und jeden Kunden in jeder Phase des Kundenlebenszyklus genutzt werden.

Standard-Events sind für aktuelle SDK-Versionen standardmäßig verfügbar. Sie erfordern keine zusätzlichen Einstellungen, mit Ausnahme von PW_InAppPurchase (siehe Details unten).

Um die in Pushwoosh verfügbaren Standard-Events zu finden und zu aktivieren, folgen Sie diesen Schritten:

1. Navigieren Sie zum Tab Events im Bereich Audience.
2. Klicken Sie auf Create Event.
3. Wählen Sie Default Event aus dem Dropdown-Menü.
4. Wählen Sie im Pop-up-Fenster das gewünschte Event aus und klicken Sie auf Activate.

Nach der Aktivierung können Standard-Events für verhaltensbasiertes Messaging verwendet werden. Verwenden Sie sie beispielsweise als Trigger-basierten Einstieg in einer Customer Journey oder als Auslöser für In-App-Nachrichten.

Tipp

Um zu sehen, wie Sie Standard-Events verwenden können, um eine Marketingkampagne in Pushwoosh zu erstellen und kostenlose Benutzer automatisch in zahlende Kunden umzuwandeln, sehen Sie sich dieses Tutorial an:

Youtube-Video: Wie Sie Standard-Events verwenden können, um eine Marketingkampagne in Pushwoosh zu erstellen und kostenlose Benutzer automatisch in zahlende Kunden umzuwandeln

PW_DeviceRegistered

Dieses Event wird nur einmal für jedes Gerät ausgelöst, beim ersten Start der App und der Initialisierung des SDK. Wie der Name schon sagt, verfolgt dieses Event die Geräteregistrierung in Ihrer App.

Anwendungsfälle

• Starten Sie eine Onboarding-Kampagne für neu registrierte Benutzer – fügen Sie den Trigger-basierten Einstieg mit dem PW_DeviceRegistered-Event zu einer Onboarding-Customer Journey hinzu.
• Identifizieren Sie Akquise-Aktivitäten, die Ihnen mehr Neukunden bringen, mithilfe der Event-Statistiken.
• Binden Sie Benutzer direkt bei ihrem ersten Besuch ein: Begrüßen Sie sie mit In-Apps, die durch das DeviceRegistered-Event ausgelöst werden.

PW_DeviceUnregistered

Dieses Event wird ausgelöst, wenn die App deinstalliert wird oder ein Benutzer sich von E-Mails oder Push-Benachrichtigungen abmeldet.

Event-Attribute

• message_id (string)
• message_code (string)
• campaign_id (string)

Anwendungsfälle

• Halten Sie Benutzer, wenn sie sich entscheiden, Ihre App nicht mehr zu verwenden. Sie können beispielsweise eine E-Mail mit einem Sonderangebot an jeden Benutzer senden, der die App deinstalliert hat.
• Pflegen Sie die Kommunikation mit Benutzern, die sich von einem Ihrer Kanäle abgemeldet haben. Wenn ein Benutzer beispielsweise keine Push-Benachrichtigungen mehr erhalten möchte, können Sie eine E-Mail senden oder eine In-App anzeigen, um ihn zu ermutigen, die App häufiger zu nutzen.

PW_ApplicationOpen

Nur für mobile Apps

Das ApplicationOpen-Event wird jedes Mal ausgelöst, wenn ein Benutzer Ihre mobile App auf seinem Gerät startet.

Event-Attribute

• device_type (Ganzzahl-Gerätetyp-Code, siehe registerDevice für Details)
• application_version

Anwendungsfälle

• Sammeln Sie Statistiken zur Benutzerbindung basierend auf den ApplicationOpen-Event-Statistiken.
• Führen Sie In-App-Messaging-Kampagnen für Benutzer durch, die in der App aktiv sind.

PW_ScreenOpen

Nur für mobile Apps

Dieses Event wird jedes Mal ausgelöst, wenn ein Benutzer einen bestimmten Bildschirm in Ihrer mobilen App anzeigt.

Event-Attribute

• application_version
• device_type (Ganzzahl-Gerätetyp-Code, siehe registerDevice für Details)
• screen_name (technischer Bildschirmname, der aus Ihrer App bezogen wird)

Anwendungsfälle

• Senden Sie perfekt relevante Nachrichten an Benutzer, die ihr Interesse an bestimmten App-Bereichen gezeigt haben, indem Sie Customer Journeys mit dem PW_ScreenOpen-Event starten.
• Bewerten und verbessern Sie die Wirksamkeit Ihrer Werbeaktionen: Führen Sie einen A/B/n-Test mit zwei oder mehreren Versionen Ihres Angebots durch, warten Sie, bis das ScreenOpen-Event stattfindet, und sehen Sie dann, welcher Inhalt am besten abgeschnitten hat.
• Finden Sie heraus, welche App-Bildschirme am häufigsten besucht werden: Filtern Sie die Event-Statistiken nach dem Bildschirmnamen.

PW_ApplicationMinimized

Nur für mobile Apps

Dieses Event wird ausgelöst, wenn ein Benutzer die App auf seinem Gerät minimiert (aber nicht zwangsweise beendet).

Event-Attribute

• device_type (Ganzzahl-Gerätetyp-Code, siehe registerDevice für Details)
• application_version

Anwendungsfälle

• Verfolgen Sie die durchschnittliche Sitzungszeit zwischen den Events ApplicationOpen und ApplicationMinimized.
• Senden Sie Push-Benachrichtigungen, während die App im Hintergrund läuft, um die Aufmerksamkeit der Benutzer zu erregen und sie zur App zurückzubringen.

PW_UserIdle

Nur für mobile Apps

Hilfe vom Entwicklerteam erforderlich

Um PW_UserIdle-Events zu erhalten, benötigen Sie die Hilfe Ihres Entwicklerteams. Teilen Sie die untenstehenden SDK-Setup-Hinweise mit ihnen.

Dieses Event wird ausgelöst, wenn ein Benutzer sich in Ihrer App befindet, aber für einen konfigurierbaren Zeitraum nicht mit dem Bildschirm interagiert hat. Im Gegensatz zu PW_ApplicationMinimized, das ausgelöst wird, nachdem der Benutzer die App verlassen hat, wird PW_UserIdle ausgelöst, während der Benutzer noch in der App ist – und erfasst den Moment, in dem die Aufmerksamkeit nachlässt, der Benutzer zögert oder abgelenkt wird. Verwenden Sie es als serverseitiges Signal, um eine rechtzeitige In-App anzuzeigen, Unterstützung anzubieten oder den Benutzer zum nächsten Schritt zu bewegen.

Die Leerlauferkennung ist standardmäßig auf beiden Plattformen deaktiviert. Wenn der Timeout-Schlüssel fehlt oder auf 0 gesetzt ist, werden keine PW_UserIdle-Events gesendet. Um sie zu aktivieren, stellen Sie den Timeout (mindestens 30 Sekunden) in der Plattformkonfiguration Ihrer App ein:

• Für iOS:
  • Fügen Sie den Schlüssel Pushwoosh_IDLE_TIMEOUT_SECONDS (Zahl, mindestens 30) zur Info.plist Ihrer App hinzu.
• Für Android:
  • Fügen Sie die Metadaten com.pushwoosh.idle_timeout_seconds (Ganzzahl, mindestens 30) zu Ihrer AndroidManifest.xml hinzu.

Event-Attribute

• screen_name (string) – der Bildschirm, auf dem der Benutzer inaktiv wurde. Formatiert als ActivityName/FragmentName auf Android und ParentVC/ChildVC auf iOS, wenn der aktuelle Bildschirm verschachtelt ist; andernfalls der Name der Aktivität oder des View Controllers.
• idle_seconds (integer) – der konfigurierte Leerlauf-Timeout, der abgelaufen ist.
• session_duration (integer) – Sekunden, seit die App das letzte Mal in den Vordergrund gebracht wurde.
• device_type (Ganzzahl-Gerätetyp-Code, siehe registerDevice für Details)
• application_version (string)

Verhalten

• Wird höchstens einmal pro Vordergrundsitzung ausgelöst. Das Zurückkehren in den Hintergrund und wieder in den Vordergrund startet eine neue Sitzung.
• Der Timer pausiert automatisch, während die Bildschirmtastatur geöffnet ist, während ein modaler Dialog oder eine Systemaufforderung auf dem Bildschirm angezeigt wird und während die App im Hintergrund ist.
• Physische Interaktion mit dem Bildschirm – Berührungen, Scrollen und Tippen – setzt den Timer zurück.

Anwendungsfälle

• Lösen Sie ein In-App-Angebot oder einen kontextbezogenen Assistenten aus, wenn Benutzer auf einem Bildschirm mit hoher Absicht – Warenkorb, Preisgestaltung, Kasse – verweilen, ohne eine Aktion auszuführen.
• Zeigen Sie einen Hinweis oder ein Tutorial an, wenn Benutzer bei einem Onboarding-Schritt ins Stocken geraten.
• Identifizieren Sie, wo Benutzer an Schwung verlieren, indem Sie die Statistiken der Leerlauf-Events nach screen_name filtern.

PW_ApplicationExit

Nur für mobile Apps

Hilfe vom Entwicklerteam erforderlich

Um PW_ApplicationExit-Events zu erhalten, benötigen Sie die Hilfe Ihres Entwicklerteams. Teilen Sie die untenstehenden SDK-Setup-Hinweise mit ihnen.

Dieses Event wird ausgelöst, wenn ein Benutzer die App in den Hintergrund schickt und nicht innerhalb eines konfigurierbaren Timeouts zurückkehrt. Im Gegensatz zu PW_ApplicationMinimized, das sofort ausgelöst wird, wenn der Benutzer die App verlässt, wird PW_ApplicationExit erst nach Ablauf der konfigurierten Verzögerung ausgelöst – was bestätigt, dass der Benutzer die Sitzung wirklich verlassen hat, anstatt nur kurz die App zu wechseln. Verwenden Sie es, um Benutzer, die eine Sitzung mitten im Prozess abgebrochen haben, erneut anzusprechen oder um Folgekampagnen nach einem bestätigten Verlassen auszulösen.

Die Erkennung der Verlassensabsicht ist standardmäßig deaktiviert. Um sie zu aktivieren, stellen Sie den Timeout (10–30 Sekunden, Werte außerhalb dieses Bereichs werden automatisch angepasst) in der Plattformkonfiguration Ihrer App ein:

• Für Android:
  • Fügen Sie die Metadaten com.pushwoosh.exit_intent_timeout_seconds (Ganzzahl, 10–30) zu Ihrer AndroidManifest.xml hinzu.
• Für iOS:
  • Fügen Sie den Schlüssel Pushwoosh_APPLICATION_EXIT_TIMEOUT_SECONDS (Zahl, 10–30) zur Info.plist Ihrer App hinzu.

Event-Attribute

• screen_name (string) – der letzte aktive Bildschirm, als der Benutzer die App in den Hintergrund geschickt hat.
• session_duration (integer) – Sekunden, seit die App das letzte Mal in den Vordergrund gebracht wurde.
• exit_intent_seconds (integer) – der effektive Timeout, der abgelaufen ist, bevor das Event ausgelöst wurde (10–30 s).
• device_type (Ganzzahl-Gerätetyp-Code, siehe registerDevice für Details)
• application_version (string)

Verhalten

• Der Timer startet, wenn die App in den Hintergrund geschickt wird, und wird abgebrochen, wenn der Benutzer vor Ablauf des Timeouts zurückkehrt.
• Der Bildschirmname und die Sitzungsdauer werden im Moment des In-den-Hintergrund-Schickens erfasst, nicht wenn das Event ausgelöst wird.
• Das Event wird nicht ausgelöst, wenn die Erkennung der Verlassensabsicht deaktiviert ist (Timeout-Schlüssel ist 0 oder nicht gesetzt).

Anwendungsfälle

• Sprechen Sie Benutzer erneut an, die einen Kauf- oder Anmeldevorgang abgebrochen haben – lösen Sie eine Push-Benachrichtigung oder E-Mail mit einer Erinnerung oder einem Rabatt aus.
• Starten Sie eine Win-Back-Customer-Journey für Benutzer, die die App verlassen, ohne eine wichtige Aktion abzuschließen (z. B. einen Warenkorb verlassen oder mitten im Onboarding aufhören).
• Identifizieren Sie Bildschirme mit hoher Abbruchrate, indem Sie die Event-Statistiken nach screen_name filtern.

PW_SiteOpened

Nur für Web-Plattformen

Das SiteOpened-Event wird jedes Mal ausgelöst, wenn ein Benutzer eine Ihrer Website-Seiten öffnet.

Event-Attribute

• device_type (Ganzzahl-Gerätetyp-Code, siehe registerDevice für Details)
• title – der Titel der besuchten Seite
• url – URL der besuchten Seite

Anwendungsfälle

• Analysieren Sie die Verteilung Ihres Website-Traffics und vergleichen Sie, wie oft Benutzer bestimmte Seiten Ihrer Website öffnen. Filtern Sie dazu die Event-Statistiken nach ihren Attributen.
• Reagieren Sie auf den Website-Besuch eines Benutzers mit einer relevanten Kommunikation: Erstellen Sie eine Journey, die mit dem SiteOpened-Event beginnt und für ein bestimmtes ‘title’- oder ‘url’-Attribut eingerichtet ist.

PW_InAppPurchase

Nur für mobile Apps

Hilfe vom Entwicklerteam erforderlich

Um das In-App-Kauf-Event einzurichten, benötigen Sie die Hilfe Ihres Entwicklerteams. Teilen Sie die Anleitung mit ihnen.

Das InAppPurchase-Event wird jedes Mal ausgelöst, wenn ein Benutzer einen In-App-Artikel in Ihrer App kauft. Beispiele hierfür sind kostenpflichtige Abonnements, Elemente der Spielmechanik, In-App-Währung usw.

Hinweis

Bitte beachten Sie, dass diese Artikel auf der App-Store-Seite Ihrer App angegeben sein müssen.

Um das In-App-Kauf-Event zu implementieren:

• Für iOS:
  • Aktivieren Sie das PW_InAppPurchase-Event in Ihrem Control Panel;
  • Setzen Sie den Parameter Pushwoosh_PURCHASE_TRACKING_ENABLED des Pushwoosh iOS SDK auf ‘yes’.
• Für Android:
  • Aktivieren Sie das PW_InAppPurchase-Event in Ihrem Control Panel;
  • Konfigurieren Sie das Senden von Kaufinformationen an Pushwoosh mithilfe dieser Anleitung.

Event-Attribute

• productIdentifier (aus dem App Store bezogen)
• quantity – die Anzahl der gekauften Artikel
• transactionDate – Kaufdatum
• status – Kaufstatus

Anwendungsfälle

• Sammeln Sie Statistiken über In-App-Käufe.
• Führen Sie Werbeaktionen durch und verfolgen Sie deren Erfolg: Setzen Sie das „Auf Trigger warten“-Event nach der Werbenachricht.

PW_NotificationOpen

Für mobile und Web-Plattformen

Dieses Event wird jedes Mal ausgelöst, wenn ein Benutzer eine mit Pushwoosh gesendete Push-Benachrichtigung öffnet.

Anwendungsfälle

• Konfigurieren Sie die optimale Zeit zum Senden einer Push-Benachrichtigung.
• Erstellen Sie Segmente basierend auf der Leistung von Benachrichtigungen innerhalb eines bestimmten Zeitraums.

PW_NotificationSend

Für mobile und Web-Plattformen

Dieses Event wird ausgelöst, sobald eine Pushwoosh-Nachricht an das Gerät eines Benutzers gesendet wird.

Event-Attribute

• message_id (string)
• message_code (string)
• campaign_id (string)

Anwendungsfälle

• Verfolgen Sie, ob eine Nachricht gesendet wird, unabhängig vom verwendeten Kanal.
• Erstellen Sie Benutzer-Segmente basierend auf der Anzahl der gesendeten Nachrichten.
• Sehen Sie alle an einen Benutzer gesendeten Nachrichten im Event-Verlauf an und analysieren Sie das weitere Verhalten des Benutzers.

PW_EmailLinkClicked

Nur für die E-Mail-Plattform

Dieses Event wird jedes Mal ausgelöst, wenn ein Benutzer auf einen Link in einer E-Mail klickt.

Event-Attribute

• message_id (string)
• message_code (string)
• campaign_id (string)
• redirect_link (string)
• original_link (string)

Anwendungsfälle

• Führen Sie gezielte Kampagnen für Benutzer durch, die auf einen bestimmten Link in einer E-Mail klicken.
• Senden Sie eine weitere Nachricht an Benutzer, die den Link in der ersten E-Mail ignoriert haben, um sie zu ermutigen, darauf zu klicken (oder eine andere Aktion durchzuführen).

PW_EmailOpen

Dieses Event wird ausgelöst, wenn ein Benutzer eine über Pushwoosh gesendete E-Mail öffnet.

Event-Attribute

• campaign_code (string): Der eindeutige Code der Kampagne, die mit der E-Mail verknüpft ist.
• campaign_id (string): Die ID der Kampagne.
• message_code (string): Der eindeutige Bezeichner der spezifischen E-Mail-Nachricht.
• message_id (string): Die ID der Nachricht.

Anwendungsfälle

• Verfolgen Sie E-Mail-Öffnungen, um Benutzer zu identifizieren, die aktiv mit Ihren E-Mails interagieren. Nutzen Sie diese Daten, um Folgekampagnen zu erstellen, z. B. das Senden von Rabattcodes an Benutzer, die Werbe-E-Mails öffnen.
• Wenn Benutzer eine E-Mail öffnen, aber die gewünschte Aktion nicht ausführen (z. B. einen Kauf tätigen), können Sie Folge-E-Mails mit Erinnerungen oder personalisierten Angeboten auslösen.
• Analysieren Sie die Öffnungsraten über Kampagnen hinweg, um Ihre Betreffzeilen und E-Mail-Timing-Strategien für Kampagnen wie Produkteinführungen oder saisonale Aktionen zu verfeinern.

PW_InAppShown

Dieses Event wird ausgelöst, wenn eine In-App-Nachricht dem Benutzer angezeigt wird.

Event-Attribute

• message_code (string): Der eindeutige Bezeichner der spezifischen Nachricht, die mit der In-App verknüpft ist.
• message_id (integer): Die ID der Nachricht.
• campaign_code (string): Der eindeutige Code der Kampagne, die mit der In-App verknüpft ist.
• campaign_id (integer): Die ID der Kampagne, die die In-App ausgelöst hat.
• rich_media_code (string): Der eindeutige Bezeichner des Rich-Media-Inhalts, der in der In-App angezeigt wird.
• inapp_code (string): Der eindeutige Code, der die spezifische angezeigte In-App-Nachricht identifiziert.

Anwendungsfälle

• Verfolgen Sie die Häufigkeit der Ansichten von In-App-Nachrichten, um Ihre Messaging-Strategie anzupassen, z. B. das Entfernen redundanter Nachrichten, die Benutzer stören könnten.
• Nutzen Sie die Daten zu In-App-Impressionen, um die Reichweite von Werbekampagnen wie Blitzverkäufen oder Abonnement-Upgrades zu bewerten.
• Wenn eine In-App-Nachricht angezeigt, aber nicht angeklickt wird, können Sie eine Folgeaktion auslösen, z. B. das Senden einer Push-Benachrichtigung mit ähnlichem Inhalt, um die Nachricht zu verstärken.

PW_InAppClicked

Dieses Event wird ausgelöst, wenn ein Benutzer mit einer In-App-Nachricht interagiert, indem er darauf klickt.

Event-Attribute

• message_code (string): Der eindeutige Bezeichner der spezifischen Nachricht, die mit der In-App verknüpft ist.
• message_id (integer): Die ID der Nachricht.
• campaign_code (string): Der eindeutige Code der Kampagne, die mit der In-App verknüpft ist.
• campaign_id (integer): Die ID der Kampagne, die die In-App ausgelöst hat.
• rich_media_code (string): Der eindeutige Bezeichner des Rich-Media-Inhalts, der in der In-App angezeigt wird (falls zutreffend).
• inapp_code (string): Der eindeutige Code, der die spezifische angeklickte In-App-Nachricht identifiziert.
• element_id (string): Der Bezeichner des spezifischen Elements innerhalb der In-App-Nachricht, das angeklickt wurde (z. B. ein Button oder Link).
• link (string): Die URL oder der Deep Link, der mit dem angeklickten Element verknüpft ist.

Anwendungsfälle

• Analysieren Sie das Klickverhalten, um herauszufinden, mit welchen Buttons oder Links Benutzer am häufigsten interagieren, und optimieren Sie zukünftige In-App-Nachrichtendesigns. Testen Sie beispielsweise verschiedene CTAs in Kampagnen für Abonnement-Upgrades.
• Lösen Sie automatisierte Aktionen basierend auf Benutzerklicks aus, z. B. das Weiterleiten von Benutzern auf eine bestimmte Produktseite oder das Senden einer Push-Benachrichtigung.

PW_WhatsAppReceived

Dieses Event wird ausgelöst, wenn eine WhatsApp-Nachricht über das System empfangen wird.

Event-Attribute

• message (string): Der Inhalt oder Bezeichner der empfangenen WhatsApp-Nachricht.

Anwendungsfälle

• Automatisieren Sie Folgeaktionen als Reaktion auf eingehende WhatsApp-Nachrichten (z. B. das Starten einer Customer Journey oder das Verfolgen von Benutzerinteraktions-Events).
• Segmentieren Sie Benutzer basierend auf ihren WhatsApp-Nachrichteninteraktionen, um gezieltes Messaging oder personalisierte Kampagnen zu ermöglichen.