세그먼트 문제 해결 - Amazon Pinpoint

세그먼트 문제 해결

실패 원인을 식별하는 데 도움이 되도록 로깅이 켜져 있는지 확인하세요. 자세한 내용은 모니터링 및 로깅을 참조하세요.

세그먼트 가져오기 실패

세그먼트 가져오기에 실패하면 다음 오류 메시지 또는 이와 유사한 오류 메시지가 표시될 수 있습니다.

가져오기 작업: 세그먼트 이름이 SampleTemplate인 SampleTemplate.csv 파일 가져오기가 실패했습니다. 잘못된 요청: 수신한 데이터가 CreateImportJob 작업에 필요한 형식과 일치하지 않습니다. 요청의 정보가 올바른 형식인지 확인한 후 다시 요청을 제출하세요.

문제 및 해결 방법
  • 이 오류는 가져온 템플릿의 형식이 올바르지 않을 때 발생합니다.

  • 템플릿이 유효한 JSON 또는 CSV 형식인지 확인하세요. 올바른 형식의 예는 세그먼트 파일 섹션을 참조하세요. 콘솔에서 샘플 템플릿을 다운로드할 수도 있습니다. 프로젝트에서 세그먼트, 세그먼트 생성, 세그먼트 가져오기를 선택하고, 예제 CSV 다운로드를 선택합니다.

  • 지정된 모든 속성이 유효한지 확인합니다. 세그먼트를 가져올 때 ChannelTypeaddress는 필수 필드입니다. 속성 이름은 대소문자를 구분합니다. 템플릿에 추가할 수 있는 속성의 전체 목록은 지원되는 속성 섹션을 참조하세요.

세그먼트 내보내기 실패

문제 및 해결 방법
  • 콘솔에서 이 작업을 수행할 때 대규모 내보내기 작업이 실패할 수 있습니다.

  • 이 제한을 해결하기 위해 Command Line Interface(CLI) 또는 SDK를 통해 CreateExportJob API를 사용하여 세그먼트를 Amazon S3 버킷으로 내보낼 수 있습니다.

동적 세그먼트의 엔드포인트 수

문제 및 해결 방법
  • 캠페인을 생성할 때 동적 세그먼트를 사용하는 경우 엔드포인트 수는 근사치이며 정확하지 않을 수 있습니다. 이는 동적 세그먼트의 엔드포인트 데이터가 정의된 기준에 따라 시간이 지남에 따라 변경될 수 있기 때문입니다. 세그먼트를 내보내 지정된 시점의 정확한 엔드포인트 수를 확인할 수 있습니다.

BadRequestException: 사용자 수당 최대 엔드포인트 초과: 15

이 오류는 동일한 UserId에 연결된 엔드포인트를 15개 이상 추가하려고 할 때 발생합니다.

참고

새 엔드포인트의 채널 유형이 ADM, GCM, APNS, APNS_VOICE, APNS_VOIP_SANDBOX 또는 BAIDU인 경우 이러한 채널 유형 중 하나가 있는 엔드포인트가 이미 있다면 요청이 성공합니다. 자세한 내용은 Amazon Pinpoint 개발자 안내서Managing an audience members maximum number of endpoints를 참조하세요.

문제 및 해결 방법
  • update-endpoint API를 사용하여 새 엔드포인트를 생성하거나 기존 엔드포인트를 편집할 때 특정 엔드포인트가 최대 15개의 엔드포인트 주소를 초과하면 이 오류가 발생할 수 있습니다.

  • 이 제한은 현재 해당 서비스의 하드 제한입니다. 늘릴 수는 없습니다. 자세한 내용은 엔드포인트 할당량을 참조하세요.

UpdateEndpointsBatch 또는 UpdateEndPoints 작업 호출 시 BadRequestException: 사용자 지정 속성이 너무 많음

이 오류는 250개가 넘는 속성을 추가하려고 할 때 발생합니다. 사용자 지정 속성의 최대 크기는 엔드포인트당 15KB입니다.

문제 및 해결 방법