Platform Web SDK를 사용하여 Target 디버그
Target 활동을 확인하고 Web SDK를 디버깅하여 구현, 콘텐츠 전달 또는 대상 자격 문제를 해결합니다. 마이그레이션 안내서의 이 페이지에서는 at.js를 사용한 디버깅과 Platform Web SDK의 차이점에 대해 설명합니다.
아래 표에는 테스트 및 디버깅 접근 방식에 대한 기능과 지원이 요약되어 있습니다.
mboxDebug URL 매개 변수alloy_debug 매개 변수 사용mboxTrace URL 매개 변수alloy_debug URL 매개 변수Adobe Experience Platform Debugger 브라우저 확장
Chrome 및 Firefox용 Adobe Experience Platform Debugger 확장 기능은 웹 페이지를 살펴보고 Adobe Experience Cloud 구현의 유효성을 검사하는 데 도움이 됩니다.
모든 웹 페이지에서 Platform Debugger를 실행할 수 있으며 확장 프로그램은 공개 데이터에 액세스할 수 있습니다. Target 추적 정보와 같은 확장을 사용하여 비공개 데이터에 액세스하려면 로그인 링크를 통해 Experience Cloud을 인증해야 합니다.
Adobe Experience Platform Debugger 가져오기 및 설치
이 Adobe Experience Platform Debugger은 Google Chrome 또는 Mozilla Firefox 브라우저에 설치할 수 있습니다. 아래의 해당 링크를 따라 원하는 브라우저에 확장을 설치합니다.
Chrome 확장 또는 Firefox 추가 기능을 설치하면 확장 모음에 아이콘(
Adobe Experience Platform Debugger 확장과 모든 Adobe 웹 응용 프로그램을 디버깅하는 방법에 대한 자세한 내용은 전용 안내서를 참조하세요.
QA URL을 사용하여 Target 활동 미리 보기
at.js와 Platform Web SDK를 사용하면 모두 Target QA URL을 사용하여 Target 활동을 미리 볼 수 있으며, 두 구현 방법 모두 동일한 QA 기능을 지원합니다.
at.js 또는 Platform Web SDK에서 at_qa_mode 브라우저에 특정 쿠키를 작성하도록 지시하여 작동하는 Target QA URL입니다. 이 쿠키는 특정 활동 및 경험에 대한 자격을 부여하는 데 사용됩니다.
sendEvent 호출에서 전달된 xdm.web.webPageDetails.URL 값을 기반으로 활성화됩니다. 모든 문자의 소문자로 시작하는 등 이 값을 수정하면 Target QA 모드가 제대로 작동하지 않을 수 있습니다.Target 활동 QA에 대한 자세한 내용은 전용 안내서를 참조하세요.
Target 구현 디버그
아래 표는 at.js와 Platform Web SDK 디버깅 전술 간의 차이점을 간략하게 설명합니다.
URL 매개 변수로 페이지를 로드합니다.
mboxDisable=trueURL 매개 변수가 있는 페이지를 로드합니다.
mboxDebug=trueURL 매개 변수가 있는 페이지를 로드합니다.
alloy_debug=true또는 개발자 콘솔에서
alloy("setDebug", { "enabled": true });을(를) 실행하십시오.window.___target_trace 개체에서 사용할 수 있습니다.URL 매개 변수가 있는 페이지 로드:
mboxTrace=window&authorization={TOKEN}Target 기능 비활성화
Platform Web SDK에는 현재 Target 응답을 선택적으로 표시하지 않는 기능이 없습니다. 하지만 브라우저의 개발자 도구, 다양한 브라우저 확장 또는 타사 응용 프로그램을 사용하여 Platform Web SDK 요청을 무시할 수 있습니다. 예를 들어 Google Chrome을 사용하여 Platform Web SDK를 차단하려면 다음을 수행하십시오.
- 페이지의 아무 곳이나 마우스 오른쪽 단추로 클릭하고 Inspect 선택
- 네트워크 탭 선택
//ee//문자열로 필터링하여 Platform Web SDK 호출만 봅니다.- 페이지 다시 로드
- 필터링된 네트워크 요청 중 하나를 마우스 오른쪽 단추로 클릭하고 요청 도메인 차단 을 선택합니다.
- 페이지를 다시 로드하고 네트워크 요청이 차단되었음을 확인합니다.
- 디버깅이 끝나면 차단된 네트워크 요청을 마우스 오른쪽 단추로 클릭하고 차단 해제 를 선택하거나 개발자 도구 패널을 닫습니다
디버그 로깅 보기
mboxDebug=true URL 매개 변수를 사용하여 at.js에 대한 디버그 로깅에는 각 Target 요청, 응답 및 페이지에 콘텐츠를 렌더링하려는 시도에 대한 자세한 정보가 표시됩니다. Platform Web SDK에 alloy_debug=true URL 매개 변수를 사용한 유사한 디버그 로깅이 있습니다.
mboxDebug=true)alloy_debug=true)AT:[alloy]Target 추적 보기
Target 추적은 활동 자격 및 방문자의 Target 프로필에 대한 자세한 정보를 제공합니다. Target 추적에는 공개적으로 사용할 수 없는 정보가 포함되어 있으므로 해당 추적을 보려면 Adobe Experience Platform Debugger 브라우저 확장 창 내에서 인증 토큰 또는 인증이 필요합니다.
mboxTrace URL 매개 변수Adobe Experience Platform Debugger을 사용하여 Platform Web SDK Target 추적을 보려면 다음을 수행하십시오.
- Platform Web SDK를 사용하여 Target을 구현한 사이트의 페이지로 이동합니다
- 브라우저 탐색 모음에서 아이콘(
- 로그인 링크 선택
- Adobe Experience Cloud 로그인을 사용하여 인증
- 왼쪽의 로그 탭을 선택하십시오.
- 맨 위의 Edge 탭을 선택합니다.
- 필요한 경우 디버깅 세션에 이름을 지정하고 연결 단추를 클릭합니다.
- 페이지를 다시 로드하면 로그가 에지 네트워크 상호 작용에 대한 자세한 정보로 채워집니다
- 설명의 "대상 추적"으로 시작하는 로그 항목에 초점을 맞추고 보기 를 선택하여 대상 추적 세부 정보를 봅니다.
보기 를 선택하면 요청과 관련된 다음 정보를 볼 수 있는 오버레이가 나타납니다.
- 일치하는 활동
- 일치하지 않는 활동
- 요청 세부 정보
- 프로필 스냅샷
Target 추적에 대한 자세한 내용은 Target 콘텐츠 게재 디버깅에 대한 전용 안내서를 참조하십시오.
Assurance 문제 해결
대상 추적 정보는 Adobe Experience Platform Debugger 브라우저 확장 기능 및 Assurance 애플리케이션(이전에는 프로젝트 그리폰)에서 모두 볼 수 있습니다. Assurance 내에서 Target 추적을 보려면 다음 작업을 수행하십시오.
- 위에 설명된 대로 Adobe Experience Platform Debugger 브라우저 확장을 열고 원격 디버깅 세션을 연결합니다
- 디버깅 로그 위에서 세션 이름이 있는 링크를 선택합니다.
- Platform Assurance는 구현을 위해 데이터 스트림에 구성된 모든 Adobe 애플리케이션에 대한 자세한 로깅을 로드하고 표시합니다
adobe.target(으)로 로그 필터링- 유형이
com.adobe.target.trace인 로그 항목 선택 - 페이로드의 세부 정보를 확장하고
context > targetTrace에서 정보를 봅니다.
네트워크 요청 및 응답 검사
Platform Web SDK sendEvent 호출의 요청 페이로드와 응답이 at.js와 다릅니다. 아래 개요는 브라우저의 개발자 도구를 사용하여 네트워크 호출을 검사하는 동안 요청 및 응답의 구조를 이해하는 데 도움이 됩니다.
컨텐츠 요청 페이로드
- 프로필, 엔터티 및 기타 mbox가 아닌 매개 변수가
data.__adobe.target아래의 이벤트 배열에 전달됩니다. - 결정 범위가
query.personalization.decisionScopes아래의 이벤트 배열에 있습니다. - mbox 매개 변수 다운스트림에 매핑되는 XDM 데이터는
xdm아래의 이벤트 배열에 있습니다.
콘텐츠 응답 본문
- Platform Web SDK가
handle개체 아래의 모든 Adobe 응용 프로그램에 대한 작업을 반환합니다 personalization:decisions작업은 Target 또는 offer decisioning의 응답을 나타냅니다- 대상 제안이 배열로 표시되며, 각 제안 ID에는
AT:접두사가 붙습니다. - 의사 결정 범위 및 활동 세부 사항은 제안 배열 내에 있습니다.
- 오퍼 세부 정보가
data아래items배열에 있습니다. - 응답 토큰이
meta아래items배열에 있습니다.
제안 이벤트 페이로드
- Target 특정 SDK 이벤트는 노출의 경우
decisioning.propositionDisplay이고, 클릭과 같은 상호 작용의 경우decisioning.propositionInteract입니다. - 제안 이벤트의 세부 정보는
xdm._experience.decisioning아래 이벤트 배열에 있습니다. - 디스플레이 또는 상호 작용 이벤트의 제안 ID는 Target에서 반환된 콘텐츠의 제안 ID와 일치해야 합니다
축하합니다. 자습서가 종료되었습니다! Adobe Target 구현을 웹 SDK로 마이그레이션해 주셔서 감사합니다.