설명서

잘못된 스키마 참조로 인해 스트리밍 수집 실패

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

Adobe Experience Platform에서 스트리밍 끝점을 사용할 경우 스트리밍 수집이 실패할 수 있습니다. 데이터 세트의 스키마 참조와 일치하지 않기 때문에 메시지를 확인할 수 없다고 오류가 표시됩니다. 이 문제는 페이로드의 스키마 참조가 올바르지 않거나 잘못된 경우, 종종 복사-붙여넣기 작업(UI의 스키마 복사 페이로드 사용) 중에 추가된 문자 때문에 발생합니다. 스키마 참조를 수정하면 유효성 검사 오류가 해결되며 데이터 수집이 진행될 수 있습니다. 이 문제를 해결하려면 페이로드의 schemaRef.id을(를) 검토하고 원하지 않는 문자를 제거한 다음 수정된 요청을 다시 보내십시오.

설명 description

환경

Adobe Experience Platform

문제/증상

  • 스트리밍 수집 시도가 실패하고 유효성 검사 오류가 발생합니다.
  • 오류 메시지는 메시지가 데이터 세트의 스키마 참조와 일치하지 않음을 나타냅니다.
  • 실패한 레코드에 schemaRef에 스키마 URL 끝에 예기치 않은 URL 인코딩 큰따옴표(%22)가 포함되어 있습니다.

해결 방법 resolution

이 문제를 해결하려면 다음 단계를 수행합니다.

  1. AEP의 스트리밍 수집을 위해 전송된 페이로드를 검토합니다.
  2. 헤더 섹션을 검사하고 schemaRef.id 값을 찾습니다.
  3. URL로 인코딩된 큰따옴표(schemaRef.id)와 같이 %22의 끝에서 불필요한 문자를 제거하십시오.
  4. schemaRef.id이(가) 추가 문자 없이 데이터 집합에 필요한 스키마 URL과 일치하는지 확인하십시오.
  5. 수정된 헤더가 포함된 스트리밍 페이로드를 다시 보냅니다.
  6. 데이터 수집이 성공하고 유효성 검사 오류가 발생하지 않는지 확인합니다.

참고: 이 문제는 다른 원본의 값을 복사할 때 종종 발생하며, 이로 인해 구성 필드에 원하지 않는 문자가 실수로 추가될 수 있습니다. API 요청 또는 구성 파일에서 사용하기 전에 URL 및 식별자를 인코딩 아티팩트가 없는지 항상 확인하십시오.

관련 읽기

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