SHOPWARE Integrationsanleitung

Mit dem uptain-Plugin erreichen Sie die bestmöglichen Ergebnisse mit dem geringsten Aufwand. Mit nur wenigen Klicks ist das Plugin integriert und in Ihrem Online-Shop startklar. Folgen Sie dazu einfach den angegebenen Schritten.

Falls Sie dennoch Fragen haben sollten, schreiben Sie bitte eine E-Mail an support@uptain.de.

Hier finden Sie das Plugin im Store von Shopware: Zum Plugin

Falls Sie noch keinen Account bei uptain haben, können Sie sich hier registrieren: Account erstellen

Schritt-für-Schritt Anleitung

LOGIN

Loggen Sie sich in den Backend-Bereich Ihres Shopware-Systems ein und navigieren Sie über die Einstellungen in den Pluginmanager.

PLUGIN HERUNTERLADEN

Laden Sie im zweiten Schritt das Conversion Plugin von uptain im Shopware Store herunter. Nach dem erfolgreichen Download navigieren Sie zunächst in den Bereich der installierten Plugins Installiert und wählen Sie anschließend das Conversion Plugin uptain-Connect aus.

PLUGIN AKTIVIEREN

Nach dem erfolgreichen Download des Conversion Plugins uptain-Connect finden Sie das uptain-Plugin zunächst im Bereich “Meine Einkäufe”. Klicken Sie nun auf das Symbol “Plugin herunterladen”.

Navigieren Sie anschließend erneut in den Bereich Installiert und aktivieren Sie das Plugin durch einen Klick auf das +.

PLUGIN KONFIGURIEREN

Im selben Fenster finden Sie die Konfigurationsmöglichkeiten. In diesem Schritt geben Sie bitte in der Konfiguration Ihre persönliche uptain-ID ein, die Ihnen vorab per E-Mail zugeschickt wurde. Diese besteht aus 16 zufälligen Zeichen.

Anschließend geben Sie bitte an, welche E-Mail Daten an uptain übermittelt werden sollen. Bei der Auswahl von Ja entscheiden Sie sich für die Übermittlung der personenbezogenen Daten Ihrer Besucher an uptain, bei Nein entsprechend dagegen.

Wählen Sie “Ja” bei der Option “Bestandskunden-Mailadressen übergeben” für die Übermittlung der personenbezogenen Daten Ihrer Bestandskunden, wenn die Anforderungen aus dem Paragraphen § 7 UWG Abs. 3 erfüllt sind.

Wählen Sie “Ja” bei der Option “Newsletterabonennten-Mailadressen übergeben” für die Übermittlung der personenbezogenen Daten Ihrer Newsletter-Abonnenten, wenn Sie ein passendes Double Opt-In vorweisen können.

Bei Auswahl der Option “Vererbt” handelt es sich um eine Einstellung, die getätigt werden kann, wenn Sie Subshop(s) verwenden und die Einstellungen des Hauptshops übernehmen möchten.

Wählen Sie “Ja” bei der Option “Kundenumsatz übergeben” für die Übermittlung des finalen Warenkorbwertes des Kunden.

Wählen Sie “Ja” bei der Option “ID zur Warenkorbherstellung übergeben” für die Übermittlung der ID zur Warenkorbwiederherstellung. Kunden haben damit die Möglichkeit geräteübergreifend ihren Warenkorb wiederherstellen zu können.

Bei “uptain Cookies initial blockieren” haben Sie folgende Möglichkeiten:

Nein: das uptain-Plugin wird direkt integriert und ist für Sie aktiv
Ja: das uptain-Plugin wird zunächst blockiert und
1. Sie nutzen das Shopware Cookiebanner: das uptain-Plugin wird erst aktiviert, wenn der User die Cookies akzeptiert
2. Sie nutzen ein anderes Cookiebanner: Sie können das uptain-Plugin mit folgendem Javascript-Snippet steuern (die genaue Konfiguration hängt von Ihrem Cookie-Tool ab): window.enableUptain()

SPEICHERN

Abschließend speichern Sie bitte alle vorgenommenen Einstellungen durch einen Klick auf Speichern. Sie finden das Conversion Plugin von uptain nach erfolgreicher Installation im Bereich der installierten Plugins wieder.

OPTIONALE PARAMETER

Sofern Sie uptain für gewisse Kundengruppen optimieren bzw. restriktieren möchten, können Sie die von Shopware erstellten Kundengruppen in Ihrem persönlichen Login-Bereich in den Bedingungen verwenden. Die Kürzel der Kundengruppen finden Sie in Ihrem Shopware Backend unter "Einstellungen" >> "Grundeinstellungen" >> Shopeinstellungen >> "Kundengruppen".

Sie haben das uptain-Plugin nun erfolgreich integriert!

Abweichende Consentmanager

Falls Sie nicht das von Shopware vorgegebene Cookie-Tool (Consentmanager) nutzen, müsste vom Tool grundsätzlich dieses Script angestoßen werden, um das Plugin zu aktivieren:

<script>
const scriptElement = document.getElementById("uptainJSSnippet");
if(scriptElement.type == 'text/plain') {
    const scriptEl = document.createElement("script");
    scriptEl.setAttribute("src", scriptElement.getAttribute("data-src"));
    document.body.appendChild(scriptEl);
    scriptElement.remove();
}
</script>

Usercentrics:

<script type="text/plain" data-usercentrics="Uptain">
const scriptElement = document.getElementById("uptainJSSnippet");
if(scriptElement.type == 'text/plain') {
    const scriptEl = document.createElement("script");
    scriptEl.setAttribute("src", scriptElement.getAttribute("data-src"));
    document.body.appendChild(scriptEl);
    scriptElement.remove();
}
</script>

Aktivieren Sie bitte zusätzliche die Option “Initially block cookies” in den Plugin-Einstellungen.