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 y ChannelType 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:

Ejemplo de valores de atributos de puntos de enlace
ChannelType	Dirección	Location.Country	Demographic.Platform	Demographic.Make	Usuario. UserId
SMS	[phone]	CA	Android	LG	example-user-id-1
APNS	1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f	EE. UU.	iOS	Apple	example-user-id-2
EMAIL	[e-mail]	EE. UU.	iOS	Apple	example-user-id-2
GCM	4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c	CN	Android	Google	example-user-id-3
EMAIL	[e-mail]	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

CSV

Puede importar los puntos finales que estén definidos en un CSV archivo, como en el siguiente ejemplo:

ChannelType,Address,Location.Country,Demographic.Platform,Demographic.Make,User.UserId
SMS,[phone],CA,Android,LG,example-user-id-1
APNS,1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f,US,iOS,Apple,example-user-id-2
EMAIL,[e-mail],US,iOS,Apple,example-user-id-2
GCM,4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c,CN,Android,Google,example-user-id-3
EMAIL,[e-mail],CN,Android,OnePlus,example-user-id-3

La primera línea es el encabezado, que contiene los atributos del punto de enlace. Para obtener una lista completa de posibles atributos, consulte Atributos admitidos.

En las líneas siguientes se definen los puntos de enlace mediante la inclusión de valores para cada atributo del encabezado.

Para incluir una coma o comillas dobles en un valor, escriba el valor entre comillas dobles, por ejemplo, "aaa,bbb".

El CSV archivo no puede contener saltos de línea ni tabulaciones. Si el archivo contiene datos con saltos de línea o tabulaciones, es posible que los datos del archivo no se importen o que se produzca un error en el proceso de importación.

JSON

Puede importar los puntos finales que estén definidos en un archivo delimitado por líneas nuevas. JSON En este formato, cada línea es un JSON objeto completo que contiene una definición de punto final individual, como en el siguiente ejemplo:

{"ChannelType":"SMS","Address":"[phone]","Location":{"Country":"CA"},"Demographic":{"Platform":"Android","Make":"LG"},"User":{"UserId":"example-user-id-1"}}
{"ChannelType":"APNS","Address":"1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f","Location":{"Country":"US"},"Demographic":{"Platform":"iOS","Make":"Apple"},"User":{"UserId":"example-user-id-2"}}
{"ChannelType":"EMAIL","Address":"[e-mail]","Location":{"Country":"US"},"Demographic":{"Platform":"iOS","Make":"Apple"},"User":{"UserId":"example-user-id-2"}}
{"ChannelType":"GCM","Address":"4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c","Location":{"Country":"CN"},"Demographic":{"Platform":"Android","Make":"Google"},"User":{"UserId":"example-user-id-3"}}
{"ChannelType":"EMAIL","Address":"[e-mail]","Location":{"Country":"CN"},"Demographic":{"Platform":"Android","Make":"OnePlus"},"User":{"UserId":"example-user-id-3"}}

Para obtener una lista completa de posibles atributos, consulte Atributos admitidos.

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.

Importación de un segmento mediante la carga de un archivo desde el equipo

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

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

2. En la página All projects (Todos los proyectos), elija el proyecto al que desee añadir el segmento.

3. En el panel de navegación, seleccione Segments (Segmentos).

4. Seleccione Create a segment (Crear segmento).

5. En Create a segment (Crear un segmento), seleccione Import a segment (Importar un segmento).

6. En Import method (Importar método), elija Upload files from your computer (Cargar archivos desde el equipo).

7. 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í).

8. 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.

9. Cuando haya terminado, elija Create segment (Crear segmento).

Importación de un segmento desde un archivo almacenado en Amazon S3

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

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

2. En la página All projects (Todos los proyectos), elija el proyecto al que desee añadir el segmento.

3. En el panel de navegación, seleccione Segments (Segmentos).

4. Seleccione Create a segment (Crear segmento).

5. En Create a segment (Crear un segmento), seleccione Import a segment (Importar un segmento).

6. En Nombre del segmento, introduzca un nombre para el segmento.

7. 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.

8. 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.

9. 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.

10. 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 custom_attribute por cualquier valor. Por ejemplo, si desea almacenar los nombres y apellidos de los usuarios en los atributos denominados 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. nota Si 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 en Wikipedia.
Attributes.custom_attribute	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 custom_attribute 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: APNS— Para un terminal que pueda recibir notificaciones push que envíes a través del canal del servicio de notificaciones push de Apple (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 terminal que pueda recibir notificaciones push que envíes a través del canal Firebase Cloud Messaging (FCM) a aplicaciones que se ejecutan en dispositivos Android. SMS— Para un terminal que pueda recibir mensajes de SMS texto.
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-2, seguido de un guión bajo (_), seguido de un valor de 3166-1 alfa-2. ISO 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). nota Las siguientes zonas horarias ya no son compatibles y se reasignan automáticamente a las zonas horarias compatibles. Zona horaria Zona horaria reasignada Canada/East-Saskatchewan America/Managua US/Pacific-New America/Los_Angeles
EffectiveDate	La fecha y la hora de la última actualización del punto final, en formato 8601. ISO Por ejemplo, 2019-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-2, del país o la región donde se encuentra el punto final. 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 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.custom_attribute	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 custom_attribute 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.custom_attribute	Un atributo personalizado que describe al usuario. Puede sustituir custom_attribute 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.