Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
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
Abra la consola de Amazon Pinpoint en https://console.aws.amazon.com/pinpoint/
. -
En el panel de navegación, elija Message templates (Plantillas de mensaje).
-
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.
-
-
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.
-
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:
-
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.
-
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.
-
-
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:
-
Elija Conectar modelo.
-
Seleccione el modelo del que desea recuperar las recomendaciones cuando envíe mensajes que utilicen la plantilla.
-
Elija Conectar modelo.
-
-
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}}
. -
Repita los pasos 4 a 6 para cada variable de mensaje que desee agregar.
-
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.
-
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. |
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:
|
CreationDate |
La fecha y hora en que se agregó el punto de enlace al proyecto, en formato ISO 86012019-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-2en_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 horariaAmerica/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 86012019-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-2US 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. |
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. |
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. |
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. |
Un atributo de usuario personalizado que describe al usuario. |
User.UserId |
Un identificador único para el usuario. |