Mobil: Was sind Android Kampagnenrückrufe und wie werden sie verwendet?

Kurzübersicht

Ab WalkMe Mobile SDK Version 1.6.0 unterstützt WalkMe Mobile SDK Kampagnenrückrufe.

Rückrufe sind eine programmatische Möglichkeit für eine App, sich für WalkMe-Kampagnenereignisse zu registrieren. Durch die Implementierung der Kampagnenrückruf-Schnittstelle können Apps die über die Rückruf-Objekte übertragenen Daten (einschließlich Kampagnen- und Benutzerinformationen) verwenden und sie für die Zwecke der App nutzen, z. B. App- oder Benutzereinstellungen gemäß Benutzerinteraktion mit der Kampagne.

Anwendungsfälle

Kampagnenrückrufe können für Folgendes und vieles mehr verwendet werden:

  • Das Onboarding von Benutzern von jedem Analytics-System verfolgen
  • Generieren von Chancen in einem CRM basierend auf dem Benutzerengagement mit WalkMe Shoutout - z. B. „Sind Sie an einer kostenlosen Demo interessiert? Ja / Nein“
  • Integrieren in bestehende Support-Systeme, um die/den WalkThru-Nutzung/-Abschluss mit den wichtigsten Support-Ticket-Themen zu verfolgen und zu vergleichen

Nachfolgend finden Sie eine Beschreibung aller erforderlichen Schritte, um Kampagnenrückrufe zu implementieren.

Schritte Zur Implementierung Von Kampagnenrückrufen

Um Kampagnen-Callbacks registrieren zu können, implementieren Sie zuerst dieser Schnittstelle:

/**
 * Schnittstellendefinition für einen Rückruf, der in Kampagnenaktionen aufgerufen werden soll.
 */
public interface WMCampaignInfoListener {
 /**
 * Aufgerufen, nachdem die Kampagne verworfen wurde.
 *
 * @param campaignInfo Die Informationen zur verworfenen Kampagne.
 */
 void onCampaignDismissed(WMCampaignInfo campaignInfo);
}

Nach der Implementierung der Schnittstelle verwenden Sie die Methode, um sich für die Campaign Callback Events zu registrieren:

/**
 * Einen Listener für Kampagnenereignisse registrieren
 *
 *@param campaignInfoListener Der Listener
 *
 */
public static void setCampaignInfoListener(WMCampaignInfoListener campaignInfoListener)

Das Callback-Rückgabeobjekt ist von der Klasse, die die folgenden Informationen enthält:

Artikel Abgerufen von Beschreibung
Kampagne CTA getCampaignCta()

Die Kampagne CTA, mit der der App-Benutzer interagiert hat.

Für alle CTAs außer der benutzerdefinierten lautet die zurückgegebene CTA:
abbi://cta , zum Beispiel: abbi://ok oder abbi://nie

Kampagnen-ID getCampaignId() Die eindeutige ID, die der Kampagne zugewiesen ist
Kampagnen-CTA-ID getCampaignCtaId() Die eindeutige ID für die Kampagne CTA
User Data (Benutzerdaten) getUserData() Ein Objekt, das Informationen über den Benutzer hält, der mit der Kampagne interagiert. Sehen Sie die vollständige Beschreibung des Objekts unten.
Kampagnendaten getCampaignData() Ein Platzhalterobjekt, das für die mögliche zukünftige Verwendung zusätzlicher Daten hinzugefügt wird, die an die Kampagne angehängt werden. Hier werden Daten zum Einreichen von Umfragen eingetragen.

Dies ist die Struktur für das Objekt:

 public class WMCampaignInfo {

 public String getCampaignCta()

 public String getCampaignId()

 public String getCampaignCtaId()

 public WMUserData getUserData()

 public Map<String, Object> getCampaignData()
}

Wie oben erwähnt, enthält es das Objekt 1, das unten beschrieben wird:

Artikel Abgerufen von Beschreibung
Öffentliche Benutzerattribute getUserAttributesMap() Alle öffentlichen Benutzerattribute die für den App-Benutzer in dem Moment festgelegt wurden, in dem der Benutzer mit der Kampagne interagiert. Die Liste enthält immer den Attributschlüssel und seinen Wert, z. B. ${ "lead_id" : "12345" , "account_type" : "family"}
Private Benutzerattribute getPrivateUserAttributes() Alle privaten Benutzerattribute die für den App-Benutzer in dem Moment festgelegt wurden, in dem der Benutzer mit der Kampagne interagiert. Die Liste enthält immer den Attributschlüssel und seinen Wert, z. B. ${ "lead_id" : "12345" , "account_type" : "family"}
Zeitstempel der Nutzererstellung getUserCreationTimestamp() Der Zeitstempel, in dem der Benutzer zuerst von WalkMe identifiziert wurde
Sitzungsdauer getSessionDuration() Wie lange war die Benutzersitzung im Moment der Durchführung der Kampagneninteraktion
Android-Version getDeviceVersion() Die Betriebssystemversion des Benutzers
Eindeutige Geräte-ID getDeviceId() Die einzigartige Geräte-ID
Gerätemodell getDeviceModel() Das Gerätemodell des Benutzers
Geräteausrichtung getDeviceOrientation() Die Ausrichtung der Geräte im Moment der Interaktion des Benutzers mit der Kampagne
App-Version getAppVersion() Die App-Version, die der Benutzer verwendet
App-Name getAppName() Der App-Name
Standort getLocale() Die Lokalisierung des Geräts des Benutzers
SDK-Version getSdkVer() Die in die App des Benutzers integrierte SDK-Version.
Sitzungs-ID getSessionId() Die einzigartige Sitzungs-ID von WalkMe
Neue Benutzeranzeige getIsNewUser() Ist dies das erste Mal, dass der Benutzer von WalkMe identifiziert wird (wahr / falsch)
Status von Push-Nachrichten getIsPushEnabled() Hat der Benutzer Push-Benachrichtigung für die App aktiviert (wahr / falsch). Wenn die App keine Push-Benachrichtigungen enthält - ist der Wert „falsch“.
Zeitzone des Geräts getTimezone() Die Zeitzone des Benutzers wie auf dem Gerät eingestellt.
Netzwerk getNetwork() Der Netzwerktyp, den der Benutzer verwendet: WLAN / Cellular / Offline
Nutzerbreitengrad getLocationLat() Platzhalter für mögliche Umsetzung des Breitengrads
Nutzerbreitengrad getLocationLong() Platzhalter für mögliche Umsetzung des Breitengrads
Systemname getSystemName() Der OS des Benutzers - in diesem Fall immer „Android“
Aktueller Zeitstempel des Benutzers getTimestamp() Der aktuelle Zeitstempel des Benutzers

Dies ist die Struktur für das Objekt:

public class WMUserData {

 /**
 * Benutzerattribute in der aktuellen Sitzung.
 */
 public Map<String, Object> getUserAttributesMap()


 /**
 * Private Benutzerattribute in der aktuellen Sitzung.
 */
 public Map<String, Object> getPrivateUserAttributes()

 /**
 * Gibt den Zeitstempel der Benutzer-Erstellung für diesen Benutzer zurück.
 *
 * @return long Zeitstempel.
 */
 public long getUserCreationTimestamp()

 /**
 * Gibt die Dauer der Benutzersitzung in Sekunden zurück.
 *
 * @return double Sekunde.
 */
 public double getSessionDuration()

 /**
 * Gibt die Android-Version des Geräts zurück.
 *
 * @return String-Versionsnummer.
 */
 public String getDeviceVersion()

 /**
 * Gibt die eindeutige ID des Geräts zurück.
 *
 * @return String id.
 */
 public String getDeviceId()

 /**
 * Gibt das Modell der Gerätemarke zurück.
 *
 * @return String Model.
 */
 public String getDeviceModel()

 /**
 * Gibt die Geräteausrichtung PRT_REG / LSL zurück.
 *
 * @return String Orientation.
 */
 public String getDeviceOrientation()
 /**
 * Gibt die Anwendungsversion zurück.
 *
 * @return String version.
 */
 public String getAppVersion()

 /**
 * Gibt den Anwendungsnamen zurück.
 *
 * @return String Name.
 */
 public String getAppName()

 /**
 * Gibt das Gebietsschema für diese Instanz der Java Virtual Machine zurück.
 *
 * @return String Name.
 */
 public String getLocale()

 /**
 * Gibt die WalkMe SDK-Version zurück.
 *
 * @return String version.
 */
 public String getSdkVer()

 /**
 * Gibt die eindeutige ID der Sitzung zurück.
 *
 * @return String id.
 */
 public String getSessionId()

 /**
 * Gibt zurück, ob der Benutzer die App zum ersten Mal verwendet.
 *
 * @return String boolean.
 */
 public String getIsNewUser()

 /**
 * Gibt zurück, ob die Push-Benachrichtigung für den Benutzer genehmigt wurde.
 *
 * @return String boolean.
 */
 public String getIsPushEnabled()

 /**
 * Gibt die Zeitzone des Benutzergeräts zurück.
 *
 * @return String timezone.
 */
 public String getTimezone()

 /**
 * Gibt das aktuelle Netzwerk des Benutzers zurück ( WIFI / 3G ).
 *
 * @return String Network.
 */
 public String getNetwork()

 /**
 * Gibt den aktuellen Breitengrad des Benutzers zurück, sofern verfügbar
 *
 * @return String latitude.
 */
 public String getLocationLat()

 /**
 * Gibt den aktuellen Standort des Benutzers zurück, wenn verfügbar.
 *
 * @return String longitude.
 */
 public String getLocationLong()

 /**
 * Gibt den Systemnamen des Benutzers zurück (Android).
 *
 * @return String Android.
 */
 public String getSystemName()

 /**
 * Gibt den aktuellen Zeitstempel dieses Benutzers zurück.
 *
 * @return String Timestamp.
 */
 public String getTimestamp()
}

War dies hilfreich?

Vielen Dank für Ihr Feedback!

Be part of something bigger.

Engage with peers, ask questions, share ideas

Ask the Community
×