Solução de problemas em segmentos - Amazon Pinpoint

Solução de problemas em segmentos

Verifique se o registro em log está ativado para ajudar a identificar a causa da falha. Para obter mais informações, consulte Monitorar e registrar em log.

Falha ao importar segmentos

Se a importação de segmentos falhar, é possível visualizar a mensagem de erro a seguir ou algo semelhante:

Trabalho de importação: falha na importação do arquivo SampleTemplate.csv com o nome de segmento SampleTemplate. Solicitação incorreta: os dados que recebemos não corresponderam ao formato esperado para a operação createImportJob. Confirme se as informações da solicitação estão formatadas corretamente e envie a solicitação novamente.

Problema e solução
  • Esse erro ocorre quando o modelo importado não está formatado corretamente.

  • Verifique se o modelo está no formato JSON ou CSV válido. Consulte Arquivos de segmentos para ver um exemplo de uso do formato correto. Um modelo de exemplo também pode ser baixado do console. No projeto, selecione Segmentos, Criar um segmento, Importar um segmento e Baixar CSV de exemplo.

  • Verifique se todos os atributos especificados são válidos. ChannelType e address são campos obrigatórios ao importar segmentos. Os nomes dos atributos diferenciam maiúsculas de minúsculas. Para obter uma lista completa dos possíveis atributos que podem ser adicionados a um modelo, consulte Atributos compatíveis.

Falha ao exportar segmentos

Problema e solução
  • Grandes trabalhos de exportação podem falhar ao executar essa ação no console.

  • Como solução alternativa para essa limitação, o segmento pode ser exportado para um bucket do Amazon S3 usando a API CreateExportJob por meio da referência da linha de comando (CLI) ou do SDK.

Contagem de endpoint para um segmento dinâmico

Problemas e soluções
  • Ao usar um segmento dinâmico para criar uma campanha, a contagem do número de endpoints é uma aproximação e pode não estar correta. Isso ocorre porque os dados do endpoint em segmentos dinâmicos estão sujeitos a alterações ao longo do tempo com base nos critérios definidos. O segmento pode ser exportado para confirmar o número exato de endpoints em um determinado momento.

BadRequestException: excedeu o limite máximo de endpoints por número de usuários: 15

Esse erro ocorre ao tentar adicionar mais de 15 endpoints associados ao mesmo UserId.

nota

Se o novo endpoint tiver um tipo de canal ADM, GCM, APNS, APNS_VOICE, APNS_VOIP_SANDBOX ou BAIDU, a solicitação será bem-sucedida se já houver um endpoint com um desses tipos de canal. Para obter mais informações, consulte Gerenciar o número máximo de endpoints de um público-alvo no Guia do desenvolvedor do Amazon Pinpoint.

Problema e solução
  • Você pode ver esse erro ao criar novos endpoints ou editar os existentes usando a API update-endpoint, e se o endpoint específico exceder o número máximo de 15 endereços de endpoint.

  • Atualmente, esse limite é o máximo do serviço. Não é possível aumentá-lo. Para obter mais informações, consulte Cotas de endpoint.

BadRequestException ao chamar a operação UpdateEndpointsBatch ou UpdateEndpoints: muitos atributos personalizados

Esse erro ocorre ao tentar adicionar mais de 250 atributos. Atributos personalizados podem ter no máximo 15 KB por endpoint.

Problema e solução