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

# E-Search_ (Kampagnen)

> FACT-Finder-Kampagnen im Shop anzeigen: Berater-Kampagnen mit Fragen und Antworten, Feedback-Kampagnen mit Texten und Produkten, Weiterleitungs-Kampagnen.

> [!WARNING]
>
> Die FACT-Finder-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. Neue Integrationen laufen ausschließlich über die FactFinder WebComponents. Diese Referenz dient dem Betrieb bestehender Shops.

Eine Kampagne ist eine Regel im FACT-Finder Management, die bei bestimmten Suchbegriffen etwas Zusätzliches ausspielt. Drei Arten gibt es, und jede braucht im Template einen eigenen Block.

| Art | Spielt aus |
| - | - |
| Berater-Kampagne | Fragen mit vorgegebenen Antworten, die die Suche schrittweise einschränken |
| Feedback-Kampagne | Texte und eine Auswahl von Produkten |
| Weiterleitungs-Kampagne | eine Zieladresse, auf die weitergeleitet wird |

Kampagnen bekommen ein eigenes Template, hinterlegt in der Shopkonfiguration `shop.config` im Abschnitt `ExternalSearch` beim Parameter `FACTFinderCampaignTemplate`. Damit lassen sie sich per `WS-ExternInclude` auf der Produktdetail- und der Warenkorbseite einbinden.

Wegweiser: [Integration von FACT-Finder Kampagnen](https://dokumentation.websale.de/v8s/integration-von-fact-finder/fact-finder-kampagnen.md) · [FACT-Finder im Überblick](https://dokumentation.websale.de/v8s/integration-von-fact-finder/integration-von-fact-finder.md) · Referenz: E-Search\_ (Grundlagen und Ergebnisliste)

## Das Grundgerüst

`E-Search_Campaign` ist zugleich die Prüfung auf vorhandene Kampagnen und die Schleife darüber. Innerhalb der Schleife entscheiden drei Klammerungen, um welche Art es sich handelt.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{!E-Search_Campaign}
   <!-- keine Kampagne für diese Suche, nichts anzeigen -->
{/!E-Search_Campaign}

{E-Search_Campaign}
   {@E-Search_Campaign}
      {E-Search_CampaignType_Advisor}
         <!-- Berater-Kampagne -->
      {/E-Search_CampaignType_Advisor}

      {E-Search_CampaignType_Feedback}
         <!-- Feedback-Kampagne -->
      {/E-Search_CampaignType_Feedback}

      {E-Search_CampaignType_Target}
         <!-- Weiterleitungs-Kampagne -->
      {/E-Search_CampaignType_Target}
   {/@E-Search_Campaign}
{/E-Search_Campaign}
```

Eine Suche kann mehrere Kampagnen gleichzeitig auslösen, auch von unterschiedlicher Art. Deshalb steht die Typprüfung innerhalb der Schleife und nicht davor.

### Kampagnen unterscheiden

| Tag | Liefert |
| - | - |
| `E-Search_Campaign_Name()` | den Namen der Kampagne |
| `E-Search_Campaign_Id()` | die Kennung der Kampagne |
| `E-Search_Campaign_Category()` | die Kategorie, zu der die Kampagne gehört |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@E-Search_Campaign}
   {E-Search_Campaign_Category(Fruehling2026)}
      <div class="kampagne fruehling">
         <!-- eigene Gestaltung für alle Kampagnen dieser Kategorie -->
      </div>
   {/E-Search_Campaign_Category(Fruehling2026)}
{/@E-Search_Campaign}
```

> [!WARNING]
>
> Die Kategorie einer Kampagne hat nichts mit den Kategorien des Shops zu tun. Sie ist nur eine Gruppierung im FACT-Finder Management, mit der sich mehrere Kampagnen gemeinsam ansprechen lassen.

Für dauerhafte Sonderdarstellungen ist die Kennung aus `E-Search_Campaign_Id()` die verlässlichste Wahl. Namen und Kategorien werden im Management leichter umbenannt, und ein umbenannter Name lässt die Klammerung stillschweigend ins Leere laufen.

## Berater-Kampagnen

Eine Berater-Kampagne besteht aus Fragen, und zu jeder Frage gehören Antworten. Im Template liegen deshalb zwei Schleifen ineinander.

| Tag | Liefert |
| - | - |
| `E-Search_CampaignAdvisor` | die Schleife über die Fragen, als Einzel-Tag den Fragetext |
| `E-Search_CampaignAdvisorEncoded` | denselben Text HTML-kodiert |
| `E-Search_CampaignAdvisor_Id()` | die Kennung der aktuellen Frage |
| `E-Search_CampaignAdvisorItem` | die Schleife über die Antworten, als Einzel-Tag den Antworttext |
| `E-Search_CampaignAdvisorItemEncoded` | denselben Text HTML-kodiert |
| `E-Search_CampaignAdvisorItem_Id()` | die Kennung der aktuellen Antwort |
| `E-Search_CampaignAdvisorItem_Link` | den Link, der diese Antwort auswählt |
| `E-Search_CampaignAdvisorItem_Params` | nur die Link-Parameter für eine SEO-Adresse |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@E-Search_Campaign}
   {E-Search_CampaignType_Advisor}
      <section class="berater">
         {@E-Search_CampaignAdvisor}
            <h3>~E-Search_CampaignAdvisorEncoded~</h3>
            <ul>
               {@E-Search_CampaignAdvisorItem}
                  <li>
                     <a href="~E-Search_CampaignAdvisorItem_Link~">
                        ~E-Search_CampaignAdvisorItemEncoded~
                     </a>
                  </li>
               {/@E-Search_CampaignAdvisorItem}
            </ul>
         {/@E-Search_CampaignAdvisor}
      </section>
   {/E-Search_CampaignType_Advisor}
{/@E-Search_Campaign}
```

> [!WARNING]
>
> Fragen und Antworten kommen aus dem FACT-Finder Management, also aus einer Quelle außerhalb des Shops. Verwenden Sie deshalb die `Encoded`-Varianten, solange Sie dort kein HTML bewusst hinterlegt haben. Die unkodierten Varianten geben alles unverändert aus, auch Zeichen, die das Seitengerüst zerstören.

Die Kennungen aus `_Id()` brauchen Sie, wenn eine bestimmte Frage oder Antwort anders aussehen soll als die übrigen, beispielsweise mit einem Bild statt eines Textes.

## Feedback-Kampagnen

Eine Feedback-Kampagne liefert Texte und dazu eine Produktauswahl. Beides sind getrennte Schleifen.

### Die Texte

| Tag | Liefert |
| - | - |
| `E-Search_CampaignFeedbackText` | die Prüfung und die Schleife über die Texte, als Einzel-Tag den Text |
| `E-Search_CampaignFeedbackText_Label()` | die Überschrift zum aktuellen Text |
| `E-Search_CampaignFeedbackText_Id()` | die Kennung des aktuellen Textes |
| `E-Search_CampaignFeedbackText_HTML` | greift, wenn der Text als HTML geliefert wird |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@E-Search_Campaign}
   {E-Search_CampaignType_Feedback}
      {E-Search_CampaignFeedbackText}
         {@E-Search_CampaignFeedbackText}
            <section class="kampagnentext">
               <h3>~E-Search_CampaignFeedbackText_Label~</h3>

               {E-Search_CampaignFeedbackText_HTML}
                  ~E-Search_CampaignFeedbackText~
               {/E-Search_CampaignFeedbackText_HTML}

               {!E-Search_CampaignFeedbackText_HTML}
                  <p>~E-Search_CampaignFeedbackText~</p>
               {/!E-Search_CampaignFeedbackText_HTML}
            </section>
         {/@E-Search_CampaignFeedbackText}
      {/E-Search_CampaignFeedbackText}
   {/E-Search_CampaignType_Feedback}
{/@E-Search_Campaign}
```

`E-Search_CampaignFeedbackText_HTML` sagt, ob der hinterlegte Text bereits Auszeichnung enthält. Ein reiner Text braucht im Template einen Absatz um sich herum, ein HTML-Text bringt seine eigene Struktur mit und würde in einem Absatz falsch verschachtelt landen.

> [!WARNING]
>
> Ein Label kann leer sein. Klammern Sie die Überschrift mit `{E-Search_CampaignFeedbackText_Label}`, wenn Sie leere Überschriften vermeiden möchten.

### Die Produkte

| Tag | Liefert |
| - | - |
| `E-Search_CampaignFeedbackResult` | die Schleife über die Produkte der Kampagne |
| `E-Search_CampaignFeedbackResult_Index` | den Produktindex des aktuellen Eintrags |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@E-Search_Campaign}
   {E-Search_CampaignType_Feedback}
      <ul class="kampagnenprodukte">
         {@E-Search_CampaignFeedbackResult}
            {PR-AdvData($E-Search_CampaignFeedbackResult_Index$)}
               <li>
                  <a href="~PR-Link~">~PR-Name~</a>
                  ~PR-Price~
               </li>
            {/PR-AdvData($E-Search_CampaignFeedbackResult_Index$)}
         {/@E-Search_CampaignFeedbackResult}
      </ul>
   {/E-Search_CampaignType_Feedback}
{/@E-Search_Campaign}
```

Wie bei der Ergebnisliste liefert FACT-Finder nur Produktindizes. `PR-AdvData()` holt die eigentlichen Produktdaten aus dem Shop, damit Preise und Verfügbarkeit stimmen.

Die Schleife nimmt zwei Parameter entgegen: den ersten anzuzeigenden Eintrag und die Anzahl. `{@E-Search_CampaignFeedbackResult(1,4)}` zeigt die ersten vier Produkte, was für einen Anreißer neben der Trefferliste meist genügt.

## Weiterleitungs-Kampagnen

Eine Weiterleitungs-Kampagne liefert eine Zieladresse, auf die der Besucher geschickt werden soll.

| Tag | Liefert |
| - | - |
| `E-Search_CampaignTarget` | die Zieladresse |
| `E-Search_CampaignTarget_Name()` | den Namen der Kampagne |

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@E-Search_Campaign}
   {E-Search_CampaignType_Target}
      <p>
         Passend zu Ihrer Suche:
         <a href="~E-Search_CampaignTarget~">~E-Search_CampaignTarget_Name~</a>
      </p>
   {/E-Search_CampaignType_Target}
{/@E-Search_Campaign}
```

> [!WARNING]
>
> Eine unangekündigte Weiterleitung nimmt dem Besucher die Kontrolle und macht den Zurück-Knopf unbrauchbar, weil die Suchergebnisseite sofort wieder weiterleitet. Ein deutlich sichtbarer Link ist in fast allen Fällen die bessere Wahl.

Soll trotzdem weitergeleitet werden, gehört der Hinweis darauf sichtbar auf die Seite, zusammen mit einem Link auf die ungefilterte Trefferliste.

## Links für SEO-Adressen

Für die Antworten einer Berater-Kampagne gibt es wie überall eine Params-Variante.

```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}}
{@E-Search_CampaignAdvisorItem}
   ~DC-FPFactFinderLink_reset~
   ~DC-FPFactFinderLink_set($CAT-Link$)~

   {E-Search_CampaignAdvisorItem_Params}
      {DC-FPFactFinderLink_contains(?)}
         ~DC-FPFactFinderLink_append(&)~
      {/DC-FPFactFinderLink_contains(?)}
      {!DC-FPFactFinderLink_contains(?)}
         ~DC-FPFactFinderLink_append(?)~
      {/!DC-FPFactFinderLink_contains(?)}
   {/E-Search_CampaignAdvisorItem_Params}

   ~WS-DisableXSSProtectionOnce~
   <a href="~DC-FPFactFinderLink~~E-Search_CampaignAdvisorItem_Params~">
      ~E-Search_CampaignAdvisorItemEncoded~
   </a>
{/@E-Search_CampaignAdvisorItem}
```

Wegweiser: SEO-Erweiterung von Links · Referenz: [DC- (Parameter)](https://dokumentation.websale.de/v8s/referenz/tags/dc/cookie-daten.md)

## Die Tags im Überblick

| Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag |
| - | - | - | - | - |
| `E-Search_Campaign` | – | ja | ja | ja |
| `E-Search_Campaign_Name()` | ja | ja | ja | – |
| `E-Search_Campaign_Id()` | ja | ja | ja | – |
| `E-Search_Campaign_Category()` | ja | ja | ja | – |
| `E-Search_CampaignType_Advisor` | – | ja | ja | – |
| `E-Search_CampaignType_Feedback` | – | ja | ja | – |
| `E-Search_CampaignType_Target` | – | ja | ja | – |
| `E-Search_CampaignAdvisor` | ja | – | – | ja |
| `E-Search_CampaignAdvisorEncoded` | ja | – | – | – |
| `E-Search_CampaignAdvisor_Id()` | ja | ja | ja | – |
| `E-Search_CampaignAdvisorItem` | ja | – | – | ja |
| `E-Search_CampaignAdvisorItemEncoded` | ja | – | – | – |
| `E-Search_CampaignAdvisorItem_Id()` | ja | ja | ja | – |
| `E-Search_CampaignAdvisorItem_Link` | ja | ja | ja | – |
| `E-Search_CampaignAdvisorItem_Params` | ja | ja | ja | – |
| `E-Search_CampaignFeedbackText` | ja | ja | ja | ja |
| `E-Search_CampaignFeedbackText_Label()` | ja | ja | ja | – |
| `E-Search_CampaignFeedbackText_Id()` | ja | ja | ja | – |
| `E-Search_CampaignFeedbackText_HTML` | – | ja | ja | – |
| `E-Search_CampaignFeedbackResult` | – | – | – | ja |
| `E-Search_CampaignFeedbackResult_Index` | ja | ja | ja | – |
| `E-Search_CampaignTarget` | ja | – | – | – |
| `E-Search_CampaignTarget_Name()` | ja | ja | ja | – |

Alle Tags dieser Seite gelten im Kampagnen-Template und im Suchtemplate. Die Advisor-Tags nur innerhalb von `E-Search_CampaignType_Advisor`, die Feedback-Tags nur innerhalb von `E-Search_CampaignType_Feedback`, die Target-Tags nur innerhalb von `E-Search_CampaignType_Target`.

`E-Search_CampaignResult()` und `E-Search_CampaignResultIndex` wurden durch `E-Search_CampaignFeedbackResult` und `E-Search_CampaignFeedbackResult_Index` ersetzt und sind hier deshalb nicht aufgeführt.

## Verwandte Themen

* Wegweiser: Integration von FACT-Finder Kampagnen
* Wegweiser: FACT-Finder im Überblick
* Referenz: [E-Search\_ (Grundlagen und Ergebnisliste)](https://dokumentation.websale.de/v8s/referenz/tags/e-search/grundlagen-und-ergebnisliste.md)
* Referenz: [E-Search\_ (Filter)](https://dokumentation.websale.de/v8s/referenz/tags/e-search/filter.md)


## Related topics

- [E-Search_ (Grundlagen und Ergebnisliste)](https://dokumentation.websale.de/v8s/referenz/tags/e-search/grundlagen-und-ergebnisliste.md)
- [E-Search_ (Filter)](https://dokumentation.websale.de/v8s/referenz/tags/e-search/filter.md)
- [E-Search_ (Sortierung)](https://dokumentation.websale.de/v8s/referenz/tags/e-search/sortierung.md)
- [E-Search_ (Blättern und Treffer pro Seite)](https://dokumentation.websale.de/v8s/referenz/tags/e-search/blaettern-und-treffer-pro-seite.md)
- [FACT-Finder-Kampagnen](https://dokumentation.websale.de/v8s/integration-von-fact-finder/fact-finder-kampagnen.md)


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