Adición de contenido personalizado a plantillas de mensajes

Para entregar contenido dinámico y personalizado en mensajes que utilizan una plantilla, agregue variables de mensaje a la plantilla de mensaje. Una variable de mensaje es un marcador de posición que hace referencia a un atributo específico que usted o Amazon Pinpoint ha creado para almacenar información sobre los usuarios. Cada atributo normalmente corresponde a una característica de un usuario, como, por ejemplo, el nombre del usuario o la ciudad donde vive. Al agregar variables de mensaje a las plantillas, puede utilizar estos atributos para entregar contenido personalizado a cada destinatario de un mensaje que use una plantilla.

Si una plantilla contiene variables de mensaje, Amazon Pinpoint sustituye automáticamente cada variable por el valor actual correspondiente del atributo para cada destinatario. Lo hace cada vez que envía un mensaje que utiliza la plantilla. Esto significa que puede enviar contenido personalizado a cada destinatario sin crear varias versiones personalizadas de un mensaje o plantilla de mensaje. También puede sentirse seguro de que el mensaje contiene la información más reciente que tiene para un destinatario.

Por ejemplo, si su proyecto es una aplicación de fitness para corredores e incluye atributos para el nombre, la actividad preferida y el récord personal de cada usuario, podría usar las siguientes variables de texto y mensaje en una plantilla:

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

Cuando envía un mensaje que utiliza la plantilla, Amazon Pinpoint sustituye las variables por el valor actual de cada atributo para cada destinatario. Los siguientes ejemplos muestran cómo lo hace.

Ejemplo 1

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

Ejemplo 2

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

Si no existe un valor de atributo para un destinatario, Amazon Pinpoint puede sustituir una variable por un valor predeterminado que especifique para la variable. Por ejemplo, si un usuario de su aplicación de fitness no ha elegido su actividad preferida, usted podría usar running como valor predeterminado para la variable {{User.UserAttributes.Activity}}. En este caso, Amazon Pinpoint sustituye la variable tal como se muestra en los siguientes ejemplos:

Ejemplo 1

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

Ejemplo 2

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

Si no especifica un valor predeterminado y no existe un valor para un destinatario, Amazon Pinpoint omite todo el texto de la variable cuando envía un mensaje a dicho destinatario. Por ejemplo:

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

Se recomienda especificar un valor predeterminado para cada variable que se incluya en una plantilla.

Adición de variables de mensaje

Puede agregar atributos de mensaje a una nueva plantilla que cree o a una plantilla existente. Si agrega variables a una plantilla existente, Amazon Pinpoint no aplica necesariamente los cambios a los mensajes existentes que utilizan la plantilla y que aún no se han enviado, como los mensajes de campaña que están programados para enviarse más adelante. Esto depende de la versión de la plantilla a la que agregue variables y de cómo configuró los mensajes que utilizan la plantilla. Para obtener más información, consulte Administración de versiones de plantillas de mensajes.

nota

Las plantillas de mensajes integrados en la aplicación no admiten el uso de variables de mensaje.

Para agregar una variable de mensaje a una plantilla de mensaje

1. Abra la consola de Amazon Pinpoint en https://console.aws.amazon.com/pinpoint/.

2. En el panel de navegación, elija Message templates (Plantillas de mensaje).

3. En la página Message templates (Plantillas de mensaje), realice una de las siguientes opciones:

   • Para crear una plantilla nueva y agregarle una variable de mensaje, elija Create template (Crear una plantilla). A continuación, en la página de plantilla, introduzca un nombre para la plantilla y, opcionalmente, una descripción de la plantilla.

   • Para agregar una variable de mensaje a una plantilla existente, elija la plantilla a la que desea agregar una variable. A continuación, en la página de plantilla, elija Edit (Editar). En Template details (Detalles de la plantilla), utilice el selector de versiones para elegir la versión de la plantilla que desea utilizar como punto de partida. Si elige la versión más reciente, puede guardar los cambios directamente en esa versión de la plantilla. De lo contrario, puede guardar los cambios como una versión nueva de la plantilla.

4. En la sección de detalles del mensaje, determine dónde desea agregar una variable de mensaje. Puede agregar una variable al cuerpo del mensaje de cualquier tipo de plantilla. Para las plantillas de notificación de inserción y correo electrónico, también puede agregar una variable al asunto o título del mensaje.

5. En el Attribute finder (Buscador de atributos), expanda la sección del tipo de atributo para el que desea agregar una variable de mensaje. Puede elegir entre los siguientes tipos de atributos:

   Atributos estándar

   Estos son atributos que Amazon Pinpoint crea automáticamente para cualquier proyecto. Esto significa que puede usarlos en mensajes que envíe para cualquier proyecto. Para obtener información detallada sobre cada uno de estos atributos, consulte Atributos admitidos.

   Para agregar una variable para un atributo estándar, elija el atributo de la lista.

   Custom attributes (Atributos personalizados)

   Estos son atributos que puede crear opcionalmente para proyectos individuales. Dado que es posible que estos atributos no estén disponibles para algunos de los proyectos, es posible que Amazon Pinpoint no pueda reemplazar la variable por un valor para todos y cada uno de los destinatarios de un mensaje que utiliza la plantilla. Para ayudarle a evitar este problema, Amazon Pinpoint proporciona opciones que le ayudarán a elegir un atributo que exista para proyectos específicos o para todos los proyectos.

   Para agregar un atributo personalizado:

   1. Elija Atributos personalizados y, a continuación, elija Cargar atributos personalizados. En la ventana que aparece, Amazon Pinpoint muestra todos los proyectos que ha creado. Al elegir cada proyecto, los atributos comunes a los proyectos seleccionados se muestran en el panel de navegación de la derecha. Si no se muestra ningún atributo, significa que no hay atributos comunes entre esos proyectos.

   2. Realice una de las siguientes acciones siguientes:

      • Para usar todos los atributos comunes a los proyectos seleccionados, elija Cargar atributos personalizados.

      • Si desea utilizar un atributo específico de la lista, ingrese cualquier parte del nombre del atributo en el campo de búsqueda. Se muestran los atributos que coinciden con el texto ingresado. Elija Cargar atributos personalizados cuando se muestre el atributo que desea utilizar. El buscador de atributos muestra los atributos personalizados recién agregados.

        nota

        No puede agregar atributos comunes de diferentes conjuntos de proyectos ni modificar la sección de atributos personalizados del buscador de atributos. Si necesita realizar cambios en los atributos personalizados, elija X para borrar el buscador de atributos y, a continuación, vuelva a empezar.

   3. En el Attribute finder (Buscador de atributos), elija el atributo para el que desea agregar una variable.

   Recommended attributes (Atributos recomendados)

   Estos son los atributos que puede crear opcionalmente para la cuenta cuando se configura Amazon Pinpoint para recuperar recomendaciones personalizadas de un modelo de recomendación. Para obtener información sobre el uso de modelos de recomendación, consulte Modelos de aprendizaje automático. Puede agregar variables para este tipo de atributo a plantillas de correo electrónico, plantillas de notificación push y plantillas de SMS. No puede agregarlas a plantillas de voz.

   Para agregar una variable para un atributo recomendado, elija el atributo de la lista. Si el Attribute finder (Buscador de atributos) no muestra ningún atributo recomendado, tendrá que conectar primero la plantilla a un modelo de recomendación.

   Para agregar un atributo recomendado:

   1. Elija Conectar modelo.

   2. Seleccione el modelo del que desea recuperar las recomendaciones cuando envíe mensajes que utilicen la plantilla.

   3. Elija Conectar modelo.

6. Cuando elige un atributo del Buscador de atributos, Amazon Pinpoint crea una variable de mensaje para el atributo y la copia en el portapapeles. Pegue la variable en la ubicación que desee. Si tiene una lista larga de atributos, ingrese el texto de búsqueda para reducir la lista. Elija X para borrar el campo de búsqueda.

   Tras pegar la variable, Amazon Pinpoint la muestra como el nombre del atributo asociado, entre dos conjuntos de llaves, por ejemplo, {{User.UserAttributes.FirstName}}.

7. Repita los pasos 4 a 6 para cada variable de mensaje que desee agregar.

8. Para especificar un valor predeterminado para una variable de mensaje, expanda la sección Default attribute values (Valores de atributo predeterminados). A continuación, en la lista de variables, introduzca el valor predeterminado que desea utilizar para la variable.

   nota

   Le recomendamos que haga esto para cada variable de la plantilla. De lo contrario, es posible que Amazon Pinpoint no pueda enviar un mensaje que utilice la plantilla o que el mensaje se muestre de formas inesperadas o no deseadas.

9. Cuando termine, realice una de las siguientes acciones:

   • Si ha agregado variables de mensaje a una plantilla nueva, elija Create (Crear).

   • Si ha agregado variables de mensaje a una plantilla existente y desea guardar los cambios como una versión nueva de la plantilla, elija Save as new version (Guardar como versión nueva).

   • Si ha agregado variables de mensaje a una plantilla existente y desea guardar los cambios como una actualización de la versión más reciente de la plantilla, elija Update version (Actualizar versión). Esta opción solo está disponible si ha abierto la versión más reciente de la plantilla en el paso 3.

Atributos admitidos

Cada proyecto puede tener atributos estándar y atributos personalizados. Los atributos estándar son atributos que Amazon Pinpoint crea automáticamente para cualquier proyecto. Los atributos personalizados son atributos que puede definir opcionalmente para un proyecto. Hay tres tipos de atributos personalizados:

• Atributos de usuario: estos atributos describen a un usuario, por ejemplo, el nombre, los apellidos y la fecha de nacimiento. Un usuario es un individuo que tiene un ID de usuario único para un proyecto.

• Atributos de punto de conexión: estos atributos describen un punto de conexión específico para un usuario. Un punto de conexión es un destino al que puede enviar mensajes, como una dirección de correo electrónico, un número de teléfono o un dispositivo móvil. Cada usuario se puede asociar a uno o varios puntos de enlace. Por ejemplo, si se comunica con un usuario por correo electrónico, SMS y teléfono, el usuario podría estar asociado a tres puntos de conexión: uno para la dirección de correo electrónico del usuario, otro para el número de teléfono móvil del usuario y otro para el número de teléfono de casa (fijo) del usuario.

• Atributos de métricas: estos atributos son métricas numéricas de las que la aplicación informa a Amazon Pinpoint para puntos de conexión individuales, como el número de sesiones de una aplicación móvil o el número de artículos que quedan en la cesta.

• Atributos Pinpoint: estos atributos son identificadores únicos para su aplicación, campaña o recorrido.

Además de los atributos personalizados y estándar que usted o Amazon Pinpoint crean para los proyectos, Amazon Pinpoint admite atributos recomendados. Un atributo recomendado es un atributo que almacena temporalmente las recomendaciones personalizadas para los usuarios o puntos de conexión. Amazon Pinpoint recupera estas recomendaciones de los modelos recomendados para los que se configura. Los atributos recomendados no están asociados a proyectos específicos. En su lugar, están asociados a la cuenta de Amazon Pinpoint. Para obtener información sobre el uso de modelos de recomendación, consulte Modelos de aprendizaje automático.

Puede utilizar cualquier atributo estándar, personalizado o recomendado en una variable de mensaje. La tabla siguiente indica el texto que aparece en una variable de mensaje para cada atributo admitido y describe cada atributo. En la tabla, custom_attribute indica texto que aparece en una variable para un atributo personalizado. En esos casos, reemplace custom_attribute por el nombre del atributo personalizado. Por ejemplo, si el proyecto almacena los nombres de los usuarios en un atributo de usuario personalizado denominado FirstName y agrega una variable para ese atributo, el texto de la variable es {{User.UserAttributes.FirstName}}.

Atributo	Descripción
Address	La dirección de destino de los mensajes o las notificaciones de inserción que envía al punto de conexión, por ejemplo, una dirección de correo electrónico, un número de teléfono o un token de dispositivo.
Pinpoint.ApplicationId	El identificador único de la aplicación.
Attributes.custom_attribute	Un atributo de punto de enlace personalizado que describe el punto de enlace.
Pinpoint.CampaignId	El identificador único de la campaña.
ChannelType	El canal que se va a utilizar al enviar mensajes o notificaciones de inserción al punto de enlace. Por ejemplo: APNS: para un punto de conexión que puede recibir notificaciones de inserción que envíe a través del canal de Apple Push Notification service (APNs) a aplicaciones que se ejecutan en dispositivos iOS. EMAIL: para un punto de conexión que puede recibir mensajes de correo electrónico. GCM: para un punto de conexión que puede recibir notificaciones de inserción que envíe a través del canal de Firebase Cloud Messaging (FCM) a aplicaciones que se ejecutan en dispositivos Android. SMS: para un punto de conexión que puede recibir mensajes de texto SMS. VOICE: para un punto de conexión que puede recibir mensajes de voz.
CreationDate	La fecha y hora en que se agregó el punto de enlace al proyecto, en formato ISO 8601. Por ejemplo, 2019-06-30T11:45:25.220Z para las 11:45 UTC 30 de junio de 2019.
Demographic.AppVersion	El número de versión de la aplicación que está asociada al punto de enlace.
Demographic.Locale	La configuración regional del punto de enlace, en el formato siguiente: el código ISO 639-1 alfa-2 seguido de un guion bajo (_), seguido de un valor ISO 3166-1 alfa-2. Por ejemplo, en_US es la configuración regional en inglés para los Estados Unidos.
Demographic.Make	El fabricante del dispositivo del punto de enlace, como, por ejemplo, apple o samsung.
Demographic.Model	Nombre o número del modelo del dispositivo del punto de enlace, como iPhone o SM-G900F.
Demographic.ModelVersion	La versión de modelo del dispositivo del punto de enlace.
Demographic.Platform	El sistema operativo del dispositivo del punto de enlace, como, por ejemplo, ios o android.
Demographic.PlatformVersion	La versión del sistema operativo en el dispositivo del punto de enlace.
Demographic.Timezone	La zona horaria del punto de enlace, como un valor de base de datos de zona horaria. Por ejemplo, America/Los_Angeles para la hora del Pacífico (América del Norte).
EffectiveDate	La fecha y la hora de la última actualización del punto de enlace, en formato ISO 8601. Por ejemplo, 2019-08-23T10:54:35.220Z para 10:54 UTC 23 de agosto de 2019.
EndpointId	El identificador único para el punto de enlace.
EndpointStatus	Si desea enviar mensajes o notificaciones de inserción al punto de enlace: ACTIVE, enviar mensajes al punto de enlace; o INACTIVE, no enviar mensajes al punto de enlace.
Id	El identificador único para el punto de enlace.
Pinpoint.JourneyId	El identificador único del viaje.
Location.City	La ciudad en la que se encuentra el punto de enlace.
Location.Country	El código de dos caracteres, en formato ISO 3166-1 alfa-2, del país o región en que se encuentra el punto de enlace. Por ejemplo, US para los Estados Unidos.
Location.Latitude	La coordenada de latitud de la ubicación del punto de enlace, redondeada a un decimal.
Location.Longitude	La coordenada de longitud de la ubicación del punto de enlace, redondeada a un decimal.
Location.PostalCode	El código postal del área donde se encuentra el punto de enlace.
Location.Region	El nombre de la región, como un estado o una provincia, en la que se encuentra ubicado el punto de enlace.
Metrics.custom_attribute	Una métrica numérica personalizada de la que la aplicación informa a Amazon Pinpoint para el punto de conexión.
OptOut	Si un usuario ha cancelado la opción de recibir sus mensajes y notificaciones push: ALL, el usuario ha cancelado la opción de recibir mensajes o notificaciones push; o NONE, el usuario no ha cancelado la opción de recibir mensajes y desea recibir todos los mensajes y notificaciones push.
RecommendationItems	Un atributo recomendado estándar que almacena una recomendación para el punto de enlace o el usuario. Este atributo contiene texto proporcionado directamente por un modelo de recomendación.
RecommendationItems.[#]	Un atributo recomendado estándar que almacena una lista ordenada de 2-5 recomendaciones para el punto de conexión o el usuario. Este atributo contiene texto proporcionado directamente por un modelo de recomendación. El marcador de posición numérico (.[#]) indica que el atributo contiene varios valores. Una variable de mensaje para este atributo puede hacer referencia a un valor específico de la lista.
Recommendations.custom_attribute	Un atributo recomendado personalizado que almacena una recomendación para el punto de enlace o el usuario. Este atributo contiene contenido proporcionado por un modelo de recomendación y mejorado por una AWS Lambda función.
Recommendations.custom_attribute.[#]	Un atributo recomendado personalizado que almacena varias recomendaciones para el punto de enlace o el usuario. Este atributo incluye contenido proporcionado por un modelo de recomendación y mejorado por una función de AWS Lambda . El marcador de posición numérico (.[#]) indica que el atributo contiene varios valores. Una variable de mensaje para este atributo puede hacer referencia específicamente a uno de esos valores.
RequestId	El identificador único de la solicitud más reciente para actualizar el punto de enlace.
User.UserAttributes.custom_attribute	Un atributo de usuario personalizado que describe al usuario.
User.UserId	Un identificador único para el usuario.