설명서

Adobe Experience Platform: 해시된 이메일에서 스트리밍 유효성 검사 실패

Last update: Tue Jan 06 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

해시된 이메일에서 스트리밍 유효성 검사가 실패할 때 Adobe Experience Platform 문제를 해결하는 방법을 알아봅니다. 스키마 요구 사항을 확인하고, 데이터 변환 규칙 및 구성을 확인하고, 해시 메커니즘을 구현해야 합니다.

설명 description

환경

  • 제품: Adobe Experience Platform (AEP)
  • 구성 요소: 데이터 수집 / Adobe Launch
  • 데이터 세트: 웹 SDK

문제

웹 SDK 데이터 세트로 데이터를 스트리밍할 때 hashed_email 필드 오류로 인해 일괄 처리가 로드되지 않습니다. hashed_email 열은 필수이며 최소 64자가 필요합니다. 그러나 일부 스트리밍 배치의 이 열에는 필수 길이를 충족하지 않는 이메일 주소가 포함되어 있어 유효성 검사 오류가 발생합니다.

오류 메시지 예: 메시지를 확인할 수 없음: [ #/path/to/hashed_email: 예상 minLength: 64, 실제: 25]

해결 방법 resolution

이 문제를 해결하려면 다음을 수행하십시오.

  1. 데이터 집합과 연결된 스키마에서 hashed_email이(가) SHA256 해시 값이어야 하는지 확인하십시오. 자세한 내용은 setCustomerIDs에 대한 ​SHA256 해시 지원을 검토하십시오.
  2. AEP으로 보내기 전에 태그 속성 구성 내의 모든 규칙 또는 데이터 요소를 검토하여 이메일 주소를 올바르게 해시하는지 확인하십시오. 자세한 내용은 태그 규칙 빌드를 검토하세요.
  3. 아직 구현되지 않은 경우 스트리밍 배치의 일부로 전송되기 전에 SHA256을 사용하여 이메일 주소를 자동으로 해시하도록 웹 구현(예: JavaScript) 내에 코드를 추가합니다. 그렇게 하지 않으면 데이터("이메일")가 일반 텍스트로 전송될 수 있습니다. 자세한 내용은 setCustomerIDs에 대한 ​SHA256 해시 지원을 검토하십시오.
  4. 데이터 수집이 발생하는 관련 웹 페이지에서 콘솔 로깅과 같은 디버깅 도구를 사용하여 모든 이벤트와 데이터 요소가 올바르게 실행되고 이메일에 대한 해시된 값을 올바르게 포함하는지 확인합니다. 웹 SDK 가이드의 디버깅을 검토합니다.
  5. 필요한 조정을 수행한 후 샘플 배치를 다시 스트리밍하여 hashed_email과(와) 관련된 유효성 검사 오류가 발생하지 않도록 확인합니다. 단계를 보려면 Web SDK을 사용하여 Experience Platform에 데이터를 스트리밍하십시오.

이러한 단계를 수행하면 스키마 요구 사항을 준수하고 잘못된 이메일 토큰 길이로 인해 향후 배치 오류가 발생하지 않도록 방지할 수 있습니다.

추가 지원이 필요하거나 이러한 변경 사항을 구현한 후에도 문제가 지속되는 경우 Adobe 지원에 추가 문제 해결 지침을 문의하십시오.

recommendation-more-help
3d58f420-19b5-47a0-a122-5c9dab55ec7f