콘텐츠 전달 문제 해결

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

  • 활동 또는 캠페인 코드를 주의깊게 확인합니다. 입력 또는 기타 오류로 인해 예상 콘텐츠가 표시되지 않을 수 있습니다.
  • Use mboxTrace or mboxDebug to troubleshoot the Target request.
  • Use the Adobe Experience Cloud Debugger, an easy-to-use tool that provides much of the same information as mboxDebug, to troubleshoot the Target request.

mboxDebug is especially useful when you are setting up Target on your page to make sure the Target request is firing and the cookie is being set. 그러나 콘텐츠 전달을 디버깅할 때 유용한 세부 정보로 이동하지는 않습니다. 사용자 활동이 페이지에 나타나지 않거나 원치 않는 콘텐츠가 나타나면 mboxTrace를 사용하여 페이지를 자세히 검사하고 디버깅하십시오.

Retrieve the authorization token to use with debugging tools

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

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

  • 적어도 편집기 권한(또는 승인자)

    고객에 대한 자세한 내용은 Target Standard 사용자 에서 역할 및 권한 지정을 참조하십시오. 고객에 대한 자세한 내용은 Target Premium 엔터프라이즈 권한 구성을 참조하십시오.

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

    작업 영역은 Target Premium 고객에게만 제공됩니다. For more information, see Configure enterprise permissions.

  • 제품 수준의 관리자 권한( Adobe Target 시스템 관리자 권한)

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

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

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

    새 인증 토큰 생성

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

    인증 토큰

mboxTrace

mboxTrace enables you to receive trace information attached to Target responses. Trace information reflects the outcome of a Target call (for example, a conversion or an impression) and any additional data that may help in determining why this particular outcome happened, such as a set of available branches among which the selection was made in a campaign. 이 정보를 사용하여 콘텐츠 전달을 디버깅하십시오.

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

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 매개 변수를 추가합니다. The following table contains information about Target response-related URL parameters.

NOTE

일부 mboxDebug 매개 변수는 인증이 있거나 없는 상태로 사용할 수 있습니다.

URL 매개 변수 목적
mboxDebug=1 Debugger
Adding this parameter to any URL with Target requests defined opens a pop-up window with valuable debugging details. 쿠키 정보, PCid 및 세션 ID 값이 작성되고 모든 URL이 표시됩니다. Click on a Target request URL to show the response for that Target request. 자세한 내용은 mbox_debug.pdf에서 볼 수 있습니다.
mboxDebug=x-cookie 쿠키 수정
mboxDisable=1 페이지에서 mbox 비활성화
mboxDebug=x-profile 프로필 세트 보기
mboxDebug=x-time Show response time for each Target request
mboxOverride.browserIp=<Insert IP address> 지리 기반의 타깃팅 테스트
이 URL 매개 변수로 지리 기반의 타깃팅을 테스트합니다. IP 주소를 이 속성의 값으로 입력하면 Test&Target의 지리 기반의 타깃팅은 캠페인에 설정된 지리 기반의 타깃팅 또는 세그먼테이션 세트에 대해 해당 IP 주소가 일치하는지 평가합니다.
NOTE

URL 단편이 쿼리 문자열 매개 변수 뒤에 있는지 확인합니다. 첫 번째 이후의 모든 것 # 은 조각 식별자이며 디버깅 매개 변수가 제대로 작동하지 않습니다.

Adobe Experience Cloud Debugger

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

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

자세한 내용은 Adobe Experience Cloud 디버거를 사용하여 Debug at.js를 참조하십시오.

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

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

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

The SiteCatalyst: purchase call can't be used for Purchase algorithm traffic data. 대신 orderConfirmPage 호출을 사용하십시오.

Check activity priority

Form-based activities created with Target Standard/Premium might collide with activities created in the Target Classic UI that have the same priority and use the same Target request.

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

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

JavaScript content delivered by the global Target request doesn't load when using mbox.js.

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

mbox.js version 58 and later executes non-JavaScript content for the global Target request immediately after the HTML BODY tag is present. JavaScript content inside <script> tags for the global Target request executes after the DOMContentLoaded event is fired. This order of content delivery ensures that JavaScript content for the global Target request is delivered and rendered properly.

Target cookie does not get set

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

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

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

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

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

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

For redirect offers, the Target response can contain /* invalid redirect offer URL */

또는

For remote offers, the Target response can contain /* invalid remote offer URL */

You can check the Target response in the browser or using mboxTrace. 올바른 URL에 대한 자세한 내용은 https://tools.ietf.org/html/std66을 참조하십시오.

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

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

교육 비디오

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

확장 추가 자습서 배지

기본 Target 디버깅 자습서 배지

mbox 추적 자습서 배지

이 페이지에서는