데이터 수집 디버깅 및 문제 해결

데이터 수집 디버깅에는 구현의 동작 방식과 데이터가 전송되는 데이터에 어떤 일이 발생하는지 확인하는 작업이 포함됩니다. 증상부터 시작하여 각 수집 단계에서 이벤트가 예상대로 작동하지 않는 위치를 찾을 때까지 이벤트를 따릅니다.

디버그 로깅은 브라우저나 애플리케이션 런타임에 SDK 명령, 태그 실행, 경고 및 오류를 표시합니다. 요청 검사는 페이로드, 응답 및 지원되는 워크플로에 대한 서버측 처리를 표시합니다. 이러한 접근 방식은 서로 보완되는 경우가 많습니다. 로그는 이벤트가 지연된 이유를 설명하고 네트워크 캡처는 요청이 전송되었는지 여부를 보여 줄 수 있습니다.

컬렉션을 통해 이벤트 팔로우 diagnostic-workflow

다음 단계를 순서대로 조사합니다. 한 단계가 성공했다는 증거는 이후 단계도 성공했다는 것을 성립시키지 않는다.

  1. 구현 실행: SDK 명령 또는 태그 규칙이 실행되었습니까? 진단 메시지 및 오류를 확인합니다. 동의 또는 ID 처리가 이벤트를 지연하는 경우 네트워크 요청을 찾기 전에 해당 상태를 조사하십시오. 디버그 로깅 사용을 참조하십시오.
  2. 보내는 요청: 요청이 전송되었으며 필요한 데이터가 포함되어 있습니까? 페이로드를 검사하고 명령 입력 또는 데이터 요소와 비교합니다. 웹 요청 검사 또는 모바일 및 서버 요청 검사를 참조하십시오.
  3. 서버 확인: 컬렉션 끝점이 요청을 받았습니까? 가능한 경우 응답을 검사하거나 지원되는 서버측 추적을 사용합니다. 요청이 전송되었음을 나타내는 클라이언트 로그는 수신 확인이 아닙니다.
  4. Edge 처리 및 라우팅: 이벤트가 의도한 데이터스트림 및 구성된 서비스를 사용했습니까? 웹 SDK의 경우 요청의 configId 매개 변수은(는) 사용한 데이터 스트림을 보여 주고 Edge 추적은(는) Edge Network에서 이벤트를 처리한 방법을 보여 줍니다.
  5. 다운스트림 처리: 대상이 예상대로 이벤트를 수락하고 처리했습니까? 대상의 제품별 디버깅 지침을 사용하십시오. Edge Network의 성공적인 응답은 모든 다운스트림 보고서 또는 저장소에서 데이터를 사용할 수 있다는 증거가 아닙니다.

시작점 선택 choose-a-starting-point

다음 표는 일반적인 작업에 대한 유용한 증거를 식별합니다. 두 접근법이 모두 적용되면, 그들은 조사의 다른 부분에 대답한다. 사용 가능한 메시지 및 도구는 SDK, 런타임 및 구성된 서비스에 따라 다릅니다.

작업 또는 증상
디버그 로깅
검사 요청
다음 검사
예상 이벤트가 표시되지 않음
동의 또는 ID 지연에 대한 명령 또는 규칙 실행, 오류 및 메시지를 확인합니다.
요청이 전송되었는지 확인하고 페이로드 및 응답을 검사합니다.
로깅으로 시작한 다음 요청 검사를 시작합니다. ID 관련 증상은 ID 문제 해결을 참조하십시오.
요청에 예기치 않은 데이터가 포함되어 있습니다.
SDK 명령 입력 및 태그 실행을 전송하려는 값과 비교합니다.
실제 나가는 페이로드를 검사합니다. 변형이 포함된 경우 Edge 추적과(와) 비교합니다.
데이터 요소, 명령 입력 및 데이터 스트림 구성을 확인하십시오.
탐색 중에 요청이 취소된 것으로 표시됨
SDK에서 이벤트를 보내려고 했는지 또는 계속 이벤트를 보관하고 있는지 확인합니다.
요청을 검사하고 가능한 경우 서버 응답 또는 Edge 추적을 검사합니다. 브라우저의 취소된 레이블만으로는 결론이 나지 않습니다.
중단된 요청 및 웹 SDK documentUnloading을(를) 참조하십시오.
요청이 성공한 것처럼 보이지만 대상 데이터가 누락되었습니다.
사용된 구성을 설정하고 구현을 입력합니다. 클라이언트 로그에서 다운스트림 처리를 확인할 수 없습니다.
Edge 추적, Assurance 및 대상별 진단을 사용합니다.
데이터 스트림, 활성화된 서비스, 라우팅 및 대상 처리를 확인합니다. Edge Network 처리 추적 및 제품별 디버깅을 참조하세요.
이벤트가 중복으로 표시됨
반복된 명령 호출 또는 태그 규칙 실행을 찾습니다.
요청 카운트, 페이로드 및 식별자를 비교합니다. 여러 클라이언트 요청만 중복될 수 있는 것은 아닙니다.
재시도 및 최소 한 번 이상의 게재와 반복된 클라이언트 실행을 조사합니다. 이벤트 중복 처리를 참조하십시오.
모바일 또는 서버 구현이 예기치 않게 동작합니다
브라우저 콘솔만 검토하지 않고 애플리케이션 또는 서버 런타임에서 SDK 출력을 검토하십시오.
지원되는 모바일 워크플로우에 Assurance을 사용하거나 애플리케이션의 HTTP 트래픽을 검사합니다. 브라우저 도구에서 서버의 발신 호출을 표시할 수 없습니다.
Mobile SDK 및 Server SDK 로깅 및 모바일 및 서버 요청 검사를 참조하십시오.

제품별 디버깅 product-specific

이 섹션의 문서는 모든 Experience Platform 데이터 수집에 적용됩니다. 데이터를 수신하는 Adobe 애플리케이션은 자체 엔드포인트, 요청 형식, 유효성 검사 보기 및 처리를 사용할 수 있습니다. Edge Network에서 이벤트를 수신하고 라우팅했는지 확인한 후 또는 구현에서 애플리케이션에 데이터를 직접 전송하는 경우 해당 애플리케이션의 디버깅 지침을 계속 진행합니다.

조사 계속 next-steps

  • 디버그 로깅 사용: Web SDK, 태그, Server SDK 및 Mobile SDK에 대한 진단 출력을 사용, 검사 및 사용하지 않도록 설정합니다.
  • 데이터 수집 요청 검사: 요청을 캡처하고, Edge Network 요청 증거를 해석하고, Edge 처리를 추적하고, 취소된 요청을 조사합니다.
  • 디버깅 도구: Adobe 도구, 태그 디버거, 브라우저 개발자 도구 및 HTTP 프록시를 비교합니다.
  • 주체별 지침: 동의 및 ID, 문서 언로드, 이벤트 복제와 같이 세부 조사를 구성 또는 API 참조에 가깝게 유지하십시오.

로그, 추적 또는 네트워크 캡처를 공유하기 전에 조직의 정책에 따라 자격 증명, 방문자 식별자 및 기타 중요한 정보를 제거하십시오.

recommendation-more-help
experience-platform-help-collection