Eine Custom Variable erstellen

Whatfix ermöglicht es Ihnen, eine Custom Variable zu erstellen, die auf den Werten basiert, die von der Anwendung Ihres Endbenutzers abgerufen werden. Sie können die Custom Variable in mehreren Inhalten und Widgets verwenden, die abgerufenen Werte in einem Pop-up vorausfüllen und Felder mithilfe eines Smart Tips automatisch eingeben.

• Wie erstellt man eine Custom Variable?

• Anwendungsfälle für Custom Variables

Wie erstellt man eine Custom Variable?

Gehen Sie wie folgt vor, um eine Custom Variable zu erstellen:

3. Klicken Sie User rules.
   

4. Klicken Sie + Regel erstellen.
   

5. Klicken Sie im Dialogfeld Regel erstellen auf Custom Variables.
   

6. Klicken Sie auf Fortfahren.
   

7. Geben Sie den Variablennamen für Ihre Referenz ein.
   

8. Geben Sie eine Beschreibung für die Variable ein.
   

9. Geben Sie im Feld Standardwert einen Wert ein, auf den die Variable zurückgreifen kann, wenn Whatfix keinen Wert aus der Anwendung abrufen kann.
   

10. Fügen Sie die folgenden Bedingungen zu einer Custom Variable hinzu:
    

Info:

Klappen Sie die folgenden Akkordeons auf, um mehr über die variablen Bedingungen zu erfahren:

Wo möchten Sie die Variable erfassen?

Definieren Sie die spezifische Seite der Anwendung (mithilfe von URL oder Seitenbedingungen), auf der die Variable ausgewertet werden soll.

Die folgende Tabelle listet alle Where-Bedingungen auf, die Sie für die Variable festlegen können:

Anzeigen	Beschreibung
URL	Verwenden Sie diese Bedingung, um die Variable auf der gesamten angegebenen URL zu bewerten.
Domain	Verwenden Sie diese Bedingung, um die Variable auf einer bestimmten Domain auszuwerten. Der Domain oder Hostname ist der erste Teil der URL.
URL Path	Verwenden Sie diese Bedingung, um die Variable auf einem bestimmten Abschnitt einer URL auszuwerten. Der Pfadname der Website ist der Teil, der nach dem Domänennamen und vor den Parametern oder Hashes steht.
URL-Parameter	Verwenden Sie diese Bedingung, um das Widget basierend auf den Parametern in der URL anzuzeigen
URL hash value	Verwenden Sie diese Bedingung, um die Variable basierend auf dem Hashwert der URL zu bewerten. Hashes sind in der Regel in Einseitenanwendungen unter Verwendung von AngularJS oder ReactJS zu finden.
Page Tags	Verwenden Sie diese Bedingung, um die Variable basierend auf Page Tags zu bewerten. Sie können zum Beispiel ein Tag namens 'asia-content' einsetzen, um Inhalte speziell für die Region Asien anzuzeigen. Weitere Informationen finden Sie unter Role oder Page basierte Tags erstellen.

Welche Werte sollte die Variable speichern?

Definieren Sie die genauen Daten, die erfasst werden sollen, z. B. Elementtext, Feldwerte, Cookies, Speicherelemente oder Window variables.

Mit Whatfix können Sie aus den folgenden Optionen auswählen:

Rückgabewert einer Funktion

Whatfix ermöglicht es Ihnen, Code-Snippets aus dem JavaScript der Anwendung abzurufen und sie als Custom Variable zu verwenden. Der Rückgabewert des Codes kann verwendet werden, um gezielten Content anzuzeigen.

Hier sind einige Beispiele:

UserLocale: Wenn Ihre Anwendung die Spracheinstellung des Benutzers in einer Hintergrundfunktion speichert (z. B. en-US oder fr-FR), können Sie dies abrufen, um sicherzustellen, dass ein französischsprachiger Benutzer nur die französische Version eines Pop-ups sieht.

getSessionId: Sie können die eindeutige ID der aktuellen Benutzersitzung abrufen. Dies ist hilfreich, wenn Sie nachverfolgen möchten, in welcher bestimmten Sitzung sich ein Benutzer befand, als er eine Survey abgeschlossen oder einen Fehler festgestellt hat.

getUserRole: Wenn die Anwendung die Benutzerrolle nicht auf dem Bildschirm anzeigt, sie aber im Code gespeichert ist (z. B. Admin, Editor, Viewer), können Sie diese abrufen, um spezielle „Nur für Admin“-Onboarding-Flows anzuzeigen.

URL

Whatfix ermöglicht es Ihnen, die Anwendungs-URL abzurufen und als Regel zu einer Custom Variable hinzuzufügen.

Weitere Informationen finden Sie unter URL Properties als Sichtbarkeitsregeln festlegen.

Element

Whatfix ermöglicht es Ihnen, bestimmte Elemente in Ihrer Anwendung anzusteuern, um Werte abzurufen, wenn diese Elemente vorhanden sind. Wenn Sie beispielsweise ein Self Help Widget nur anzeigen möchten, wenn der Benutzer nicht angemeldet ist, wählen Sie den Button Anmelden als Ziel-Element.

Führen Sie die folgenden Schritte aus, um ein Element als Bezeichner auszuwählen:

1. Mithilfe der Frage Was möchten Sie identifizieren? Dropdown, wählen Sie Element.

   

2. Klicken Sie Element mit Studio auswählen.

   

3. Geben Sie die URL der Seite ein, von der Sie das Element auswählen möchten.

4. Klicken Sie Element auswählen.

   

5. Auf der umgeleiteten Seite verwenden Sie Whatfix Studio, um das gewünschte Element auszuwählen.

   

   Your title goes here

   • Klicken Sie auf Display Rules hinzufügen, um Display Rules für das ausgewählte Element hinzuzufügen oder zu bearbeiten. Für weitere Informationen sehen Sie Ausgewählte Elementbedingungen.
     

   • Klicken Sie auf das Element erneut auswählen, um das Element in der Anwendung erneut auszuwählen.
     

Local Storage

Local Storage ist eine Art von Webspeicher, der verwendet wird, um Daten auf der Clientseite zu speichern. Es speichert Daten ohne Ablaufdatum. Daten bleiben auch nach dem Schließen und erneuten Öffnen des Browsers bestehen, was sie nützlich für die langfristige Speicherung über mehrere Sitzungen hinweg macht.

Whatfix ermöglicht es Ihnen, Werte auf der Grundlage bestimmter, im local storage abgelegter Werte abzurufen. Überlegen Sie, dass Sie ein bestimmtes Widget nur anzeigen möchten, wenn der Benutzer den Dunkelmodus aktiviert.

Führen Sie die folgenden Schritte aus, um einen local storage key als Bezeichner auszuwählen:

1. Mithilfe der Frage Was möchten Sie identifizieren? Wählen Sie in der Dropdown-Liste Local Storage.

   

2. Geben Sie im Abschnitt Key den Namen des Schlüssels ein, den Sie identifizieren möchten.

   

Session storage

Session Storage ist eine Art von Webspeicher, der verwendet wird, um Daten auf der Clientseite zu speichern. Die gespeicherten Daten sind auf eine einzige Browsersitzung begrenzt. Daten werden nur so lange gespeichert, wie der Browser oder Tab offen ist. Wenn der Benutzer das Tab oder den Browser schließt, werden die Daten gelöscht.

Whatfix ermöglicht es Ihnen, Werte auf der Grundlage bestimmter, im Sitzungsspeicher gespeicherter Werte abzurufen. Berücksichtigen Sie, dass Sie ein Smart Tip Segment in Ihrer Anwendung nur anzeigen möchten, nachdem ein Benutzer eine bestimmte Anzahl von Klicks während seiner Sitzung ausgeführt hat.

Führen Sie die folgenden Schritte aus, um einen session storage key als Bezeichner auszuwählen:

1. Mithilfe der Frage Was möchten Sie identifizieren? Wählen Sie in der Dropdown-Liste Session Storage.

   

2. Geben Sie im Abschnitt Key den Namen des key ein, den Sie identifizieren möchten.

   

Cookie

Ein Cookie ist ein kleines Stück Daten, das von einem Webbrowser auf dem Gerät eines Benutzers gespeichert wird. Es wird verwendet, um Informationen über den Benutzer zu speichern, wie Login-Daten, Seitenpräferenzen oder Sitzungsdaten, bei verschiedenen Besuchen auf einer Website.

Whatfix ermöglicht es Ihnen, Werte auf der Grundlage bestimmter, in Cookies gespeicherter Werte abzurufen. Zum Beispiel, wenn Sie eine bestimmte Tasklist nur anzeigen möchten, wenn die Cookie-Daten eines Benutzers darauf hinweisen, dass er aus einem bestimmten Land stammt, wählen Sie Cookies als Ihren Identifikator. Geben Sie den Cookie Key an, den Sie überwachen möchten, und definieren Sie den erforderlichen Wert für diesen key. Das Widget erscheint nur, wenn der Cookie key mit dem angegebenen Wert übereinstimmt, sodass Sie Inhalte anzeigen können, die für den geografischen Standort des Benutzers relevant sind.

Führen Sie die folgenden Schritte aus, um einen Cookie-Schlüssel als Bezeichner auszuwählen:

1. Mithilfe der Frage Was möchten Sie identifizieren? Dropdown, wählen Sie Cookie.

   

2. Geben Sie im Abschnitt Key den Namen des key ein, den Sie identifizieren möchten.

   

Window Variable

Eine Window-Variable kann verwendet werden, wenn Sie ein Widget basierend auf einer globalen Javascript-Variable, die in der Anwendung vorhanden ist, oder basierend auf der von Ihnen in der Advanced customization von Whatfix erstellten Variable verfügbar machen müssen. Wenn Sie zum Beispiel die Rolle des Benutzers überprüfen wollen, können Sie die Bedingung user.role='admin' festlegen. Dies ermöglicht Ihnen, ein Widget für bestimmte User roles anzuzeigen.

Info:

Um zu bestimmen, welche Window Variable verwendet werden soll oder um eine Window Variable zu konfigurieren, kontaktieren Sie support@whatfix.com.

Führen Sie die folgenden Schritte aus, um eine Window Variable als Bezeichner auszuwählen:

1. Mithilfe der Frage Was möchten Sie identifizieren? Wählen Sie in der Dropdown-Liste Window Variable.

   

2. Geben Sie im Abschnitt Key den Namen des key ein, den Sie identifizieren möchten.

   

Für wen soll die Variable erfasst werden?

Legen Sie das Zielpublikum basierend auf Benutzertypen oder Attributen fest (zum Beispiel Rolle, Cohort oder Enterprise spezifische Attribute).

Die folgende Tabelle listet alle Who-Bedingungen auf, die Sie für die Variable festlegen können:

Identifizieren Sie den Benutzer anhand von	Beschreibung
Enterprise Attributes	Mit Attribut-Bedingungsregeln können Sie spezifische Informationen auf der Grundlage von Rollen, Abteilungen, Geografie, Konten usw. abrufen. Sobald die Attribute in Whatfix integriert sind, können Sie sie als Anzeige-Bedingung für die Variable sehen. Weitere Informationen finden Sie unter Attribute als Visibility Rules. Wenn Sie Ihre Anwendungsinformationen für die Segmentation von Inhalten benötigen, können Sie mit Enterprise Attributes diese Daten zur Verwendung in Whatfix abrufen.
User Attributes	Wenn Sie Inhalte auf der Grundlage von Informationen über Endbenutzer aus Ihrer Anwendung segmentieren müssen, können Sie mithilfe von User Attributes diese Daten zur Verwendung in Whatfix abrufen. Weitere Informationen finden Sie unter Attribute als Visibility Rules.
Rollen	Whatfix bietet Ihnen die Option, mithilfe von Role Tags unterschiedliche Inhalte für unterschiedliche Benutzer anzuzeigen. Einem Admin-Benutzer können beispielsweise im Vergleich zu einem einfachen Benutzer mehrere und unterschiedliche Inhalte angezeigt werden. Dies hilft bei der gezielten Bereitstellung von Informationen darüber, was die Benutzer in Ihrer Applikation leisten können. Weitere Informationen finden Sie unter Tags als Visibility Rules festlegen.
Cohorts	Erstellen Sie Cohorts für bestimmte Benutzer, basierend auf bestimmten Anwendungsfällen, um Whatfix Inhalte anzuzeigen. Zeigen Sie ein Pop-up neuen Benutzern, die 7 Tage oder weniger im System verbracht haben und 3 Aufgaben über die neueste Version der Anwendung abgeschlossen haben. Weitere Informationen finden Sie unter Cohorts als Visibility Rules hinzufügen.
Salesforce Objekte	Salesforce Lightning Objekte sind Eigenschaften, die Whatfix dabei unterstützen, relevanten Inhalt für Salesforce Lightning Benutzer basierend auf vorhandenen Salesforce Lightning Eigenschaften bereitzustellen, die dabei helfen, verschiedene Benutzer zu identifizieren. Mithilfe von Salesforce Lightning-Objekten können Sie Ihren Benutzern problemlos relevante Inhalte anzeigen. Salesforce-Objekte sind nur für die Salesforce-App anwendbar und erscheinen, wenn Ihre App entsprechend konfiguriert ist. Weitere Informationen finden Sie unter Verwendung von Salesforce Lightning Objekten für die Segmentation von Inhalten in Whatfix.

11. Sobald Sie alle Bedingungen für die Variable konfiguriert haben, klicken Sie auf Speichern.
    

12. Verwenden Sie den Schalter, um die Custom Variable zu aktivieren.
    

Note:

• Sie müssen die Custom Variable veröffentlichen aus dem Ready-Status.
  

• Custom Variables sind so konzipiert, dass sie nur vorübergehend bestehen bleiben, damit sie nützlich bleiben, ohne wiederholte oder irrelevante Triggers auszulösen. Das Ablaufdatum stellt sicher, dass Variablen für den aktuellen Kontext des Benutzers relevant bleiben und verhindert, dass veraltete oder persistente Werte unerwünschten Content erneut erscheinen lassen. Hier sind einige Beispiele:

  • Wenn eine Custom Variable ausgewertet und ihr Wert in der Anwendung geändert wird, wird die Custom Variable automatisch aktualisiert.

  • Wenn Sie sich von der Anwendung abmelden oder wenn der Local Storage, Session Storage oder cache geleert werden, läuft die Custom Variable ab. Wenn Sie sich wieder anmelden und eine Aktion durchführen, wird die Custom Variable erneut ausgewertet.

  • Bleibt der Wert unverändert (zum Beispiel ein Benutzername, der konstant bleibt), läuft die Custom Variable nach 7 Tagen ab, um sicherzustellen, dass sie weiterhin aktuell und relevant bleibt.

Anwendungsfälle für Custom Variables

Erweitern Sie die folgenden Akkordeons für weitere Details: