설명서 Journey Optimizer Journey Optimizer 안내서

라이브 여정 실행 문제 해결 troubleshooting-execution

Last update: Tue Nov 25 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

적용 대상:
Journey Orchestration

주제:

작성 대상:

중간
사용자

이 섹션에서는 여정 이벤트 문제 해결, 프로필이 여정에 입력되었는지 여부, 프로필이 이벤트를 탐색하는 방법 및 메시지가 전송되었는지 확인하는 방법을 알아봅니다.

여정을 테스트하거나 게시하기 전에 오류를 해결할 수도 있습니다. 이 페이지에서 하는 방법을 알아보세요.

인바운드 액션을 사용 중인 경우 이 페이지에서 문제를 해결하는 방법을 알아보세요.

이벤트가 제대로 전송되었는지 확인 checking-that-events-are-properly-sent

여정의 시작점은 항상 이벤트입니다. Postman과 같은 도구를 사용하여 테스트를 수행할 수 있습니다.

이러한 도구를 통해 보내는 API 호출이 올바르게 전송되었는지 여부를 확인할 수 있습니다. 오류가 반환되면 호출에 문제가 있는 것입니다. 페이로드, 헤더(특히 조직 ID) 및 대상 URL을 다시 확인하십시오. 올바른 URL이 무엇인지를 관리자에게 물어볼 수 있습니다.

이벤트는 소스에서 여정으로 직접 푸시되지 않습니다. 실제로 여정은 Adobe Experience Platform의 수집 API 스트리밍에 의존합니다. 따라서 이벤트 관련 문제가 발생하면 Adobe Experience Platform 설명서에서 수집 API 스트리밍 문제 해결을 참조할 수 있습니다.

ERR_MODEL_RULES_16 오류로 인해 여정에서 테스트 모드를 사용하도록 설정하지 못하는 경우 채널 작업을 사용할 때 사용된 이벤트에 ID 네임스페이스가 포함되어 있는지 확인하십시오.

ID 네임스페이스는 테스트 프로필을 고유하게 식별하는 데 사용됩니다. 예를 들어 테스트 프로필을 식별하는 데 이메일을 사용하는 경우 ID 네임스페이스 이메일을(를) 선택해야 합니다. 고유 식별자가 전화번호인 경우 ID 네임스페이스 Phone을(를) 선택해야 합니다.

사람들이 여정을 입력하는지 확인 checking-if-people-enter-the-journey

여정 보고는 여정에 들어오는 사람들을 실시간으로 측정합니다.

이벤트를 성공적으로 보냈는데 여정에 들어오는 사람이 없다면 여정에서 이벤트 보내기 및 이벤트 받기 사이에 무언가 잘못된 것입니다.

아래 질문과 함께 문제 해결을 시작할 수 있습니다.

수신 이벤트를 기다리는 여정이 테스트 모드이거나 라이브 상태인 것이 확실합니까?
페이로드 미리 보기에서 페이로드를 복사하기 전에 이벤트를 저장했습니까?
이벤트 페이로드에 이벤트 ID가 포함되어 있습니까?
정확한 URL을 입력했습니까?
이벤트 구성 창에서 페이로드 구조 미리 보기를 사용하여 수집 API 스트리밍 페이로드 구조를 따랐습니까? 이 페이지를 참조하십시오.

이벤트 헤더에 올바른 키-값 쌍을 사용했습니까?

code language-none
`X-gw-ims-org-id - your organization's ID Content-type - application/json`

NOTE

스트리밍 대상이 있는 대상 자격 여정의 경우: 대상 자격 활동을 여정 진입점으로 사용하는 경우 시간 요소, 대상의 빠른 종료 또는 게시하기 전에 대상에 프로필이 이미 있었던 경우 대상에 해당하는 모든 프로필이 여정에 들어가는 것은 아닙니다. 스트리밍 대상 자격 시간 고려 사항에 대해 자세히 알아보세요.

사람들이 여정을 탐색하는 방법 확인 checking-how-people-navigate-through-the-journey

여정 보고는 여정 내에서 개인 사용자의 진행 상황을 측정합니다. 사람들이 어디에서 왜 멈췄는지를 쉽게 파악할 수 있습니다.

확인할 몇 가지 사항은 다음과 같습니다.

그 사람을 배제하는 조건 때문입니까? 예를 들어 조건이 "gender = male"인데 당사자가 여성입니다. 이 검사는 조건이 너무 복잡하지 않은 경우 비즈니스 사용자가 수행할 수 있습니다.
데이터 소스에 대한 호출이 응답하지 않기 때문입니까? 여정이 테스트 모드일 때는 이 정보를 테스트 모드 로그에서 볼 수 있습니다. 여정이 라이브 상태일 때는 관리자가 데이터 소스에 대한 직접 호출을 테스트하고 수신된 답변을 확인할 수 있습니다. 관리자가 여정을 복제하여 테스트할 수도 있습니다.

메시지를 성공적으로 보냈는지 확인 checking-that-messages-are-sent-successfully

개인 사용자가 여정에서 플로우를 제대로 따랐는데 받아야 할 메시지를 받지 못하는 경우에는 다음을 확인하면 됩니다.

Journey Optimizer이(가) 메시지를 보낼 요청을 올바르게 고려했습니다. 비즈니스 사용자는 전송되어야 하는 메시지에 액세스하여 최신 실행 시간이 여정 실행 시간과 일치하는지 확인할 수 있습니다. 최신 API 호출/이벤트를 수신했는지 확인할 수도 있습니다.
Journey Optimizer이(가) 메시지를 보냈습니다. 여정 보고를 확인하여 오류가 없는지 확인합니다.

사용자 지정 작업을 통해 전송된 메시지의 경우, 여정 테스트 중에 확인할 수 있는 유일한 사실은 사용자 지정 작업 시스템의 호출이 오류로 이어졌는지 여부입니다. 사용자 지정 작업과 연결된 외부 시스템에 대한 호출이 오류로 이어지지 않았는데 메시지가 전송되지 않은 경우에는 외부 시스템 쪽에서 몇 가지 조사를 수행해야 합니다.

여정 단계 이벤트의 중복 항목 이해 duplicate-step-events

여정 인스턴스, 프로필, 노드 및 요청 ID가 동일한 여러 항목이 표시되는 이유는 무엇입니까?

여정 단계 이벤트 데이터를 쿼리할 때 동일한 여정 실행에 대해 중복 로그 항목으로 표시되는 것을 가끔 관찰할 수 있습니다. 이러한 항목은 다음에 대해 동일한 값을 공유합니다.

profileID - 프로필 ID
instanceID - 여정 인스턴스 식별자
nodeID - 특정 여정 노드
requestID - 요청 식별자

그러나 이러한 항목에는 실제 데이터 중복과 이 시나리오를 구분하는 주요 지표인 다른 _id개의 값이(가) 있습니다.

이 비헤이비어의 원인은 무엇입니까?

이 문제는 Adobe Journey Optimizer의 마이크로서비스 아키텍처에서 백엔드 자동 확장 작업("밸런싱 조정"이라고도 함)으로 인해 발생합니다. 높은 로드 또는 시스템 최적화 기간 중:

여정 단계 이벤트는 처리를 시작하고 여정 단계 이벤트 데이터 세트에 기록됩니다
자동 확장 작업은 여러 서비스 인스턴스에 워크로드를 재분배합니다.
다른 서비스 인스턴스에서 동일한 이벤트를 재처리하여 다른 _id을(를) 사용하는 두 번째 로그 항목을 만들 수 있습니다.

이는 예상되는 시스템 동작이며 설계된 대로 작동합니다.

여정 실행 또는 메시지 전달에 영향을 줍니까?

아니요. 로깅에만 영향을 줍니다. Adobe Journey Optimizer은 메시지 실행 레이어에 내장된 중복 제거 메커니즘을 통해 다음을 보장합니다.

각 프로필에는 하나의 메시지(이메일, SMS, 푸시 알림 등)만 전송됩니다
작업은 한 번만 실행됩니다
여정 실행이 올바르게 진행됨

ajo_message_feedback_event_dataset을(를) 쿼리하거나 작업 실행 로그를 확인하여 이를 확인할 수 있습니다. 중복된 여정 단계 이벤트 항목에도 불구하고 실제로 보낸 메시지는 한 개뿐입니다.

쿼리에서 이러한 사례를 식별하려면 어떻게 해야 합니까?

여정 단계 이벤트 데이터를 분석할 때:

필드 _id을(를) 확인: 실제 시스템 수준 중복에는 동일한 _id이(가) 있습니다. 다른 _id 값은 위에서 설명한 리밸런싱 시나리오와 별도의 로그 항목을 나타냅니다.

메시지 배달 확인: 메시지 피드백 데이터를 상호 참조하여 한 개의 메시지만 전송되었는지 확인합니다.

code language-sql

code language-sql
`SELECT timestamp, _experience.customerJourneyManagement.messageExecution.messageExecutionID, _experience.customerJourneyManagement.messageDeliveryfeedback.feedbackStatus FROM ajo_message_feedback_event_dataset WHERE _experience.customerJourneyManagement.messageExecution.journeyVersionID = '<journeyVersionID>' AND TO_JSON(identityMap) like '%<profileID>%' ORDER BY timestamp DESC;`

SELECT
  timestamp,
  _experience.customerJourneyManagement.messageExecution.messageExecutionID,
  _experience.customerJourneyManagement.messageDeliveryfeedback.feedbackStatus
FROM ajo_message_feedback_event_dataset
WHERE
  _experience.customerJourneyManagement.messageExecution.journeyVersionID = '<journeyVersionID>'
  AND TO_JSON(identityMap) like '%<profileID>%'
ORDER BY timestamp DESC;

고유 식별자별로 그룹화: 실행을 계산할 때는 _id을(를) 사용하여 정확한 개수를 구하십시오.

code language-sql

code language-sql
`SELECT COUNT(DISTINCT _id) as unique_executions FROM journey_step_events WHERE _experience.journeyOrchestration.stepEvents.journeyVersionID = '<journeyVersionID>' AND _experience.journeyOrchestration.stepEvents.profileID = '<profileID>'`

SELECT
  COUNT(DISTINCT _id) as unique_executions
FROM journey_step_events
WHERE
  _experience.journeyOrchestration.stepEvents.journeyVersionID = '<journeyVersionID>'
  AND _experience.journeyOrchestration.stepEvents.profileID = '<profileID>'

이것을 관찰하면 어떻게 해야 하나요?

이는 정상적인 시스템 동작이며 작업이 필요하지 않습니다. 중복 로깅이 여정 구성 또는 메시지 전달에 문제를 나타내지 않습니다.

여정 단계 이벤트를 기반으로 보고서나 분석을 작성하는 경우:

고유 이벤트를 계산하기 위한 기본 키로 _id 사용
메시지 게재를 분석할 때 메시지 피드백 데이터 세트와 상호 참조
시간 분석 시 서로 몇 초 이내에 클러스터링된 항목이 표시될 수 있습니다

여정 단계 이벤트 쿼리에 대한 자세한 내용은 쿼리 예제를 참조하십시오.

대시보드 지표 불일치 문제 해결 dashboard-metrics

개요 대시보드에 표시된 지표가 찾아보기 탭의 실제 여정 수와 일치하지 않으면 다음을 확인하십시오.

최근 활동이 없는 여정은 대시보드에서 제외되므로 문제의 여정이 지난 24시간 동안 트래픽을 보유하고 있는지 확인하십시오.
조직의 모든 여정을 볼 수 있는 적절한 액세스 권한이 있는지 확인하십시오.
여정을 변경한 후 지표를 새로 고치는 데 최대 30분이 소요됩니다.

불일치가 지속되면 Adobe 지원 센터에 문의하여 개요 및 찾아보기 탭의 스크린샷을 확인하십시오.

recommendation-more-help

b22c9c5d-9208-48f4-b874-1cefb8df4d76