Installation – Sovendus Optimize

Table Of Contents

Schritt 1:Conversion Tracking
Schritt 2: Script für Verhaltensanalyse
Warenkorbabbrecher Tracking

Schritt 1:Conversion Tracking

Variante 1 (ohne Basket Tracking):

Nachfolgendes Tracking muss fix auf der Bestellabschluss-Seite im Shop integriert werden. Das Tracking dient dazu, die durch Sovendus Optimize vermittelten Transaktionen zu tracken und im Dashboard abzubilden.

<script async src="https://www.sovopt.com/OPTIMIZE_ID/conversion/?ordervalue=XXX&ordernumber=XXX&vouchercode=XXX&email=XXX&subtext=XXX"></script>

Parameter	Beschreibung	Wert	Pflicht
OPTIMIZE_ID	Eindeutige Kunden ID	OPTIMIZE_ID	X
ordervalue	Gesamtwert der Bestellung (z.B. 243.30)	Dynamisch	X
ordernumber	Bestellnummer	Dynamisch	X
vouchercode	Gutscheincode Dieser Parameter ist nur in Zusammenhang mit dem Gutscheincode-Tracking Pflicht.	Dynamisch	X
email	E-Mail-Adresse des Kunden	Dynamisch
subtext	selbst definierbares Feld, um zusätzliche Infos zur Bestellung zu übermitteln	Dynamisch

Die Werte wie ordervalue, ordernumber und vouchercode müssen durch die effektiven Werte mittels Variablen ersetzt werden. Der Bestellwert muss dabei mit einem Punkt getrennt übermittelt werden: Bsp. 50.00

Beim Vouchercode muss der jeweils eingelöste Gutscheincode übergeben werden. Falls bei einer Bestellung kein Gutscheincode eingelöst wird, so kann die Variable leer bleiben und es muss nichts übergeben werden.

Variante 2 (mit Basket Tracking):

Falls Kampagnen auf Basis der gekauften Produkte geschaltet werden möchten muss das Basket Tracking auf der Bestellabschluss-Seite im Shop integriert werden. Die Variablen gekennzeichnet durch %Variable% müssen durch die Werte der jeweiligen Bestellung ersetzt werden. Damit die Funktion gb_send zur Verfügung steht muss vorgängig das Script für Verhaltensanalyse gefeuert werden.

gb_send("event", "purchase", {
	order: {
		id: "%OrderNumber%",
		revenue: "%OrderValue%",
	},
	products: [
		{
			id: "%productId%",
			name: " %productName%",
			price: "%productPrice%",
			quantity: "%productQuantity%",
			category: "%productCategory%",
			brand: "%productBrand%",
		}, ...
	],
});

Schritt 2: Script für Verhaltensanalyse

Damit wir Ihre Werbemassnahme zum richtigen Zeitpunkt ausspielen können, muss nachfolgendes Script-Tag auf jeder Seite (einschliesslich der Checkoutseite) integriert werden.

<script async src="https://www.sovopt.com/OPTIMIZE_ID"></script>

Warenkorbabbrecher Tracking

Für die Verwendung von Warenkorbabbrecher-Funktionen, können Sie uns beim hinzufügen und entfernen von Produkten zum Warenkorb den Inhalt wie folgt übermitteln. Die Events add_to_cart und remove_from_cart dürfen lediglich die Werte des veränderten Produkts beinhalten.

Bei der nachfolgenden Implementation für die Erkennung, der sich im Warenkorb befindenden Produkte, handelt es sich um die von uns empfohlene Variante. Sollte diese Implementation bei Ihnen nicht möglich sein, bietet Sovendus Optimize auch die Möglichkeit die Produkte automatisch auszulesen. Falls Sie daran interessiert sind, wenden Sie sich bitte an Ihren Account Manager.

Event: Add to Cart

Dieser Event muss immer dann gefeuert werden, wenn ein Produkt zum Warenkorb hinzugefügt wird.

gb_send('event', 'add_to_cart', {
  'id': %ProductId%,
  'name': %ProductName%,
  'price': %ProductPrice%, 
  'quantity': %Quantity%,
  'url': %ProductDetailUrl%,
  'image': %ProductImage%,
  'additionalKey': %additionalValue%
});

// Beispiel
gb_send('event', 'add_to_cart', {
  'id': 546,
  'name': 'T-Shirt blue',
  'price': 54.50, 
  'quantity': 1,
  'url': 'https://example-shop.com/t-shirt-blue',
  'image': 'https://example-shop.com/t-shirt-blue.jpg',
  'description': 'A blue v-neck t-shirt'
});

Parameter	Beschreibung	Wert	Pflicht
id	Eindeutige Produkt ID (z.B. EAN)	Integer	X
name	Produkt Name	String	X
price	Produkt Preis	String	X
quantity	Anzahl der Produkte die zum Warenkorb hinzugefügt werden	Integer	X
url	Link zur Produktdetailseite	String	X
image	Link zum Produktbild	String	X
additionalKey	Es können beliebig weitere Key / Value Einträge hinzugefügt werden. Diese Informationen können danach z.B. im Warenkorbabbrecher E-Mail verwendet werden	Integer/String

Event: Remove from Cart

Wird ein Produkt aus dem Warenkorb entfernt, muss der remove_from_cart Event gefeuert werden. Bei diesem Event benötigt es jedoch nur die Werte id und quantity.

gb_send('event', 'remove_from_cart', {
  'id': %ProductId%,
  'quantity': %Quantity%
});

// Beispiel
gb_send('event', 'remove_from_cart', {
  'id': 546,
  'quantity': 2
});

Event: Update Cart

Mit dem update_cart Event kann der aktuelle Stand des Warenkorbs übermittelt werden. Dadurch wird der aktuelle Stand des Warenkorbs in Sovendus Optimize überschrieben.

gb_send('event', 'update_cart', [
    {
      'id': %ProductId%,
      'name': %ProductName%,
      'price': %ProductPrice%, 
      'quantity': %Quantity%,
      'url': %ProductDetailUrl%,
      'image': %ProductImage%,
      'additionalKey': %additionalValue%
    },
    {
      'id': %ProductId%,
      'name': %ProductName%,
      'price': %ProductPrice%,
      'quantity': %ProductQuantity%
      'url': %ProductDetailUrl%,
      'image': %ProductImage%,
      'additionalKey': %additionalValue%
    }
]);


// Bespiel
gb_send('event', 'update_cart', [
  {
    'id': 546,
    'name': 'T-Shirt blue',
    'price': 54.50, 
    'quantity': 1,
    'url': 'https://example-shop.com/t-shirt-blue',
    'image': 'https://example-shop.com/t-shirt-blue.jpg',
    'description': 'A blue v-neck t-shirt'
  }, 
  {
    'id': 547,
    'name': 'Pants blue',
    'price': 20.00, 
    'quantity': 2,
    'url': 'https://example-shop.com/pants-blue',
    'image': 'https://example-shop.com/pants-blue.jpg',
    'description': 'Blue pants'
  }
]);