DCS 오류 코드, 메시지 및 예제

코드 ID별로 숫자 순서로 나열된 Data Collection Servers (DCS)에 의해 생성된 오류 코드와 메시지

아래 표에서 기울임체​는 변수 자리 표시자를 나타냅니다.

시스템 오류 코드

오류 코드 오류 메시지 설명
0 지정되지 않은 오류 다른 오류 처리기에서 다루지 않는 이벤트를 처리하는 다목적 캐치(catch-all) 오류입니다. 이 오류를 해결하기 어렵습니다. 알 수 없는 다양한 작업 또는 이벤트에 의해 발생할 수 있습니다. 이 오류가 표시되면 DCS 요청을 다시 시도하십시오. 문제가 계속되면 Adobe 담당자에게 문의하십시오.
1 호스트 이름에 대한 구성을 찾을 수 없습니다.hostname 요청에 전송된 호스트 이름이 파트너 프로비저닝 팀에서 설정하지 않았습니다. 이 오류 메시지가 표시되면 Adobe 담당자에게 문의하십시오.
2 잘못된 d_orgid 값(이 조직 ID에 대한 구성을 찾을 수 없음):ID 조직 ID가 잘못되었습니다. ID를 확인하고 요청을 다시 시도하십시오. 조직 ID를 모르거나 보유하고 있는 경우, 찾는 방법에 대한 자세한 내용은 "관리 페이지" 섹션 조직 및 계정 연결을 참조하십시오.

통합 오류 코드

오류 코드 오류 메시지 설명
100 요청에 대한 호스트 이름을 검색할 수 없습니다. 요청에 API 호출이 호스트 HTTP 헤더를 보내지 않았습니다. 호스트 헤더를 호출에 추가하고 다시 시도하십시오. 대부분의 브라우저와 API 클라이언트는 이 작업을 자동으로 수행합니다.
101 ID에 잘못된 Experience Cloud ID가 전달되었습니다. DCS 호출에 잘못된 Experience Cloud ID가 있습니다. 헤더 문자열에서 d_mid= 키-값 쌍을 선택합니다. 올바른 Experience Cloud ID를 전달하고 있는지 확인하고 요청을 다시 시도하십시오.
102 요청 ID에서 잘못된 AAM ID이(가) 전달되었습니다. DCS 호출에 잘못된 Audience Manager ID가 있습니다. 헤더 문자열에서 d_uuid= 키-값 쌍을 선택합니다. 올바른 Audience Manager ID를 전달하고 있는지 확인하고 요청을 다시 시도하십시오.
104 모든 고객 ID가 잘못되었습니다. 호출의 모든 고객 ID가 잘못되었습니다. ID를 확인하고 다시 시도하십시오.
109 Referer HTTP referer은(는) 파트너 Partner ID에 사용할 수 없습니다. 호출의 HTTP referer 헤더는 호출의 파트너 ID에 대해 허용되지 않습니다. HTTP referer 헤더가 올바른지 확인하십시오.
111 잘못된 IMS 토큰이 수신되었습니다. Audience Manager - Adobe Target 통합에 대해 반환됩니다. 잘못된 IMS 토큰을 포함하는 DCS을(를) 호출하면 오류가 발생합니다. 토큰의 형식이 잘못되었거나, 만료되었거나, 사용자에게 필요한 리소스에 액세스할 수 있는 권한이 없을 수 있습니다.

옵트아웃 오류 코드

코드 ID 메시지 설명

171

id ID에 대한 옵트아웃 태그가 있습니다.

고객이 관심 기반 광고를 받지 않기로 선택한 경우

172

차단된 쿠키

사용자의 브라우저가 타사 쿠키를 차단하면 반환됩니다.

173

NAI를 통해 트러스트 관계가 발생했습니다.

사용자가 NAI를 통해 옵트아웃 프로세스를 시작했습니다.

198

파트너가 이 국가의 요청을 차단합니다.

IP 주소를 기준으로 DCS는 파트너가 의도적으로 트래픽을 제한한 국가의 요청을 차단합니다.

199

이 국가의 요청은 허용되지 않습니다.

IP 주소를 기준으로 DCS는 다음 국가의 요청을 차단합니다.

  • 쿠바(CU)
  • 이란(IR)
  • 북한(KP)
  • 수단(SD)
  • 시리아(SY)

프로필 검색 오류 코드

코드 ID 메시지 설명

200

ID에 대한 프로필 캐시에서 트레이트를 읽을 수 없습니다.ID

내부 저장소에서 사용자 프로필을 읽을 수 없을 때 반환됩니다.

201

고객 ID에 대한 프로필 캐시에서 장치 ID를 읽을 수 없습니다.ID

프로필 링크 병합 규칙에 대해 장치 ID을(를) 검색할 수 없을 때 반환됩니다.

202

장치 ID에 대한 관련 고객을 읽을 수 없습니다.ID

내부 저장소에서 마지막으로 인증된 병합 규칙에 대해 장치 ID에 연결된 고객 ID(UUID)를 검색할 수 없을 때 반환됩니다.

203

ID에 대한 장치 클러스터를 읽을 수 없습니다.ID

동일한 장치 그래프 클러스터의 연결된 장치 ID는 이 장치 ID에 대해 반환할 수 없습니다.

204

기본 장치에 대해 프로필을 읽지 못했기 때문에 마이그레이션을 수행할 수 없습니다.

이 오류가 표시되면 데이터 저장소( PCS)에서 확장성 문제가 발생할 수 있습니다. 문제가 계속되면 Adobe 담당자에게 문의하십시오.

205

ID에 대해 프로필을 읽지 못했기 때문에 ID에서 ID(으)로 마이그레이션을 수행할 수 없습니다.

이 오류가 표시되면 데이터 저장소( PCS)에서 확장성 문제가 발생할 수 있습니다. 문제가 계속되면 Adobe 담당자에게 문의하십시오.

통합 경고 코드

코드 ID 메시지 설명

300

잘못된 고객 ID ID

고객 ID가 잘못되었습니다(데이터 소스에 대한 값이 없거나 통합 코드가 누락됨, 데이터 소스에 대한 형식이 잘못됨, 차단된 고객 ID, 빈 고객 ID, 파트너에 속하지 않는 데이터 소스에 대한 권한 없는 액세스 시도).

301년

최대 고객 ID 수를 초과했습니다. 허용되는 최대 수는 maximum allowed입니다. 찾은 값은 maximum found입니다.

장치 간 데이터 원본과 연결된 고객 ID의 수가 요청당 허용되는 장치 간 ID를 초과합니다. 이러한 ID에는 장치 간, 모바일 또는 쿠키 ID가 포함됩니다. 제한은 현재 10으로 설정되어 있습니다.

302년

인증되지 않은 고객 ID ID

현재 조직 ID가 고객 ID 데이터 소스를 소유하지 않을 때 반환됩니다. 조직 ID를 모르거나 가지고 있는 경우, 찾는 방법에 대한 자세한 내용은 조직 및 계정 연결의 "조직 ID 찾기" 섹션을 참조하십시오.

303년

차단된 고객 ID ID

고객 ID가 악성 ID로 식별되고에 추가되면 차단 목록 반환됩니다.

304년

차단된 데이터 소스 ID ID

데이터 소스 ID가 악성 ID로 식별되어에 추가되면 차단 목록 반환됩니다.

306년

차단된 선언된 장치 ID ID

장치 ID가 악의적인 것으로 식별되어에 차단 목록 추가되었습니다. 이 장치 ID가 들어 있는 DCS 요청이 짧은 시간 내에 극한의 양을 수신할 때 이 문제가 발생할 수 있습니다.

307년

ID에 대한 차단된 프로필 작업

ID가 악성 ID로 식별되어에 추가되었기 때문에 읽기/쓰기 작업이 차단되었습니다. 오류 코드 306을 차단 목록 참조하십시오.

309년

고객 ID ID이(가) 요청당 선언된 고객 ID의 제한을 초과했기 때문에 폐기되었습니다.

오류 301과 관련되어 있습니다. 이 오류는 한도를 초과했기 때문에 폐기된 고객 ID를 지정합니다.

예를 들어, DCS 호출에 선언된 고객 ID가 12개인 경우 이 중 2개가 무시됩니다. 폐기된 고객 ID를 릴레이하기 위해 이 오류는 응답에 두 번 나타납니다(무시된 고객 ID에 한 번).

310년

고객 ID가 지정된 네임스페이스의 제한을 초과했기 때문에 무시됩니다. 네임스페이스 id는 ID이고 고객 ID는 ID입니다.

이 오류 코드는 DCS 호출에 동일한 네임스페이스( DPID)에 대해 선언된 고객 ID가 3개 이상인 경우 반환됩니다.

https://partner.demdex.net/event?d_rtbd=json&d_cid_ic=one&d_cid_ic=one&d_cid_ic=one&d_cid_ic=one

이 샘플 DCS 요청에는 동일한 네임스페이스에 대해 선언된 4개의 ID가 있습니다(통합 코드 1 포함). ID 중 하나가 무시되고 오류 310이 반환됩니다.

311년

요청에 잘못된 매개 변수가 있습니다.

하나 이상의 URL 매개 변수가 제대로 인코딩되지 않은 경우 DCS에서 이 오류 코드를 반환합니다. 이 경우 DCS은 전체 요청을 무시합니다.

http(s)://partner.demdex.net/event?d_event=imp&d_rtbd=json&d_src=38454&d_site=%esid!&d_creative=%ecid!&d_adgroup=%eaid!&d_placement=%epid!&d_campaign=%ebuy!&d_adsrc=48123

위의 샘플 요청에서 % 시퀀스가 잘못 인코딩되었습니다. 따라서 DCS은 무시하게 됩니다.

올바르게 인코딩된 샘플은 다음과 같아야 합니다.

http(s)://partner.demdex.net/event?d_event=imp&d_rtbd=json&d_src=38454&d_site=%25esid!&d_creative=%25ecid!&d_adgroup=%25eaid!&d_placement=%25epid!&d_campaign=%25ebuy!&d_adsrc=48123

312년

요청에 잘못된 전역 장치 ID가 포함되어 있습니다.

요청에 잘못된 전역 장치 ID가 포함된 경우 DCS에서 이 오류 코드를 반환합니다. DCS는 잘못된 ID를 무시하고 잘못된 ID의 특정 오류와 함께 312 오류를 발생시킵니다. 올바른 장치 광고 ID 형식 및 해당 글로벌 데이터 소스에 대한 자세한 내용은 Audience Manager의 전역 데이터 소스ID의 인덱스를 참조하십시오.

잘못된 호출의 예: "http://partner.demdex.net/event?d_rtbd=json&d_cid=20915%01a53cc5a2-6aa1-4210-8ded-a88b29b6212z"

설명:IDFA(DPID 20915)는 대문자 ID여야 합니다. 요청에 제공된 ID는 소문자입니다.

313년

GCL에 CMP ID가 없습니다.

평가 시 Audience Manager의 캐시된 글로벌 CMP 목록 버전에 없는 CMP ID로 gdpr=1 및 IAB TC 문자열이 생성되면 IAB TCF용 Audience Manager 플러그인은 IAB TC 문자열을 삭제하고 평소대로 요청을 처리합니다. IAB TCF v2.0 ${GDPR} 매크로는 0으로 설정되고 ${GDPR_CONSENT_XXX} 매크로는 비어 있습니다.

314년

CMP ID가 GCL에서 삭제된 것으로 표시됨

글로벌 CMP 목록의 캐시된 버전에서 삭제된 것으로 표시된 CMP에서 gdpr=1 및 IAB TC 문자열이 생성되면 IAB TCF용 Audience Manager 플러그인이 TC 문자열을 삭제하고, 평가 시간이 전역 CMP 목록에서 삭제 시간이 지난 경우 요청을 평소대로 처리합니다. IAB TCF v2.0 ${GDPR} 매크로는 0으로 설정되고 ${GDPR_CONSENT_XXX} 매크로는 비어 있습니다.

315년

동의 문자열은 동의 없음을 나타냅니다.

IAB TCF용 Audience Manager 플러그인은 동의하지 않으면 사용자를 추가 데이터 수집에서 옵트아웃하거나 파트너 컨텍스트를 감지하지 못하면 호출을 완전히 삭제합니다.

샘플 오류 코드 메시지

DCS은 JSON 개체나 HTTP 응답 문자열의 X- 헤더에 있는 오류 코드와 메시지를 반환합니다.

샘플 DCS 오류 코드 및 메시지

{ 
   "errors":[ 
      { 
         "code":101,
         "msg":"Invalid Experience Cloud id passed in"
      },
      { 
         "code":102,
         "msg":"Invalid aam id passed in request"
      }
   ]
}

X-오류

X- 헤더에 의해 캡처된 오류 코드는 다음과 같은 URL 문자열에 나타납니다. X-Error: 101,102.

경합 조건 및 오류 처리

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free