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>

---

Campaign

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

Attribute

Attribut	Beschreibung
Name (erforderlich)	Technischer Bezeichner des Kampagnenfelds. Muss eindeutig und ohne Leerzeichen sein.
Label	Anzeigename in der Benutzeroberfläche.
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 auf dieser Signaturvorlage erscheinen. Nur Kampagnen, die mindestens einen der definierten Tags tragen, werden angezeigt.

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

Wird kein <TagFilter> angegeben, werden alle aktiven Kampagnen berücksichtigt.

---

Zusammenspiel mit Kampagnenvorlagen

Kampagnenfelder in einer Signaturvorlage werden durch Kampagnenvorlagen befüllt. Eine Kampagnenvorlage (Vorlagentyp: Outlook-Kampagnenvorlage) definiert den konkreten HTML-Inhalt (Banner, Text, Bild) und ist über Tags mit der Signaturvorlage verknüpft.

Das Zusammenspiel:

1. Signaturvorlage definiert mit Campaign Fields benannte Platzhalter (Name).
2. Eine oder mehrere Kampagnenvorlagen sind mit passenden Tags versehen.
3. primedocs wählt zur Laufzeit die aktive Kampagnenvorlage anhand der Tags und fügt ihren Inhalt in den entsprechenden Platzhalter ein.