Die Werbekarte im Chat

Mit der Werbekarte zeigen Sie im Chatfenster ein eigenes Angebot – typischerweise Ihren Bezahltarif. Die Karte besteht aus einem Bild, einer Überschrift, einem kurzen Text, einem großen Knopf und einem Textlink darunter. Sie steht oben im Gespräch, auf der Startseite des Chats oder an beiden Stellen.

Die Karte ist keine Nachricht: Sie erscheint nicht im Gesprächsverlauf, den Ihr Team sieht, und Besucher können sie nicht wegklicken. Knopf und Textlink öffnen ihr Ziel in einem neuen Tab.

Einrichten

Sie finden die Werbekarte im Konto unter Projekt → Aussehen → Werbekarte. Die Chat-Vorschau auf dieser Seite zeigt die Karte, während Sie tippen.

• Überschrift – Pflicht, höchstens 80 Zeichen.
• Text darunter – optional, höchstens 200 Zeichen.
• Bild – optional, eine Adresse mit https://. Ohne Bild bleibt die Karte rein textlich.
• Knopftext – Pflicht, höchstens 40 Zeichen, zum Beispiel „30 Tage gratis testen“.
• Knopfziel – Pflicht, die Seite, auf die der Knopf führt.
• Textlink – optional, höchstens 60 Zeichen, zum Beispiel „Alle Tarife ansehen“. Mit Textlink ist auch ein Linkziel Pflicht. Einen Pfeil am Ende ergänzt das Widget selbst.
• Eigene Farbe für Knopf und Akzent – ohne Haken nimmt die Karte Ihre Markenfarbe. Die Schrift auf dem Knopf wird automatisch hell oder dunkel gesetzt, damit sie lesbar bleibt.
• Wo die Karte steht – „Im Gespräch, oben im Verlauf“ und/oder „Auf der Startseite“. Die Startseite muss dafür eingeschaltet sein.
• Wem sie gezeigt wird – allen Besuchern oder nur Besuchern, die nicht identifiziert sind (siehe unten).

Verwenden Sie für Knopfziel und Linkziel Adressen mit https://. Das Widget zeigt Knopf und Textlink nur mit einem https-Ziel an.

Einschalten lässt sich die Karte nur vollständig: mit Überschrift, Knopftext, Knopfziel und mindestens einem Ort. Fehlt etwas, wird sie als Entwurf gespeichert, und das Konto nennt die fehlende Angabe.

Die Texte gelten in der Standardsprache des Projekts. Nach dem Speichern dauert es bis zu einer Minute, bis Ihre Besucher die Änderung sehen.

Zahlenden Kunden die Karte nicht zeigen

Wer schon bezahlt, braucht keine Werbung für den Bezahltarif. reactive.chat kennt den Tarif Ihrer Nutzer nicht – Ihre Seite schon. Dafür gibt es drei Wege.

1. Zielgruppe „Nur Besuchern, die nicht identifiziert sind“. Meldet Ihre Seite angemeldete Nutzer ohnehin mit ReactiveChat('identify', …) an (mit userId oder email), sehen diese Nutzer die Karte nicht mehr. Das genügt, wenn bei Ihnen nur zahlende Kunden ein Login haben.

2. Eine Zeile in Ihrem Seitenskript, sobald Sie wissen, dass der Nutzer zahlt:

ReactiveChat('promo', false);

Läuft diese Zeile womöglich, bevor der Einbindungsschnipsel geladen ist, setzen Sie davor:

window.ReactiveChat = window.ReactiveChat || function () { (window.ReactiveChat.q = window.ReactiveChat.q || []).push(arguments); };

3. Ein Attribut am Einbindungsschnipsel, wenn Ihr Server die Seite für zahlende Kunden ohnehin anders ausliefert:

<script src="https://cdn.reactive.chat/loader.js"
        data-rc-site-key="SITE_KEY"
        data-rc-promo="false"
        async></script>

Beide Abschalter gelten nur für die Seite, auf der sie stehen, und nur für diesen Seitenaufruf. Mit ReactiveChat('promo', true) zeigen Sie die Karte wieder so, wie sie im Konto eingestellt ist.

Die Karte je Seite anpassen

Statt true oder false können Sie ein Objekt übergeben. Seine Felder ersetzen auf dieser Seite die Einstellungen aus dem Konto; was Sie nicht angeben, kommt aus dem Konto.

ReactiveChat('promo', {
  titel: 'Jahrestarif: 2 Monate geschenkt',
  knopf: 'Jetzt wechseln',
  ziel: 'https://www.ihre-domain.de/preise?jahr=1'
});

Die Feldnamen sind dieselben wie im Konto:

• titel – Überschrift (höchstens 80 Zeichen),
• text – Text darunter (höchstens 200 Zeichen),
• bild – Bildadresse mit https://,
• knopf und ziel – Knopftext (höchstens 40 Zeichen) und Knopfziel,
• link_text und link_ziel – Textlink (höchstens 60 Zeichen) und sein Ziel,
• farbe – eigene Farbe als #rrggbb,
• orte – eine Liste aus "gespraech" und "start"; ohne Angabe gilt ["gespraech"], wenn auch im Konto nichts eingestellt ist,
• zielgruppe – "alle" oder "anonym".

Texte können Sie auch je Sprache angeben, zum Beispiel titel: { de: 'Jahrestarif', en: 'Annual plan' }. Längere Texte werden gekürzt.

Ein Objekt zeigt die Karte auf dieser Seite auch dann, wenn sie im Konto ausgeschaltet ist. Geben Sie in diesem Fall alles selbst an: mindestens titel, für einen Knopf außerdem knopf und ziel.

Einblendungen und Klicks

Im Konto steht unter der Werbekarte der Abschnitt Wirkung: Einblendungen, Klicks auf Knopf und Textlink sowie die Klickrate, zusammengefasst für die letzten 7 und 30 Tage und je Tag. Gezählt wird je Besucher und Tag höchstens eine Einblendung je Ort und ein Klick je Ziel. Ihre Vorschau im Konto zählt nicht mit, ebenso wenig eine Karte, die nur per ReactiveChat('promo', {...}) eingeblendet wird, während sie im Konto ausgeschaltet ist.

Ereignisse für Ihre eigene Auswertung

Zusätzlich melden zwei Ereignisse in Ihrem Seitenskript, was mit der Karte geschieht – zum Beispiel, um sie an Ihr eigenes Analysewerkzeug weiterzugeben.

ReactiveChat('on', 'promo:shown', function (e) {
  // e.ort: "gespraech" oder "start"
});

ReactiveChat('on', 'promo:click', function (e) {
  // e.ziel: "knopf" oder "link", e.ort: "gespraech" oder "start"
});

promo:shown kommt einmal je Ort und Seitenaufruf, und zwar erst, wenn das Chatfenster offen ist und die Karte darin steht. Eine Karte in einem geschlossenen Chat hat niemand gesehen. promo:click kommt bei jedem Klick auf Knopf oder Textlink.

Wenn die Karte nicht erscheint

• Ist sie eingeschaltet? Eine unvollständige Karte bleibt ein Entwurf.
• Bis zu einer Minute vergeht nach dem Speichern, bis Besucher die Änderung sehen.
• Ort „Startseite“: Ist die Startseite des Chats eingeschaltet?
• Zielgruppe „nicht identifiziert“: Meldet Ihre Seite den Besucher mit ReactiveChat('identify', …) an, sieht er die Karte nicht.
• Abgeschaltet auf dieser Seite? Suchen Sie nach data-rc-promo="false" am Schnipsel und nach ReactiveChat('promo', false) in Ihren Skripten.
• Knopf oder Textlink fehlen: Das Ziel beginnt nicht mit https://.

Wie Sie den Chat über einen eigenen Link oder Knopf Ihrer Seite öffnen, steht unter Chat über einen eigenen Link oder Knopf öffnen. Die Grundlagen der Einbindung beschreibt Das Widget einbinden.