Integration von Feedback-Kampagnen

Feedback-Kampagnen ermöglichen es, Text oder Produkte in Form von „Feedback“ an den Shop zurückzugeben. Diese Kampagnen sind vom Typ (oder Geschmacksrichtung) FEEDBACK.

Feedback-Text

Frühere Versionen von FactFinder verwalteten diese Art von variablem Inhalt mithilfe von Nummern. Das Integrationsprojekt legte die Position auf der Shop-Seite fest, an der bestimmte Feedback-Text-Nummern erscheinen sollten. Der Benutzer wusste dann beispielsweise beim Erstellen des Feedback-Textes Nummer 3, dass dieser Text an einer bestimmten Stelle erscheinen würde, wie z. B. über den Suchergebnissen [1].

Seit Version 6.7 werden Namen für die Feedback-Texte erstellt und zurückgegeben.

Für aktuelle Integrationen sollten die Namen der Feedback-Texte als Identifikatoren verwendet werden.

[1]

„Über den Suchergebnissen“ ist hierbei wirklich nur ein Beispiel. Die Position des Feedback-Textes kann vom Shop-Betreiber im Integrationsprojekt ausgewählt werden.

Die Namen werden während des Integrationsprojekts mit dem Shop-Betreiber vereinbart und entsprechend in FactFinder konfiguriert. In der Benutzeroberfläche können Benutzer aus den vordefinierten Namen auswählen. Außerdem können Sie festlegen, ob jeder Feedback-Text HTML-Code enthalten darf oder nicht. Dieses Merkmal wird von FactFinder zusammen mit dem Feedback-Text zurückgegeben. Es ermöglicht Ihnen während der Integration einfach zu entscheiden, ob der anzuzeigende Text HTML-escaped werden soll oder nicht [2].

[2]

Der Standardwert für das HTML-Attribut ist false. Wenn das HTML-Attribut nicht angegeben ist, bedeutet dies, dass der Feedback-Text kein HTML enthalten darf und daher escaped werden muss.

REST-Schnittstelle

Die technische Dokumentation der REST-API ist in der Search-Anwendung selbst enthalten und kann über [Ihr NG-Server]/fact-finder/swagger-ui.html aufgerufen werden. Sie ist auch über die folgende URL erreichbar:

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

Methoden sind unter records dokumentiert. Zusätzlich zum Anzeigen der Parameterdokumentation können Sie auch eine Abfrage testen und die Ergebnisse anzeigen. Die Dokumentation wurde mit Swagger erstellt, sodass Sie Swagger Codegen verwenden können, um einen Client für die Nutzung in Ihrem Code zu generieren.

Bitte verwenden Sie die Kampagne Methode, um Kampagnen abzurufen.

Push-Produkte

Sie können Produkte für Feedback-Kampagnen. FactFinder gibt die Produktliste zusammen mit der Kampagne zurück.

Die Einträge in der Produktliste enthalten jeweils die vollständige Feldliste aus dem Produktdatensatz in der FactFinder-Datenbank. Um jedoch Bandbreite zu sparen, können Sie auch die Parameter idsOnly=true mit der Suchanfrage übergeben. In diesem Fall wird der Inhalt der Datensätze weggelassen.

Es ist möglich, dass Kampagnen zurückgegeben werden, die 0 Produkte enthalten. Der Benutzer kann die Option wählen, Kampagnenprodukte in die Suchergebnisse zu integrieren. In diesem Fall wird keine spezifische Produktliste der Kampagne zurückgegeben. Es wird jedoch eine Kampagne zurückgegeben, um dem Shop anzuzeigen, dass eine Kampagne durch die Suchanfrage ausgelöst wurde.