Hinzufügen von personalisierten Inhalten zu Nachrichtenvorlagen - Amazon Pinpoint

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Hinzufügen von personalisierten Inhalten zu Nachrichtenvorlagen

Fügen Sie der Nachrichtenvorlage Nachrichtenvariablen hinzu, um dynamische, personalisierte Inhalte in Nachrichten bereitzustellen, die eine Vorlage verwenden. Eine Nachrichtenvariable ist ein Platzhalter, der sich auf ein bestimmtes Attribut bezieht, das Sie oder Amazon Pinpoint zum Speichern von Informationen über Ihre Benutzer erstellt haben. Jedes Attribut entspricht typischerweise einem Merkmal eines Benutzers, z. B. dem Vornamen eines Benutzers oder dem Ort, in dem er wohnt. Durch Hinzufügen von Nachrichtenvariablen zu Vorlagen können Sie diese Attribute verwenden, um jedem Empfänger einer Nachricht, für die eine Vorlage verwendet wird, benutzerdefinierte Inhalte bereitzustellen.

Wenn eine Vorlage Nachrichtenvariablen enthält, ersetzt Amazon Pinpoint jede Variable durch den aktuellen, entsprechenden Wert des Attributs für jeden Empfänger. Dies geschieht jedes Mal, wenn es eine Nachricht sendet, die die Vorlage verwendet. Dies bedeutet, dass Sie personalisierte Inhalte an jeden Empfänger senden können, ohne mehrere benutzerdefinierte Versionen einer Nachrichten- oder Nachrichtenvorlage zu erstellen. Sie können auch sicher sein, dass die Nachricht die neuesten Informationen enthält, die Sie für einen Empfänger haben.

Wenn Ihr Projekt beispielsweise eine Fitnessanwendung für Läufer ist und Attribute für den Vornamen, die bevorzugte Aktivität und den persönlichen Rekord jedes Benutzers enthält, können Sie die folgenden Text- und Nachrichtenvariablen in einer Vorlage verwenden:

Hi {{User.UserAttributes.FirstName}}, congratulations on your new {{User.UserAttributes.Activity}} record of {{User.UserAttributes.PersonalRecord}}!

Wenn Sie eine Nachricht senden, die die Vorlage verwendet, ersetzt Amazon Pinpoint die Variablen durch den aktuellen Wert jedes Attributs für jeden Empfänger. In den nachstehenden Beispielen wird dies veranschaulicht.

Beispiel 1

Hi Sofia, congratulations on your new half marathon record of 1:42:17!

Beispiel 2

Hi Alejandro, congratulations on your new 5K record of 20:52!

Wenn für einen Empfänger kein Attributwert vorhanden ist, kann Amazon Pinpoint eine Variable durch einen Standardwert ersetzen, den Sie für die Variable angeben. Wenn beispielsweise ein Benutzer Ihrer Fitnessanwendung seine bevorzugte Aktivität nicht ausgewählt hat, können Sie running als Standardwert für die Variable {{User.UserAttributes.Activity}} verwenden. In diesem Fall ersetzt Amazon Pinpoint die Variable, wie in den folgenden Beispielen gezeigt:

Beispiel 1

Hi Jane, congratulations on your new running record of 1:42:17!

Beispiel 2

Hi John, congratulations on your new running record of 20:52!

Wenn Sie keinen Standardwert angeben und für einen Empfänger kein Wert vorhanden ist, lässt Amazon Pinpoint beim Senden einer Nachricht an den betreffenden Empfänger den gesamten Text für die Variable weg. Beispielsweise:

Hi Mary, congratulations on your new record of 20:52!

Als bewährte Methode empfiehlt es sich, für jede Variable in einer Vorlage einen Standardwert anzugeben.

Hinzufügen von Nachrichtenvariablen

Sie können Nachrichtenattribute zu einer neuen Vorlage, die Sie erstellen, oder zu einer vorhandenen Vorlage hinzufügen. Wenn Sie einer vorhandenen Vorlage Variablen hinzufügen, wendet Amazon Pinpoint die Änderungen nicht unbedingt auf Nachrichten an, die die Vorlage verwenden und noch nicht gesendet wurden, z. B. Kampagnennachrichten, die zu einem späteren Zeitpunkt gesendet werden sollen. Dies hängt von der Version der Vorlage ab, der Sie Variablen hinzufügen, und von der Konfiguration der Nachrichten, die die Vorlage verwenden. Weitere Informationen finden Sie unter Verwalten von Nachrichtenvorlagenversionen.

Anmerkung

In-App-Messaging-Vorlagen unterstützen die Verwendung von Nachrichtenvariablen nicht.

So fügen Sie einer Nachrichtenvorlage eine Nachrichtenvariable hinzu:
  1. Öffnen Sie die Amazon Pinpoint Pinpoint-Konsole unter https://console.aws.amazon.com/pinpoint/.

  2. Wählen Sie im Navigationsbereich Nachrichtenvorlagen aus.

  3. Führen Sie auf der Seite Message templates (Nachrichtenvorlagen) eine der folgenden Aktionen aus:

    • Um eine neue Vorlage zu erstellen und ihr eine Nachrichtenvariable hinzuzufügen, wählen Sie Create template (Vorlage erstellen) aus. Geben Sie dann auf der Vorlagenseite einen Namen für die Vorlage und optional eine Beschreibung der Vorlage ein.

    • Um einer vorhandenen Vorlage eine Nachrichtenvariable hinzuzufügen, wählen Sie die Vorlage aus, der Sie eine Variable hinzufügen möchten. Wählen Sie dann auf der Vorlagenseite Edit (Bearbeiten) aus. Wählen Sie unter Template details (Vorlagendetails) die Version der Vorlage aus, die Sie als Ausgangspunkt verwenden möchten. Wenn Sie die neueste Version auswählen, können Sie die Änderungen direkt in dieser Version der Vorlage speichern. Andernfalls können Sie Ihre Änderungen als neue Version der Vorlage speichern.

  4. Legen Sie im Abschnitt „Message details (Nachrichtendetails)“ fest, wo Sie eine Nachrichtenvariable hinzufügen möchten. Sie können dem Text jeder Vorlagenart eine Variable hinzufügen. Für E-Mail- und Pushbenachrichtigungsvorlagen können Sie dem Betreff oder dem Titel der Nachricht auch eine Variable hinzufügen.

  5. Erweitern Sie in Attribute finde (Attributsuche) den Abschnitt für den Attributtyp, für den Sie eine Nachrichtenvariable hinzufügen möchten. Sie können unter den folgenden Attributtypen auswählen:

    Standardattribute

    Dies sind Attribute, die Amazon Pinpoint automatisch für jedes Projekt erstellt. Sie können sie also in Nachrichten verwenden können, die Sie für ein beliebiges Projekt senden. Ausführliche Informationen zu den einzelnen Attributen finden Sie unter Unterstützte Attribute.

    Um eine Variable für ein Standardattribut hinzuzufügen, wählen Sie das Attribut aus der Liste aus.

    Custom attributes (Benutzerdefinierte Attribute)

    Dies sind Attribute, die Sie optional für einzelne Projekte erstellen können. Da diese Attribute für einige Ihrer Projekte möglicherweise nicht verfügbar sind, kann Amazon Pinpoint die Variable möglicherweise nicht für jeden Empfänger einer Nachricht, der die Vorlage verwendet, durch einen Wert ersetzen. Um dieses Problem zu vermeiden, bietet Amazon Pinpoint Optionen zur Auswahl eines Attributs, das für bestimmte Projekte oder alle Ihre Projekte vorhanden ist.

    So fügen Sie ein benutzerdefiniertes Attribut hinzu:

    1. Wählen Sie Benutzerdefinierte Attribute und anschließend Benutzerdefinierte Attribute laden aus. In dem sich öffnenden Fenster listet Amazon Pinpoint alle Projekte auf, die Sie erstellt haben. Wenn Sie die einzelnen Projekte auswählen, werden die Attribute, die den ausgewählten Projekten gemeinsam sind, im rechten Navigationsbereich angezeigt. Wenn keine Attribute angezeigt werden, gibt es keine gemeinsamen Attribute zwischen diesen Projekten.

    2. Führen Sie eine der folgenden Aktionen aus:

      • Um alle Attribute zu verwenden, die den ausgewählten Projekten gemeinsam sind, wählen Sie Benutzerdefinierte Attribute laden.

      • Um ein bestimmtes Attribut aus der Liste zu verwenden, geben Sie einen beliebigen Teil des Attributnamens in das Suchfeld ein. Attribute, die dem eingegebenen Text entsprechen, werden angezeigt. Wählen Sie Benutzerdefinierte Attribute laden aus, wenn das Attribut, das Sie verwenden möchten, angezeigt wird. Die Attributsuche zeigt die neu hinzugefügten benutzerdefinierten Attribute an.

        Anmerkung

        Sie können keine gemeinsamen Attribute aus verschiedenen Projektgruppen hinzufügen oder den Abschnitt Benutzerdefinierte Attribute der Attributsuche ändern. Um benutzerdefinierte Attribute zu ändern, wählen Sie X, um die Attributsuche zu löschen, und beginnen Sie dann erneut.

    3. Wählen Sie in Attribute finder (Attributsuche) das Attribut aus, für das Sie eine Variable hinzufügen möchten.

    Recommended attributes (Empfohlene Attribute)

    Dies sind Attribute, die Sie optional für Ihr Konto erstellen, wenn Sie Amazon Pinpoint für den Abruf personalisierter Empfehlungen aus einem Empfehlungsmodell konfigurieren. Informationen zur Verwendung von Empfehlungsmodellen finden Sie unter Machine Learning-Modelle. Sie können Variablen für diesen Attributtyp zu E-Mail-Vorlagen, Vorlagen für Push-Benachrichtigungen und SMS Vorlagen hinzufügen. Es ist nicht möglich, sie zu Sprachvorlagen hinzuzufügen.

    Um eine Variable für ein empfohlenes Attribut hinzuzufügen, wählen Sie das Attribut aus der Liste aus. Wenn der Attributfinder keine empfohlenen Attribute auflistet, müssen Sie die Vorlage zunächst mit einem Empfehlungsmodell verbinden.

    So fügen Sie ein empfohlenes Attribut hinzu:

    1. Wählen Sie Modell verbinden aus.

    2. Wählen Sie das Modell aus, aus dem Sie Empfehlungen abrufen möchten, wenn Sie Nachrichten senden, die die Vorlage verwenden.

    3. Wählen Sie Modell verbinden aus.

  6. Wenn Sie ein Attribut aus der Attributsuche auswählen, erstellt Amazon Pinpoint eine Nachrichtenvariable für das Attribut und kopiert sie in die Zwischenablage. Fügen Sie die Variable an der gewünschten Position ein. Wenn Sie eine lange Liste von Attributen haben, geben Sie Suchtext ein, um die Liste einzugrenzen. Wählen Sie X aus, um das Suchfeld zu leeren.

    Nachdem Sie die Variable eingefügt haben, zeigt Amazon Pinpoint sie als Namen des zugehörigen Attributs an, eingeschlossen in zwei Gruppen geschweifter Klammern – zum Beispiel {{User.UserAttributes.FirstName}}.

  7. Wiederholen Sie die Schritte 4—6 für jede Nachrichtenvariable, die Sie hinzufügen möchten.

  8. Um einen Standardwert für eine Nachrichtenvariable anzugeben, erweitern Sie den Abschnitt Default attribute values (Standardattributwerte). Geben Sie dann in der Liste der Variablen den Standardwert ein, den Sie für die Variable verwenden möchten.

    Anmerkung

    Wir empfehlen, dies für jede Variable in der Vorlage zu tun. Andernfalls ist Amazon Pinpoint möglicherweise nicht in der Lage, eine Nachricht zu senden, die die Vorlage verwendet, oder die Nachricht wird auf unerwartete oder unerwünschte Weise angezeigt.

  9. Führen Sie nach Abschluss einen der folgenden Schritte aus:

    • Wenn Sie einer neuen Vorlage Nachrichtenvariablen hinzugefügt haben, wählen Sie Create (Erstellen) aus.

    • Wenn Sie einer vorhandenen Vorlage Nachrichtenvariablen hinzugefügt haben und Ihre Änderungen als neue Version der Vorlage speichern möchten, wählen Sie Save as new version (Als neue Version speichern) aus.

    • Wenn Sie einer vorhandenen Vorlage Nachrichtenvariablen hinzugefügt haben und Ihre Änderungen als Aktualisierung der neuesten Version der Vorlage speichern möchten, wählen Sie Update version (Version aktualisieren) aus. Diese Option ist nur verfügbar, wenn Sie in Schritt 3 die neueste Version der Vorlage geöffnet haben.

Unterstützte Attribute

Jedes Projekt kann Standardattribute und benutzerdefinierte Attribute haben. Standardattribute sind Attribute, die Amazon Pinpoint automatisch für jedes Projekt erstellt. Benutzerdefinierte Attribute sind Attribute, die Sie optional für ein Projekt erstellen. Es gibt drei Arten von benutzerdefinierten Attributen:

  • Benutzerattribute: Diese Attribute beschreiben einen Benutzer, z. B. den Vornamen, den Nachnamen und das Geburtsdatum eines Benutzers. Ein Benutzer ist eine Person mit einer eindeutigen Benutzer-ID.

  • Endpunktattribute: Diese Attribute beschreiben einen bestimmten Endpunkt für einen Benutzer. Ein Endpunkt ist ein Ziel, an das Sie Nachrichten senden können, wie zum Beispiel eine E-Mail-Adresse, Telefonnummer oder ein Mobilgerät. Jeder Benutzer kann mindestens einem Endpunkt zugeordnet werden. Wenn Sie beispielsweise mit einem Benutzer per E-Mail und Telefon kommunizierenSMS, könnte der Benutzer mit drei Endpunkten verknüpft werden — einem für die E-Mail-Adresse des Benutzers, einem weiteren für die Handynummer des Benutzers und einem weiteren für die Festnetznummer des Benutzers.

  • Metrikattribute: Diese Attribute sind numerische Metriken, die Ihre Anwendung an Amazon Pinpoint für einzelne Endpunkte meldet, z. B. die Anzahl der Sitzungen für eine mobile App oder die Anzahl der in einem Einkaufswagen verbleibenden Artikel.

  • Punktgenaue Attribute — Diese Attribute sind eindeutige Identifikatoren für Ihre Anwendung, Kampagne oder Journey.

Zusätzlich zu benutzerdefinierten Attributen und Standardattributen, die Sie oder Amazon Pinpoint für Ihre Projekte erstellen, unterstützt Amazon Pinpoint empfohlene Attribute. Ein empfohlenes Attribut ist ein Attribut, das vorübergehend personalisierte Empfehlungen für Benutzer oder Endpunkte speichert. Amazon Pinpoint ruft diese Empfehlungen von Empfehlungsmodellen ab, die Sie für die Verwendung konfigurieren. Empfohlene Attribute sind nicht bestimmten Projekten zugeordnet. Vielmehr sind sie Ihrem Amazon-Pinpoint-Konto zugeordnet. Informationen zur Verwendung von Empfehlungsmodellen finden Sie unter Machine Learning-Modelle.

Sie können jedes Standardattribut und jedes benutzerdefinierte oder empfohlene Attribut in einer Nachrichtenvariablen verwenden. In der folgenden Tabelle ist der Text angegeben, der in der Nachrichtenvariablen für jedes unterstützte Attribut angezeigt wird, sowie eine Beschreibung jedes Attributs. In der Tabelle custom_attribute gibt Text an, der in einer Variablen für ein benutzerdefiniertes Attribut erscheint. Ersetzen Sie in diesen Fällen custom_attribute mit dem Namen des benutzerdefinierten Attributs. Wenn Ihr Projekt beispielsweise die Vornamen der Benutzer in einem benutzerdefinierten Benutzerattribut namens FirstName speichert und Sie eine Variable für dieses Attribut hinzufügen, lautet der Text für die Variable {{User.UserAttributes.FirstName}}.

Attribut Beschreibung
Address Die Zieladresse für Nachrichten oder Push-Benachrichtigungen, die Sie an den Endpunkt senden, z. B. eine E-Mail-Adresse, eine Telefonnummer oder ein Geräte-Token.
Pinpoint.ApplicationId Der eindeutige Bezeichner für die Anwendung.
Attributes.custom_attribute Ein benutzerdefiniertes Endpunktattribut, das den Endpunkt beschreibt.
Pinpoint.CampaignId Der eindeutige Bezeichner für die Kampagne.
ChannelType Der Kanal, der beim Senden von Nachrichten oder Push-Benachrichtigungen an den Endpunkt verwendet werden soll. Beispielsweise:
  • APNS— Für einen Endpunkt, der Push-Benachrichtigungen empfangen kann, die Sie über den Apple Push Notification Service (APNs) -Kanal an Apps senden, die auf iOS-Geräten ausgeführt werden.

  • EMAIL: Für einen Endpunkt, der E-Mail-Nachrichten empfangen kann.

  • GCM— Für einen Endpunkt, der Push-Benachrichtigungen empfangen kann, die Sie über den Firebase Cloud Messaging-Kanal (FCM) an Apps senden, die auf Android-Geräten ausgeführt werden.

  • SMS— Für einen Endpunkt, der SMS Textnachrichten empfangen kann.

  • VOICE: Für einen Endpunkt, der Sprachnachrichten empfangen kann.

CreationDate Datum und Uhrzeit des Hinzufügens des Endpunkts zum Projekt im ISO8601-Format. Zum Beispiel 2019-06-30T11:45:25.220Z für 11:45 Uhr am 30. UTC Juni 2019.
Demographic.AppVersion Die Versionsnummer der Anwendung, die diesem Endpunkt zugeordnet ist.
Demographic.Locale Das Gebietsschema des Endpunkts im folgenden Format: der Alpha-2-Code ISO 639-1, gefolgt von einem Unterstrich (_), gefolgt von einem 3166-1-Alpha-2-Wert. ISO Beispielsweise ist en_US das Gebietsschema der USA in englischer Sprache.
Demographic.Make Der Hersteller des Endpunktgeräts, z. B. apple oder samsung.
Demographic.Model Der Modellname oder die Nummer des Endpunktgeräts, z. B. iPhone oder SM-G900F.
Demographic.ModelVersion Die Modellversion des Endpunktgeräts.
Demographic.Platform Das Betriebssystem des Endpunktgeräts, z. B. ios oder android.
Demographic.PlatformVersion Die Version des Betriebssystems auf dem Endpunktgerät.
Demographic.Timezone Die Zeitzone des Endpunkts als ZZ-Datenbankwert. Zum Beispiel America/Los_Angeles für Pacific Time (Nordamerika).
EffectiveDate Datum und Uhrzeit der letzten Aktualisierung des Endpunkts im Format 8601. ISO Zum Beispiel 2019-08-23T10:54:35.220Z für 10:54 Uhr am 23. UTC August 2019.
EndpointId Die eindeutige ID für den Endpunkt.
EndpointStatus Ob Nachrichten oder Push-Benachrichtigungen an den Endpunkt gesendet werden sollen:ACTIVE, Nachrichten an den Endpunkt senden oder,INACTIVE, keine Nachrichten an den Endpunkt senden.
Id Die eindeutige ID für den Endpunkt.
Pinpoint.JourneyId Die eindeutige Kennung für die Reise.
Location.City Der Ort, an dem sich der Endpunkt befindet.
Location.Country Der zweistellige Code im Alpha-2-Format ISO 3166-1 für das Land oder die Region, in der sich der Endpunkt befindet. Zum Beispiel US für die Vereinigten Staaten.
Location.Latitude Der Breitengrad des Endpunktstandorts, auf eine Dezimalstelle gerundet.
Location.Longitude Der Längengrad des Endpunktstandorts, auf eine Dezimalstelle gerundet.
Location.PostalCode Die Postleitzahl oder die ZIP Postleitzahl für das Gebiet, in dem sich der Endpunkt befindet.
Location.Region Der Name der Region, in der sich der Endpunkt befindet, z. B. ein Bundesland oder eine Provinz.
Metrics.custom_attribute Eine benutzerdefinierte numerische Metrik, die Ihre Anwendung für den Endpunkt an Amazon Pinpoint meldet.
OptOut Ob der Benutzer den Empfang von Nachrichten und Push-Benachrichtigungen von Ihnen abgelehnt hat:ALL, der Benutzer hat sich abgemeldet und möchte keine Nachrichten oder Push-Benachrichtigungen erhalten, oder,NONE, der Benutzer hat sich nicht abgemeldet und möchte alle Nachrichten und Push-Benachrichtigungen erhalten.
RecommendationItems Ein empfohlenes Standardattribut, das eine Empfehlung für den Endpunkt oder Benutzer speichert. Dieses Attribut enthält Text, der direkt von einem Empfehlungsmodell bereitgestellt wird.
RecommendationItems.[#]

Ein empfohlenes Standardattribut, das eine geordnete Liste mit 2–5 Empfehlungen für den Endpunkt oder Benutzer speichert. Dieses Attribut enthält Text, der direkt von einem Empfehlungsmodell bereitgestellt wird.

Der numerische Platzhalter (.[#]) gibt an, dass das Attribut mehrere Werte enthält. Eine Nachrichtenvariable für dieses Attribut kann auf einen bestimmten Wert in der Liste verweisen.

Recommendations.custom_attribute Ein benutzerdefiniertes empfohlenes Attribut, das eine Empfehlung für den Endpunkt oder Benutzer speichert. Dieses Attribut enthält Inhalte, die über ein Empfehlungsmodell bereitgestellt und durch eine AWS Lambda Funktion erweitert werden.
Recommendations.custom_attribute.[#]

Ein benutzerdefiniertes empfohlenes Attribut, das mehrere Empfehlungen für den Endpunkt oder Benutzer speichert. Dieses Attribut enthält Inhalte, die von einem Empfehlungsmodell bereitgestellt und durch eine AWS Lambda -Funktion erweitert werden.

Der numerische Platzhalter (.[#]) gibt an, dass das Attribut mehrere Werte enthält. Eine Nachrichtenvariable für dieses Attribut kann sich speziell auf einen dieser Werte beziehen.

RequestId Die eindeutige ID der letzten Anforderung zum Aktualisieren des Endpunkts.
User.UserAttributes.custom_attribute Ein benutzerdefiniertes Benutzerattribut, das den Benutzer beschreibt.
User.UserId Eine eindeutige ID für den Benutzer.