콘텐츠 전달 문제 해결

페이지에 예상되는 콘텐츠가 표시되지 않으면 몇 가지 단계를 진행하여 콘텐츠 제공을 디버깅할 수 있습니다.

• 활동 또는 캠페인 코드를 주의깊게 확인합니다. 입력 또는 기타 오류로 인해 예상 콘텐츠가 표시되지 않을 수 있습니다.
• mboxTrace 또는 mboxDebug를 사용하여 Target 요청의 문제를 해결합니다.
• mboxDebug와 동일한 정보를 많이 제공하는 사용이 간편한 도구인 Adobe Experience Cloud Debugger를 사용하여 Target 요청의 문제를 해결하십시오.

mboxDebug는 Target 요청이 실행되고 쿠키가 설정되어 있는지 확인하기 위해 페이지에서 Target을 설정하는 경우에 특히 유용합니다. 그러나 콘텐츠 전달을 디버깅할 때 유용한 세부 정보로 이동하지는 않습니다. 사용자 활동이 페이지에 나타나지 않거나 원치 않는 콘텐츠가 나타나면 mboxTrace를 사용하여 페이지를 자세히 검사하고 디버깅하십시오.

디버깅 도구에 사용할 인증 토큰 검색

mboxTrace 및 mboxDebug는 캠페인 데이터 및 프로필 데이터를 외부 당사자에게 노출할 수 있으므로 인증 토큰이 필요합니다. 인증 토큰은 Target UI에서 검색할 수 있습니다. 토큰은 6시간 동안 유효합니다.

인증 토큰을 생성하려면 다음 사용자 권한 중 하나가 있어야 합니다.

• 편집기 권한(또는 승인자) 이상

  Target Standard 고객에 대한 자세한 내용은 사용자​의 역할 및 권한 지정을 참조하십시오. Target Premium 고객에 대한 자세한 내용은 기업 권한 구성을 참조하십시오.

• 작업 공간/제품 프로필 수준에서 관리자 역할

  작업 공간은 Target Premium 고객에게만 제공됩니다. 자세한 내용은 엔터프라이즈 권한 구성을 참조하십시오.

• Adobe Target 제품 수준에서 관리자 권한(Sysadmin 권한)

인증 토큰을 검색하려면 다음을 수행하십시오.

1. 관리 > 구현​을 클릭합니다.

2. 디버거 도구 섹션에서 새 인증 토큰 생성​을 클릭합니다.

   

3. 생성된 토큰을 URL에 매개 변수로 추가하여 고급 디버깅 도구 중 하나를 활성화합니다.

   

mboxTrace

mboxTrace를 사용하여 Target 응답에 첨부된 추적 정보를 수신할 수 있습니다. 추적 정보는 Target 호출(예: 전환 또는 노출)의 결과와 이러한 특정 결과가 발생한 이유를 확인하는 데 도움이 될 수 있는 추가 데이터(예: 캠페인에서 선택 영역이 포함되는 사용 가능한 분기 세트)를 반영합니다. 이 정보를 사용하여 콘텐츠 전달을 디버깅하십시오.

다음 매개 변수를 사용할 수 있습니다.

mboxTrace 옵션	결과
?mboxTrace=console	콘솔 로그에 개체로 출력합니다. at.js의 경우 mbox.js의 경우처럼 새 브라우저 창을 팝업하거나 콘솔에 출력하지 않고, 네트워크 요청을 조사한 후 Preview(Chrome) 또는 Response(Firefox)에서 확인해야 합니다.
?mboxTrace=json	콘솔 로그에 리터럴 JSON 문자열로 출력합니다.
?mboxTrace=window	팝업 창에 JSON 문자열로 출력합니다.
?mboxTrace=disable	추적 세션 모드를 해제합니다.

mboxTrace 호출 예

https://www.mysite.com/page.html?mboxTrace=window&authorization=f543abf-0111-4061-9619-d41d665c59a6

출력에는 콘텐츠에 대한 아주 자세한 정보가 표시됩니다. mboxTrace는 캠페인이나 활동 및 프로필에 대한 세부 정보를 표시합니다. 또한 실행 전에 프로필 스냅숏과 실행 후 변경된 사항에 대한 스냅숏도 제공합니다. 그뿐 아니라 각 위치에 대해 평가된 캠페인 또는 활동도 표시합니다.

일부 정보에는 일치하거나 일치하지 않는 세그먼트 및 타겟 ID가 포함됩니다.

• SegmentId: 재사용 가능한 세그먼트 라이브러리 또는 특정 캠페인에 대해 생성된 익명 세그먼트의 세그먼트 ID입니다.
• TargetId: 타겟 표현식 라이브러리 또는 캠페인의 세그먼트에 대한 익명 타겟의 타겟 ID입니다.
• Unmatched: 요청이 이 호출에서 해당 세그먼트 또는 타겟에 자격을 부여하지 않았습니다.
• Matched: 요청이 지정된 세그먼트 또는 타겟에 자격을 부여했습니다.

추천 페이지에서 mboxTrace 사용:추천이 있는 페이지에 mboxTrace를 쿼리 매개 변수로 추가하면 페이지의 Recommendations 디자인이 mboxTrace 세부 정보 창으로 바뀝니다. 이 창에는 다음을 포함한 권장 사항에 대한 자세한 정보가 표시됩니다.

• 반환된 권장 사항 및 요청된 권장 사항
• 사용된 키 및 권장 사항을 생성하는지 여부
• 조건에 따라 생성된 권장 사항 및 백업 권장 사항
• 조건 구성
• 적용되는 제외 및 포함
• 컬렉션 규칙

쿼리 매개 변수에 =console, =json 또는 =window는 포함할 필요가 없습니다. mboxTrace 세부 정보를 다 지정했으면 =disable을 추가하고 Enter 키를 눌러 일반 표시 모드로 돌아갑니다.

사이트의 일반적인 기능 및 모양은 mboxTrace의 영향을 받지 않습니다. 방문자는 일반 권장 사항 디자인을 보게 됩니다.

mboxDebug

mboxDebug를 사용하려면 URL 끝에 mboxDebug 매개 변수를 추가합니다. 다음 표에는 Target 응답 관련 URL 매개 변수에 대한 정보가 포함되어 있습니다.

URL 매개 변수	목적
mboxDebug=1	디버거 Target 요청이 정의된 URL에 이 매개 변수를 추가하면 중요한 디버깅 세부 정보가 있는 팝업 창이 열립니다. 쿠키 정보, PCid 및 세션 ID 값이 작성되고 모든 URL이 표시됩니다. Target 요청 URL을 클릭하여 해당 Target 요청에 대한 응답을 표시합니다. 자세한 내용은 mbox_debug.pdf에서 볼 수 있습니다.
mboxDebug=x-cookie	쿠키 수정
mboxDisable=1	페이지에서 mbox 비활성화
mboxDebug=x-profile	프로필 세트 보기
mboxDebug=x-time	각 Target 요청에 대한 응답 시간 표시
mboxOverride.browserIp=<Insert IP address>	지리 기반의 타깃팅 테스트 이 URL 매개 변수로 지리 기반의 타깃팅을 테스트합니다. IP 주소를 이 속성의 값으로 입력하면 Test&Target의 지리 기반의 타깃팅은 캠페인에 설정된 지리 기반의 타깃팅 또는 세그먼테이션 세트에 대해 해당 IP 주소가 일치하는지 평가합니다.

Adobe Experience Cloud Debugger

Adobe Experience Cloud Debugger를 사용하면 쉽고 빠르게 대상 구현을 이해할 수 있습니다. 라이브러리 구성을 빠르게 보고, 요청을 검토하여 사용자 지정 매개 변수가 올바르게 전달되고 있는지 확인한 다음, 콘솔 로깅을 켜고, Target 요청을 모두 비활성화할 수 있습니다. Experience Cloud에 인증하면 강력한 MboxTrace 도구를 사용하여 방문자 프로필뿐만 아니라 활동 및 대상자 자격을 검사할 수 있습니다.

자세한 내용은 아래 교육 비디오를 참조하십시오.

자세한 내용은 Adobe Experience Cloud 디버거](/docs/target/c-implementing-target/c-implementing-target-for-client-side-web/c-target-debugging-atjs/target-debugging-atjs.html?lang=ko)를 사용하여 [Debug at.js를 참조하십시오.

전달 중 target.js가 로드되지 않는 경우

전달 중에 target.js가 로드되지 않으면 Mbox.js에서는 방문자에게 "em-disabled"라는 쿠키를 보냅니다. 이 쿠키는 Visual Experience Composer를 사용하여 만든 오퍼가 사이트에서 렌더링되지 못하게 합니다. 이 쿠키가 있는 방문자는 테스트 콘텐츠를 보지 못하고 해당 활동 보고서에서 카운트되지도 않습니다. 다른 모든 오퍼 콘텐츠(예: Target Classic의 캠페인)는 계속 로드됩니다. 이 쿠키의 수명은 로드 실패 시간부터 30분입니다.

최상위 판매자가 권장 사항에 나타나지 않습니다.

SiteCatalyst: purchase 호출은 구매 알고리즘 트래픽 데이터에 사용할 수 없습니다. 대신 orderConfirmPage 호출을 사용하십시오.

활동 우선 순위 확인

Target Standard/Premium으로 만든 양식 기반 활동은 우선 순위가 같으며 동일한 Target 요청을 사용하는 Target Classic UI에서 만든 활동과 충돌할 수 있습니다.

사용자 지정 코드가 Internet Explorer 8에서 예상한 결과를 생성하지 않습니다.

Target에서는 더 이상 IE 8을 지원하지 않습니다.

글로벌 Target 요청으로 전달되는 JavaScript 컨텐츠는 mbox.js를 사용할 때 로드되지 않습니다.

mbox.js 버전 58 이상으로 업그레이드하십시오.

mbox.js 버전 58 이상에서는 HTML BODY 태그가 있는 즉시 전역 Target 요청에 대해 비 JavaScript 컨텐츠를 실행합니다. 전역 Target 요청에 대한 <script> 태그 내의 JavaScript 컨텐츠는 DOMContentLoaded 이벤트가 실행된 후 실행됩니다. 이러한 컨텐츠 전달 순서에 따라 글로벌 Target 요청에 대한 JavaScript 컨텐츠가 전달되고 제대로 렌더링됩니다.

Target 쿠키가설정되지 않음

사이트에 us.domain.com과 같은 하위 도메인이 있지만 domain.com (us.domain.com이 아님)에 Target 쿠키 세트가 필요한 경우 cookieDomain 설정을 무시해야 합니다. 자세한 내용은 targetGlobalSettings()를 참조하십시오.

요소가 AEM 개인화에도 속하면 Target 콘텐츠가 깜박이거나 표시되지 않습니다.

DOM 요소가 Adobe Experience Manager(AEM) 개인화 타깃팅 및 Target 활동의 일부인 경우 Target 콘텐츠가 깜박이거나 표시되지 않을 수 있습니다.

이를 해결하려면 Target이 실행 중인 페이지에서 AEM 개인화를 비활성화하면 됩니다.

잘못된 URL로 인해 리디렉션 및 원격 오퍼가 전달에 실패했습니다.

리디렉션 또는 원격 오퍼가 잘못된 URL을 사용하는 경우 배달되지 않을 수 있습니다.

리디렉션 오퍼의 경우 Target 응답에는 /* invalid redirect offer URL */이 포함될 수 있습니다.

또는

원격 오퍼의 경우 Target 응답에는 /* invalid remote offer URL */이(가) 포함될 수 있습니다.

브라우저에서 Target 응답을 확인하거나 mboxTrace를 사용할 수 있습니다. 올바른 URL에 대한 자세한 내용은 https://tools.ietf.org/html/std66을 참조하십시오.

Target 요청이 내 사이트에서 실행되고 있지 않습니다.

잘못된 doctype을 사용하는 경우 at.js는 Target 요청을 실행하지 않습니다. at. s에는 HTML5 doctype이 필요합니다.

교육 비디오

다음 비디오에는 이 문서에서 설명한 개념에 대한 자세한 정보가 포함되어 있습니다.

확장 추가

기본 Target 디버깅

mbox 추적