Dieser Artikel richtet sich in erster Linie an fortgeschrittene JavaScript-Entwickler, die einen Tracking-Code für einen mobilen Shop von Shopgate erstellen oder anpassen möchten.
Grundlegende Informationen zur Konvertierung und Einbettung eines vorhandenen Tracking-Codes finden Sie in diesem Artikel.

Erste Schritte

Das Custom-Tracking-Code-System von Shopgate basiert auf JavaScript und verfügt über mehr als 150 vordefinierte Variablen. Mit diesen Variablen können Sie unterschiedlichstes Kundenverhalten von der mobilen Website und den Apps von Shopgate tracken.

Beispielcode

Hier ist ein Beispiel eines Tracking-Codes von Facebook. Die Shopgate Variablen sind gelb gekennzeichnet.

// Facebook Tracking Code zur Conversion Rate

var cart_items_amount_net = sgData.order.amount.net - sgData.order.shipping.amount.net - sgData.order.payment.amount.net;

(function() {
 var _fbq = window._fbq || (window._fbq = []);
 if (!_fbq.loaded) {
 var fbds = document.createElement('script');
 fbds.async = true;
 fbds.src = '//connect.facebook.net/en_US/fbds.js';
 var s = document.getElementsByTagName('script')[0];
 s.parentNode.insertBefore(fbds, s);
 _fbq.loaded = true;
 }
})();
window._fbq = window._fbq || [];
window._fbq.push(['track', 'xxxx_your_id_xxxx', {'value':cart_items_amount_net,'currency': sgData.order.amount.currency}]);

In diesem Beispiel werden folgende Shopgate-Variablen genutzt:

Klicken Sie hier für eine detaillierte Liste aller verfügbaren Variablen.

Verfügbare Plattformen & Seiten

Einige der Shopgate-Variablen sind für alle Seiten verfügbar, die Mehrheit der Variablen wurde jedoch für spezielle Seiten erstellt. Alle Variablen können sowohl auf der mobilen Seite als auch auf den nativen Apps angewendet werden. Zum Beispiel:

• sgData.device: Verfügbar für jede Seite Ihrer Apps und für die mobile Seite.
• sgData.cart.products[].uid: Ausschließlich für die Seite "Warenkorb" in Ihren Apps und in der mobilen Seite verfügbar.

In der Übersicht sehen Sie alle verfügbaren Plattformen und Seiten. Hier finden Sie die für diese Seiten verfügbaren Variablen.

Custom Tracking Code bei Shopgate einbinden

Um einen Custom-Tracking-Code in Ihre Apps und mobile Website einzubinden, folgen Sie den nächsten Schritten:

1. Loggen Sie sich in Ihren Shopgate-Adminbereich ein. Klicken Sie in der Menüleiste auf Einstellungen und wählen Sie dann Tracking-Tools aus.
2. Gehen Sie zum Bereich Tracking-Codes, wählen Sie eine Plattform sowie eine Seite, auf der dieser Code eingesetzt werden soll, und klicken Sie auf +Hinzufügen.
   Eine Liste der verfügbaren Plattformen und Seiten finden Sie hier.
3. Ein leeres Script-Editor-Fenster öffnet sich. Geben Sie Ihren Tracking-Code in das Fenster ein und klicken Sie anschließend auf Speichern.
   ☞ Nutzen Sie den Shortcut CTRL+Space, um eine Liste der Variablen zu sehen, die auf dieser Seite verfügbar sind.
   

Das war's auch schon! Falls Sie einen weiteren Code eingeben wollen, wiederholen Sie einfach die vorherigen Schritte.

Tracking-Variablen

In diesem Kapitel finden Sie alle Details über die vordefinierten Tracking-Variablen.

Tracking-Events

Abgesehen von den oben aufgelisteten Tracking-Variablen, gibt es vier vordefinierte Tracking-Events. Zum Beispiel:

in jQuery

$(document).on('sgAddToCart', function(e) {
console.log(e.originalEvent.detail);
});

in Vanilla JS

document.addEventListener('sgAddToCart', function(e) {
console.log(e.detail);
});

In den Beispielen sorgt das Event "sgAddToCart" dafür, dass nützliche Informationen getrackt werden, nachdem der "Add To Cart"-Button eines bestimmten Produktes gedrückt wird.

Weitere Informationen über die verfügbaren Events finden Sie in der folgenden Tabelle:

Frequently Asked Questions

Warum ist in <noscript> Tags kein Code notwendig?

Ihr Code-Snippet innerhalb der <noscript>...</noscript> Tags wird als Ersatzfunktion genutzt, falls JavaScript nicht verfügbar ist. Trotzdem ist JavaScript für ALLE Systeme bei Shopgate erforderlich. Deshalb müssen Sie keinen <noscript> Ersatzcode hinterlegen.

Wie kann ich doppelte Tracking-Codes vermeiden? 

Das Tracking-Code-System bei Shopgate ist so entwickelt, dass alle Tracking-Codes verfolgt werden. Das schließt auch jene Codes ein, die mehr als einmal für eine Seite auf einer Plattform hinterlegt wurden. Tracking-Codes "für alle Seiten" werden zusätzlich zu den seitenspezifischen Codes verfolgt. Deshalb ist es empfehlenswert, Ihre Tracking-Codes sorgfältig auf diese Kriterien zu prüfen:

• Haben Sie einen Code-Abschnitt mehr als einmal eingefügt (manuell, kopiert)?
• Wenn Sie mehr als einen Zugang für eine Seite auf derselben Plattform eingegeben haben, wurde die Tracking-Funktion dementsprechend in mehreren Zugängen eingegeben?
• Wenn Sie einen Tracking-Code für "Alle Seiten" eingerichtet haben, wurde dadurch dieser Tracking-Code von allen anderen Zugängen entfernt?

Wie kann ein Tracking-Pixel erstellt werden?

Um ein Tracking-Pixel zu erstellen oder zu ändern, können Sie sich am folgenden Beispiel orientieren. Möchten Sie Parameter wie die Kunden-E-Mail-Adresse, Telefonnummer etc. zu dem Pixel hinzufügen, nutzen Sie "?" und die verfügbaren Variablen (gelb gekennzeichnet):

var image = document.createElement('img');
image.height = '1';
image.width = '1';
image.style = 'border-style:none;';
imgtag.alt = '';
image.src = 'http://yourdomain.com/pixel.png?email='+sgData.user.email+'&phone='+sgData.user.phone;
document.getElementsByTagName('body')[0].appendChild(image);

Klicken Sie hier für eine Liste mit allen vorhandenen Variablen.

Anmerkung:

Für Connect nur verfügbar, wenn ein Classic Checkout verwendet wird.