Integration von Feedback-Kampagnen

Zeigen Sie Feedback-Text und von Feedback-Kampagnen zurückgegebene vorgeschobene Produkte an der richtigen Stelle an.

Feedback-Kampagnen ermöglichen es Ihnen, Text oder Produkte als „Feedback“ an den Shop zurückzugeben. Diese Kampagnen verwenden den Typ oder Ausprägung, FEEDBACK.

Feedback-Text

Frühere FactFinder-Versionen verwalteten diese Art von variablem Inhalt mit numerischen Kennungen. Das Integrationsprojekt legte fest, wo jede Feedback-Text-Nummer auf der Shop-Seite erschien. So könnte beispielsweise Feedback-Text Nummer 3 oberhalb der Suchergebnisse platziert worden sein [1].

Seit Version 6.7 verwenden Feedback-Texte stattdessen Namen.

Verwenden Sie für aktuelle Integrationen diese Namen als Kennungen.

[1]

„Oberhalb der Suchergebnisse“ ist in diesem Fall wirklich nur ein Beispiel. Die Position des Feedback-Texts kann vom Shop-Betreiber im Integrationsprojekt ausgewählt werden.

Die Namen werden während des Integrationsprojekts mit dem Shop-Betreiber abgestimmt und anschließend in FactFinder konfiguriert. In der Benutzeroberfläche können Benutzer aus diesen vordefinierten Namen auswählen. Sie können außerdem festlegen, ob jeder Feedback-Text HTML enthalten darf. FactFinder gibt diese Eigenschaft zusammen mit dem Feedback-Text zurück, sodass Ihre Integration entscheiden kann, ob der Text mit HTML-Escaping versehen werden muss [2].

[2]

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

REST-Schnittstelle

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

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

Die relevanten Methoden sind unter Datensätze. Zusätzlich zur Parameterdokumentation können Sie Anfragen testen und die Ergebnisse direkt überprüfen. Da die Dokumentation mit Swagger erstellt wurde, können Sie auch Swagger Codegen verwenden, um einen Client zu generieren.

Bitte verwenden Sie die Kampagne Methode, um Kampagnen abzurufen.

Push-Produkte

Sie können Produkte zuordnen zu Feedback-Kampagnen. FactFinder gibt die Produktliste mit der Kampagne zurück.

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

Eine Kampagne kann auch mit 0 Produkten zurückgegeben werden. Benutzer können wählen, Kampagnenprodukte direkt in die Suchergebnisse zu integrieren. In diesem Fall wird keine separate Kampagnen-Produktliste zurückgegeben. Die Kampagne selbst wird weiterhin zurückgegeben, damit der Shop weiß, dass die Suchanfrage sie ausgelöst hat.