> For the complete documentation index, see [llms.txt](https://docs.fact-finder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fact-finder.com/integration/de/campaign-specific-integration/integrating-feedback-campaign.md).

# 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.fact-finder.com/integration/de/campaign-specific-integration/integrating-feedback-campaign.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
