Um sich in unser System zu integrieren, müssen Sie unsere Skripte in Ihrem Shop implementieren. Sie werden verwendet, um Transaktionen korrekt zu registrieren und Provisionen an die entsprechenden Partner zu berechnen.

Die Transaktionsregistrierung betrifft nur Transaktionen, die über die Weiterleitung des 100shoppers-Plugins ausgeführt werden.

1. Skript Data Loader

Dieses Skript sollte in der Kopfzeile jeder Webseite des Shops platziert werden. Es ist verantwortlich für die Erkennung der Parameter, die im Rahmen der Widget-Umleitung übertragen werden, und für das Setzen eines Cookies, das später die Verknüpfung der Transaktion mit dem Dienst ermöglicht, von dem der Nutzer umgeleitet wurde.

Script for foreign markets

<script type="text/javascript">
"use strict";(function(scriptUrl,campaignId){if(!window.bb){window.bb=function(){
for(var _len=arguments.length,params=Array(_len),_key=0;_key<_len;_key++){
params[_key]=arguments[_key]}return window.bb.q.push(params)};window.bb.q=[]
;window.bb.campaignId=campaignId;var script=document.createElement("script")
;var firstScript=document.getElementsByTagName("script")[0];script.async=true
;script.src=scriptUrl;firstScript.parentNode.insertBefore(script,firstScript)}
})("https://shop-{sufix-country}.100shoppers.com/js/bb-shop.min.js", {your-shop-ID},1);
</script>

Script for Polish markets

<script type="text/javascript">
"use strict";(function(scriptUrl,campaignId){if(!window.bb){window.bb=function(){
for(var _len=arguments.length,params=Array(_len),_key=0;_key<_len;_key++){
params[_key]=arguments[_key]}return window.bb.q.push(params)};window.bb.q=[]
;window.bb.campaignId=campaignId;var script=document.createElement("script")
;var firstScript=document.getElementsByTagName("script")[0];script.async=true
;script.src=scriptUrl;firstScript.parentNode.insertBefore(script,firstScript)}
})("https://shop-js.buybox.click/js/bb-shop.min.js", {your-shop-ID},1);
</script>

Cookies

Nach der Platzierung auf der Website des Shops und dem Wechsel von 100Shoppers.com zum Shop sollten unter den Cookies im Browser diejenigen mit dem Namen:

  • bbuuid, bb_session_track i bb_track.

Diese parameter:

  • {your-shop-ID} es ist eine eindeutige Shop-Kennung, die Sie vom 100SHOPPERS-Manager erhalten
  • {sufix-country} es ist das Suffix Ihres Landes, z.B.: de, lt, fr.

2. Skript für die Produktanzeige

Dies ist ein Skript, das uns die Anzeige einer bestimmten Produktwebseite meldet. Das Skript sollte auf jeder Produktwebseite platziert werden.

<script type="text/javascript">
  bb("productView", { "productId": "{your-product-id}" })
</script>

Diese parameter:

  • {your-product-ID} ist die Produktkennung, die mit der Angebots-ID übereinstimmt, die uns in der XML-Datei übergeben wurde.

3. Skript für Auftrags-/Transaktionsberichte

Dies ist das Skript, das uns über die Bestellung / Transaktion informiert, zusammen mit den Informationen über die bestellten Produkte und die Abrechnungsdetails (Provisionen). Es sollte auf der Bestellbestätigungsseite (die letzte Seite des Kaufprozesses) platziert werden.

<script type="text/javascript">
bb("order", { "orderId": "{your-order-id}", "products": [
   { "productId": "{your-product-id}", "quantity": {item-quantity}, "commissionId": {your-commission-id}, "gross": {item-gross-price}},
   ...
   { "productId": "{your-product-id}", "quantity": {item-quantity}, "commissionId": {your-commission-id}, "gross": {item-gross-price}}
]});
</script>

Diese parameter:

  • {Ihre-Bestell-ID} ist die Bestell-/Transaktions-ID im Shop
  • {Ihre-Produkt-ID} ist die Produkt-ID, die mit der Angebots-ID übereinstimmt, die uns in der XML-Datei übergeben wurde
  • {Stückzahl} ist die Menge der bestellten Produkte
  • {produkt-brutto-preis} ist der Bruttopreis, zu dem das jeweilige Produkt bestellt wurde
  • {ihre-kommission-id} ist die Kennung der Provision, die für den Verkauf eines bestimmten Produkts berechnet wird.

die Provisionskennungen werden im Panel generiert. Ihre Provisionskennung wird Ihnen von unserem Vertreter mitgeteilt. Die Provision ist "0" für Onlineshop, die auf den Websites der Hersteller angezeigt werden.

Achtung

  • Alle Skripte müssen auf Webseiten innerhalb der gleichen Domain funktionieren.
  • Das Skript kann sicher zu jeder Transaktion hinzugefügt werden - bevor eine Bestellung registriert wird, prüft das Skript, ob der Benutzer von unserem Widget kommt (prüft, ob die richtigen Cookies gesetzt sind).
  • Wir verwenden eine Methode zum asynchronen Laden von JavaScript, die die Ladezeit Ihrer Seite in keiner Weise beeinträchtigt.

Bei Abrechnungen nach Nettobeträgen ist in den Shop-Einstellungen das entsprechende Flag zu setzen und in der Bestellung z.B. ein zusätzlicher Parameter "netto" hinzuzufügen:


<script type="text/javascript">
bb("order", { "orderId": "{your-order-id}", "products": [
   { "productId": "{your-product-id}", "quantity": {item-quantity}, "commissionId": {your-commission-id}, "gross": {item-gross-price}, "net": {item-net-price}},
   ...
   { "productId": "{your-product-id}", "quantity": {item-quantity}, "commissionId": {your-commission-id}, "gross": {item-gross-price}, "net": {item-net-price}}
]});
</script>
  • bb_session_track ist ein Cookie, das zur Identifizierung eines bestimmten Benutzers in einer einzigen Sitzung vom Übergang von unserem Widget bis zum Ende eines Besuchs im Shop verwendet wird (Lebensdauer - aktuelle Sitzung)
  • bb_track ist ein Cookie zur Identifizierung eines Benutzers, der sich durch unser Netzwerk bewegt (Lebensdauer - so lange wie möglich, standardmäßig ein Jahr)
  • bbuuid ist ein Cookie, das zur Identifizierung der letzten Weiterleitung vom Widget zum Shop verwendet wird; es wird zur Aufzeichnung von Transaktionen und zur korrekten Berechnung von Provisionen an den entsprechenden Partner verwendet (Lebensdauer - wie vereinbart).

Sie müssen uns nur in den Bereich der vertrauenswürdigen Partner aufnehmen (wo Sie als Shop mitteilen, an wen die Daten übermittelt werden).

Andere Optionen:

  • API integration
  • PrestaShop modul
  • Shoper plugin
  • Google Tag Manager