> ## Documentation Index
> Fetch the complete documentation index at: https://dokumentation.websale.de/llms.txt
> Use this file to discover all available pages before exploring further.

# FACT-Finder-Kampagnen

> Suchergebnisse mit Feedback-, Weiterleitungs- und Berater-Kampagnen gezielt beeinflussen, auf der Trefferliste, der Produktdetailansicht und im Warenkorb.

> [!WARNING]
>
> **Die Direktanbindung ist veraltet und wird nicht mehr unterstützt.** Sie steht nur bis FactFinder-Version 6.9 zur Verfügung und wird von WEBSALE weder gepflegt noch weiterentwickelt. Für neue Integrationen verwenden Sie die FactFinder WebComponents nach der offiziellen Dokumentation von FactFinder. Diese Seite ist für bestehende Shops gedacht, die noch mit der Direktanbindung arbeiten.

Eine Kampagne greift in das Suchergebnis ein, abhängig davon, was der Kunde gesucht hat. Sucht jemand nach einer Marke, erscheint deren Banner. Sucht jemand nach "AGB", landet er direkt auf der Informationsseite. Und wer nach "Tischdecke" sucht, bekommt Rückfragen gestellt, die ihn zu einer kleinen, passenden Auswahl führen.

WEBSALE unterstützt drei der Kampagnentypen von FACT-Finder:

| Typ | Wirkung | Wo einsetzbar |
| - | - | - |
| Feedback | zeigt Banner, Texte und hervorgehobene Produkte | Trefferliste, Produktdetailansicht, Warenkorb |
| Weiterleitung | schickt den Kunden zu einer bestimmten Seite | Trefferliste |
| Berater | stellt Fragen und führt über die Antworten zu Produkten | Trefferliste |

Voraussetzung ist in allen Fällen die FACT-Finder-Suchfunktion.

> [!WARNING]
>
> FACT-Finder kann mehrere Kampagnen gleichzeitig zurückliefern, darunter solche, die sich gegenseitig ausschließen, beispielsweise zwei Weiterleitungen. Geliefert werden sie unpriorisiert. Legen Sie deshalb bei der Einbindung selbst eine Rangfolge fest, etwa über einen freien Platzhalter, mit dem die übrigen Kampagnen ausgeblendet werden.

Wegweiser: [Integration von FACT-Finder](https://dokumentation.websale.de/v8s/integration-von-fact-finder/integration-von-fact-finder.md)

## Der gemeinsame Aufbau

Alle drei Typen werden gleich geklammert. Die äußere Klammerung prüft, ob überhaupt eine Kampagne vorliegt, die Schleife läuft über alle gelieferten Kampagnen, und darin entscheidet eine Klammerung über den Typ.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-Search_Campaign}
   {@E-Search_Campaign}

      {E-Search_CampaignType_Feedback}
         ...
      {/E-Search_CampaignType_Feedback}

   {/@E-Search_Campaign}
{/E-Search_Campaign}
```

Konfiguriert wird jede Kampagne zuerst im FACT-Finder Management: ein oder mehrere Suchbegriffe als Auslöser, dazu Modus, Startdatum und Gültigkeitsdauer.

## Feedback-Kampagnen auf der Trefferliste

Damit heben Sie Produktgruppen hervor, beispielsweise mit einem Banner, und bestimmen zugleich, welche Produkte als erste erscheinen.

Im Kampagnen-Manager von FACT-Finder muss dafür "Kampagne aktiv auf: Suchergebnis" gewählt sein. Im Modus "Pushed Products" werden die ausgewählten Produkte dem Ergebnis vorangestellt, untergemischt oder sie ersetzen es ganz.

Der Code gehört in das Ergebnis-Template, das in der `shop.config` hinter `FactFinderTemplate` steht.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<!-- innerhalb des Formulars -->
{E-Search_Campaign}
   {@E-Search_Campaign}
      {E-Search_CampaignType_Feedback}

         <!-- Texte und Banner der Kampagne -->
         {@E-Search_CampaignFeedbackText}
            (ID ~E-Search_CampaignFeedbackText_Id~)
            ~E-Search_CampaignFeedbackText_Label~
            ~E-Search_CampaignFeedbackText~
         {/@E-Search_CampaignFeedbackText}

         <!-- die hervorgehobenen Produkte -->
         {@E-Search_CampaignFeedbackResult}
            {PR-AdvData(~E-Search_CampaignFeedbackResult_Index~)}
               ~PR-Name~
               <img src="~PR-Image~">
               ~PR-Price~ ~WS-CurrencySymbol~
            {/PR-AdvData(~E-Search_CampaignFeedbackResult_Index~)}
         {/@E-Search_CampaignFeedbackResult}

      {/E-Search_CampaignType_Feedback}
   {/@E-Search_Campaign}
{/E-Search_Campaign}
```

FACT-Finder liefert je Treffer nur den Produktindex. `PR-AdvData()` holt damit die Produktdaten aus dem Shop, und innerhalb dieser Klammerung stehen alle gewohnten Produkt-Tags bereit.

## Feedback-Kampagnen an Produkt und Warenkorb

Auf der Produktdetailansicht und im Warenkorb gibt es keine Suche, die eine Kampagne auslösen könnte. Hier muss der Shop die Kampagne bei FACT-Finder eigens abfragen, und zwar über ein externes Include mit den passenden Parametern.

![Factfinder Feedback Kampagne Gesamt](https://mintcdn.com/websaleag-44ee7ea6/ZpqrUDlxS94uTw6k/images/factfinder_feedback_kampagne_gesamt.jpg?fit=max\&auto=format\&n=ZpqrUDlxS94uTw6k\&q=85\&s=9da79af7ecd16719fea6cbe7a9eafad8)

Wird zum Beispiel nach der Marke "Wintec" gesucht, kann automatisch ein Titelbild für diese Marke angezeigt werden.

| Ort | Parameter |
| - | - |
| Produktdetailansicht | Subshop-ID und die Produktnummer des angezeigten Produkts |
| Warenkorb | Subshop-ID und die Produktnummern aller Produkte im Warenkorb |

### Schritt 1: Das Kampagnen-Template zuweisen

```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
<ExternalSearch>
   ...
   FactFinderCampaignTemplate = incl_factfinder_campaign.htm
   ...
</ExternalSearch>
```

Gibt es den Abschnitt noch nicht, legen Sie ihn an.

### Schritt 2: Das Kampagnen-Template anlegen

Es enthält denselben Code wie oben, nur ohne das umgebende Formular.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-Search_Campaign}
   {@E-Search_Campaign}
      {E-Search_CampaignType_Feedback}

         {@E-Search_CampaignFeedbackText}
            (ID ~E-Search_CampaignFeedbackText_Id~)
            ~E-Search_CampaignFeedbackText_Label~
            ~E-Search_CampaignFeedbackText~
         {/@E-Search_CampaignFeedbackText}

         {@E-Search_CampaignFeedbackResult}
            {PR-AdvData(~E-Search_CampaignFeedbackResult_Index~)}
               ~PR-Name~
               <img src="~PR-Image~">
               ~PR-Price~ ~WS-CurrencySymbol~
            {/PR-AdvData(~E-Search_CampaignFeedbackResult_Index~)}
         {/@E-Search_CampaignFeedbackResult}

      {/E-Search_CampaignType_Feedback}
   {/@E-Search_Campaign}
{/E-Search_Campaign}
```

### Schritt 3: Auf der Produktdetailansicht abfragen

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
~WS-ExternInclude($URL-Homepage$/cgi/wsproductsearch/wsproductsearch.cgi?m=$WS-MallID$&s=$WS-ShopID$&ss=$WS-SubShopID$&wsps_act=productcampaign&wsps_pi=$PR-Number$)~
```

### Schritt 4: Im Warenkorb abfragen

Hier muss die Adresse erst zusammengesetzt werden, weil für jedes Produkt im Warenkorb ein Parameter anzuhängen ist.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
~DC-FP2_reset~
~DC-FP2_append($URL-Homepage$/cgi/wsproductsearch/wsproductsearch.cgi)~
~DC-FP2_append(?m=$WS-MallID$&s=$WS-ShopID$&ss=$WS-SubShopID$&wsps_act=basketcampaign)~

{@BASKET-PR-Data}
   {PR-AdvData($BASKET-PR-ProdIndex$)}
      ~DC-FP2_append(&wsps_pi=$PR-Number$)~
   {/PR-AdvData($BASKET-PR-ProdIndex$)}
{/@BASKET-PR-Data}

~WS-DisableXSSProtectionOnce~
~WS-ExternInclude($DC-FP2$)~
```

Der Umweg über `PR-AdvData()` ist nötig, weil der Warenkorb den Produktindex führt, die Kampagnenabfrage aber die Produktnummer erwartet.

> [!WARNING]
>
> Ohne `WS-DisableXSSProtectionOnce` würde die zusammengesetzte Adresse HTML-codiert ausgegeben und der Aufruf ginge ins Leere.

## Weiterleitungs-Kampagnen

Bestimmte Suchbegriffe führen direkt auf eine Seite Ihres Shops. Wer "AGB" sucht, landet auf den Geschäftsbedingungen statt auf einer leeren Trefferliste.

Das Ziel legen Sie im FACT-Finder Management fest. Der Code gehört in das Ergebnis-Template.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-Search_Success}
   {E-Search_Campaign}
      {@E-Search_Campaign}
         {E-Search_CampaignType_Target}

            <script type="text/javascript">
               location.href = "~E-Search_CampaignTarget~";
            </script>

         {/E-Search_CampaignType_Target}
      {/@E-Search_Campaign}
   {/E-Search_Campaign}
{/E-Search_Success}
```

Für eine sichtbare Ausgabe statt der sofortigen Weiterleitung stehen `~E-Search_CampaignTarget~` für die Adresse und `~E-Search_CampaignTarget_Name~` für deren Bezeichnung zur Verfügung.

> [!WARNING]
>
> Setzen Sie eine Weiterleitungs-Kampagne nicht innerhalb von `{E-Search_Result}`. Diese Klammerung greift nur, wenn es einen Treffer gibt, und genau das ist bei einer Weiterleitung in der Regel nicht der Fall.

## Berater-Kampagnen

Statt einer Trefferliste bekommt der Kunde eine Frage gestellt. Hinter jeder Antwort liegt eine Produktauswahl, und Antworten können zu weiteren Fragen führen. Das Ergebnis ist ein Fragenbaum, der die Beratung eines Fachverkäufers nachbildet.

Zurückgeliefert wird immer nur die gerade aktive Frage. Zu Beginn ist das die erste Frage des Baums. Klickt der Kunde eine Antwort an, wird die daran anschließende Frage zur aktiven.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{E-Search_Campaign}
   {@E-Search_Campaign}
      {E-Search_CampaignType_Advisor}
         {@E-Search_CampaignAdvisor}

            <h2>~E-Search_CampaignAdvisor~</h2>

            {@E-Search_CampaignAdvisorItem}
               (ID ~E-Search_CampaignAdvisorItem_Id~)
               <a href="~E-Search_CampaignAdvisorItem_Link~">~E-Search_CampaignAdvisorItem~</a>
            {/@E-Search_CampaignAdvisorItem}

         {/@E-Search_CampaignAdvisor}
      {/E-Search_CampaignType_Advisor}
   {/@E-Search_Campaign}
{/E-Search_Campaign}
```

> [!WARNING]
>
> Berater-Kampagnen sehen aus wie eine Filtergruppe, verhalten sich aber anders: Sobald eine Frage aktiv ist, werden alle übrigen Filter ausgeblendet. Stellen Sie sie deshalb besser in einem eigenen Bereich oberhalb der Trefferliste dar als innerhalb der Filter. Sonst irritiert das abweichende Verhalten den Kunden.

## Zum Schluss: freigeben

Nach der Einbindung im Shop müssen die Kampagnen im Kampagnen-Manager von FACT-Finder noch freigegeben werden. Ohne diesen Schritt bleibt alles unsichtbar, ohne dass ein Fehler erkennbar wäre.

Referenz: [Tags für die FACT-Finder-Integration](https://dokumentation.websale.de/v8s/materialien/materialien-fact-finder-templates.md)

## Verwandte Themen

* Wegweiser: [Integration von FACT-Finder](https://dokumentation.websale.de/v8s/integration-von-fact-finder/integration-von-fact-finder.md)
* Wegweiser: [FACT-Finder: Filter, Sortierung und Navigation](https://dokumentation.websale.de/v8s/integration-von-fact-finder/fact-finder-filter-sortierung-und-navigation.md)
* Wegweiser: [Externe Inhalte einbinden](https://dokumentation.websale.de/v8s/externe-dienste/externe-inhalte-einbinden.md)


## Related topics

- [Integration von FACT-Finder](https://dokumentation.websale.de/v8s/integration-von-fact-finder/integration-von-fact-finder.md)
- [E-Search_ (Kampagnen)](https://dokumentation.websale.de/v8s/referenz/tags/e-search/kampagnen.md)
- [FACT-Finder: Filter, Sortierung und Navigation](https://dokumentation.websale.de/v8s/integration-von-fact-finder/fact-finder-filter-sortierung-und-navigation.md)
- [Materialien FACT-Finder-Templates](https://dokumentation.websale.de/v8s/materialien/materialien-fact-finder-templates.md)
- [FactFinder WebComponents](https://dokumentation.websale.de/v8s/integration-von-fact-finder/factfinder-webcomponents.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.