> ## 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. # ABTest- (A/B-Tests) > Die Tags für A/B-Tests im Template: Testfälle ausspielen, Varianten klammern und Konversionen zählen. Mit einem A/B-Test spielt der Shop dieselbe Seite in mehreren Varianten aus und misst, welche davon häufiger zum Ziel führt. Angelegt wird ein Test im A/B-Test-Manager, im Template entscheiden die Tags mit dem Präfix `ABTest-` darüber, was ein Besucher tatsächlich zu sehen bekommt. Drei Tags genügen dafür. `ABTest-active()` schaltet den Testbereich überhaupt erst ein, `ABTest-caseA` bis `ABTest-caseJ` klammern die einzelnen Varianten, und `ABTest-TriggerConversion()` meldet auf der Zielseite den Erfolg zurück. | Tag | Einzel-Tag | Bereichs-Tag | negatives Bereichs-Tag | Schleifen-Tag | | - | - | - | - | - | | `ABTest-active()` | – | ja | ja | – | | `ABTest-caseA` bis `ABTest-caseJ` | – | ja | ja | – | | `ABTest-TriggerConversion()` | ja | – | – | – | Alle drei Tags sind in allen Templates zulässig. Wegweiser: [A/B-Test](https://dokumentation.websale.de/v8s/funktionen-zur-shop-optimierung/a-b-test.md) ## Der Aufbau im Template Die beiden Bereichs-Tags gehören immer ineinander. Außen steht `ABTest-active()` mit der Test-ID, innen je ein Bereich für jeden im A/B-Test-Manager angelegten Testfall. ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} {ABTest-active(startseite-banner)} {ABTest-caseA} {/ABTest-caseA} {ABTest-caseB} {/ABTest-caseB} {/ABTest-active(startseite-banner)} {!ABTest-active(startseite-banner)} {/!ABTest-active(startseite-banner)} ``` > [!WARNING] > > Der negative Bereich gehört dazu. Ohne ihn erscheint an dieser Stelle gar nichts, sobald der Test beendet ist oder seine ID nicht mehr existiert. Was außerhalb der Testphase zu sehen sein soll, gehört deshalb ausdrücklich ins Template. Die Groß- und Kleinschreibung der Tag-Namen und der Test-ID spielt keine Rolle. `ABTest-active` und `abtest-Active` führen zum selben Ergebnis. Bleiben Sie trotzdem bei einer Schreibweise, sonst findet eine spätere Suche im Template-Verzeichnis nicht alle Stellen. ## ABTest-active() Der Bereich wird angezeigt, wenn der A/B-Test mit der angegebenen ID gerade aktiv ist. Die Test-ID wird als Parameter übergeben und muss genau der ID aus dem A/B-Test-Manager entsprechen. ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} {ABTest-active(startseite-banner)} Dieser Bereich wird angezeigt, wenn der A/B-Test aktiv ist. {/ABTest-active(startseite-banner)} {!ABTest-active(startseite-banner)} Dieser Bereich wird angezeigt, wenn der A/B-Test nicht aktiv ist. {/!ABTest-active(startseite-banner)} ``` ### Wie der Testfall zugewiesen wird Der Shop würfelt den Testfall nicht aus. Beim ersten Aufruf des Tests in einer Sitzung ermittelt er, welcher Testfall bisher die wenigsten Ansichten hat, und weist diesen zu. Dadurch verteilen sich die Besucher gleichmäßig auf die Varianten, ohne dass am Ende eine Variante deutlich weniger Daten hat als die andere. Gezählt wird je Subshop. Ein Test, der in mehreren Subshops läuft, gleicht seine Verteilung also in jedem Subshop für sich aus. Die Ansicht wird nur vom positiven Bereich `{ABTest-active(…)}` gezählt, nicht vom negativen. Ein Template, das ausschließlich mit `{!ABTest-active(…)}` arbeitet, liefert dem Test also keine Daten. ## ABTest-caseA bis ABTest-caseJ Der Bereich wird angezeigt, wenn der zugehörige Testfall für diesen Besucher zugewiesen ist. Für jeden im A/B-Test-Manager angelegten Testfall gehört ein eigener Bereich ins Template, von `ABTest-caseA` bis höchstens `ABTest-caseJ`. Mehr als zehn Testfälle sind nicht möglich. ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} {ABTest-active(startseite-banner)} {ABTest-caseA} Variation für den Testfall A {/ABTest-caseA} {ABTest-caseB} Variation für den Testfall B {/ABTest-caseB} {/ABTest-active(startseite-banner)} ``` > [!WARNING] > > Diese Tags sind nur innerhalb der Klammerung von `ABTest-active()` gültig. Stehen sie außerhalb, ist das Tag ungültig und wird nicht als Klammerung ausgewertet. Der Buchstabe im Tag entspricht der Reihenfolge der Testfälle im A/B-Test-Manager: Der erste Testfall ist A, der zweite B und so fort. Er ist unabhängig davon, wie Sie den Testfall dort benannt haben. Wird ein Testfall im Manager gelöscht, rücken die dahinterliegenden Testfälle einen Buchstaben nach vorn. Prüfen Sie in diesem Fall die Zuordnung im Template, sonst zeigt Variante B plötzlich den Inhalt von C. ## ABTest-TriggerConversion() Zählt eine Konversion für den Test mit der angegebenen ID. Das Tag gehört auf die Seite, deren Aufruf als Erfolg gewertet wird. ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} ~ABTest-TriggerConversion(startseite-banner)~ ``` Gebraucht wird das Tag nur, wenn im A/B-Test-Manager als Konversionsziel "Durch Tag auf Zielseite" festgelegt wurde. Bei den übrigen Zielen zählt der Shop selbst, das Tag bleibt dann wirkungslos. > [!WARNING] > > Die Test-ID muss exakt der ID aus dem A/B-Test-Manager entsprechen. Ein Tippfehler bleibt im Seitenquelltext unbemerkt, verfälscht aber die Auswertung. Zur Kontrolle schreibt das Tag bei einer gefundenen Test-ID einen HTML-Kommentar in die Seite: ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} ``` Er ist im Quelltext der Zielseite sichtbar und im Browser nicht. Damit lässt sich prüfen, ob das Tag an der richtigen Stelle steht, ohne auf die Auswertung im A/B-Test-Manager zu warten. ## Varianten gezielt ansehen Im Testmodus können Sie jeden Testfall selbst aufrufen, statt darauf zu warten, dass der Shop ihn zuweist. Dafür wird der Shop mit drei Parametern aufgerufen: ```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} ?test=on&ab-test-id=&ab-test-case= ``` | Parameter | Bedeutung | | - | - | | `test=on` | schaltet den Testmodus ein | | `ab-test-id` | die ID des Tests, dessen Varianten Sie ansehen wollen | | `ab-test-case` | der Buchstabe des gewünschten Testfalls | Mit `ab-test-id=off` beenden Sie den A/B-Testmodus wieder, ohne den allgemeinen Testmodus zu verlassen. Aufrufe im Testmodus fließen nicht in die Auswertung ein. Weder Ansichten noch Konversionen werden dabei gezählt, Sie können also beliebig oft zwischen den Varianten wechseln. > [!WARNING] > > Der Testmodus greift nur, wenn A/B-Tests für den Shop freigeschaltet sind und die angegebene Test-ID tatsächlich existiert. Stimmt die ID nicht oder ist der Buchstabe kein gültiger Testfall, bleibt der Testmodus stillschweigend ungesetzt, und Sie sehen die regulär zugewiesene Variante. Prüfen Sie in dem Fall zuerst die Schreibweise der ID. Anders als im Livebetrieb prüft der Testmodus nur, ob der Test angelegt ist, nicht ob er gerade läuft. Sie können Varianten also schon vor dem Start und noch nach dem Ende eines Tests ansehen. ## Verwandte Themen * Wegweiser: [A/B-Test](https://dokumentation.websale.de/v8s/funktionen-zur-shop-optimierung/a-b-test.md) * Wegweiser: Testmodus ## Related topics - [A/B-Test](https://dokumentation.websale.de/v8s/funktionen-zur-shop-optimierung/a-b-test.md) - [Sektionen: Positionen und Zahlung](https://dokumentation.websale.de/v8s/schnittstellen/bestellungen/ws-bestelldaten/sektionen-positionen-und-zahlung.md) - [Spezielle Online-Dienste](https://dokumentation.websale.de/v8s/online-servicebereich/spezielle-online-dienste.md) - [Testmodi des Shops ein- und ausschalten](https://dokumentation.websale.de/v8s/domains/testmodi-des-shops-ein-ausschalten.md) - [WEBSALE-Suche und FACT-Finder-Suche parallel betreiben](https://dokumentation.websale.de/v8s/anwendungsbeispiele/appex-websale-und-fact-finder-suche-parallel.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.