Ansprache-Regeln

Im Feldsatz Proaktive Ansprache legen Sie fest, wann das Chatfenster Besucher Ihrer Website von sich aus mit einem Satz anspricht: nach einer Zeit auf der Seite, nach einem gelesenen Anteil, nach einem Stillstand, beim Verlassen der Seite oder beim zweiten Besuch. Diese Seite beschreibt jedes Feld, jede Grenze und jede Meldung und zeigt, wie sich die Sprechblase auf Ihrer Website verhält.

Wo Sie die Regeln einstellen

1. 1

   Schritt 1

   Assistenten öffnen

   Öffnen Sie in der Anwendung Arbeit › Assistenten, also app.xicbot.de/assistenten.

2. 2

   Schritt 2

   Assistent aufklappen

   Wählen Sie beim gewünschten Assistenten Bearbeiten. Mit der Rolle Lesen heißt der Knopf Ansehen, und die Felder bleiben gesperrt. Schließen klappt den Assistenten wieder zu.

3. 3

   Schritt 3

   Feldsatz finden

   Im Abschnitt Chatfenster auf Ihrer Website steht der Feldsatz Proaktive Ansprache. Unter den Regeln und dem Knopf Regel hinzufügen steht ein Hinweis; an seinem Ende zeigt ein Zähler, wie viele Regeln bestehen, etwa 0/5.

4. 4

   Schritt 4

   Regel anlegen

   Regel hinzufügen hängt am Ende eine neue Zeile an. Wählen Sie das Ereignis, tragen Sie bei Bedarf Zahl und Pfad ein und schreiben Sie den Satz.

5. 5

   Schritt 5

   Speichern

   Speichern sendet das ganze Formular des Chatfensters. Während des Sendens steht dort Wird gespeichert …, danach erscheint „Gespeichert.“

Die Felder einer Regel

Über jedem Feld einer Zeile steht seine Beschriftung: Ereignis, Wert, Nur auf Pfad und Satz der Ansprache. Hinter dem Zahlfeld steht die Einheit, Sekunden oder Prozent. Bildschirmleser nennen das Zahlfeld mit Beschriftung und Einheit, etwa „Wert Sekunden“.

Regel hinzufügen erscheint, solange weniger als fünf Regeln bestehen. Darunter steht „Je Regel ein Ereignis und ein Satz. Die erste Regel, die zutrifft, spricht; danach schweigt das Widget für diesen Besuch. Ohne Regel erscheint nichts ungefragt.“ und der Zähler, etwa 2/5. Mit „Besuch“ ist dabei der einzelne Seitenaufruf gemeint. Neue Regeln kommen ans Ende der Liste; verschieben lassen sich Regeln nicht.

Die fünf Ereignisse

Ab wann die Zeit zählt

Das Chatfenster lädt erst, wenn die Seite fertig geladen ist. Sobald es seine Einstellungen vom Server erhalten hat, werden die Regeln scharf geschaltet, und ab dann laufen die Uhren für Nach Zeit auf der Seite und Nach Stillstand. Die Ladezeit der Seite zählt nicht mit. Scrollen und Mausrad gelten nicht als Stillstand: wer liest, ist nicht untätig.

Wie der gelesene Anteil gemessen wird

Gemessen wird, wie weit die untere Kante des sichtbaren Bereichs in die Seite reicht, gerundet auf ganze Prozent. Oben auf einer Seite, die dreimal so hoch ist wie das Fenster, sind das bereits 33 Prozent; eine Regel mit 30 Prozent spricht dort sofort. Eine Seite, die nicht höher ist als das Fenster, zählt als ganz gelesen. Geprüft wird beim Scharfschalten, beim Scrollen und wenn sich die Fenstergröße ändert.

Beim zweiten Besuch

Für Beim zweiten Besuch legt das Widget im Browser eine Marke ab. Sie sagt nur „schon einmal hier gewesen“ und trägt keine Kennung.

• Name im lokalen Speicher: xicbot.besuch.<Schlüssel>, gültig 90 Tage.
• Jedes Scharfschalten der Regel liest die Marke und schreibt sie neu; die 90 Tage beginnen damit von vorn.
• Die Regel spricht, wenn die Marke schon bestand. Das trifft bereits beim nächsten Seitenaufruf zu, auch innerhalb derselben Sitzung.
• Die Marke entsteht nur auf Seiten, deren Pfad zur Regel passt.
• Lässt der Browser keinen Speicher zu, spricht die Regel nicht.
• <Schlüssel> ist der Wert des Attributs data-xicbot im Einbaucode. Mit einem anderen Schlüssel beginnt die Zählung von vorn.

Welche Regel spricht

• Scharf geschaltet werden die Regeln in der Reihenfolge des Formulars, höchstens fünf. Regeln ohne Satz und Regeln, deren Pfad nicht passt, fallen dabei weg.
• Die Regel, deren Ereignis zuerst eintritt, spricht. Alle übrigen werden in diesem Moment abgeschaltet.
• Treffen schon beim Scharfschalten mehrere Regeln zu, etwa Beim zweiten Besuch oder ein kleiner Anteil auf einer kurzen Seite, spricht die oberste davon.
• Die Sperre gilt für den Seitenaufruf. Auf der nächsten Seite derselben Website werden die Regeln neu scharf geschaltet.

Pfadfilter

Nur auf Pfad vergleicht den Anfang des Seitenpfads, ohne Domain, Abfrage und Anker. Groß- und Kleinschreibung zählen. Ein leeres Feld lässt die Regel auf allen Seiten gelten, auf denen das Widget eingebunden ist.

Die Sprechblase

Die Sprechblase erscheint dort, wo sich das Chatfenster öffnet: in derselben Ecke wie der Knopf, 12 Pixel über ihm oder 12 Pixel darunter, wenn der Knopf oben steht. Weicht der Knopf einer festen Leiste der Seite aus, rückt die Sprechblase mit. Sie ist höchstens 320 Pixel breit, auf schmalen Bildschirmen höchstens die Fensterbreite abzüglich 32 Pixel, weiß mit dunkler Schrift in 15 Pixeln und abgerundeten Ecken.

• Der Satz selbst ist ein Knopf mit mindestens 48 Pixeln Höhe. Ein Klick öffnet das Chatfenster.
• Das Kreuz daneben, 44 Pixel breit, schließt die Sprechblase. Bildschirmleser nennen es „Hinweis schließen“, bei englischem Chatfenster „Dismiss message“. Die Regeln bleiben für diesen Seitenaufruf abgeschaltet.

Die Sprechblase trägt die Rolle status; Bildschirmleser melden den Satz, ohne den Fokus zu verschieben. Der Satz steht als reiner Text da: Sternchen, Links oder HTML erscheinen so, wie Sie sie eintippen. Übersetzt wird er nicht. Für eine englische Fassung Ihrer Website legen Sie eine eigene Regel mit passendem Pfad an, etwa /en/.

Tritt der Knopf vor einem Aufbau zurück, der fast das ganze Fenster deckt (ab 80 Prozent der Fensterhöhe), ist auch die Sprechblase ausgeblendet. Näheres unter Darstellung und Bedienung.

Wann keine Sprechblase erscheint

• Keine Regel hat einen Satz, oder kein Pfad passt zur aufgerufenen Seite.
• Der Besucher hat das Chatfenster auf dieser Seite schon geöffnet. Ab dann bleibt die Ansprache für den Seitenaufruf aus.
• Das Skript trägt data-einwilligung="erforderlich", und der Besucher hat noch nicht über window.xicbot.einwilligen() zugestimmt. Siehe Einwilligung und Besucherrechte.
• Der Assistent hat nicht den Status aktiv, sondern Entwurf oder pausiert, Chatfenster freigeben ist ausgeschaltet, oder das Konto ist nicht aktiv. Das Widget nimmt dann auch seinen Knopf von der Seite.
• Der Assistent hat noch keine aktive Fassung. Dann wird keine Regel scharf geschaltet. Der Knopf bleibt auf der Seite, das geöffnete Chatfenster zeigt „Dieser Assistent ist noch nicht bereit.“
• Das Chatfenster hat seine Einstellungen noch nicht vom Server erhalten, etwa ohne Netzverbindung. Bis dahin ist keine Regel scharf geschaltet.
• window.xicbot.widerrufen() wurde aufgerufen. Der Widerruf nimmt Regeln und Sprechblase sofort von der Seite. Bis zum nächsten Seitenaufruf bleibt die Ansprache aus, auch wenn Ihre Seite erneut einwilligen() aufruft.

Speichern und Wirksamkeit

Vor dem Senden räumt das Formular auf: Regeln ohne Satz fallen weg, Pfad und Satz verlieren führende und folgende Leerzeichen, und die Zahl wird in den Bereich des Ereignisses geholt. Bei Beim Verlassen der Seite und Beim zweiten Besuch geht der Wert 0 mit. Der Server prüft die Liste erneut, speichert je Regel nur ereignis, wert, pfad und text und legt eine leere Liste als „keine Regeln“ ab.

Besucher bekommen neue Regeln mit dem nächsten Seitenaufruf. Auf einer Seite, die schon offen ist, sieht das Widget nur beim Öffnen des Chatfensters und bei der Rückkehr in den Browser-Tab nach Änderungen, höchstens einmal je Minute, und übernimmt dabei nur die Anzeige: Überschrift, Farbe, Ecke, Abstände, Breite, Höhe, Skalierung, Eckenradius und Bild sowie den Hinweis unter der Überschrift und den Grenzenhinweis. Die Regeln gelten dort erst nach dem Neuladen.

Meldungen beim Speichern

Lehnt der Server eine Regel ab, steht am Ende des Feldsatzes Proaktive Ansprache ein Satz zum Grund: bei outreach_rule_path „Der Pfad einer Regel muss mit „/“ beginnen und darf höchstens 120 Zeichen lang sein, zum Beispiel /kontakt.“, bei jeder anderen Kennung „Eine Regel der proaktiven Ansprache ist ungültig. Prüfen Sie je Regel Ereignis, Wert, Pfad und Satz.“ Welche Zeile betroffen ist, nennt die Anwendung nicht. Lehnt der Server zugleich ein Feld ab, das die Anwendung nicht markiert, lautet die Meldung beim Speichern „Das hat nicht geklappt. Bitte prüfen Sie Ihre Eingaben.“ Die Antwort der Schnittstelle führt beim Feld widget_outreach_rules eine der folgenden Kennungen. Die Prüfung endet beim ersten Fehler.

Rollen

Mit Lesen ist das Formular im Abschnitt Chatfenster auf Ihrer Website gesperrt, einschließlich Speichern. Mehr unter Team und Rollen.

Schnittstelle

Die Regeln stehen beim Assistenten im Feld widget_outreach_rules und werden mit dem Assistenten gelesen und geändert. Antworten tragen sie unter widget.outreach_rules. Fehlt das Feld in einer Änderung, bleiben die Regeln, wie sie sind; null oder [] löscht sie. Allgemeines unter API: Wissen und Assistenten und API-Grenzen.

{
  "widget_outreach_rules": [
    { "ereignis": "tiefe", "wert": 60, "pfad": "/preise", "text": "Fragen zu den Paketen? Ich helfe gern." },
    { "ereignis": "ausstieg", "wert": 0, "pfad": "", "text": "Bevor Sie gehen: Kann ich noch etwas beantworten?" },
    { "ereignis": "zeit", "wert": 45, "pfad": "", "text": "Suchen Sie etwas Bestimmtes?" }
  ]
}

In diesem Beispiel spricht auf /preise die erste Regel, sobald 60 Prozent gelesen sind, sofern nicht vorher der Mauszeiger die Seite verlässt oder 45 Sekunden vergehen. Auf allen anderen Seiten entscheiden Verlassen und Zeit.

Weiterlesen

• Widget-Einstellungen: Titel, Farbe, Platz und Größe des Chatfensters
• Widget einbauen
• Script-Attribute, darunter data-einwilligung
• JavaScript und Speicher
• Einwilligung und Besucherrechte
• Darstellung und Bedienung
• Gespräch im Widget
• Auslieferung des Widgets

Häufige Fragen