권장하는 에어브릿지 이벤트 - 게임

2024년 11월 1일에 업데이트됨

에어브릿지에서 유저 행동을 분석하기 위해서는 서비스 분야에 따라 알맞은 이벤트 정의와 이벤트 택소노미가 필요합니다. 게임 분야에서 권장하는 이벤트 택소노미를 확인해 보세요.

알립니다
에어브릿지 이벤트에 대한 이해가 필요합니다. 아래 가이드를 함께 확인해 주세요.
에어브릿지 이벤트
이벤트 택소노미
개발자에게 필요한 가이드는 아래에서 확인할 수 있습니다.
에어브릿지 SDK 시작하기
에어브릿지 이벤트 예시 코드 (업데이트 예정)

게임 분야

게임 장르와 목적에 따라 게임을 즐기는 유저의 행동이 다양하기 때문에 서비스하는 게임을 즐기는 유저 또는 목표로 하는 유저를 먼저 파악한 후에 에어브릿지 이벤트를 정의해야 합니다. 게임 분야에서 권장하는 에어브릿지 이벤트를 수집하면 아래 질문에 답을 할 수 있습니다.

유저가 게임 내 상품 중에서 어떤 것을 구매하나요?
어떤 유저가 게임을 자주 찾아 오나요?
소셜 미디어에 게임에 대한 정보를 공유한 유저는 몇 명인가요?
친구를 초대한 유저는 몇 명인가요?

권장하는 이벤트 택소노미

게임 분야에서 권장하는 이벤트 택소노미입니다. 게임 장르와 게임 목적에 따라 실제 이벤트 택소노미는 변경될 수 있습니다.

앱 설치(Install), 딥링크 실행(Deeplink Open), 앱 실행(Open)은 수집하기 위한 별도 작업이 필요하지 않습니다. 앱 설치, 딥링크 실행, 앱 실행은 에어브릿지 SDK를 설치하면 자동으로 수집되는 이벤트입니다.

스탠다드 이벤트

스탠다드 이벤트 전체 목록은 에어브릿지 가이드를 참고해 주세요.

수집 목적

앱을 설치한 후에 회원으로 가입한 유저가 몇 명인지 확인할 수 있습니다. 또한 회원으로 가입한 유저의 잔존율(Retention)을 확인할 수 있습니다.

이벤트 정의 예시

유저가 어떤 플랫폼으로 서비스에 가입했는지 확인하기 위해서는 회원 가입에 사용한 플랫폼에 대한 정보를 액션 또는 라벨로 수집해야 합니다.

`#{"width":"80px"}` 구성요소	`#{"width":"240px"}` 설명
카테고리	`airbridge.user.signup`
액션, 라벨	{회원 가입에 사용한 플랫폼}
밸류	-
어트리뷰트	-
트리거	회원가입 완료 메시지가 출력된 시점

수집 목적

로그인한 유저가 몇 명인지 확인할 수 있습니다. 또한 로그인한 유저의 잔존율(Retention)을 확인할 수 있습니다.

이벤트 정의 예시

유저가 어떤 플랫폼으로 로그인했는지 확인하기 위해서는 로그인에 사용한 플랫폼에 대한 정보를 액션 또는 라벨로 수집해야 합니다.

`#{"width":"80px"}` 구성요소	`#{"width":"240px"}` 설명
카테고리	`airbridge.user.signin`
액션, 라벨	{로그인에 사용한 플랫폼}
밸류	-
어트리뷰트	-
트리거	유저가 로그인을 완료한 시점

수집 목적

구매 완료 이벤트를 수집하면 광고로 게임을 시작한 유저가 발생시킨 매출을 확인할 수 있습니다. 또한 확인한 매출로 LTV(Life Time Value, 생애 가치), ROI(Return on Investment, 광고 지출 대비 수익률) 등을 측정하거나 광고 캠페인을 최적화할 수 있습니다.

이벤트 정의 예시

유저가 구매한 방법이나 유저가 구매한 상품 카테고리를 확인하기 위해서는 액션과 라벨로 해당 정보를 수집해야 합니다. 또한 매출을 계산하기 위해서는 수집한 정보를 더해야 하기 때문에 구매 금액을 밸류로 수집합니다. 시맨틱 어트리뷰트를 설정하면 다양한 정보를 수집할 수 있습니다.

`#{"width":"80px"}` 구성요소	`#{"width":"240px"}` 설명
카테고리	`airbridge.ecommerce.order.completed`
액션, 라벨	{구매 방법}, {구매한 상품 카테고리}
밸류	{구매 금액}
어트리뷰트	Transaction ID, Currency, Product ID, Product Price, Product Quantity
트리거	유저가 상품을 구매한 시점

수집 목적

실제 매출액을 확인하기 위해서는 유저가 구매한 금액에서 유저가 구매를 취소한 금액을 제외해야 합니다.

이벤트 정의 예시

구매를 취소한 방법과 구매를 취소한 상품 카테고리는 액션과 밸류로 수집합니다. 또한 구매를 취소한 상품 금액을 더하거나 빼기 위해서는 밸류로 수집해야 합니다.

`#{"width":"80px"}` 구성요소	`#{"width":"240px"}` 설명
카테고리	`airbridge.ecommerce.order.canceled`
액션, 라벨	{취소 방법}, {구매를 취소한 상품 카테고리}
밸류	{구매를 취소한 상품 금액}
어트리뷰트	Transaction ID, Currency, Product ID, Product Price, Product Quantity
트리거	구매가 취소된 이후에 금액이 환불된 시점

주의하세요
구매 취소 이벤트(airbridge.ecommerce.order.canceled)는 시맨틱 어트리뷰트 중에서 Transaction ID를 반드시 수집해야 합니다. 해당 Transaction ID는 구매 완료 이벤트(airbridge.ecommerce.order.completed)에서 수집한 구매 상품의 Transaction ID와 같아야 합니다.
구매 취소 이벤트 설정에 대한 자세한 내용은 에어브릿지 가이드를 참고해 주세요.

알립니다
인게임 광고 노출로 발생한 매출액을 수집한다면 구글 애드몹, 유니티 레벨플레이 등과 광고 매출 연동을 진행하는 것을 권장합니다.

수집 목적

유저가 인게임 광고를 시청한 행동을 수집합니다. 어디서 노출된 게임이 가장 많이 노출되는지 확인할 수 있습니다.

이벤트 정의 예시

`#{"width":"80px"}` 구성요소	`#{"width":"240px"}` 설명
카테고리	`airbridge.adImpression`
액션, 라벨	{인게임 광고가 노출된 지면}
밸류	-
어트리뷰트	-
트리거	유저가 인게임 광고를 모두 시청한 시점

수집 목적

특정 레벨 또는 특정 스테이지 달성 여부를 이벤트로 수집하면 광고를 보고 게임을 시작한 유저가 게임을 충분히 즐기는지 확인할 수 있습니다.

이벤트 정의 예시

레벨 달성 (airbridge.achieveLevel) 이벤트만으로는 특정 레벨 또는 특정 스테이지 달성 여부는 알 수 있지만, 달성한 레벨 또는 스테이지에 대한 정보는 수집하지 않습니다. 달성한 레벨 또는 스테이지에 대한 정보는 액션 또는 라벨로 수집할 수 있습니다.

`#{"width":"80px"}` 구성요소	`#{"width":"240px"}` 설명
카테고리	`airbridge.achieveLevel`
액션, 라벨	{달성한 레벨 또는 스테이지}, {유저가 선택한 서버 이름}
밸류	-
어트리뷰트	Level, Description
트리거	유저의 특정 레벨 또는 특정 스테이지 달성 시점

유저가 특정 레벨 또는 특정 스테이지를 달성할 때마다 레벨 달성 이벤트를 각각 수집하기 보다는 구간에 따라 이벤트를 수집하는 것을 권장합니다. 아래 테이블을 참고해 주세요.

`#{"width":"80px"}` 수집 방법	`#{"width":"140px"}` 설명	`#{"width":"120px"}` 액츄얼스 리포트 조회
레벨마다 수집	- 레벨 1부터 레벨 10까지 발생한 레벨 달성 이벤트를 따로 수집하면 최대 10종류의 레벨이 수집됩니다. - 같은 방법으로 레벨 100까지 수집하면 최대 100종류의 레벨이 수집됩니다.	- Event Action을 그룹바이로 설정하면 레벨마다 행이 생깁니다. 따라서 최대 100행이 조회됩니다.
구간별로 수집	- 레벨 1부터 레벨 10까지 발생한 레벨 달성 이벤트를 액션에서 1 step으로 수집하면 1종류의 구간이 수집됩니다. - 같은 방법으로 레벨 100까지 수집하면 최대 10종류의 레벨이 수집됩니다.	- Event Action을 그룹바이로 설정하면 구간마다 행이 생깁니다. 따라서 최대 10행이 조회됩니다.

#{"width":"80px"}

수집 방법

#{"width":"140px"}

설명

#{"width":"120px"}

액츄얼스 리포트 조회

레벨마다 수집

- 레벨 1부터 레벨 10까지 발생한 레벨 달성 이벤트를 따로 수집하면 최대 10종류의 레벨이 수집됩니다.

- 같은 방법으로 레벨 100까지 수집하면 최대 100종류의 레벨이 수집됩니다.

- Event Action을 그룹바이로 설정하면 레벨마다 행이 생깁니다. 따라서 최대 100행이 조회됩니다.

구간별로 수집

- 레벨 1부터 레벨 10까지 발생한 레벨 달성 이벤트를 액션에서 1 step으로 수집하면 1종류의 구간이 수집됩니다.

- 같은 방법으로 레벨 100까지 수집하면 최대 10종류의 레벨이 수집됩니다.

- Event Action을 그룹바이로 설정하면 구간마다 행이 생깁니다. 따라서 최대 10행이 조회됩니다.

수집 목적

특정 과제, 특정 업적 또는 특정 진척도 달성 여부를 이벤트로 수집하면 게임을 시작한 유저가 게임을 충분히 즐기는지 확인할 수 있습니다.

이벤트 정의

과제 달성 (airbridge.unlockAchievement) 이벤트만으로는 특정 과제, 특정 업적 또는 특정 진척도 달성 여부 자체는 알 수 있지만, 달성한 과제 또는 업적 카테고리에 대한 정보는 수집하지 않습니다. 달성한 과제, 업적 또는 진척도에 대한 정보는 액션 또는 라벨로 수집할 수 있습니다.

`#{"width":"80px"}` 구성요소	`#{"width":"240px"}` 설명
카테고리	`airbridge.unlockAchievement`
액션, 라벨	{달성한 과제 또는 업적 카테고리}
밸류	-
어트리뷰트	Achievement ID, Description, Score
트리거	유저의 특정 과제 등 달성 시점

달성한 과제, 업적 또는 진척도를 각각 수집하기 보다는 일정 기준에 따라 이벤트를 수집하는 것을 권장합니다. 아래 테이블을 참고해 주세요.

`#{"width":"80px"}` 수집 방법	`#{"width":"140px"}` 설명	`#{"width":"120px"}` 액츄얼스 리포트 조회
각각 수집	- 업적 1부터 업적 10까지 따로 수집하면 최대 10종류의 업적이 수집됩니다. - 같은 방법으로 업적 100까지 수집하면 최대 100종류의 업적이 수집됩니다.	- Event Action을 그룹바이로 설정하면 레벨마다 행이 생깁니다. 따라서 최대 100행이 조회됩니다.
일정 기준에 따라 수집	- 업적 1부터 업적 10까지 발생한 업적 달성 이벤트를 액션에서 Category 1로 수집하면 1종류의 업적이 수집됩니다. - 같은 방법으로 업적 100까지 수집하면 최대 10종류의 업적이 수집됩니다.	- Event Action을 그룹바이로 설정하면 구간마다 행이 생깁니다. 따라서 최대 10행이 조회됩니다.

#{"width":"80px"}

수집 방법

#{"width":"140px"}

설명

#{"width":"120px"}

액츄얼스 리포트 조회

각각 수집

- 업적 1부터 업적 10까지 따로 수집하면 최대 10종류의 업적이 수집됩니다.

- 같은 방법으로 업적 100까지 수집하면 최대 100종류의 업적이 수집됩니다.

- Event Action을 그룹바이로 설정하면 레벨마다 행이 생깁니다. 따라서 최대 100행이 조회됩니다.

일정 기준에 따라 수집

- 업적 1부터 업적 10까지 발생한 업적 달성 이벤트를 액션에서 Category 1로 수집하면 1종류의 업적이 수집됩니다.

- 같은 방법으로 업적 100까지 수집하면 최대 10종류의 업적이 수집됩니다.

- Event Action을 그룹바이로 설정하면 구간마다 행이 생깁니다. 따라서 최대 10행이 조회됩니다.

수집 목적

게임에서 구매한 크레딧 또는 게임에서 사용할 수 있는 재화를 통해서 구매한 상품을 분석할 수 있습니다.

이벤트 정의 예시

밸류로 유저가 상품을 구입하면서 사용한 크레딧 수량을 수집해야 유저가 사용한 크레딧의 합계를 구할 수 있습니다.

`#{"width":"80px"}` 구성요소	`#{"width":"240px"}` 설명
카테고리	`airbridge.spendCredits`
액션, 라벨	{크레딧으로 구매한 아이템 종류}
밸류	{사용한 크레딧 수량}
어트리뷰트	Transaction ID, Product ID, Product Name, Product Quantity
트리거	유저가 크레딧을 사용해 상품을 구입한 시점

수집 목적

게임 초대 링크 또는 게임 관련 콘텐츠를 게임에 있는 공유 기능을 통해서 사용한 유저에 관해 데이터를 수집할 수 있습니다. 이를 통해 리퍼러(Referrer) 과정 분석에 활용할 수 있습니다.

이벤트 정의 예시

유저가 공유하기 위해 생성한 링크 종류와 링크를 생성한 앱 내 위치에 관한 정보는 액션과 라벨로 수집합니다.

`#{"width":"80px"}` 구성요소	`#{"width":"240px"}` 설명
카테고리	`airbridge.share`
액션, 라벨	{공유한 링크 종류}, {링크를 생성한 앱 내 위치}
밸류	-
어트리뷰트	Description, Shared Channel
트리거	유저가 링크 생성하기 버튼을 클릭해서 링크를 생성한 시점

커스텀 이벤트

아래 커스텀 이벤트 외에 필요한 커스텀 이벤트를 추가로 정의할 수 있습니다.

수집 목적

앱을 설치한 이후에 게임을 플레이하는 유저의 상세한 잔존율을 분석할 수 있습니다.

이벤트 정의 예시

게임 플레이는 게임 장르에 따라 수집하는 시점이 다를 수 있습니다. RPG 장르는 실제 '게임 시작' 버튼을 클릭한 시점에 이벤트를 수집할 수 있습니다. 퍼즐, 아케이드 장르는 스테이지를 시작할 때마다 이벤트를 수집할 수 있습니다.

`#{"width":"80px"}` 구성요소	`#{"width":"240px"}` 설명
카테고리	`play_game`
액션, 라벨	-
밸류	-
어트리뷰트	-
트리거	게임을 시작하거나 스테이지를 시작하는 시점

수집 목적

게임 서비스에서 제공하는 보너스를 획득한 유저를 분석할 수 있습니다. 또한 보너스를 획득하기 위해 유저가 어떻게 게임을 플레이했는지 확인할 수 있습니다.

이벤트 정의 예시

보너스를 통해 여러 종류의 재화를 유저에게 제공한다면 액션 또는 라벨로 제공한 재화 종류에 관한 정보를 수집할 수 있습니다.

`#{"width":"80px"}` 구성요소	`#{"width":"240px"}` 설명
카테고리	`claim_bonus`
액션, 라벨	{보너스로 받은 재화 종류}
밸류	-
어트리뷰트	-
트리거	유저가 보너스를 받은 시점

수집 목적

게임 서버가 여러 개라면 광고에 따라 유저가 선호하는 서버가 다른지 분석할 수 있습니다.

이벤트 정의 예시

유저가 게임을 시작한 서버에 대한 정보는 액션 또는 라벨로 수집합니다.

`#{"width":"80px"}` 구성요소	`#{"width":"240px"}` 설명
카테고리	`join_server`
액션, 라벨	{서버 이름}
밸류	-
어트리뷰트	-
트리거	유저가 서버를 선택해서 게임을 시작한 시점

수집 목적

패치를 진행한 이후 게임 패키지 다운로드 여부와 유저의 잔존율(Retention)을 분석할 수 있습니다.

이벤트 정의 예시

패치별로 유저 행동을 분석하기 위해서는 패치를 진행한 게임 버전을 액션 또는 라벨로 수집합니다.

`#{"width":"80px"}` 구성요소	`#{"width":"240px"}` 설명
카테고리	`complete_patch`
액션, 라벨	{패치를 진행한 게임 버전}
밸류	-
어트리뷰트	-
트리거	패치가 완료된 시점

도움이 되었나요?

더 필요한 내용이 있나요?

권장하는 에어브릿지 이벤트 - 게임

알립니다

게임 분야

권장하는 이벤트 택소노미

스탠다드 이벤트

구매 완료 (airbridge.ecommerce.order.completed)

구매 취소 (airbridge.ecommerce.order.canceled)

주의하세요

인게임 광고 노출 (airbridge.adImpression)

알립니다

레벨 달성 (airbridge.achieveLevel)

과제 달성 (airbridge.unlockAchievement)

크레딧 사용 (airbridge.spendCredits)

커스텀 이벤트

게임 플레이

보너스 획득

게임 서버 선택

패치 완료

권장하는 에어브릿지 이벤트 - 게임self.__wrap_n!=1&&self.__wrap_b(":R29jtt7ppjtsba:",0.5)

알립니다

게임 분야

권장하는 이벤트 택소노미

스탠다드 이벤트

회원가입 (airbridge.user.signup)

로그인 (airbridge.user.signin)

구매 완료 (airbridge.ecommerce.order.completed)

구매 취소 (airbridge.ecommerce.order.canceled)

주의하세요

인게임 광고 노출 (airbridge.adImpression)

알립니다

레벨 달성 (airbridge.achieveLevel)

과제 달성 (airbridge.unlockAchievement)

크레딧 사용 (airbridge.spendCredits)

공유 (airbridge.share)

커스텀 이벤트

게임 플레이

보너스 획득

게임 서버 선택

패치 완료

권장하는 에어브릿지 이벤트 - 게임