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

Un segmento importado se compone de puntos de enlace IDs, usuarios o una combinación de ambos. Cuando se usa Amazon Pinpoint para enviar un mensaje al segmento, los posibles destinos incluyen:

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:

Archivos de segmento

Los puntos finales o el usuario IDs que pertenecen a su segmento se definen en un archivo de valores separados por comas (CSV) o JSON. A continuación, este archivo se importa a Amazon Pinpoint para crear el segmento.

Al importar un segmento, recuerde lo siguiente:

Ejemplos de archivos de segmento

Los ejemplos de archivos de esta sección se basan en los siguientes datos:

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.

ChannelType,Address,Location.Country,Demographic.Platform,Demographic.Make,User.UserId
SMS,+16045550182,CA,Android,LG,example-user-id-1
APNS,1a2b3c4d5e6f7g8h9i0j1a2b3c4d5e6f,US,iOS,Apple,example-user-id-2
EMAIL,john.stiles@example.com,US,iOS,Apple,example-user-id-2
GCM,4d5e6f1a2b3c4d5e6f7g8h9i0j1a2b3c,CN,Android,Google,example-user-id-3
EMAIL,wang.xiulan@example.com,CN,Android,OnePlus,example-user-id-3

Importación de un segmento

Hay dos formas de importar segmentos en Amazon Pinpoint: puede cargar archivos directamente desde el equipo o puede importar los archivos que se almacenan 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 del cliente 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 con un tamaño superior a 1 GB, deberá importar archivos desde 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.

Atributos admitidos

La tabla de esta sección muestra y describe los atributos que puede especificar en las definiciones de puntos de conexión que se van a importar en Amazon Pinpoint. Si importa segmentos utilizando archivos CSV, los encabezados del archivo deben coincidir con los nombres que se muestran en la columna Attribute (Atributo).

Para los archivos JSON, un punto en el nombre del atributo indica que el nombre que aparece después de ese punto es un objeto anidado en un objeto principal con un nombre que sea igual al valor anterior al punto. Por ejemplo, un archivo JSON que contiene los atributos Demographic.Make y Demographic.Model presenta la siguiente estructura:

{
...
"Demographic": {
  ...
  "Make":"Apple",
  "Model":"iPhone"
  ...
  }
...
}

La estructura JSON completa se parece bastante a la solicitud de punto de conexión de ejemplo en la Referencia de la API de Amazon Pinpoint. 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 valores en CSV, 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.

En JSON, el atributo personalizado debe tener el formato adecuado en "Attributes":{"Ride":["Bus"]}.

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.