> ## 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. # Kampagnen-Steuerung > Zeitgesteuerte Marketing-Aktionen einrichten, Konfigurationswerte und Templatebereiche an eine Kampagne binden und Zeitpläne pflegen. Eine Kampagne schaltet Teile Ihres Shops für einen festgelegten Zeitraum um. Typisches Beispiel: An zwei Wochenenden im Jahr liefern Sie versandkostenfrei, und auf der Startseite liegt währenddessen ein Banner. Das Besondere daran ist die Arbeitsteilung. Eingerichtet wird eine Kampagne einmal, von jemandem, der Konfiguration und Templates beherrscht. Ein- und ausgeschaltet wird sie später vom Händler selbst, ohne dass jemand an Konfiguration oder Templates muss. ![Kampagnen](https://mintcdn.com/websaleag-44ee7ea6/-4O6W3x8MU7HVGrG/images/kampagnen.jpg?fit=max\&auto=format\&n=-4O6W3x8MU7HVGrG\&q=85\&s=e6664d1c0086948e8b5c33d8134705af) Diese Funktion muss von der WEBSALE AG für Ihren Shop freigeschaltet werden. ## Dienste und Aufgaben | Dienst | Wer damit arbeitet | Wofür | | - | - | - | | **Konfiguration**, Registerkarte **KampagnenManager** | wer den Shop einrichtet | Kampagnen anlegen und festlegen, welche Inhalte sie ersetzen | | **KampagnenSteuerung** | der Händler | Zeitpläne anlegen, ändern und löschen | Beide Dienste liegen im Online-Servicebereich. ## Die Bausteine einer Kampagne | Baustein | Aufgabe | | - | - | | Kampagnen-ID | benennt die Kampagne. Sie taucht in Konfiguration und Templates auf | | Config-Eintrag-ID | benennt **eine** Stelle in der Konfiguration, die diese Kampagne umschaltet | | Zeitplan | legt fest, wann die Kampagne aktiv ist. Mehrere Zeiträume je Kampagne sind möglich | Die zweite Ebene ist der Grund, warum das System so mächtig ist. Eine Kampagne "Versandkostenreduktion" kann gleichzeitig die UPS-Kosten und die DHL-Kosten umschalten, mit unterschiedlichen Werten. Dafür bekommt sie zwei Config-Einträge, beispielsweise `ups-versandkosten` und `dhl-versandkosten`. > [!WARNING] > > Vergeben Sie sprechende IDs. Sie stehen später in der Konfiguration und in den Templates, und dort ist eine ID wie `Kampagne1` wertlos. Notieren Sie beide IDs beim Anlegen, Sie brauchen sie in den nächsten Schritten wörtlich. ## Was Sie über Kampagnen wissen sollten | Punkt | Regel | | - | - | | Geltungsbereich | Kampagnen werden für den ganzen Shop angelegt und je Subshop aktiviert | | Anzahl | zunächst bis zu zehn Kampagnen. Das Limit lässt sich auf Anfrage erhöhen | | Zeiträume | je Kampagne beliebig viele | | Zeitzone | einstellbar, damit die Zeitzone der jeweiligen Region gilt | | Hinweisbereiche in Templates | beliebig viele | | Config-Einträge | beliebig viele | > [!WARNING] > > Kampagnen-Tags funktionieren in allen bearbeitbaren subshop-spezifischen Konfigurationsdateien, also in `.dat`- und `.config`-Dateien des jeweiligen Subshops, beispielsweise auch in der `country.dat`. In globalen Konfigurationsdateien funktionieren sie **nicht**. Wegweiser: [Konfigurations-Typen](https://dokumentation.websale.de/v8s/grundlagen-konfiguration/konfigurations-typen.md) ## Das Tag `WS-Campaign` in zwei Rollen Dasselbe Tag arbeitet an zwei Stellen unterschiedlich. | Ort | Schreibweise | Wirkung | | - | - | - | | Konfigurationsdatei | `$WS-Campaign(Kampagnen-ID,Config-Eintrag-ID)$` | wird durch den hinterlegten Inhalt ersetzt, je nachdem ob die Kampagne aktiv ist | | Template | `{WS-Campaign(Kampagnen-ID)}…{/WS-Campaign(Kampagnen-ID)}` | Abschnitt, der nur während der Kampagne erscheint | In der Konfiguration stehen **zwei** Parameter und Dollarzeichen als Klammer, im Template **ein** Parameter und die geschweifte Abschnittsklammer. Wer die Schreibweisen verwechselt, bekommt keinen Fehler, sondern nur keine Wirkung. ## Eine Kampagne anlegen Als durchgehendes Beispiel dient eine Kampagne `versandfrei`, die die Versandkosten eines Versanddienstleisters umstellt und dazu ein Banner einblendet. ### Schritt 1: Die betroffenen Konfigurationszeilen vorbereiten Öffnen Sie im Dienst **Konfiguration** die Shopkonfiguration des betreffenden Subshops und suchen Sie die Zeilen, die die Kampagne ändern soll. Kopieren Sie sie in ein separates Editorfenster und legen Sie zwei Fassungen an: die bisherigen Werte für die Zeit ohne Kampagne und die neuen Werte für die Zeit mit Kampagne. ![Kampagne Konfigs Notierenall](https://mintcdn.com/websaleag-44ee7ea6/-4O6W3x8MU7HVGrG/images/kampagne_konfigs_notierenall.jpg?fit=max\&auto=format\&n=-4O6W3x8MU7HVGrG\&q=85\&s=9d16824a5bd25e2a9371d387a06ea876) Diese Vorarbeit lohnt sich, weil Sie beide Fassungen gleich in den Kampagnen-Config-Eintrag übernehmen und den Originalinhalt nicht verlieren. ### Schritt 2: Die Kampagne anlegen 1. Wechseln Sie auf die Registerkarte **KampagnenManager**. 2. Bewegen Sie den Mauszeiger über den Titelbalken **Kampagnen** im Navigationsbereich und klicken Sie auf das eingeblendete Dokumentsymbol. 3. Vergeben Sie im Dialogfenster Namen und Kampagnen-ID und legen Sie die Grundeinstellungen fest. 4. Speichern Sie. Die Kampagne erscheint in der Liste im Navigationsbereich. ![Kampagne1neuerstellung](https://mintcdn.com/websaleag-44ee7ea6/-4O6W3x8MU7HVGrG/images/kampagne1neuerstellung.jpg?fit=max\&auto=format\&n=-4O6W3x8MU7HVGrG\&q=85\&s=9ae1bcbe3a268f31718039bcbb46464b) ### Schritt 3: Die Config-Einträge anlegen Jede Stelle der Konfiguration, die umgeschaltet werden soll, braucht einen eigenen Config-Eintrag. 1. Klicken Sie in der Liste auf die Kampagne. Rechts erscheint ihre Definition. 2. Klicken Sie in der Titelzeile des Abschnitts **Kampagnen-Config-Einträge** auf das Dokumentsymbol. 3. Vergeben Sie Namen und Config-Eintrag-ID. 4. Tragen Sie unter **Inhalt (aktiv)** die Fassung für die laufende Kampagne ein und unter **Inhalt (inaktiv)** die Fassung für die übrige Zeit. Der inaktive Inhalt ist optional. 5. Speichern Sie und legen Sie bei Bedarf weitere Einträge an. ![Kampagne1konfig Eintrag](https://mintcdn.com/websaleag-44ee7ea6/-4O6W3x8MU7HVGrG/images/kampagne1konfig_eintrag.jpg?fit=max\&auto=format\&n=-4O6W3x8MU7HVGrG\&q=85\&s=d3f94775102fb8808c77ee8201da5637) Zusammenhängende Konfigurationszeilen, auch ein ganzer Abschnitt, passen in einen einzigen Config-Eintrag. Sie brauchen also nicht je Zeile einen Eintrag, sondern je Stelle, die zusammen umgeschaltet wird. ### Schritt 4: Das Tag in die Konfiguration einsetzen Öffnen Sie die `shop.config` jedes zugeordneten Subshops, suchen Sie den betreffenden Inhalt und ersetzen Sie ihn durch das Tag. ```ini theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} <+Deliverer> Allow = yes ID = 1 Name-Txt = UPS BasicCost-List = $WS-Campaign(versandfrei,ups-versandkosten)$ # ohne Kampagne: (0:10)(200:8) NoCost-Txt = %%ShopConfigDeliverer01NoCostTxt%% DeliveryCountry-Rule = AllowCountries DeliveryCountry-List = DEU ``` > [!WARNING] > > Schreiben Sie den ursprünglichen Inhalt als Kommentar in dieselbe Zeile. Sonst steht dort nach dem Ersetzen nur noch ein Tag, und niemand kann Monate später nachvollziehen, welcher Wert vorher galt. Beim Abbau der Kampagne brauchen Sie genau diesen Wert wieder. Speichern und aktivieren Sie anschließend. Prüfen Sie noch in der geöffneten Ansicht, ob die Config-Einträge übernommen wurden. ### Schritt 5: Den Bereich im Template anlegen Auf jedem Template lässt sich ein Bereich einrichten, der nur während der Kampagne erscheint. Das kann ein Satz sein, ein Banner, ein Seitenabschnitt oder eine vollständig andere Seite. ```html theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} {WS-Campaign(versandfrei)} Dieses Wochenende versandkostenfrei bestellen {/WS-Campaign(versandfrei)} ``` Das Tag verlangt zwingend eine Kampagnen-ID als Parameter. Ohne Parameter liefert es nichts. Referenz: [WS-Campaign()](https://dokumentation.websale.de/v8s/referenz/tags/ws/merkzettel-vergleich-upload-und-externe-dienste.md#die-tags-im-uberblick) ## Zeitpläne festlegen und ändern Die Kampagne ist damit eingerichtet, aber noch ohne Wirkung. Erst ein Zeitplan schaltet sie ein. 1. Wählen Sie im Online-Servicebereich Ihre Shop-ID und den Dienst **KampagnenSteuerung**. 2. Wählen Sie links die Kampagne aus. Rechts erscheint ihre Definition. 3. Klicken Sie in der Titelzeile des Abschnitts **Zeitplan** auf das Dokumentsymbol und wählen Sie Anfangs- und Enddatum. 4. Speichern Sie. Der Zeitraum erscheint in der Liste der Zeitpläne. Zum Ändern klicken Sie in der Zeile des Zeitplans auf das Stiftsymbol, zum Löschen auf das Papierkorbsymbol. ![Kampagnensteuerung](https://mintcdn.com/websaleag-44ee7ea6/-4O6W3x8MU7HVGrG/images/kampagnensteuerung.png?fit=max\&auto=format\&n=-4O6W3x8MU7HVGrG\&q=85\&s=8618e961f82c62faabe55a714d24c5e9) Jeder Anwender mit den entsprechenden Rechten kann Zeitpläne pflegen. Genau dafür ist die KampagnenSteuerung ein eigener Dienst: Der Händler steuert seine Aktionen selbst, ohne an die Konfiguration zu müssen. ## Eine Kampagne vorab prüfen Sie können eine Kampagne ansehen, bevor ihr Zeitplan greift. 1. Öffnen Sie im Dienst **Konfiguration** auf der Registerkarte **Konfigurationen** die `shop.config` des gewünschten Subshops. 2. Klicken Sie rechts oben in der Titelzeile auf das Symbol für die Testkonfiguration. 3. Wählen Sie die zu testenden Kampagnen aus, auch mehrere, und klicken Sie auf **Testkonfiguration erstellen**. 4. Rufen Sie den Shop im Testmodus mit dem zusätzlichen Parameter auf. ![Kampagne1 Test](https://mintcdn.com/websaleag-44ee7ea6/-4O6W3x8MU7HVGrG/images/kampagne1_test.jpg?fit=max\&auto=format\&n=-4O6W3x8MU7HVGrG\&q=85\&s=d70485bb348081a624ff793031189b86) ```text theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/websale.json"]}} https://www.beispielshop.de/?test=on&campaign-test=on https://www.beispielshop.de/?test=on&campaign-test=off ``` > [!WARNING] > > Der Kampagnen-Testmodus wirkt nur zusammen mit dem Testmodus des Shops. `campaign-test=on` allein bewirkt nichts. > > Im Testmodus lassen sich nur **inaktive** Kampagnen einschalten. Die umgekehrte Probe, also eine laufende Kampagne testweise abzuschalten, ist damit nicht möglich. Planen Sie das Ende einer Aktion deshalb über den Zeitplan und nicht über den Testmodus. Das Ein- und Ausschalten des Kampagnen-Testmodus veranlasst den Shop, die Konfiguration neu einzulesen, einmal die Testfassung und einmal die normale. Deshalb wirken die geänderten Konfigurationswerte sofort. Wegweiser: [Testmodi des Shops ein-/ausschalten](https://dokumentation.websale.de/v8s/domains/testmodi-des-shops-ein-ausschalten.md) ## Prüfen, welche Kampagnen gerade laufen In der Kampagnenliste steht hinter jeder Kampagne ein Uhrensymbol. Grün bedeutet, dass die Kampagne laut Zeitplan gerade aktiv ist, ausgegraut bedeutet inaktiv. Die Liste finden Sie sowohl in der KampagnenSteuerung als auch im KampagnenManager. Der Shop merkt sich den Zustand einer Kampagne kurzzeitig, statt ihn bei jedem Seitenaufruf neu zu ermitteln. Eine gerade geänderte Zeitplanung schlägt deshalb nicht im selben Moment im Shop durch. ## Eine Kampagne abbauen > [!WARNING] > > Bevor Sie eine Kampagnendefinition löschen, setzen Sie die betroffenen Stellen in der Konfiguration auf ihren Ausgangszustand zurück und entfernen Sie die Bereiche aus den Templates. Ein Tag, dessen Kampagne es nicht mehr gibt, hinterlässt in der Konfiguration eine Lücke an einer Stelle, an der vorher ein Wert stand, beispielsweise bei Versandkosten. ## Verwandte Themen * Wegweiser: [Konfigurations-Typen](https://dokumentation.websale.de/v8s/grundlagen-konfiguration/konfigurations-typen.md) * Wegweiser: Testmodi des Shops ein-/ausschalten * Referenz: [WS-Campaign()](https://dokumentation.websale.de/v8s/referenz/tags/ws/merkzettel-vergleich-upload-und-externe-dienste.md#die-tags-im-uberblick) ## Related topics - [Spezielle Online-Dienste](https://dokumentation.websale.de/v8s/online-servicebereich/spezielle-online-dienste.md) - [Mehrwertsteuer](https://dokumentation.websale.de/v8s/preise/mehrwertsteuer.md) - [Testmodi des Shops ein- und ausschalten](https://dokumentation.websale.de/v8s/domains/testmodi-des-shops-ein-ausschalten.md) - [Arbeiten mit dem Online-Servicebereich](https://dokumentation.websale.de/v8s/arbeiten-mit-dem-online-servicebereich.md) - [Merkzettel, Vergleich, Upload und externe Dienste](https://dokumentation.websale.de/v8s/referenz/tags/ws/merkzettel-vergleich-upload-und-externe-dienste.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.