Weitere Parameter für die manuelle Integration

Übermittlung von weiteren Daten

Damit Sie alle Funktionen von uptain nutzen können, übermitteln Sie bitte noch weitere Session-Daten:

Warenkorbwert	data-scv=”{{0 oder Warenkorbwert}}”
Bestellnummer	data-ordernumber=”{{Bestellnummer}}”
Erfolgreich bestellt	data-success=”{{1 oder 0}}”

Kundengruppe	data-customergroup=”{{Kundengruppe}}”
Verwendete Gutscheincode	data-usedvoucher=”{{Gutscheincode}}”
Kundenumsatz	data-revenue=”{{Kundenumsatz}}”

Sowie personenbezogene Daten für eine individualisierte Ansprache:

E-Mail	data-email=”{{E-Mail}}”
Titel	data-title=”{{Titel}}”
Vorname	data-firstname=”{{Vorname}}”
Nachname	data-lastname=”{{Nachname}}”
Geschlecht	data-gender=”{{Geschlecht}}”

Achten Sie dabei jedoch darauf, dass Sie nur E-Mail-Adressen und andere personenbezogene Daten übermitteln, bei denen Sie ein passendes Double Opt-In vorweisen oder Sie sicherstellen können, dass die jeweilige E-Mail des Besuchers die Anforderungen aus dem Paragraphen § 7 UWG Abs. 3 erfüllt. Sollte dies nicht gegeben sein oder möchten Sie für bestimmte Benutzer keine Aktivitäten von uptain durchführen, lassen Sie die Variable data-email einfach leer.

Darüber hinaus können Sie für den erweiterten Funktionsumfang weitere optionale Parameter übergeben, sofern dies gewünscht ist:

DIV-Tag für die Übermittlung der weiteren Daten

Bitte integrieren Sie folgendes DIV-Tag an der selben Stelle wie das Snippet und am besten direkt dahinter. Beachten Sie den folgenden Hinweis.

<div 
  id="__up_data_qp" 
    data-scv=”{{Warenkorbwert}}"
    data-ordernumber=”{{Bestellnummer}}"
    data-success=”{{1 oder 0}}"
    data-email="{{E-Mail}}" 
    data-firstname=”{{Vorname}}"
    data-lastname=”{{Nachname}}"
    data-usedvoucher=”{{Gutscheincode}}"
    data-customergroup=”{{Kundengruppe}}"
    data-revenue="{{Kundenumsatz}}"
    data-gender="{{Geschlecht}}"
    data-title="{{Titel}}"
  > 
</div>

Bei jedem Seitenaufruf wird das eingebettete JavaScript-Snippet ausgeführt und übermittelt alle im HTML-Tag bereitgestellten Daten. Allerdings müssen einige Daten zum Uptain übertragen werden, ohne dass eine neue Seite geladen werden muss, während der Benutzer auf derselben Seite bleibt. Beispielsweise bei Single Page Applications oder, wenn etwas in den Warenkorb gelegt wurde und die Seite nicht neu geladen wird oder die Produkte einer Kategorie oder einer Suchergebnisseite asynchron geladen werden.

Nachdem die aktualisierten Daten in das HTML-Tag geschrieben wurden, muss eine JavaScript-Funktion ausgeführt werden, um die Übertragung der Daten an uptain zu initiieren. In diesem Fall sollte folgende Funktion ausgeführt werden:

window._upEventBus.publish("uptain.readData");

An die Stelle der Werte in geschliffenen Klammern wie z.B. {{Warenkorbwert}} fügen Sie bitte die entsprechende Variable aus Ihrem Shop ein. Wie die entsprechende Variable in Ihrem Shop heißt, entnehmen Sie bitte aus der zugehörigen Dokumentation.

Erläuterungen zu den Variablen

data-scv

Hier übergeben Sie uns den aktuellen Warenkorbwert einer Session. Wenn der Kunde nichts im Warenkorb hat, übergeben Sie bitte die Zahl 0. Sobald der Kunde ein Produkt im Wert von z.B. 100 € legt, sollte “100.00” in der Variable stehen.

Bitte achten Sie darauf, dass auf der Dankesseite der Warenkorbwert erhalten bleibt oder als finaler Bestellwert übergeben wird. Auf der Dankesseite darf nicht “0.00” oder ein leerer Wert übergeben werden.

data-ordernumber

Hier übergeben Sie uns die jeweilige Bestellnummer nach erfolgreicher Bestellung. Dieser Wert darf nur auf der Dankesseite (Seite, auf der ein Kunde nach erfolgreicher Bestellung landet) übergeben werden.

data-success

Hier informieren Sie uns darüber, dass eine Bestellung erfolgreich durchgeführt wurde. Dieser Wert darf ebenfalls nur auf der Dankesseite mit 1 übergeben werden. Ansonsten übergeben Sie bitte eine 0 oder lassen den Wert leer.

data-email

Hier übergeben Sie uns die E-Mail-Adresse des eingeloggten Kunden. Beachten Sie bitte den Hinweis auf Datenschutz von oben.

data-firstname

Hier übergeben Sie uns den Vornamen des eingeloggten Kunden. Beachten Sie bitte den Hinweis auf Datenschutz von oben.

data-lastname

Hier übergeben Sie uns den Nachnamen des eingeloggten Kunden. Beachten Sie bitte den Hinweis auf Datenschutz von oben.

data-title

Als Freitext kann hier der Titel der Anrede (z.B. Dr. oder Prof.) Ihrer Webseitenbesucher übergeben werden.

data-gender

Sie können die Geschlechter Ihrer Webseitenbesucher übergeben. Wählen Sie zwischen m für männlich oder f für weiblich und lassen Sie das Feld für divers bitte leer.

data-customergroup

Sie können die in Ihrem Backend angelegten Kundengruppen übergeben.

data-revenue

Übergeben Sie uns den Kundenumsatz als Zahl und verwenden Sie dabei nur einen Punkt als Trennzeichen und nur und immer zwei Nachkommastellen.

data-usedvoucher

Übergeben Sie hier bitte den eingelösten Gutschein-Code spätestens auf der Dankesseite. Es ist wichtig, dass der tatsächlich eingegebene Gutschein übergeben wird und nicht eine interne Bezeichnung oder ähnliches. Achten Sie bitte auch auf die Groß- und Kleinschreibung.

Denken Sie bitte immer daran die Funktionalitäten selbständig zu testen, soweit es Ihnen möglich ist.