HTML 분석 연동

HTML ads는 노출 및 클릭 외에도 추가적인 데이터 포인트를 제공합니다. AppLovin을 사용하면 HTML 로드 시점, 사용자의 챌린지 진행 상황, 사용자의 경험 완료 시점, CTA 버튼 클릭 시점 등 HTML 내의 특정 이벤트를 추적할 수 있습니다.

분석 기능 사용 시기

몰입형 HTML 경험에 분석 기능을 연동하세요. 다음과 같이 짧은 HTML 경험에는 분석 기능을 연동하지 마십시오.

완료하는 데 필요한 상호작용이 3회 미만인 HTML
첫 번째 상호작용 후 5초 이내에 리디렉션되는 HTML

구현 방법

기본 사용법

모든 Analytics 호출은 안전성 검사를 수행하도록 처리하세요.

if (typeof window.ALPlayableAnalytics != 'undefined') {
  window.ALPlayableAnalytics.trackEvent('«event-name»');
}

info

중요 참고 사항

항상 Analytics 호출 감싸기: 안전 검사는 로컬에서 테스트하거나 다른 네트워크에서 광고를 게재할 때 오류가 발생하는 것을 방지합니다.
ALPlayableAnalytics를 정의하지 마십시오: SDK가 컨텍스트 내에서 ALPlayableAnalytics 객체를 자동으로 정의합니다.
사전 정의된 이벤트만 작동합니다: AppLovin은 커스텀 이벤트를 추적하지 않습니다.

사용 가능한 이벤트

로딩 및 표시 이벤트

이벤트 이름	설명	필수 여부	중복 제거 여부	리포트 열
`LOADING`	플레이어블 내 로딩이 시작됩니다. 로딩 화면을 표시하는 등 사용자가 상호작용하기 전에 로딩이나 초기화를 수행하는 경우 이 이벤트를 구현하십시오.	선택 사항	예	HTML loading
`LOADED`	플레이어블 내 로딩이 완료됩니다.	조건부¹	예	HTML loaded
`DISPLAYED`	HTML 크리에이티브가 사용자에게 표시되고 사용자가 상호작용할 준비가 완료됩니다.	필수	예	HTML displayed

¹ LOADING 이벤트를 구현하는 경우 이 이벤트를 반드시 구현해야 합니다. 그렇지 않은 경우에는 이 이벤트를 구현하지 마십시오.

챌린지 이벤트

이벤트 이름	설명	필수 여부	중복 제거 여부	리포트 열
`CHALLENGE_STARTED`	사용자가 HTML에서 챌린지를 시작합니다. 사용자가 "시작"을 클릭하거나 크리에이티브와 의미 있는 상호작용을 할 때 이를 트리거하십시오.	선택 사항	예	Challenge started
`CHALLENGE_FAILED`	사용자가 실패 상태에 도달하여 챌린지에 실패합니다.	조건부^1,2	예	Challenge failed
`CHALLENGE_RETRY`	사용자가 실패한 챌린지를 다시 시도합니다.	조건부^1,2,3	예	Challenge retry
`CHALLENGE_PASS_25`	사용자가 챌린지 진행률 25%에 도달합니다.	조건부¹	예	Challenge pass 25
`CHALLENGE_PASS_50`	사용자가 챌린지 진행률 50%에 도달합니다.	조건부¹	예	Challenge pass 50
`CHALLENGE_PASS_75`	사용자가 챌린지 진행률 75%에 도달합니다.	조건부¹	예	Challenge pass 75
`CHALLENGE_SOLVED`	사용자가 챌린지를 성공적으로 완료합니다.	조건부^1,2	예	Challenge solved

¹ CHALLENGE_STARTED 이벤트를 구현하는 경우에만 이 이벤트들을 구현하십시오.
² CHALLENGE_STARTED 이벤트를 구현하는 경우, 이 이벤트 중 최소 하나 이상을 구현해야 합니다. CHALLENGE_STARTED 이벤트를 구현하지 않는 경우, 이 이벤트들을 사용하지 마십시오.
³ CHALLENGE_FAILED 이벤트를 구현하는 경우에만 이 이벤트를 구현하고, 사용자가 챌린지에 실패한 후에만 호출하십시오.

완료 및 전환 이벤트

이벤트 이름	설명	필수 여부	중복 제거 여부	리포트 열
`CTA_CLICKED`	사용자가 크리에이티브 내부의 콜투액션(CTA) 버튼을 클릭합니다.	선택 사항	예	CTA clicked
`ENDCARD_SHOWN`	HTML 경험 내부의 엔드 카드 또는 요약 화면이 표시됩니다.	선택 사항	예	Endcard shown

이벤트 순서

권장 순서:

(선택 사항) LOADING
(선택 사항) LOADED
DISPLAYED
챌린지가 존재하는 경우
1. CHALLENGE_STARTED
2. (선택 사항) CHALLENGE_PASS_25
3. (선택 사항) CHALLENGE_PASS_50
4. (선택 사항) CHALLENGE_PASS_75
5. CHALLENGE_SOLVED
(선택 사항) ENDCARD_SHOWN
(선택 사항) CTA_CLICKED (디자인에 따라 ENDCARD_SHOWN 전후에 발생할 수 있음)

실패 및 재시도 순서 (예시):

(선택 사항) LOADING
(선택 사항) LOADED
DISPLAYED
CHALLENGE_STARTED
(선택 사항) CHALLENGE_PASS_25
CHALLENGE_FAILED
CHALLENGE_RETRY
(선택 사항) CHALLENGE_PASS_25
(선택 사항) CHALLENGE_PASS_50
(선택 사항) CHALLENGE_PASS_75
CHALLENGE_SOLVED

세부 사항

처음부터 CTA가 표시되는 경우

CTA_CLICKED는 DISPLAYED 이후 언제든지 발생할 수 있으며, 반드시 ENDCARD_SHOWN 이후에 발생할 필요는 없습니다.

챌린지가 없는 플레이어블 (순수 인터랙티브 데모, 엔드 카드 형태의 HTML, 승패 없음)

Playable Analytics를 사용하지 마십시오.

기술적 오류와 사용자 실패의 구분

기술적 문제로 인한 크래시, JS 예외, 로드 실패 또는 타임아웃에 CHALLENGE_FAILED를 사용하지 마십시오.

로딩 화면이 없는 경우

LOADING 및 LOADED를 건너뛰고 DISPLAYED로 시작하십시오.

엔드 카드의 의미

ENDCARD_SHOWN은 플레이어블 외부의 포스트 플레이어블 엔드 카드 템플릿이 아니라, HTML 플레이어블 경험 내부의 엔드 카드 또는 요약 화면을 나타냅니다.

추적 가능한 주요 지표

성과 지표

로드 성공률 (LOADING, LOADED)
표시 성과 (DISPLAYED)

참여 지표

챌린지 참여율 (CHALLENGE_STARTED)
챌린지 진행 상황 (CHALLENGE_PASS_25, CHALLENGE_PASS_50, CHALLENGE_PASS_75)
완료율 (CHALLENGE_SOLVED)

전환 지표

콜투액션(CTA) 성과 (CTA_CLICKED)
엔드 카드 효과성 (ENDCARD_SHOWN)

챌린지 성과

성공 대비 실패율 (CHALLENGE_SOLVED 대비 CHALLENGE_FAILED)
재시도 동작 (CHALLENGE_RETRY)

인기 크리에이티브 라이브러리

MMP 트래킹 설정

운영정책 이용약관 퍼블리셔 정책 디맨드 파트너 정책 플랫폼 규제 프라이버시 Your Privacy Choices

쿠키설정