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 informações sobre os endpoints que pertencem ao segmento. Um endpoint é um destino de mensagens único, como um token de push para dispositivos móveis, um número de celular ou um endereço de e-mail.
A importação de segmentos é útil se você já criou segmentos de usuários fora do Amazon Pinpoint, mas deseja envolver os usuários em campanhas do Amazon Pinpoint.
Quando você importa um segmento, o Amazon Pinpoint obtém os endpoints do segmento do Amazon Simple Storage Service (Amazon S3). Antes de importar, adicione os endpoints ao Amazon S3 e crie um perfil do IAM que conceda ao Amazon Pinpoint acesso ao Amazon S3. Em seguida, você informa a ao Amazon Pinpoint o local de armazenamento dos endpoints do Amazon S3, e o Amazon Pinpoint adiciona cada endpoint ao segmento.
Para criar o perfil do IAM, consulte IAMfunção para importar endpoints ou segmentos. Para obter informações sobre a importação de um segmento usando o console do Amazon Pinpoint, consulte Importar segmentos no Guia do usuário do Amazon Pinpoint.
Para ver mais exemplos de código, consulte Exemplos de código.
Importar um segmento
O exemplo a seguir demonstra como importar um segmento usando o AWS SDK for Java.
import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.pinpoint.PinpointClient; import software.amazon.awssdk.services.pinpoint.model.CreateImportJobRequest; import software.amazon.awssdk.services.pinpoint.model.ImportJobResponse; import software.amazon.awssdk.services.pinpoint.model.ImportJobRequest; import software.amazon.awssdk.services.pinpoint.model.Format; import software.amazon.awssdk.services.pinpoint.model.CreateImportJobResponse; import software.amazon.awssdk.services.pinpoint.model.PinpointException;
import software.amazon.awssdk.regions.Region; import software.amazon.awssdk.services.pinpoint.PinpointClient; import software.amazon.awssdk.services.pinpoint.model.CreateImportJobRequest; import software.amazon.awssdk.services.pinpoint.model.ImportJobResponse; import software.amazon.awssdk.services.pinpoint.model.ImportJobRequest; import software.amazon.awssdk.services.pinpoint.model.Format; import software.amazon.awssdk.services.pinpoint.model.CreateImportJobResponse; import software.amazon.awssdk.services.pinpoint.model.PinpointException; /** * Before running this Java V2 code example, set up your development * environment, including your credentials. * * For more information, see the following documentation topic: * * https://docs.aws.amazon.com/sdk-for-java/latest/developer-guide/get-started.html */ public class ImportSegment { public static void main(String[] args) { final String usage = """ Usage: <appId> <bucket> <key> <roleArn>\s Where: appId - The application ID to create a segment for. bucket - The name of the Amazon S3 bucket that contains the segment definitons. key - The key of the S3 object. roleArn - ARN of the role that allows Amazon Pinpoint to access S3. You need to set trust management for this to work. See https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html """; if (args.length != 4) { System.out.println(usage); System.exit(1); } String appId = args[0]; String bucket = args[1]; String key = args[2]; String roleArn = args[3]; PinpointClient pinpoint = PinpointClient.builder() .region(Region.US_EAST_1) .build(); ImportJobResponse response = createImportSegment(pinpoint, appId, bucket, key, roleArn); System.out.println("Import job for " + bucket + " submitted."); System.out.println("See application " + response.applicationId() + " for import job status."); System.out.println("See application " + response.jobStatus() + " for import job status."); pinpoint.close(); } public static ImportJobResponse createImportSegment(PinpointClient client, String appId, String bucket, String key, String roleArn) { try { ImportJobRequest importRequest = ImportJobRequest.builder() .defineSegment(true) .registerEndpoints(true) .roleArn(roleArn) .format(Format.JSON) .s3Url("s3://" + bucket + "/" + key) .build(); CreateImportJobRequest jobRequest = CreateImportJobRequest.builder() .importJobRequest(importRequest) .applicationId(appId) .build(); CreateImportJobResponse jobResponse = client.createImportJob(jobRequest); return jobResponse.importJobResponse(); } catch (PinpointException e) { System.err.println(e.awsErrorDetails().errorMessage()); System.exit(1); } return null; } }
Para ver o exemplo completo do SDK, consulte ImportingSegments.java on. GitHub