at.js 사용자 지정 이벤트

mbox 요청 또는 오퍼가 실패하거나 성공하는 경우를 알려주는 at.js custom events에 대한 정보입니다.

이전에 mbox.js에서는 페이지에서 실행되는 다른 JavaScript 코드가 내부에서 진행되는 상황을 알지 못했습니다. at.js가 발전하면서 이 문제를 해결할 수 있는 기회가 생겼습니다.

고객에 따르면, 다음을 포함하여 알림을 받기 원하는 몇 가지 시나리오가 있습니다.

  • 시간 초과, 잘못된 상태 코드, JSON 구문 분석 오류 등으로 인해 mbox 요청이 실패한 경우
  • mbox 요청이 성공한 경우
  • mbox 요소 누락, 선택기를 찾을 수 없음 등으로 인해 오퍼 렌더링이 실패한 경우
  • 오퍼 렌더링이 성공한 경우 DOM 변경 사항이 적용된 경우

사전 정의된 이벤트에는 이벤트 유형에 따라 필수 데이터를 추출할 수 있는 구조가 있습니다.

다른 시나리오에서 이벤트를 사용할 수 있게 하도록 사용자 정의 이벤트에는 이벤트 개체(핸들러에 전달)의 detail 속성에 지정된 페이로드 개체가 있습니다. 또한 문자열을 이벤트 이름으로 전달하지 않도록 하기 위해 adobe.target.event 네임스페이스를 사용하여 이벤트가 상수로 표시됩니다.

구조

키 유형 설명
유형 문자열 at.js와의 상호 작용을 추적, 디버깅 및 사용자 지정하는 데 도움이 되도록 알림을 받으려는 몇 가지 시나리오가 있습니다.
아래에 나열된 각 사용자 지정 이벤트는 "상수" 및 "문자열 값"의 두 가지 형식을 갖습니다.
  • 상수: 앞에 adobe.target.event.를 추가하고, 모두 대문자로 표시하고 밑줄 문자를 포함합니다. at.js가 로드된 후, mbox 응답이 수신되기 전에 사용자 지정 이벤트에 가입하려면 상수를 사용하십시오.
  • 문자열 값: 소문자로 나타내고 대시를 포함합니다. at.js가 로드되기 전​에 사용자 지정 이벤트에 가입하려면 문자열 값을 사용하십시오.
요청이 실패했습니다
​상수:adobe.target.event.REQUEST_FAILED
문자열 값:at-request-failed
설명:시간 초과, 잘못된 상태 코드, JSON 구문 분석 오류 등으로 인해 mbox 요청이 실패했습니다.
요청 성공
​상수: adobe.target.event.REQUEST_SUCCEEDED
문자열 값: at-request-succeeded
설명: mbox 요청이 성공했습니다.
컨텐츠 렌더링 실패
​상수: adobe.target.event.CONTENT_RENDERING_FAILED
문자열 값: at-content-rendering-failed
설명: mbox 요소 누락, 선택기를 찾을 수 없음 등으로 인해 오퍼 렌더링이 실패했습니다.
컨텐츠 렌더링 성공
​상수: adobe.target.event.CONTENT_RENDERING_SUCCEEDED
문자열 값: at-content-rendering-succeeded
설명: 오퍼 렌더링이 성공했습니다. DOM 변경 사항이 적용된 경우​
라이브러리를 로드함
​상수: adobe.target.event.LIBRARY_LOADED
문자열 값: at-library-loaded
설명: 이 이벤트는 at.js가 완전히 로드된 시기를 추적하는 데 이상적입니다. 이 이벤트를 사용하여 글로벌 mbox 실행을 사용자 지정할 수 있습니다. 또한 이 이벤트를 사용하여 글로벌 mbox를 비활성화한 후 이 이벤트를 수신하여 나중에 글로벌 mbox를 실행할 수도 있습니다.
요청 시작
​상수: adobe.target.event.REQUEST_START
문자열 값: at-request-start
설명: HTTP 요청이 실행되기 전에 이 이벤트가 실행됩니다. 리소스 시간 설정 API를 사용하는 성능 측정에 이 이벤트를 사용할 수 있습니다.
컨텐츠 렌더링 시작
​상수: adobe.target.event.CONTENT_RENDERING_START
문자열 값: at-content-rendering-start
설명: 선택기 폴링이 시작되고 컨텐츠가 페이지에 렌더링되기 전에 이 이벤트가 실행됩니다. 이 이벤트를 사용하여 컨텐츠 렌더링 진행 상태를 추적할 수 있습니다.
컨텐츠 렌더링 오퍼 없음
​상수: adobe.target.event.CONTENT_RENDERING_NO_OFFERS
문자열 값: at-content-rendering-no-offers
설명: 반환된 오퍼가 없으면 이 이벤트가 실행됩니다.
컨텐츠 렌더링 리디렉션
​상수: adobe.target.event.CONTENT_RENDERING_REDIRECT
문자열 값: at-content-rendering-redirect
설명: 오퍼가 리디렉션이고 Target이 다른 URL로 리디렉션될 때 이 이벤트가 실행됩니다.
mbox 문자열 mbox 이름
message 문자열 발생한 사항, 오류 메시지 등과 같이 사람이 읽을 수 있는 설명을 포함합니다.
tracking 개체 sessionId 및 deviceId를 포함합니다. 일부 경우에 deviceId이 에지 서버에서 검색할 수 없기 때문에 Target가 누락될 수 있습니다.
유형 문자열 장치 내 의사 결정 가공물 성공
​상수:
adobe.target.event.ARTIFACT_DOWNLOAD_SUCCEEDED
문자열 값: artifactDownloadSucceeded
설명:장치 내 의사 결정 아티팩트가 성공적으로 다운로드될 때 호출됩니다.
장치 내 의사 결정 아티팩트가
​실패상수: adobe.target.event.ARTIFACT_DOWNLOAD_FAILED
문자열 값: artifactDownloadFailed
설명:장치 내 의사 결정 아티팩트를 다운로드하지 못할 때 호출됩니다.

사용

document.addEventListener(adobe.target.event.REQUEST_SUCCEEDED, function(event) { 
  console.log('Event', event); 
});

교육 비디오: 응답 토큰 및 at.js 사용자 지정 이벤트 자습서 배지

다음 비디오를 시청하여 응답 토큰 및 at.js 사용자 지정 이벤트를 사용하여 Target에서 타사 시스템으로 프로필 정보를 공유하는 방법을 학습하십시오.

이 페이지에서는