콘텐츠로 이동

마케팅 어트리뷰션 사용하기

이벤트란 게임 설치, 게임 업데이트, 아이템 구매와 같이 유저가 게임을 플레이하면서 수행하는 모든 활동입니다. 마케팅 어트리뷰션은 이러한 이벤트 로그를 모아 서버에 전송하여 유저 활동을 추적하는 기능으로, 마케팅 어트리뷰션의 추척 데이터를 분석하여 다양하게 활용할 수 있습니다. 예를 들어, 게임내에서 발생하는 레벨업, 아이템 강화와 같은 이벤트를 추적하여 유저 행동을 예측할 수 있으며 게임을 더 재밌게 즐길 수 있도록 유도할 수 있습니다.

Hive SDK를 사용하면 유저 앱에 유저가 진입하는 경로와 유저 활동을 추적할 수 있는 서드 파티(Third party) 앱 마케팅 어트리뷰션을 함께 사용할 수 있습니다. SDK에서 지원하는 서드 파티 앱 마케팅 어트리뷰션은 Adjust와 Singular, AppsFlyer, Firebase Analytics, Airbridge 다섯 가지입니다.

제공 기능 및 지원 범위

마케팅 어트리뷰션에서 제공하는 기능은 아래와 같습니다.

  • 이벤트 자동 추적: 앱 설치, 앱 오픈, 앱 업데이트, 인앱 구매와 같이 기본적인 이벤트를 자동으로 트래킹하고 어트리뷰션 서버로 데이터 전송합니다.
  • 이벤트 수동 추적: 게임에서 수집하려는 이벤트를 직접 정의하여 트래킹하고 어트리뷰션 서버로 데이터 전송합니다.
  • PG 결제 구매 완료 정보 수집 : PG 결제 사용 시에도 구매 완료 이벤트를 수집할 수 있습니다.
  • 어트리뷰트 전송 : 이벤트 수동 추적 시, 어트리뷰트를 통해 이벤트의 추가 정보를 수집할 수 있습니다.
  • 광고 노출 정보 전송: 게임에서 광고가 노출될 때 광고 플랫폼 종류, 광고 노출 위치, 노출 시점, 노출당 광고 수익 등을 측정하여 전송합니다.
  • SDK Signature : 스푸핑(거짓 이벤트를 광고 서버에 전송하는 광고 사기) 방지 솔루션입니다. 유효한 서명 정보를 확인하여 참/거짓 이벤트를 구분하고 광고 사기를 방지합니다.
  • 앱 삭제 추적 : 하루 한 번 사일러트 푸시를 발송하여 앱 삭제 여부를 확인합니다.
  • 디퍼드 딥링크: 앱을 설치하지 않은 유저를 앱스토어로 이동시켜 설치를 유도하고, 설치한 앱을 실행하면 유저에게 지정된 콘텐츠 위치로 리다이렉트합니다.
  • 마켓별 유입량 측정 설정 : 마켓(GooglePlay Store, One Store, Huawei Store, Galaxy Store 등)에 대한 앱 설치 성과를 분석할 수 있도록 식별자를 설정합니다.
Note

광고 정보 전송, SDK Signature, 앱 삭제 추적, 디퍼드 딥링크, 마켓별 유입량 측정 설정은 모바일 게임 앱에서만 지원하는 기능입니다.

게임 앱이 모바일 혹은 PC 환경이냐에 따라 지원되는 마케팅 어트리뷰션 서드 파티 앱의 종류와 기능에 차이가 있습니다.

모바일

모바일 환경에서는 다섯 가지 마케팅 어트리뷰션 앱을 모두 지원하며 각 앱 별로 제공되는 기능은 아래와 같습니다.

기능 Adjust Airbridge Appsflyer Firebase Analytics Singular
이벤트 자동 추적 O O O O O
이벤트 수동 추적 O O O O O
PG 결제 구매 완료 정보 수집 O O O O O
어트리뷰트 전송 O O O O O
광고 정보 전송 O O O O O
SDK Signature O O - - -
앱 삭제 추적 O O O - -
디퍼드 딥링크 - O - - -
마켓별 유입량 측정 설정 - O - - -

PC

PC 환경에서는 Airbridge와 Appsflyer(Steam) 두가지만 지원합니다.

기능 Airbridge Appsflyer
이벤트 자동 추적 O O
이벤트 수동 추적 O O
PG 결제 구매 완료 정보 수집 O O
어트리뷰트 전송 O O

커뮤니티 & 웹 상점

커뮤니티 & 웹 상점에서는 마케팅 어트리뷰션으로 Airbridge의 이벤트 자동 추적 기능만 이용할 수 있습니다. 또한 모바일 및 PC 환경에서 모두 이벤트를 수집할 수 있습니다.

Note

커뮤니티 & 웹 상점에서는 Airbridge 뿐만 아니라 Google Tag Manager(GTM) 로도 이벤트 수집이 가능합니다. GTM 코드를 발급 후 하이브 콘솔에 등록하면 수집할 수 있습니다. 자세한 내용은 콘솔 가이드를 참고하세요.

커뮤니티 자동 수집 이벤트

Airbridge가 커뮤니티 사이트에서 자동 수집할 수 있는 이밴트는 아래와 같습니다.

이벤트 이벤트 상세 트리거 시점 구성 요소(참고) 에어브릿지 이벤트 목록 매칭
로그인 로그인 로그인 완료 후 정상적으로 페이지 진입한 시점 - 로그인(스탠다드)
로그인 회원가입 커뮤니티 아이디 생성 시점 - 회원가입(스탠다드)
로그인 로그아웃 로그아웃 버튼 선택 시점 - 로그아웃(스탠다드)
게시글(콘텐츠) 메인 화면 조회 메인 화면에 노출된 게시글 선택 시점 •게시글 정보( 제목, 이미지/동영상, 닉네임, 등록일자, 뷰카운트, 댓글 ) •게시판 타입 •목록에서의 노출 위치 홈 화면 조회(스탠다드)
게시글(콘텐츠) 카테고리/메뉴 선택 카테고리/메뉴 버튼 선택 시점 •카테고리/메뉴명 상품리스트 조회 (스탠다드)
게시글(콘텐츠) 글쓰기 버튼 선택 사이드 네비게이션/카테고리 내 글쓰기 버튼 선택 시점 •카테고리 •형식 (커스텀 이벤트)
게시글(콘텐츠) 게시글 등록 게시글 작성 완료 후 등록 선택 시점 •길이 (작성 분량) •첨부파일 갯수 •작성 소요 시간 •작성 일자 (커스텀 이벤트)
게시글(콘텐츠) 게시글 삭제 등록된 게시글의 삭제 버튼 선택 시점 •게시글 정보(제목, 이미지/동영상, 닉네임, 등록일자, 뷰카운트, 댓글) (커스텀 이벤트)
게시글(콘텐츠) 게시글 임시등록 게시글 작성 중 임시등록 선택 시점 - (커스텀 이벤트)
게시글(콘텐츠) 정렬/필터 적용 게시글 목록에서 디폴트 정렬/필터 외 다른 방식 선택 시점 •선택한 정렬 방식 •선택한 필터 (커스텀 이벤트)
게시글(콘텐츠) 커뮤니티 활동 •댓글/대댓글 작성 완료 후 등록 버튼 선택 시점 •댓글/대댓글 삭제 버튼 선택 시점 •신고, 좋아요, 싫어요 선택 시점 •게시글 정보 (커스텀 이벤트)
게시글(콘텐츠) 게시글 공유 게시글 공유 버튼 선택 후 공유 팝업에서 공유 수단 선택한 시점 •게시글 정보 •선택한 공유 수단 공유(스탠다드)
게시글(콘텐츠) 검색 결과 조회 검색 결과 리스트 중 게시글 선택 시점 • 게시글 정보 •페이지 번호 검색결과 조회 (스탠다드)
게시글(콘텐츠) 해시태그 이용 •게시글 작성 시 해시태그 입력 후 등록 선택 시점 •해시태그(#) 입력 후 검색 시작 시점 •게시글 정보 •입력한 해시태그 수 •해당 해시태그 관련 게시글 수 (커스텀 이벤트)
사용자 프로필 설정 •프로필 수정 완료 시점 •타 사용자 프로필 조회 시점 •프로필 이미지 •닉네임 (커스텀 이벤트)
사용자 탈퇴 커뮤니티 탈퇴 안내 팝업에서 탈퇴 버튼 선택 시점 - (커스텀 이벤트)
그 외 웹 상점 진입 헤더/사이드 네비게이션 내 웹 상점 버튼 선택 시점 - (커스텀 이벤트)
그 외 구매 내역 확인 헤더/사이드 네비게이션 내 구매 내역 버튼 선택 시점 - (커스텀 이벤트)
그 외 PC로 플레이 진입(웹) 사이드 네비게이션 내 PC로 플레이 버튼 선택 시점 - (커스텀 이벤트)
그 외 쿠폰 교환소 진입 사이드 네비게이션 내 쿠폰 교환소 버튼 선택 시점 - (커스텀 이벤트)
그 외 브랜드 사이트 진입 사이드 네비게이션 내 브랜드 사이트 버튼 선택 시점 - (커스텀 이벤트)
그 외 마켓 이동 푸터/사이드 네비게이션 내 마켓 이동 버튼 선택 시점 - (커스텀 이벤트)

웹 상점 자동 수집 이벤트

Airbridge가 웹 상점 사이트에서 자동 수집할 수 있는 이밴트는 아래와 같습니다.

이벤트 트리거 시점 구성 요소
로그인 로그인 후 로그인이 완료되어 페이지 진입한 시점 -
회원 가입 커뮤니티 아이디 생성 시점 기준 -
홈화면 조회 홈 화면 페이지 진입 시 -
상품 리스트 조회 상품 리스트 노출 시 •카테고리명 •페이지 번호
카테고리 선택 카테고리 버튼 선택 시 카테고리명
상품 상세 조회 상품 정보 클릭 후 상품 상세 정보 페이지 진입 시 •상품 마켓 •상품명 •통화 •상품 가격
구매하기 버튼 클릭 상품 상세 정보 내 구매하기 버튼 클릭 시 •상품 마켓 •상품명 •통화 •상품 가격
결제 시작 서버 정보 선택 팝업에서 구매하기 버튼 클릭 시 •상품 마켓 •상품명 •통화 •상품 가격 •상품 수량
구매 완료 웹 PG 결제 완료 후 빌링으로부터 결제 완료 정보를 전달받는 시점 •통화 •주문번호 •상품 마켓 •상품명 •상품 가격 •구매 수량

서드 파티 어트리뷰션 활성화하기

Hive API를 이용하여 서드 파티 어트리뷰션을 활성화하거나 비활성화할 수 있습니다. 서드 파티 어트리뷰션을 활성화·비활성화하려면 Analytics API의 setEnableTracker() 함수를 호출하세요. 함수의 첫 번째 파라미터로는 활성화·비활성화하고자 하는 어트리뷰션을 다음과 같이 안내된 문자열로 정의하세요:

  • Adjust: ADJUST
  • Singular: SINGULAR
  • AppsFlyer: APPSFLYER
  • Firebase: FIREBASE
  • Airbridge: AIRBRIDGE
Note

사용하고자 하는 서드 파티 어트리뷰션을 hive_config.xml에 정의하였다면 서드 파티 어트리뷰션은 기본으로 활성화 됩니다. 때문에 Hive 초기화 후 직접 서드 파티 어트리뷰션을 활성화할 필요는 없습니다.

다음은 특정 어트리뷰션을 비활성화하는 예제 코드입니다.

API Reference: hive.Analytics.setEnableTracker

using hive;    
    String trackerName = "ADJUST";    

Analytics.setEnableTracker(trackerName, false);

#include "HiveAnalytics.h"

FString TrackingTypeName = TEXT("ADJUST");
FHiveAnalytics::SetEnableTracker(TrackingTypeName, false);

API Reference: Analytics::setEnableTracker

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    string trackerName = "ADJUST";    

Analytics::setEnableTracker(trackerName, false);

API Reference: Analytics.setEnableTracker

import com.hive.Analytics    
    val trackerName = "ADJUST"    

Analytics.setEnableTrackerWithName(trackerName, false)

API Reference: AnalyticsInterface.setEnableTracker

import HIVEService    
    let trackerName = "ADJUST"    
AnalyticsInterface.setEnableTracker(name: trackerName, enable: false)

API Reference: setEnableTracker(name:enable:)

import HIVEService
let trackName = "ADJUST”
AnalyticsInterface.setEnableTracker(name: trackerName, enable: false)

API Reference: HIVEAnalytics:setEnableTracker

#import <HIVEService/HIVEService-Swift.h>    
    NSString *trackerName = @"ADJUST";    

[HIVEAnalytics setEnableTrackerWithName: trackerName enable: NO];

Windows에 마케팅 어트리뷰션 적용하기

Windows 환경에서 마케팅 어트리뷰션을 적용 순서는 아래와 같습니다.

  1. 릴리스 > 플러그인 > 마케팅 어트리뷰션 > Windows로 이동합니다.
  2. 사용할 마케팅 어트리뷰션 플러그인을 다운로드합니다.
  3. 다운로드 받은 파일의 압축을 해제합니다.
  4. 압축 해제된 파일 중 DLL 파일을 _{게임 앱 실행 파일 경로}/plugins/trackers_에 추가합니다.