Allgemeine Parameter

Verweisen Sie auf die allgemeinen Tracking-Parameter, die für FactFinder-Tracking-Ereignisse erforderlich sind.

Die folgenden Parameter sind für jeden Aufruf erforderlich oder optional.

Parameter		Beschreibung
id	erforderlich	ID des Elements, für das Informationen gesendet werden. Wenn Sie mehrere ID-Felder verwenden, z. B. Produkt-ID, Versions-ID, EAN oder ISBN, klären Sie mit FactFinder, welcher Wert hier übergeben werden soll.
masterId	erforderlich, wenn Deduplizierung verwendet wird	Wenn Ihr Shop Artikelvarianten enthält und Sie die Varianten-ID über den id Parameter senden, senden Sie hier auch die Hauptartikelnummer. Dadurch wird sichergestellt, dass Produkte und zugehörige Ereignisse korrekt verknüpft werden.
channel	erforderlich	Der Name des FactFinder-Kanals, in dem die Suche durchgeführt wurde.
sid	erforderlich	Verwenden Sie dies, um die Sitzungskennung des Benutzers zu übergeben. Sie wird für Log-Analysen verwendet, z. B. Click-through-Rate, Search-to-Cart-Rate und Conversion-Rate. Wenn Sie Personalisierung verwenden möchten, übergeben Sie diesen Parameter für alle Tracking-Ereignisse und für Suchanfragen.
event	erforderlich	Dieser Parameter gibt den Ereignistyp an. Bitte verwenden Sie für die verschiedenen Typen die folgenden Werte: click – Klick auf das Produkt oder den Link zur Detailseite cart – Produkt in den Warenkorb gelegt checkout – Produkt gekauft login – Benutzer meldet sich an recommendationClick – Klick auf ein von der Recommendation Engine vorgeschlagenes Produkt feedback – Kommentar zum Suchergebnis, der vom Shop-Besucher hinterlassen wurde
title	erforderlich	Der Artikelname. Dieser Wert ist in der Praxis optional. Sie können auch eine leere Zeichenfolge senden oder den Parameter weglassen.
userId	erforderlich	Verwenden Sie dies, um eine Benutzerkennung zu übergeben. Wie die Sitzungs-ID muss sie anonymisiert sein. Anders als sid, bleibt sie gleich, wenn ein Benutzer zurückkehrt. Dieser Parameter ist für das login Ereignis erforderlich, wenn das Modul Personalisierung verwendet wird.

REST

Die Dokumentation der REST-API ist Teil der Suchanwendung und unter [Ihr NG-Server]/fact-finder/swagger-ui.html verfügbar. Sie können hier auch darauf zugreifen:

Swagger-Link: https://ng-demo.fact-finder.de/fact-finder/swagger-ui.html

Zusätzlich zur Parameterdokumentation können Sie Anfragen testen und die Ergebnisse direkt einsehen. Da die Dokumentation mit Swagger erstellt wurde, können Sie auch Swagger Codegen verwenden, um einen Client zu generieren.

Die Dokumentation der Tracking-Schnittstelle ist unter dem tracking Ressource verfügbar.