E-Search_ (Kampagnen) - WEBSALE Dokumentation

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 · FACT-Finder im Überblick · 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.

{!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

{@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}

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

{@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}

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

{@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.

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

{@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

{@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}

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.

{@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)

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.

​Das Grundgerüst

​Kampagnen unterscheiden

​Berater-Kampagnen

​Feedback-Kampagnen

​Die Texte

​Die Produkte

​Weiterleitungs-Kampagnen

​Links für SEO-Adressen

​Die Tags im Überblick

​Verwandte Themen

Das Grundgerüst

Kampagnen unterscheiden

Berater-Kampagnen

Feedback-Kampagnen

Die Texte

Die Produkte

Weiterleitungs-Kampagnen

Links für SEO-Adressen

Die Tags im Überblick

Verwandte Themen