Bei einer Attributreferenz handelt es sich um die Syntax eines Attributs in Mapp Engage. Diese Syntax ist die Form des Attributs, die Mapp Engage erkennt und zur Verarbeitung der Attributinformation nutzen kann.

Verwenden Sie die Attributreferenz in folgenden Situationen:

  • Beim Erstellen personalisierter Nachrichten.

  • Beim Importieren von Kontakt- und Profildaten in Mapp Engage mittels einer CSV- oder XML-Datei.

  • Beim Erstellen von Mapp Engage-Funktionen.

Dieses Thema bietet eine Übersicht über folgende Attributreferenzen:

  • ​Standardattribute​
  • Angepasste Attribute​
  • Verteilerattribute:​  
  • Mitgliedsattribute​
  • Platzhalter für andere Informationen

Standardattribute​

In individuell konfigurierten Systemen können Standardattribute verwendet werden, um verschiedene Werte von den hier aufgeführten zu speichern. In der Regel werden die Attribute jedoch mit den hier beschriebenen Werten befüllt sein.

Personalisierungs-Platzhalter erstellen: Um Informationen direkt in eine Nachricht einzufügen, wird der gesamte Ausdruck innerhalb der Platzhalter-Zeichen platziert: <% .... %>. Das System ersetzt alles, was zwischen diesen Zeichen steht, mit den entsprechenden Daten oder Informationen. Dieser Prozess findet während des Versands statt. Eine Vorschau der aufgelösten Personalisierungen können Sie im Dialog ​Nachrichtenvorschau​ ansehen.

Name

Attributreferenz

Personalisierungs-Platzhalter

Im Attribut gespeicherte Daten

​E-Mail-Adresse

${user['Email']}

<%${user['Email']}%>

E-Mail-Adresse des Kontakts.

Mobilfunknummer

${user['MobileNumber']}

<%${user['MobileNumber']}%>

Mobilfunknummer des Kontakts.

Die Mobilfunknummer muss den Ländercode beinhalten. Es kann ein Plus-Zeichen (+) vor die Nummer gesetzt werden.

Mobile App-Alias​

${user['FaxNumber']}

<%${user['AppAlias']}%>

Mobile App-Alias des Kontakts

Vorname

${user['FirstName']}

<%${user['FirstName']}%>

Vorname des Kontakts.

Nachname

${user['LastName']}

<%${user['LastName']}%>

Nachname des Kontakts.

Anrede

${user['Title']}

<%${user['Title']}%>

Hier wird das Präfix festgelegt, das zum Namen des Kontakts hinzugefügt wird. Der Attributwert wird im System als Zahl gespeichert.

  • Herr – Dieser Wert wird als Zahl 1 gespeichert.

  • Frau – Dieser Wert wird als Zahl 2 gespeichert.
    Ist ein Wert nicht spezifiziert, wird der Attributwert als -1 gespeichert.

Verwenden Sie keinen Platzhalter, um das Attribut ​Anrede​ in eine Nachricht einzufügen. Die Zahl wird in den Text Ihrer Nachricht eingefügt.

Geburtstag

${user['DateOfBirth']}

<%${user['DateOfBirth']}%>

Das Geburtsdatum des Kontakts.

Beispiel: 16.04.1965

Quell-ID​

${user['PartnerId']}

<%${user['PartnerId']}%>

ID, die die Quelle des Kontakts identifiziert (z. B. durch bestimmte Seiten oder Aktionen).

Benutzeridentifikatoren

${user['Identifier']}

<%${user['Identifier']}%>

Externer Identifikator (z. B. von einem CRM-System).

Im Kontaktprofil speichert das Attribut ​Identifikator​ einen externen Identifikator im Mapp Engage-System. Diese ID kann beispielsweise eine in einem externen CRM-System verwendete ID sein.

Die maximale Länge des externen Identifikators beträgt 20 Zeichen.

Land

${user['ISOCountryCode']}

<%${user['ISOCountryCode']}%>

Das Herkunftsland des Kontakts.

Das Format ist das standardisierte ISO-Länderformat (z. B. FR für Frankreich, EN für England).

Sprache

${user['ISOLanguageCode']}

<%${user['ISOLanguageCode']}%>

Sprache des Empfängers.

Das Format ist das standardisierte ISO-Sprachformat (z. B. fr für Französisch, en für Englisch).

Postleitzahl

${user['ZipCode']}

<%${user['ZipCode']}%>

Postleitzahl des Kontakts.

Pseudonym

${user['Nickname']}

<%${user['Nickname']}%>

Das Pseudonym des Kontakts.

Herkunft

${user['Source']}

<%${user['Source']}%>

Dieses Attribut speichert die Herkunft des Kontakts.

Mapp Engage befüllt dieses Attribut automatisch, wenn der Kontakt im System erstellt wird.

Folgende Werte sind möglich:

  • Importieren​ – Der Kontakt wurde durch einen Datenimport erstellt (CSV, XML oder Text).

  • Hinzufügen​ – Der Kontakt wurde manuell im System erstellt.

  • Web​ – Der Kontakt hat sich über eine Zielseite angemeldet.

  • Mail​ – Der Kontakt hat sich per E-Mail angemeldet. Diese Funktion wird in den Verteilereinstellungen definiert.

  • SMS​ – Der Kontakt hat sich per eingehender SMS angemeldet.

  • Unbekannt​ – Die Herkunft des Kontakts ist unbekannt.

  • Weiterleitung​ – Der Kontakt wurde mit einer weitergeleiteten Nachricht erstellt.

  • Vorschau​ – Der Kontakt wurde als Testempfänger in einem Verteiler hinzugefügt.

  • SOAP​ – Der Kontakt wurde durch einen API-Aufruf hinzugefügt.

Angepasste Attribute​

Ein angepasstes Attribut ist ein Property-Feld, das Daten über einen Kontakt speichert. Dieser Attributstyp wird individuell für Ihr System erstellt. Angepasste Attribute sind systemspezifisch und werden nicht standardmäßig von Mapp Engage bereitgestellt. Sie können angepasste Attribute erstellen, um die für Ihre Marketing-Anforderungen und -Strategien relevanten Kontaktdaten zu speichern.

Sie können den Namen der Profilattribute in Ihrem System im Bereich ​Administration​ anzeigen.

Die Attributreferenz verfügt über das folgende Format:${user.CustomAttribute['Name']}

Der entsprechende Personalisierungs-Platzhalter ist wie folgt aufgebaut: <%${user.CustomAttribute['Name']}%>

Beispiel

Ein Attribut mit dem Namen LetzterKauf weist folgende Referenz auf: ${user.CustomAttribute['LetzterKauf']}

Um den Attributwert direkt in eine Nachricht einzufügen, verwenden Sie den Platzhalter <%${user.CustomAttribute['LetzterKauf']}%>


Verteilerattribute

Ein Verteilerattribut speichert einen Wert für alle Mitglieder eines Verteilers. Der Wert ist für alle Verteilermitglieder identisch.

Sie können den Namen und die Werte der Verteilerattribute in jedem Verteiler im Bereich ​Administration​ anzeigen.

Sie können Verteilerattribute in der Mapp Engage-Benutzeroberfläche im Bereich ​Verteiler​ oder mit einer Importdatei erstellen.

Die Attributreferenz verfügt über das folgende Format: ${group.CustomAttribute['Name']}

Der entsprechende Personalisierungs-Platzhalter ist wie folgt aufgebaut: <%${group.CustomAttribute['Name']}%>

Beispiel

Ein Attribut mit dem Namen ReiseZiel weist folgende Referenz auf: ${group.CustomAttribute['Reiseziel']}

Um den Attributwert direkt in eine Nachricht einzufügen, verwenden Sie den Platzhalter <%${group.CustomAttribute['Reiseziel']}%>


Mitgliedsattribute​

Mithilfe von Mitgliedsattributen können Sie unterschiedliche Informationen für denselben Kontakt in unterschiedlichen Verteilern speichern.

Sie können Mitgliedsattribute nur durch den Import einer XML- oder CSV-Datei erstellen. Die manuelle Erstellung von Mitgliedsattributen auf der CEP-Benutzeroberfläche ist nicht möglich.

Sie können Mitgliedsattribute im Profil des Kontakts anzeigen, müssen jedoch über das Register ​Mitgliedschaften​ im Bereich ​Kontaktverwaltung​ auf den Kontakt zugreifen.

Die Attributreferenz verfügt über das folgende Format: ${user.MemberAttribute['Name']}

Der entsprechende Personalisierungs-Platzhalter ist wie folgt aufgebaut: <%${user.MemberAttribute['Name']}%>

Beispiel

Ein Attribut mit dem Namen LastPurchase weist folgende Referenz auf: ${user.MemberAttribute['LetzterKauf']}

Um den Attributwert direkt in eine Nachricht einzufügen, verwenden Sie den Platzhalter <%${user.MemberAttribute['LetzterKauf']}%>


Platzhalter für andere Informationen​

Tag

Beschreibung

<%${member['CreationDate']}%>

Das Datum, an dem der Kontakt sich zum Verteiler angemeldet hat oder zum Verteiler hinzugefügt wurde.

Das Datum hat folgendes Format: yyyy-mm-dd hh:mm:ss:ms.

<%${member['MessageCounter']}%>

Die kumulierte Anzahl der Nachrichten, die vom ausgewählten Verteiler an den Kontakt gesendet wurden.

<%${group['name']}%>

Name des Verteilers.

<%${group['Email']}%>

E-Mail-Adresse des Verteilers

<%${group['NoOfMembers']}%>

Aktuelle Anzahl der aktiven Mitglieder des Verteilers.

<%${message['RecipientCount']}%>

Anzahl der Empfänger, an die eine Nachricht gesendet wurde, in der der Platzhalter enthalten war.

<%${message['Forwarded']}%>

Dieses Attribut enthält einen booleschen Wert.

False​ – Die Nachricht wurde über einen normalen Versand versendet.

True​ – Die Nachricht wurde mit einem Mapp Engage-Weiterleitungsnachrichtenformular versendet.

<%${user['EmailDomain']}%>

Die Domäne der E-Mail-Adresse des Kontakts.

Die E-Mail-Domäne ist der Teil der Adresse, der nach dem @-Symbol steht.

Verwandte Themen​