사용자 지정 작업 문제 해결 troubleshoot-a-custom-action
Journey Optimizer 사용자 인터페이스의 관리 섹션에서 API 호출을 전송하여 사용자 지정 작업을 테스트할 수 있습니다. 이 기능은 여정에서 사용자 지정 작업을 사용하기 전이나 후에 문제를 해결하는 데 도움이 됩니다.
관리자는 테스트 요청 보내기 기능을 사용하여 Adobe Journey Optimizer에서 직접 실제 API를 호출하여 사용자 지정 작업 구성의 유효성을 검사합니다. 이 기능을 사용하면 여정에서 사용하기 전에 요청 구조, 헤더, 인증 및 페이로드의 형식이 올바르게 지정됩니다.
이 기능을 사용하면 테스트 및 유효성 검사 프로세스를 간소화하여 사용자 지정 작업이 라이브 여정에서 올바르게 작동하도록 할 수 있습니다.
전제 조건 troubleshoot-custom-action-prereq
테스트 요청 보내기 기능을 사용하려면 사용자 지정 작업을(를) URL, 헤더 및 인증 설정으로 미리 구성해야 합니다.
관리자가 이 기능을 사용하려면 다음 권한이 필요합니다.
- 사용자에게 Manage journeys events, data sources and actions 권한이 있어야 합니다.
- 이 권한은 여정 관리자 역할에 포함되어 있습니다.
- View journeys events 권한만으로는 충분하지 않습니다.
이 섹션에서 여정 권한에 대해 자세히 알아보세요.
테스트 요청 보내기 기능을 사용하는 방법 troubleshoot-custom-action-use
사용자 지정 작업을 테스트하려면 다음 단계를 수행합니다.
-
작업 구성 화면으로 이동하여 사용자 지정 작업을 선택합니다.
-
작업 구성 화면 하단의 테스트 요청 보내기 단추를 클릭합니다.
{width="70%"}
-
팝업 창에서 요청 매개 변수를 지정할 수 있습니다.
-
사용자 지정 작업 메서드가 GET인 경우 페이로드가 필요하지 않습니다.
-
사용자 지정 작업 메서드가 POST인 경우 JSON 페이로드를 제공해야 합니다.
note note NOTE Adobe Journey Optimizer은 이 JSON의 구조가 잘못된 경우 오류를 발생시키지만 데이터 유형과 불일치하는 경우 오류를 발생시키지 않습니다. 예를 들어 문자열이어야 하는 항목에 정수 매개 변수를 사용하는 경우 오류가 발생하지 않습니다. -
인증이 정의된 경우 인증 세부 정보를 입력하라는 메시지가 표시됩니다.
-
-
요청을 실행하려면 보내기를 클릭하세요.
-
헤더 및 상태 코드를 포함한 API의 응답이 인터페이스에 표시됩니다.
인증 처리 troubleshoot-custom-action-auth
사용자 지정 작업에 인증이 포함되어 있는 경우 Adobe Journey Optimizer에서는 사용자가 각 테스트 요청에 대한 인증 세부 정보를 입력해야 합니다.
- 기본 인증: 사용자가 암호를 제공해야 합니다.
- API 키 인증: 사용자가 API 키 값을(를) 입력해야 합니다.
- 사용자 지정 인증: 사용자는 요청 bodyParam에 인증 매개 변수를 제공해야 합니다. 이 경우 인증 요청 및 인증 응답 섹션이 추가됩니다.
주요 이점 troubleshoot-custom-action-benefits
Journey Optimizer 관리자는 외부 도구(예: Postman)를 사용하여 사용자 지정 작업을 테스트할 수도 있습니다. 외부 테스트와 비교하여 제품 내 문제 해결 기능이 제공하는 주요 이점은 다음과 같습니다.
-
테스트 요청은 AJO 여정에 의해 실행됩니다. 즉, 다음을 의미합니다.
- 정확한 요청 구조(Adobe Journey Optimizer 관련 헤더 포함)가 사용됩니다.
- 소스 IP 및 헤더가 라이브 여정에 사용된 헤더와 일치합니다.
-
사용자 지정 작업이 이미 배포되었으므로 테스트 요청 보내기 기능을 실시간 여정 문제 해결에 사용할 수 있습니다.
-
이 제품 내 테스트 기능을 사용하면 도구 간에 구성 세부 정보를 수동으로 복사할 필요가 없으므로 오류 위험이 줄어듭니다.
문제 해결 troubleshoot-custom-action-check
요청이 실패하는 경우 다음을 확인할 수 있습니다.
- 테스트에 입력한 인증 자격 증명입니다.
- 요청 메서드(GET 및 POST) 및 해당 페이로드.
- 사용자 지정 작업에 정의된 API 끝점 및 헤더입니다.
- 응답 데이터를 사용하여 잠재적인 구성 오류를 식별합니다.
이벤트 삭제 및 유휴 시간 초과 처리 handling-discard-events-and-idle-timeouts
한 여정의 사용자 지정 작업에서 두 번째 여정을(를) 시작하는 이벤트를 트리거할 때 두 번째 여정이 올바른 상태이고 이벤트가 인식되는지 확인하십시오. 이벤트가 두 번째 여정의 시작 조건을 충족하지 않는 경우 이벤트는 삭제되고 notSuitableInitialEvent과(와) 같은 코드가 있는 로그에 표시될 수 있습니다. 두 번째 여정이 준비되지 않은 경우 유휴 시간 초과가 발생하여 로그에 이벤트가 삭제될 수 있습니다.
일반적인 원인:
-
여정 조건을 충족하지 않음 - 두 번째 이벤트가 조건 조건을 가진 규칙 기반 이벤트를 사용합니다. 예를 들어 필수 필드는 비어 있지 않아야 합니다(예: 특정 필드의
isNotEmpty). 이벤트 페이로드가 해당 조건을 만족하지 않는 경우(예: 필드가 비어 있거나 누락된 경우) 이벤트는 수신되지만 삭제됨이며 두 번째 여정이 트리거되지 않습니다. 이는 예상되는 동작입니다. 설명서 및 로그는 자격 조건이 충족되지 않으면 이벤트가 삭제되고 해당 프로필에 대해 여정이 트리거되지 않음을 확인합니다. 사용자 지정 작업에서 보낸 페이로드에 두 번째 여정의 이벤트 구성에 필요한 모든 필드와 값이 포함되어 있는지 확인합니다. 여정 실행에서 규칙 기반 이벤트를 구성 및 이벤트 수신 문제 해결하는 방법을 알아봅니다. -
두 번째 여정이 준비되지 않음 - 두 번째 여정이 아직 활성화되지 않았거나(예: 테스트 모드가 아니거나 라이브가 아님) 사용자 지정 작업 실행과 두 번째 여정을 받을 준비가 된 사이에 시간 간격이 있는 경우 유휴 시간 초과가 발생할 수 있습니다. 사용자 지정 작업이 트리거되기 전에 대상 여정이 게시되었는지 또는 테스트 모드에 있는지 확인하십시오.
-
삭제 이벤트 진단 - 로그에 삭제 이벤트가 표시되면 여정 로그와 Splunk 추적을 확인하여 이벤트가 수신되었지만 자격(페이로드가 규칙에 맞지 않음) 또는 타이밍으로 인해 삭제되었는지 확인하십시오. 두 번째 여정의 시작 날짜 및 구성이 올바르고 여정이 활성 날짜 창 내에 있는지 확인합니다.
사용자 지정 작업을 통해 여정을 연결할 때 이벤트가 삭제되지 않도록 하려면 두 번째 여정의 이벤트 규칙에 대해 이벤트 페이로드의 유효성을 확인하고 대상 여정이 활성 상태 또는 테스트 중이며 활성 날짜 창 내에 있는지 확인하십시오.
추가 리소스
사용자 지정 작업 구성 및 사용에 대한 자세한 내용은 아래 섹션을 참조하십시오.
- 사용자 지정 작업 시작 - 사용자 지정 작업이 무엇이고 이러한 작업이 서드파티 시스템에 연결하는 데 어떻게 도움이 되는지 알아봅니다.
- 사용자 지정 작업 구성 - 사용자 지정 작업을 만들고 구성하는 방법에 대해 알아봅니다.
- 사용자 지정 작업 사용 - 여정에서 사용자 지정 작업을 사용하는 방법에 대해 알아봅니다.
- 사용자 지정 작업 매개 변수에 컬렉션 전달 - 런타임에 동적으로 채워진 사용자 지정 작업 매개 변수에서 컬렉션을 전달하는 방법을 알아봅니다.