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.
Importación de segmentos
Con Amazon Pinpoint, puede definir un segmento de usuarios mediante la importación de un archivo que contiene información acerca de los usuarios que pertenecen al segmento. La importación de segmentos resulta útil si los segmentos de usuarios se definen fuera de Amazon Pinpoint, pero se desea conectar a los usuarios con campañas de Amazon Pinpoint.
A diferencia de los segmentos dinámicos que se crean con el generador de segmentos de la consola, un segmento importado es un conjunto inmutable de puntos finales o usuarios: IDs
- Punto de conexión
-
Un destino al que puede enviar mensajes, por ejemplo, una dirección de correo electrónico, el identificador de un dispositivo móvil o el número de un teléfono móvil. Una definición de punto de enlace puede incluir atributos que describan al usuario o el dispositivo al que se envían los mensajes. También puede incluir un ID de usuario.
Puede definir un segmento importando una lista de definiciones de puntos de conexión. Amazon Pinpoint crea el segmento y actualiza con la nueva información todos los puntos de conexión que haya agregado previamente a Amazon Pinpoint.
- ID de usuario
-
Un ID que representa a un usuario individual de la audiencia. Este ID debe asignarse a uno o varios puntos de enlace. Por ejemplo, si una persona utiliza la aplicación en varios dispositivos, la aplicación puede asignar su ID de usuario al punto de enlace de cada dispositivo.
Puede definir un segmento importando el usuario IDs únicamente si ha añadido los puntos de enlace asociados al usuario IDs a Amazon Pinpoint.
Un segmento importado se compone de puntos de enlaceIDs, usuarios o una combinación de ambos. Cuando se usa Amazon Pinpoint para enviar un mensaje al segmento, los posibles destinos incluyen:
-
Cada punto de enlace que figure en el archivo importado.
-
Cada punto de enlace que esté asociado con cada ID de usuario que figure en el archivo importado.
Cuando crea un nuevo segmento, puede utilizar uno importado como segmento base. Después puede aplicar filtros al segmento de base, que ajustará según sus necesidades.
Consideraciones sobre segmentos importados
Debe tener en cuenta los factores siguientes al crear segmentos importados:
-
Al crear una campaña, debe elegir un segmento. Al elegir un segmento dinámico, Amazon Pinpoint proporciona una estimación del tamaño de dicho segmento. Sin embargo, cuando se elige un segmento importado, Amazon Pinpoint no puede proporcionar una estimación.
-
Si crea una campaña que envía mensajes cuando se producen determinados eventos, no se pueden utilizar segmentos importados. Las campañas basadas en eventos solo puede utilizar segmentos dinámicos. Para obtener más información acerca de la creación de segmentos dinámicos, consulte Creación de segmentos.
Archivos de segmento
Defina los puntos de enlace o el usuario IDs que pertenecen a su segmento en un archivo o valores separados por comasCSV. JSON A continuación, este archivo se importa a Amazon Pinpoint para crear el segmento.
Al importar un segmento, recuerde lo siguiente:
-
Amazon Pinpoint no puede importar archivos comprimidos.
-
Los archivos que importe deben utilizar una codificación de UTF 8 caracteres.
-
Si importa puntos de enlace nuevos, los atributos
Address
yChannelType
son obligatorios. -
Si está actualizando puntos de enlace existentes, el atributo
Id
es obligatorio para cada punto de enlace que desee actualizar. -
Las definiciones de puntos de enlace solo pueden incluir determinados atributos. Para ver una lista, consulte Atributos admitidos. Además, el nombre de un atributo debe tener 50 caracteres o menos. El valor de un atributo debe tener 100 caracteres o menos.
Ejemplos de archivos de segmento
Los ejemplos de archivos de esta sección se basan en los siguientes datos:
ChannelType | Dirección | Location.Country | Demographic.Platform | Demographic.Make | Usuario. UserId |
---|---|---|---|---|---|
SMS | +16045550182 | CA | Android | LG | example-user-id-1 |
APNS | 1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f | EE. UU. | iOS | Apple | example-user-id-2 |
john.stiles@example.com | EE. UU. | iOS | Apple | example-user-id-2 | |
GCM | 4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c | CN | Android | example-user-id-3 | |
wang.xiulan@example.com | CN | Android | OnePlus | example-user-id-3 |
Cada fila de esta tabla representa un punto de enlace individual. Tenga en cuenta que el usuario IDs example-user-id-2
y example-user-id-3
yo estamos asignados a dos puntos finales cada uno.
ejemplo Archivo con definiciones de puntos de enlace
Importación de un segmento
Hay dos formas de importar segmentos a Amazon Pinpoint: puede cargar archivos directamente desde su ordenador o puede importar archivos almacenados en un bucket de Amazon Simple Storage Service (Amazon S3).
Le recomendamos que cargue los archivos desde su ordenador, especialmente si ya tiene los datos de los clientes en su ordenador. Sin embargo, solo se pueden importar 10 archivos a la vez, y solo puede cargar archivos con un tamaño inferior a 1 gigabyte (GB).
Si necesita importar más de 10 archivos a la vez o si necesita cargar archivos de más de 1 GB, debe importar los archivos de Amazon S3. La opción de importación de Amazon S3 también es útil si ya dispone de procesos que envíen archivos de datos del cliente a Amazon S3 para el almacenamiento.
Esta sección incluye procedimientos para la importación de segmentos mediante estos dos métodos.
Puede crear segmentos mediante la carga de hasta 10 archivos directamente desde su equipo. Los archivos que cargue pueden estar en JSON formato CSV o formato. Puede cargar archivos de cualquier combinación de formatos. Por ejemplo, puede cargar un JSON archivo y tres CSV archivos.
Para importar un segmento
Abra la consola Amazon Pinpoint en. https://console.aws.amazon.com/pinpoint/
-
En la página All projects (Todos los proyectos), elija el proyecto al que desee añadir el segmento.
-
En el panel de navegación, seleccione Segments (Segmentos).
-
Seleccione Create a segment (Crear segmento).
-
En Create a segment (Crear un segmento), seleccione Import a segment (Importar un segmento).
-
En Import method (Importar método), elija Upload files from your computer (Cargar archivos desde el equipo).
-
En Files to import (Archivos que importar), seleccione Choose files (Elegir archivos). Seleccione el archivo o los archivos que desee importar.
nota
También puede arrastrar archivos desde el explorador de archivos del equipo y soltarlos directamente en el área Drop files here (Soltar archivos aquí).
-
Cuando cargue archivos en Amazon Pinpoint, tendrá que proporcionar un nombre de segmento para cada archivo que importe. En Nombres de segmento, introduzca un nombre de segmento para cada archivo que desee importar.
De forma predeterminada, Amazon Pinpoint proporciona un nombre de segmento que es igual al nombre del archivo importado, pero sin la extensión de nombre de archivo. Puede cambiar estos valores predeterminados a cualquier nombre.
nota
Puede utilizar el mismo nombre para varios segmentos. Si lo hace, Amazon Pinpoint crea un segmento distinto para cada archivo, y asigna un ID exclusivo a cada archivo. La fecha de creación es ligeramente diferente para cada archivo que importa. Puede utilizar estos factores para distinguir entre segmentos que tengan el mismo nombre.
-
Cuando haya terminado, elija Create segment (Crear segmento).
Antes de utilizar este procedimiento para importar un segmento, primero debe crear un bucket de Amazon S3 y cargar el archivo en ese bucket. Puede organizar los archivos de segmentos distintos en carpetas diferentes. Cuando Amazon Pinpoint importa los puntos de enlace o el usuario IDs de un segmento, incluye los archivos en todas las carpetas y subcarpetas que pertenecen a la ubicación de Amazon S3 que especifique.
Para obtener una introducción a la creación de buckets y a la carga de objetos, consulte ¿Qué es Amazon S3? en la Guía del usuario de Amazon Simple Storage Service.
Amazon Pinpoint solo puede importar un formato de archivo (CSVoJSON) por segmento, por lo que la ruta de Amazon S3 que especifique solo debe contener archivos de un solo tipo.
Para importar un segmento
Abra la consola Amazon Pinpoint en. https://console.aws.amazon.com/pinpoint/
-
En la página All projects (Todos los proyectos), elija el proyecto al que desee añadir el segmento.
-
En el panel de navegación, seleccione Segments (Segmentos).
-
Seleccione Create a segment (Crear segmento).
-
En Create a segment (Crear un segmento), seleccione Import a segment (Importar un segmento).
-
En Nombre del segmento, introduzca un nombre para el segmento.
-
En el caso de Amazon S3 URL, introduzca la ubicación del depósito de Amazon S3 que contiene el archivo de su segmento. La dirección del bucket debe estar en el siguiente formato:
s3://
bucket-name
/folder-name
Amazon Pinpoint importa los archivos desde la ruta especificada y desde cualquier subcarpeta de esa ruta.
-
Para IAMel rol, complete uno de los siguientes pasos:
-
Si quiere que Amazon Pinpoint cree un rol que permita leer desde un bucket de Amazon S3, elija Crear un rol automáticamente. A continuación, en el caso del IAMrol, introduce un nombre para el rol que vas a crear.
-
Si ya ha creado un IAM rol que permite a Amazon Pinpoint leer desde un bucket de Amazon S3, elija Choose an existing role. A continuación, para IAMel rol, elija un rol que contenga los permisos adecuados.
Si desea crear el IAM rol usted mismo, consulte el IAMrol para importar puntos de enlace o segmentos en la Guía para desarrolladores de Amazon Pinpoint. Después de crear el rol, especifíquelo en la consola de Amazon Pinpoint.
-
-
En Qué tipo de archivo va a importar, elija Notación de JavaScript objeto (JSON) o Valores separados por comas (CSV), según el formato del archivo que haya cargado en Amazon S3.
-
Seleccione Create segment (Crear segmento).
Atributos admitidos
En la tabla de esta sección se enumeran y describen los atributos que puede especificar, en las definiciones de puntos de conexión, que se importan a Amazon Pinpoint. Si importa segmentos mediante CSV archivos, los encabezados del archivo deben coincidir con los nombres que aparecen en la columna de atributos.
En el caso de JSON los archivos, un punto en el nombre del atributo indica que el nombre que sigue al punto es un objeto anidado en un objeto principal con un nombre igual al valor que precede al punto. Por ejemplo, un JSON archivo que contiene los Demographic.Model
atributos Demographic.Make
y tiene la siguiente estructura:
{
...
"Demographic": {
...
"Make":"Apple",
"Model":"iPhone"
...
}
...
}
La JSON estructura completa se parece mucho a la solicitud de punto final de ejemplo de Amazon Pinpoint API Reference. Sin embargo, no todos los atributos del esquema de la solicitud de punto de enlace se admiten al importar segmentos, como EndpointStatus
y EffectiveDate
.
Para que un campo personalizado tenga varios valoresCSV, debe replicar el encabezado y conservar un valor por encabezado. Por ejemplo:
...,User.UserId, User.UserAttributes.new_multi_field,User.UserAttributes.new_multi_field
...,example-user-id-2,test10,test20
Puede reemplazar los nombres de atributo que se muestran como
por cualquier valor. Por ejemplo, si desea almacenar los nombres y apellidos de los usuarios en los atributos denominados custom_attribute
FirstName
y LastName
puede crear atributos personalizados denominados User.UserAttributes.FirstName
y User.UserAttributes.LastName
, respectivamente. Un nombre de atributo puede contener hasta 50 caracteres. Un valor de atributo puede contener hasta 100 caracteres. Los nombres de atributo distinguen entre mayúsculas y minúsculas.
EnJSON, el atributo personalizado debe tener el formato adecuado. "Attributes":{"Ride":["Bus"]}
Atributo | Descripción | ||||||
---|---|---|---|---|---|---|---|
Address |
La dirección de destino única 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. notaSi la dirección del punto de conexión es un número de teléfono, debe especificarlo en formato E.164. Para obtener más información sobre el formato E.164, consulte E.164 |
||||||
Attributes. |
Un atributo personalizado que describe el punto de enlace. Puede utilizar este tipo de atributo como criterios de selección al crear un segmento. Puede sustituir por cualquier valor. |
||||||
ChannelType |
El canal que se va a utilizar al enviar mensajes o notificaciones de inserción al punto de enlace. Por ejemplo:
|
||||||
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 final, en el siguiente formato: el código ISO639-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).notaLas siguientes zonas horarias ya no son compatibles y se reasignan automáticamente a las zonas horarias compatibles.
|
||||||
EffectiveDate |
La fecha y la hora de la última actualización del punto final, en formato 8601. ISO2019-08-23T10:54:35.220Z para las 10:54 a.m. del 23 UTC de agosto de 2019. |
||||||
Id |
El identificador único para el punto de enlace. | ||||||
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 o ZIP postal del área en la que se encuentra el punto final. | ||||||
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, por ejemplo, el número de sesiones o el número de artículos que quedan en un carrito, para utilizarla con fines de segmentación. Puede sustituir por cualquier valor.Estos valores personalizados solo pueden ser numéricos. Puesto que se trata de números, Amazon Pinpoint puede realizar operaciones aritméticas, como obtener el valor promedio o la suma, con ellos. |
||||||
OptOut |
Indica si un usuario ha elegido no recibir mensajes y notificaciones de inserción de usted. Los valores aceptables son: ALL el usuario se ha excluido y no quiere recibir ningún mensaje o notificación automática, o bienNONE , el usuario no se ha excluido y quiere recibir todos los mensajes y notificaciones push. |
||||||
RequestId |
El identificador único de la solicitud más reciente para actualizar el punto de enlace. | ||||||
User.UserAttributes. |
Un atributo personalizado que describe al usuario. Puede sustituir por cualquier valor, como FirstName o Age . |
||||||
User.UserId |
Un identificador único para el usuario. |
Puede crear hasta 250 atributos personalizados para los puntos de conexión y usuarios de cada proyecto. Para obtener más información, consulte Cuotas de Amazon Pinpoint en la Guía para desarrolladores de Amazon Pinpoint.