As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Importar segmentos

Com o Amazon Pinpoint, você pode definir um segmento de usuário importando um arquivo que contém informações sobre os usuários que pertencem ao segmento. A importação de segmentos é útil se você define segmentos de usuários fora do Amazon Pinpoint, mas deseja envolver os usuários em campanhas do Amazon Pinpoint.

Diferentemente dos segmentos dinâmicos que você cria com o criador de segmentos no console, um segmento importado é um conjunto imutável de endpoints ou usuários: IDs

Um segmento importado consiste em endpointsIDs, usuário ou uma combinação de ambos. Quando você usa o Amazon Pinpoint para enviar uma mensagem ao segmento, os possíveis destinos incluem:

Ao criar um novo segmento, você pode usar um segmento importado como base. Em seguida, você pode aplicar filtros para o segmento base para refinar-lo de acordo com suas necessidades.

Considerações sobre segmentos importados

Considere os seguintes fatores ao criar segmentos importados:

Arquivos de segmentos

Você define os endpoints ou o usuário IDs que pertencem ao seu segmento em valores separados por vírgula (CSV) ou arquivo. JSON Em seguida, importe o arquivo para o Amazon Pinpoint para criar o segmento.

Ao importar um segmento, lembre-se do seguinte:

Exemplo de arquivos de segmento

Os arquivos de exemplo nesta seção são baseados nos seguintes dados:

Cada linha na tabela representa um único endpoint. Observe que o usuário IDs example-user-id-2 e eu example-user-id-3 estamos atribuídos a dois endpoints cada.

Importar um segmento

Há duas maneiras de importar segmentos para o Amazon Pinpoint: você pode carregar arquivos diretamente do seu computador ou importar arquivos armazenados em um bucket do Amazon Simple Storage Service (Amazon S3).

Recomendamos que você faça upload de arquivos do seu computador, especialmente se você já tiver os dados do cliente em seu computador. No entanto, só é possível importar 10 arquivos por vez e fazer upload de arquivos com menos de 1 gigabyte (GB).

Se você precisar importar mais de 10 arquivos de uma vez ou se precisar fazer upload de arquivos maiores que 1 GB, deverá importar arquivos do Amazon S3. A opção de importação do Amazon S3 também será útil se você já tiver processos que enviam arquivos de dados do cliente para o Amazon S3 para armazenamento.

Esta seção inclui procedimentos para importar segmentos usando os dois métodos.

Atributos compatíveis

A tabela nesta seção lista e descreve os atributos que você pode especificar, nas definições de endpoint, que você importa para o Amazon Pinpoint. Se você importar segmentos usando CSV arquivos, os cabeçalhos no arquivo devem corresponder aos nomes mostrados na coluna Atributo.

Para JSON arquivos, um ponto no nome do atributo indica que o nome após o período é um objeto aninhado em um objeto pai com um nome igual ao valor anterior ao período. Por exemplo, um JSON arquivo que contém os Demographic.Model atributos Demographic.Make e tem a seguinte estrutura:

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

A JSON estrutura completa se assemelha muito ao exemplo de solicitação de endpoint no Amazon API Pinpoint Reference. No entanto, nem todos os atributos no esquema de solicitação de endpoint são compatíveis quando você importa os segmentos, incluindo o EndpointStatus e o EffectiveDate.

Para que um campo personalizado tenha vários valoresCSV, você deve replicar o cabeçalho e manter um valor por cabeçalho. Por exemplo:

...,User.UserId, User.UserAttributes.new_multi_field,User.UserAttributes.new_multi_field
...,example-user-id-2,test10,test20

É possível substituir os nomes de atributos exibidos em como custom_attribute por qualquer valor. Por exemplo, se você deseja armazenar o nome e o sobrenome dos usuários em atributos chamados FirstName e LastName, pode criar atributos personalizados chamados User.UserAttributes.FirstName e User.UserAttributes.LastName, respectivamente. Um nome de atributo pode conter até 50 caracteres. Um valor de atributo pode conter até 100 caracteres. Os nomes dos atributos diferenciam maiúsculas de minúsculas.

EmJSON, o atributo personalizado deve ser formatado em"Attributes":{"Ride":["Bus"]}.

É possível criar até 250 atributos personalizados para endpoints e usuários em cada projeto. Para obter mais informações, consulte Cotas do Amazon Pinpoint no Guia do desenvolvedor do Amazon Pinpoint.