PriceShape bietet eine offene API, um Daten aus Ihrem Shop in PriceShape zu integrieren. Durch das Senden von Daten wie Seitenaufrufen und Verkaufszahlen kann PriceShape Ihre Konversionsraten verfolgen und Ihnen ermöglichen, Preisstrategien basierend auf der Leistung Ihrer Produkte zu erstellen.
Die Daten können entweder über die Sales Data API oder mit PriceShapes Sales-Datenskript an PriceShape gesendet werden.
Hinweise zur Implementierung
Das Skript ist für die Verwendung im Quellcode der Website vorgesehen.
Wenn Sie einen Tag-Manager verwenden, müssen Sie das Skript an Ihre Einrichtung anpassen.
Übersicht der Datenereignisse
Die folgenden Ereignisse können für jedes Produkt verfolgt und an PriceShape gesendet werden:
Seitenaufrufe: Die Gesamtzahl der aufgerufenen produktbezogenen Seiten.
Produkte zum Warenkorb hinzugefügt: Die Anzahl der Male, die ein Produkt zum Warenkorb hinzugefügt wurde.
Produkte verkauft: Die Gesamtmenge eines bestimmten Produkts, die verkauft wurde.
Einzigartige Produktverkäufe: Die Anzahl der einzigartigen Transaktionen, die ein bestimmtes Produkt betreffen.
Client-seitiges Skript
Das Skript funktioniert durch Ereignisse oder Auslöser. Das bedeutet, dass das Skript aktiviert werden muss, wenn ein Kunde auf einen bestimmten Teil der Website zugreift oder mit diesem interagiert.
Head-Skript
Platzieren Sie das Skript <head>
im Tag Ihrer Seitentemplate. Das Skript <head>
sollte auf allen Seiten Ihrer Website verfügbar sein oder mindestens auf den Seiten, auf denen wir Verkaufsdaten verfolgen müssen. Es muss außerdem oberhalb der Ereignis-Skripte im Quellcode platziert werden.
Im <head>
-Tag Ihrer Seitenvorlage. Ihr individuelles Skript finden Sie unter "Kontoeinstellungen" -> "Integrationen".
<script type="text/javascript"> (function (window) { function sendEvent(body) { if (!window.navigator || !window.navigator.sendBeacon) { console.log("This browser does not support sendBeacon"); return false;
} window.navigator.sendBeacon( "https://public.app.priceshape.io/api/2022-08/sales-data?app_id=####", JSON.stringify(body) );
} window.PRICESHAPE = { trackPage: function (upi) { sendEvent([
{ pageViews: 1, upi
}
]);
}, itemSold: function (upi, quantity = 1) { sendEvent([
{ itemsSold: quantity, uniqueSales: 1, upi
}
]);
}, itemsSold: function (data) { sendEvent(data);
}, itemAddedToCart: function (upi) { sendEvent([
{ itemAddedToCart: 1, upi
}
]);
},
};
})(window); </script>
Ereignis-Skripte
Implementieren Sie sie am Ende des -Elements für alle Seiten, um Seitenereignisse zu verfolgen.
Produktseitenaufrufe
Auslösebedingung: Immer wenn ein Kunde zu einer produktbezogenen URL navigiert.
Wenn Sie mit Varianten arbeiten, müssen Sie möglicherweise die Logik anpassen, um Varianten zu berücksichtigen, entweder durch:
Auslösen eines einzelnen Aufrufs für die erste angeklickte Variante.
Auslösen eines Aufrufs für alle angeklickten Varianten
// Track a page view, by UPI
<script
type="text/javascript"> window.PRICESHAPE.trackPage(upi)
</script>
Verkaufte Artikel und einzigartige Verkäufe
Auslösebedingung: Sobald ein Kunde einen Artikel kauft.
Verkaufte Artikel und einzigartige Verkäufe sollten auf der „Danke für Ihre Bestellung“-Seite oder nach Abschluss der Transaktion ausgelöst werden.
// Track items sold, by UPI
<script
type="text/javascript"> window.PRICESHAPE.itemSold(upi, quantity) </script>
// if multiple products at once
// UPI is a string
window.PRICESHAPE.itemsSold([
{ upi: '001234567', itemsSold: 2, uniqueSales: 1},
{ upi: '000567789', itemsSold: 1, uniqueSales: 1},
])
In den Warenkorb gelegt
Auslösebedingung: Sobald ein Kunde einen Artikel in den Warenkorb legt.
// Track added to cart, by UPI
<script
type="text/javascript"> window.PRICESHAPE.itemAddedToCart(upi)
</script>
Datenformat
Die Daten sollten über eine POST-Anfrage gesendet werden an:
Sie können Ihr einzigartiges Skript unter "Kontoeinstellungen" -> "Integrationen" finden.
Namenskonventionen und Format
Alle Daten müssen im JSON-Format vorliegen und folgenden Namenskonventionen entsprechen:
PageViews
ItemsSold
UniqueSales
Syntax-Beispiel
Datenanforderungen sollten als Array von Objekten gepostet werden.
Beispiel:
[{"pageViews": 1, "upi": "5705145043275"},{ "upi": "5705145043275", "itemsSold": 2, "uniqueSales": 1},{"upi": "5705145043275", "itemAddedToCart": 2}]
Für einzelne Ereignisse:
[{"upi": "5705145043275", "itemAddedToCart": 2}]
Stellen Sie sicher, dass Zeichenketten und Zahlen sind korrekt unterschieden.