Kampagnenfelder (Campaign Fields)

Die Dokumentfunktion Campaign Fields bindet aktive Kampagnen in Outlook-Signaturvorlagen ein. Sie definiert benannte Kampagnenfelder, die in der Signatur als Platzhalter verwendet werden. Über Tag-Filter wird gesteuert, welche Kampagnen in welcher Signaturvorlage erscheinen.

hinweis

Diese Dokumentfunktion steht ausschliesslich auf Outlook-Signaturvorlagen zur Verfügung.

---

Grundaufbau

<CampaignConfiguration>
  <Campaign Name="SommerAktion" Label="Sommeraktion 2024">
    <TagFilter>
      <Tag>Kampagne</Tag>
      <Tag>Sommer</Tag>
    </TagFilter>
  </Campaign>
  <Campaign Name="WinterAktion" translate-Label="Campaigns.Winter" />
</CampaignConfiguration>

---

Platzhalter in der Signatur

Jedes Kampagnenfeld steht im HTML-Inhalt und im Nur-Text-Inhalt der Signaturvorlage als Platzhalter {{<Name>}} zur Verfügung. Zur Laufzeit wird er durch den Inhalt der ausgewählten Kampagnen-Vorlage ersetzt, im HTML-Inhalt durch deren HTML, im Nur-Text-Inhalt durch deren Nur-Text. Passt keine Kampagne oder wählt der Benutzer keine Kampagne, bleibt der Platzhalter leer.

{{#if SommerAktion}}<p>{{SommerAktion}}</p>{{/if}}

Der {{#if}}-Block lässt das umgebende Markup weg, wenn das Feld leer ist. Ohne Platzhalter im Inhalt erscheint die Kampagne nicht, auch wenn sie aktiv ist.

---

Campaign

Jedes <Campaign>-Element definiert einen Kampagnenfeld-Eintrag.

Attribute

Attribut	Beschreibung
Name (erforderlich)	Technischer Bezeichner des Kampagnenfelds und zugleich der Platzhalter im Inhalt. Muss eindeutig und ohne Leerzeichen sein.
Label	Anzeigename der Kampagnenauswahl im Add-In.
translate-Label	Übersetzungsschlüssel für den Anzeigenamen (alternativ zu Label).
AutoInsert	Steuert, ob eine aktive Kampagne ohne Zutun des Benutzers eingesetzt wird. Standardwert: true. Bei false wirkt die Einstellung je Client-Typ unterschiedlich (siehe Wirkung von AutoInsert).

Wirkung von AutoInsert

AutoInsert="false" unterdrückt eine Kampagne nicht überall gleich:

Client-Typ	Wirkung von AutoInsert="false"
Outlook-Web-Add-In, Signatur wird automatisch eingesetzt (neue Nachricht, geänderte Empfänger)	Der Kampagnenplatzhalter bleibt leer.
Outlook-Web-Add-In, Signatur wird manuell eingefügt	Im Kampagnen-Dropdown ist «keine Kampagne» vorausgewählt. Die Kampagne bleibt wählbar und kann bewusst eingesetzt werden.
primedocs Desktop, automatische Signatur	Keine Wirkung. Die automatische Desktop-Signatur läuft über einen eigenen Mechanismus mit den Menüband-Befehlen Kampagne aktivieren und Kampagne deaktivieren.
primedocs Desktop, Dokument erstellen oder Vorlage testen	Keine Wirkung. Die Kampagne wird eingesetzt.

<!-- Kampagne nur auf ausdrückliche Auswahl, nicht von selbst -->
<Campaign Name="Sonderaktion" Label="Sonderaktion" AutoInsert="false" />

hinweis

AutoInsert steuert die Vorbelegung, nicht die Berechtigung. Soll eine Kampagne gar nicht zur Auswahl stehen, gehört das in den TagFilter oder in die Berechtigungen der Kampagnen-Vorlage.

TagFilter

Über <TagFilter> wird eingeschränkt, welche Kampagnen-Vorlagen für dieses Kampagnenfeld infrage kommen. Jeder <Tag> ist eine Alternative: Eine Kampagnen-Vorlage passt, sobald sie einen der aufgeführten Tags trägt. Mehrere Tags innerhalb eines <Tag>-Elements, durch ; getrennt, muss die Vorlage alle tragen.

<Campaign Name="SommerAktion" Label="Sommeraktion">
  <TagFilter>
    <Tag>Sommer</Tag>
    <Tag>Retail;Schweiz</Tag>
  </TagFilter>
</Campaign>

Dieses Feld nimmt Kampagnen-Vorlagen mit dem Tag Sommer sowie Kampagnen-Vorlagen, die Retail und Schweiz zugleich tragen.

Wird kein <TagFilter> angegeben, kommen alle aktiven Kampagnen-Vorlagen infrage, auch solche ohne Tag.

---

Zusammenspiel mit Kampagnen-Vorlagen

Kampagnenfelder in einer Signaturvorlage werden durch Kampagnen-Vorlagen befüllt. Eine Kampagnen-Vorlage definiert den konkreten Inhalt (Banner, Text, Bild) und ist über Tags mit dem Kampagnenfeld verknüpft.

Das Zusammenspiel:

1. Die Signaturvorlage definiert mit Campaign Fields ein Kampagnenfeld (Name) und führt den Platzhalter {{<Name>}} im Inhalt.
2. Eine oder mehrere Kampagnen-Vorlagen sind mit passenden Tags versehen, veröffentlicht und für den Benutzer freigegeben, und ihr Zeitraum (Aktiv von, Aktiv bis) läuft.
3. Beim Erzeugen der Signatur wählt primedocs unter diesen Kampagnen-Vorlagen die erste nach Priorität und fügt ihren Inhalt in den Platzhalter ein. Im Web-Add-In kann der Benutzer beim manuellen Einfügen der Signatur eine andere der infrage kommenden Kampagnen oder keine Kampagne wählen.

Zeitraum, Priorität und die Reihenfolge bei mehreren aktiven Kampagnen beschreibt die Seite Kampagnen-Vorlage.