오류 코드 참조 error-codes

Adobe Journey Optimizer은 표준화된 오류 코드를 사용하여 여정, 캠페인 및 메시지 구성 전반에서 문제를 빠르게 식별하고 해결하는 데 도움이 됩니다. 이러한 오류 코드를 이해하면 문제 해결 시간을 크게 줄이고 최적의 캠페인 성능을 유지하는 데 도움이 됩니다.

오류 코드 구조 이해 error-code-structure

Adobe Journey Optimizer 오류 코드는 구성 요소 및 문제 유형을 식별하는 데 도움이 되는 일관된 이름 지정 패턴을 따릅니다.

  • 서비스 접두사: 오류를 생성한 Adobe Journey Optimizer 서비스(예: 푸시/전송 서비스용 CJMPTS, 여정 런타임용 CJMRT, 메시지 작성 서비스용 CJMMAS, 캠페인용 CJMCMP, 전송 계층용 CJMTL, 보고/프로비저닝 서비스용 CJMRPS)를 나타냅니다.
  • 오류 번호: 특정 오류 조건에 대한 고유 식별자
  • HTTP 상태 코드: 표준 HTTP 상태 코드(예: 400, 403, 422, 500)

예: CJMRT-030012-422은(는) 오류 번호가 030012이고 HTTP 상태가 422(처리할 수 없는 엔터티)인 CJMRT(여정 런타임 오류)를 나타냅니다.

오류 코드를 찾을 수 있는 위치 find-error-codes

오류 코드는 Adobe Journey Optimizer 내 여러 위치에 나타납니다.

  • 여정 실행 보고서 및 로그
  • Campaign 활성화 화면
  • 메시지 유효성 검사 경고
  • 시스템 알림 및 경고
  • API 응답(REST API 사용 시)

오류가 발생하면 전체 오류 코드와 함께 제공되는 요청 ID를 참고하십시오. 이러한 ID는 문제 해결 및 지원 에스컬레이션에 필요합니다.

서비스별 일반 오류 코드 error-codes-by-service

CJMPTS: 푸시 및 전송 서비스 오류 cjmpts-errors

이러한 오류는 푸시 알림 게재 및 메시지 전송 작업 중에 발생합니다.

오류 코드
설명
근본 원인
해결 방법
CJMPTS-1410-500
푸시/채널 보내기 작업 시 내부 서버 오류
채널 백엔드 중단, 만료된 자격 증명, 잘못된 구성 또는 공급자 버그
​1. 지연 후 다시 시도
2. 공급자 구성 및 할당량을 확인하십시오
3. 푸시 자격 증명이 유효한지 확인
4. 대체 채널
5을(를) 사용하여 테스트합니다. 영구적인 경우 Adobe 지원 팀에 요청 ID

관련 설명서​로 문의하십시오. 푸시 구성
CJMPTS-1006-404
푸시/SMS가 "리소스를 찾을 수 없음"으로 실패
참조된 공급자/채널이 없거나 철자가 잘못되었거나 프로비저닝이 해제되었습니다.
​1. 공급자/채널 참조 및 ID
2를 검토하고 수정합니다. 샌드박스/조직 구성 감사
3. 채널 구성이 활성 상태인지 확인하십시오
4. 필요한 경우 채널 구성을 다시 만드십시오​

관련 설명서: 채널 표면
CJMPTS-1510-500
푸시 채널 전송 시 내부 서버 오류
백엔드 푸시/전송 오작동, 공급자 또는 인프라 오류
​1. 채널 프로비저닝 설정
2을 확인합니다. 푸시 자격 증명이 유효한지 확인
3.
4 작업을 다시 시도하십시오. 영구적인 경우 Adobe 지원 팀에 요청 ID

관련 설명서​로 문의하십시오. 푸시 구성
CJMPTS-1023-500
푸시 전송/프로세스 중 내부 서버 오류(타사 게이트웨이)
일시적인 클라우드 오작동 또는 알 수 없는 서비스 오류
​1. 공급자/채널 구성 확인
2. 타사 게이트웨이 상태 확인
3. 몇 분 후 다시 시도하십시오
4. 추가 컨텍스트에 대한 로그 검토​

관련 설명서: 푸시 알림
CJMPTS-1310-500
렌더링 서비스의 내부 오류(미리 보기 또는 라이브 보내기)
다운스트림 템플릿 렌더러가 실패했습니다. 일반적으로 JSON/템플릿 구문 문제
​1. 템플릿 구문 및 구조의 유효성을 검사합니다
2. 모든 개인화 변수가 유효한지 확인
3. 테스트 페이로드를 사용하여 문제를 식별하십시오
4. 필요한 경우 템플릿 복잡성 단순화​

관련 설명서: 메시지 템플릿, Personalization 구문

CJMRT: 여정 런타임 및 API 오류 cjmrt-errors

이러한 오류는 여정 실행, 이벤트 처리 및 API 작업 중에 발생합니다.

오류 코드
설명
근본 원인
해결 방법
CJMRT-110001-500
워크플로우 단계에 대한 최대 실행 수를 초과했습니다(예: IP 선호도 프로비저닝 단계 시간 초과)
인프라/서비스 지연 또는 일시적인 백엔드 문제로 인해 허용된 다시 시도/시간 내에 워크플로/프로비저닝 작업이 완료되지 않았습니다.
​1. 잠시 후 다시 시도하십시오
2. Adobe 상태에서 중단을 확인
3. 워크플로우/작업/조직 세부 정보
4을(를) 사용하여 Adobe 지원으로 에스컬레이션합니다. 가능한 경우 로그 및 네트워크 캡처를 제공합니다​

관련 설명서: 여정 문제 해결
CJMRT-000071-400
여정/테스트 이벤트 또는 API 호출 중 잘못된 요청
페이로드/매개 변수의 형식이 잘못되었거나 누락되었습니다. 입력이 존재하지 않거나 비활성 리소스를 참조합니다.
​1. 요청 본문에서 오류 세부 정보를 검토합니다
2. 올바른 참조/매개 변수
3. 고급 구성을 제거하고
4을(를) 다시 시도하십시오. 문제를 식별하기 위한 기능을 하나씩 다시 추가하십시오​

관련 설명서: 여정 문제 해결, 이벤트 구성
CJMRT-000013-401
메시지 런타임 작업/API 이벤트 중 승인되지 않은 오류
인증 실패: 토큰이 만료되었거나, 권한이 없거나, 통합/사용자가 환경 액세스 권한을 잃었습니다.
​1. 권한 및 역할을 확인합니다
2. 인증 토큰
3을(를) 새로 고칩니다. 알려진 유효한 사용자/서비스 계정
4을(를) 사용하십시오. 제품 프로필 할당 검토​

관련 설명서: 권한
CJMRT-080605-400
여정 런타임의 잘못된 요청(예: 노드 트리거, 작업 등)
구성은 제거/이름 변경 또는 오래된 기능/템플릿/채널을 참조합니다.
​1. 모든 리소스 참조를 확인합니다
2. 여정 구성 및 기능 플래그 감사
3. 끊어진 참조를 업데이트하십시오
4. 최근 시스템 업데이트 및 마이그레이션 검토​

관련 설명서: 여정 만들기
CJMRT-030012-422
처리할 수 없는 엔티티 - 액션 실패, 잘못된 이벤트 또는 잘못된 페이로드
잘못된 입력 데이터(예: 존재하지 않는 대상, 이벤트 또는 속성)
​1. 입력/이벤트 페이로드 구조
2을(를) 다시 확인합니다. 참조된 개체(대상, 데이터 세트)가 있고 활성 상태인지 확인하십시오
3. 모든 필수 필드가 있는지 확인합니다
4. 정상 작동이 확인된 페이로드로 테스트​

관련 설명서: 여정 문제 해결, 이벤트 구성
CJMRT-130004-400
잘못된 요청 - 여정 노드 또는 채널 구성에서 잘못된 입력
여정 페이로드 또는 구성 참조가 제거됨/잘못된 리소스
​1. 여정 노드 구성 검토
2. 참조된 모든 리소스(메시지, 대상, 작업)가 있는지 확인하십시오
3. 끊어진 참조를 수정하거나 업데이트하십시오
4. 필요한 경우 여정 구성을 다시 빌드합니다​

관련 설명서: 여정 만들기, 사용자 지정 작업
CJMRT-000032-409
충돌 - 리소스가 이미 있음
중복 ID 또는 이름으로 리소스 만들기 시도
​1. 모든 리소스에 고유 ID 및 이름을 사용합니다
2. 같은 식별자
3을(를) 가진 기존 리소스를 확인하십시오. 충돌하는 개체를 삭제하거나 이름을 바꾸십시오
4. 명명 규칙 검토​

관련 설명서: 여정 만들기
CJMRT-170016-400
여정 구성/미리보기 중 잘못된 요청
페이로드에 필수 종속성이 없거나 템플릿 링크가 끊어졌습니다.
​1. 필요한 모든 리소스가 활성 상태인지 확인합니다
2. 템플릿 및 콘텐츠 블록이 게시되었는지 확인
3. 모든 종속성이 올바르게 연결되어 있는지 확인합니다
4. 여정 테스트 모드 결과 검토​

관련 설명서: 여정 테스트, 여정 종속성
CJMRT-080608-400
도메인/채널/위임에 잘못된 요청이 있음
필수 DNS 레코드 또는 이메일/SMS 구성 누락
​1. 전자 메일 도메인에 대한 DNS 구성을 완료합니다
2. 하위 도메인 위임이 완료되었는지 확인
3. 구성 마법사를 다시 실행하십시오
4. DNS 전파 허용 시간(최대 72시간)

관련 설명서: 채널 표면, 하위 도메인 위임
CJMRT-110100-500
페이로드 내부 오류
백엔드 데이터/구성 버그 또는 지원되지 않는 구성
​1.
2 작업을 다시 시도하십시오. 고급 기능을 사용하는 경우 구성을 단순화합니다
3. 요청 ID 및 정확한 페이로드를 사용하여 Adobe 지원 센터로 에스컬레이션합니다
4. 릴리스 정보에서 알려진 문제를 확인합니다​

관련 설명서: 여정 문제 해결

CJMMAS: 메시지 작성 서비스 오류 cjmmas-errors

메시지, 사전 설정 및 콘텐츠를 작성, 편집 또는 게시할 때 이러한 오류가 발생합니다.

오류 코드
설명
근본 원인
해결 방법
CJMMAS-1732-500
증명 실패 - AEM 에셋으로 증명/테스트를 전송할 때 모든 에셋이 게시되지 않음
최근에 게시된 자산이 아직 AJO에 없습니다. 자산 ID가 일치하지 않습니다. 교차 리포지토리 사용, AEM 동기화 지연
​1. 올바른 저장소/환경에서 게시된 자산 ID만 사용합니다
2. AEM과 AJO
3 간의 동기화 시간을 허용합니다. 정상 작동이 확인된 자산
4을(를) 사용하여 다시 시도하십시오. AEM에서 에셋 게시 상태 확인​

관련 설명서: Assets 통합
CJMMAS-1069-500
메시지 템플릿을 저장하거나 게시하는 도중 내부 오류 발생
백엔드 예외(인프라/서비스 버그 또는 콘텐츠 문제), 지원되지 않는 마크업/기능
​1. 템플릿 복잡성을 단순화하거나 줄입니다
2. 문제를 식별하기 위해 증분 단계로 콘텐츠를 다시 추가하십시오
3. Adobe 상태 페이지
4를 확인하세요. 지원되지 않는 기능 또는 마크업을 제거합니다​

관련 설명서: 콘텐츠 템플릿
CJMMAS-1149-400
메시지, 사전 설정 또는 변형을 저장할 때 잘못된 요청
메시지에 필수 필드가 누락되었거나 구성이 잘못되었습니다.
​1. 모든 필수 필드(별표로 표시)를 작성합니다
2. 메시지/사전 설정 구성의 유효성을 검사합니다
3. 필드 값 형식 및 제약 조건을 확인하십시오
4. UI에서 유효성 검사 메시지 검토​

관련 설명서: 전자 메일 채널, 채널 표면
CJMMAS-2073-422
메시지 사전 설정 편집에서 처리할 수 없는 엔티티
유효성 검사 오류, 지원되지 않는 필드 또는 잘못된 구문
​1. 표시된 대로 구문/필드 오류를 수정합니다
2. 정상 작동이 확인된 구성과 비교
3. 저장하기 전에 메시지 UI 유효성 검사 사용
4. 설명서에서 필드 요구 사항 검토​

관련 설명서: 메시지 사전 설정, 전자 메일 설정
CJMMAS-1300-500
메시지 작성의 내부 오류
인프라 문제, 대용량 콘텐츠 또는 서비스 다운타임으로 인한 백엔드 충돌
​1. 템플릿/콘텐츠를 단순화합니다(크기/복잡성 감소)
2.
3 작업을 다시 시도하십시오. 작업을 증분 저장
4. 영구적인 경우 Adobe 지원​

관련 설명서: 콘텐츠 템플릿(으)로 에스컬레이션
CJMMAS-2001-200
성공 상태이지만 오류 배너: 옵트아웃 링크가 누락됨
이메일 변형에 필수 구독 취소 링크가 없음
​1. 모든 이메일 변형에 옵트아웃/구독 취소 링크를 추가합니다
2. 모든 언어 버전
3에 링크가 있는지 확인하십시오. 개인화 도우미를 사용하여 옵트아웃 링크
4을(를) 삽입하십시오. 게시하기 전에 모든 변형을 테스트합니다​

관련 설명서: 옵트아웃 관리, 전자 메일 디자인
CJMMAS-1603-403
템플릿 또는 사전 설정을 업데이트/게시할 때 사용할 수 없음
사용자에게 필요한 권한/역할이 없거나 현재 상태에서 허용되지 않는 작업입니다.
​1. 사용자에게 적절한 권한이 있는지 확인합니다(메시지 관리자, 작성자 등).
2. 사전 설정/템플릿 상태(초안, 게시됨, 보관됨)
3 확인 필요한 경우 관리자에게 액세스 권한을 요청하십시오
4. 제품 프로필 할당 검토​

관련 설명서: 권한, 액세스 제어

CJMCMP: 캠페인 오류 cjmcmp-errors

이러한 오류는 캠페인 생성, 구성 및 활성화 중에 발생합니다.

오류 코드
설명
근본 원인
해결 방법
CJMCMP-6003-400
여정/메시지를 게시/테스트할 때 "하나 이상의 잘못된 캠페인이 있습니다."
노드가 누락되었거나 게시되지 않았거나 잘못된 캠페인을 참조합니다. 레거시 또는 복제된 여정이 인라인을 생성하지 않습니다.
​1. 각 메시지 노드를 열고 구성을 확인합니다
2. 메시지 노드를 다시 연결하거나 다시 추가합니다
3. 테스트 모드를 활성화하여 인라인 캠페인을 강제로 만듭니다
4. 문제가 자주 발생하는 경우 새 여정 마법사로 이동​

관련 설명서: 여정 만들기, 여정 테스트
CJMCMP-2003-400
UI 배너: 이메일 Designer의 "실험이 올바르지 않음"
오래되었거나 누락된 실험/데이터 공급자, 실험 정리 실패, 스키마 불일치 또는 UI 유효성 검사 버그
​1. 사용되지 않은 실험 필드를 제거합니다
2. 스키마 및 데이터 공급자 연결의 유효성을 검사합니다
3. UI를 다시 로드하고 브라우저 캐시를 지웁니다
4. 문제가 해결되지 않은 경우 노드/이메일을 다시 만들기​

관련 설명서: 콘텐츠 실험
CJMCMP-3001-400
시뮬레이션/미리보기 "잘못된 표면 유형 필터"
레거시 구조를 사용하여 빌드된 노드가 type=surfaceId를 전송하고 백엔드에 brandingPresetId가 필요합니다.
​1. 영향을 받는 노드
2을(를) 삭제하고 다시 만듭니다. 새 여정 버전/템플릿
3을 사용하십시오. 테스트 모드를 사용하여 구성
4을(를) 지웁니다. 문제가 광범위할 경우 노드를 대량 다시 만들기​

관련 설명서: 채널 표면, 메시지 시뮬레이션
CJMCMP-2050-400
캠페인 활성화 또는 승인의 잘못된 요청
캠페인이 유효하지 않거나 누락된 정책 또는 세그먼트를 참조합니다.
​1. 모든 캠페인 노드 구성을 감사
2. 정책/세그먼트 링크가 최신 링크이고 유효한지 확인
3. 올바른 구성으로 업데이트하십시오
4. 활성화 전에 캠페인 다시 테스트​

관련 설명서: 캠페인 만들기, 캠페인 승인

CJMTL: 전송 레이어 오류 cjmtl-errors

이러한 오류는 메시지 전송 및 게재 작업 중에 발생합니다.

오류 코드
설명
근본 원인
해결 방법
CJMTL-010018-422
콘텐츠를 저장/전송할 때 "Personalization이 도메인 이름에 허용되지 않음"
지나치게 엄격한 유효성 검사가 일시적으로 동적 href 도메인 개인화를 중단했습니다.
​1. 도메인 변수를 사용하는 경우 링크를 리팩터링합니다
2. 최신 AJO 버전이 사용 중인지 확인
3.
4 작업을 다시 시도하십시오. 문제가 지속되면 정적 도메인을 사용합니다​

관련 설명서: Personalization 구문, 이메일 디자인
CJMTL-010011-422
처리할 수 없는 엔티티 - 푸시/SMS/이메일 전송이 실패함, "잘못된 필드"라고 메시지 표시
페이로드 또는 수신자/연락처 데이터가 누락되었거나 잘못됨
​1. 로그에서 특정 필드 오류를 검사합니다
2. 프로필/연락처 정보를 수정
3. 테스트 프로필
4을(를) 사용하여 확인합니다. 필요에 따라 페이로드 포맷 리팩터링​

관련 설명서: 프로필 관리, 테스트 프로필

CJMRPS: Reporting and Provisioning 서비스 오류 cjmrps-errors

이러한 오류는 보고 구성 및 데이터 세트 프로비저닝 작업 중에 발생합니다.

오류 코드
설명
근본 원인
해결 방법
CJMRPS-1047-409
"충돌. 보고 데이터 세트를 추가할 때 데이터 세트가 이미 "추가됨
이미 프로비저닝된 데이터 세트를 추가하려고 합니다.
​1. 보고 설정에서 데이터 집합 구성을 검토하십시오
2. 이미 있는 데이터 세트를 다시 추가하지 마십시오
3. 마이그레이션 보고를 위해 공식 마이그레이션 확인 목록을 사용합니다
4. 중복 데이터 세트 참조 제거​

관련 설명서: 보고 개요, 캠페인 보고서, 여정 보고서

일반적인 문제 해결 방법 troubleshooting-approach

오류 코드가 나타나면 다음 체계적인 방법을 따르십시오.

  1. 오류 식별: 전체 오류 코드, HTTP 상태 및 함께 제공되는 메시지나 요청 ID를 참고하십시오.

  2. 서비스 찾기: 영향을 받는 구성 요소를 식별하려면 서비스 접두사(CJMPTS, CJMRT, CJMMAS, CJMCMP, CJMTL, CJMRPS)를 사용하십시오.

  3. 상태 코드 확인:

    • 400(잘못된 요청): 입력 데이터 및 구성 검토
    • 403(사용할 수 없음): 권한 및 액세스 권한 확인
    • 409(충돌): 중복되거나 충돌하는 리소스를 찾습니다
    • 422(처리할 수 없는 엔터티): 스키마 요구 사항에 대한 데이터 유효성 검사
    • 500(내부 서버 오류): 다시 시도하여 지원을 위해 에스컬레이션할 수 있습니다.
  4. 최근 변경 내용 검토: 최근에 수정된 내용(여정 업데이트, 새 캠페인, 구성 변경 등)을 고려합니다.

  5. 설명서를 참조하세요: 이 안내서에 제공된 링크를 사용하여 영향을 받는 기능에 대한 자세한 설명서에 액세스합니다.

  6. 필요한 경우 다시 시도: 500 계열 오류의 경우 몇 분 후에 간단히 다시 시도하면 일시적인 문제가 해결됩니다.

  7. 필요한 경우 에스컬레이션: 해결 단계를 수행한 후에도 오류가 지속되면 Adobe 지원 센터에 다음 방법으로 문의하십시오.

    • 전체 오류 코드
    • 요청 ID(가능한 경우)
    • 재현 단계
    • 관련 구성 세부 정보

일반적인 오류를 방지하는 모범 사례 best-practices

여정 활성화 전 journey-best-practices

  • 모든 리소스의 유효성을 검사합니다: 참조된 모든 대상, 이벤트, 데이터 원본 및 사용자 지정 작업이 올바르게 구성되었는지 확인합니다.
  • 철저하게 테스트: 게시하기 전에 테스트 모드를 사용하여 문제를 식별합니다(자세히 알아보기)
  • 볼륨 유효성 검사: 라이브로 전환되기 전에 시험 실행을 사용하여 대상 도달 및 분기 논리의 유효성을 검사합니다(자세히 알아보기).
  • 권한 확인: 모든 구성 요소에 필요한 액세스 권한이 있는지 확인하십시오.
  • 종속성 검토: 연결된 모든 메시지와 콘텐츠가 게시되었는지 확인

메시지를 만들 때 message-best-practices

  • 필수 필드 완료: 저장하기 전에 항상 모든 필수 필드를 입력하십시오.
  • 옵트아웃 링크 포함: 모든 이메일 변형에 구독 취소 링크 추가(자세히 알아보기)
  • 개인화 확인: 샘플 프로필로 모든 다이내믹 콘텐츠를 테스트합니다(자세히 알아보기).
  • 관리 가능한 템플릿 유지: 렌더링 문제를 일으킬 수 있는 너무 복잡한 템플릿을 사용하지 마십시오

캠페인 관리용 campaign-best-practices

  • 대상 데이터 확인: 대상 대상이 올바르게 구성 및 채워졌는지 확인하십시오.
  • 승인 상태 확인: 활성화하기 전에 승인 요구 사항을 이해합니다(자세히 알아보기).
  • 구성 모니터링: 채널 표면 및 사전 설정의 유효성을 정기적으로 검토합니다.
  • DNS 변경 계획: 도메인을 업데이트할 때 DNS 전파에 충분한 시간을 허용합니다.

추가 리소스 additional-resources

지원 받기 getting-support

이 안내서를 사용하여 해결할 수 없는 지속적인 오류가 발생하는 경우:

  1. 정보 수집: 오류 코드, 요청 ID, 타임스탬프 및 재현 단계를 수집합니다.
  2. 시스템 상태 확인: 알려진 서비스 문제에 대해서는 Adobe 상태를 방문하세요.
  3. 설명서 검색: 솔루션에 대한 Adobe Experience League 검토
  4. 커뮤니티 참여: Adobe Journey Optimizer 커뮤니티에 질문 게시
  5. Adobe 지원에 문의: 모든 관련 세부 정보를 포함한 지원 티켓을 제출합니다.
NOTE
이 오류 코드 참조는 새 코드가 식별되고 문서화됨에 따라 계속 업데이트됩니다. 최신 정보는 Adobe Journey Optimizer 커뮤니티 블로그를 정기적으로 확인하십시오.

관련 항목

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76