게임 초대는 게임 유저 유입을 향상시키는데 효과적인 기능입니다. 이를 사용하기 위해서는 먼저 다음 프로세스를 확인해주세요.

게임 초대 프로세스

1. 게임 초대 기획

  • 초대 UI기획
  • 초대 달성 캠페인 및 보상 기획
  • 초대 공유 수단 기획
  • 게임 소개 페이지 기획

2. 초대 캠페인 백오피스 등록

  • 앱 등록
  • CPA 등록(CPA 사용시)
  • 캠페인과 보상 설정을 위한 프로모션 등록

3. 게임 초대 구현

  • 초대 기획을 구현
  • Hive UA API 적용

4. 테스트 진행

  • 초대 URL , QR 코드 정보 정상 여부 확인
  • 초대 완료 횟수 등 결과 정상 여부 확인
  • CPA 로그 전송 정상 여부 확인
  • 초대 캠페인 달성 후 보상 지급 정상 여부 확인 등

 

게임 초대 기획

게임 초대를 기획하는 단계로 캠페인 구성 내용과 보상, 초대 UI  등 아래 사항을 고려해야합니다.

항목 설명 Hive UA 제공 기능 비고
캠페인  초대 달성 목표를 설정하고, 초대 목표를 달성 시 지급할 보상과 최대 보상 횟수 등의 기획이 필요합니다. • CPI : 게임을 설치하고 실행 시 보상

• CPA : 특정 액션을 달성 시 보상

• 건별 보상 캠페인 : 친구가 CPI나 CPA를 달성 할 때마다 보상 지급

• 목표 달성 캠페인 : CPI나 CPA를 달성한 친구수가 목표치에 도달하면 보상 지급

 • CPI는 게임을 설치하고 실행 및 vid를 발급받는 시점에 완료되고 보상이 지급 됨

• 최대 보상을 받을 수 있는 횟수 제한 기획(필수)

• CPI의 경우 보상 받을 수 있는 최대 수량이나 액수가 누구나 획득해도 문제 없는 수준으로 설정 필요
공유 수단  게임에서 사용할 공유 수단 기획이 필요합니다. 공유 수단은 대표적으로 Hive, 카카오톡, LINE, Facebook 등이 있으며 초대 URL이나 QR Code를 친구에게 전송하기 위해 필요합니다.
SDK 4.11.2 이상에서는 게임별 추가 구현 없이, 소셜미디어 공유 기능을 지원합니다. (Kakao Talk, LINE, Facebook, Facebook Messenger, WhatsApp, WeChat)또한 실제 공유 시 발송되는 문구를 정해야 합니다.		 • 개인별 초대 URL 발급

• 개인별 초대 QR Code 발급

 • QR Code를 공유 수단을 통해 친구에게 발송하는 기능 및 QR Code 이미지를 단말 사진첩에 저장하는 기능 구현(권장)

•  OS에서 제공하는 기본 공유 수단 api를 이용하여 친구에게 초대를 발송하는 기능 구현(권장)

• SNS 등 외부 공유 수단 이용해 초대 URL을 친구에게 발송하는 기능 구현(선택 – 게임팀에서 구현 필요)
게임 초대 UI  게임 초대 화면에 대한 기획이 필요합니다.

캠페인과 초대를 발송하는 것들의 구성이 필요하고, 한 화면에 구성하기도, 서로 다른 화면에 캠페인과 초대 발송을 나누어 구성하기도 합니다.

담당 : 게임팀 담당자 혹은 사업 담당자
1. 캠페인의 제목, 2. 설명, 3. 이미지,4. 현재 완료한 초대 수, 5. 최대 초대 목표 수(아래 캠페인 예시 참고)캠페인의 제목, 설명, 이미지는 게임에서 직접 구현 가능한 선택사항

[캠페인 예시 이미지 – 체인스트라이크]

 

안내 페이지

UA 에서는 IP주소를 수집하여 유저를 트래킹하는데, 유저가 초대 링크를 클릭하고 마켓을 이동하기 전이나 앱을 설치 중에 네트워크 환경을 IP에서 LTE로 혹은 LTE에서 IP로 바꿀 경우 더이상 트래킹이 불가능하여 보상을 지급할 수 없습니다. 따라서, 초대 링크를 클릭하였을 때 이를 유저에게 안내해주는 페이지를 노출해야합니다.

안내페이지는 Android, iOS 유저에게 노출되며, 콘솔>프로모션>앱설정>UA설정 탭에서 해당 기능을 설정할 수 있습니다. 자세한 설정 방법은 앱 설정하기 항목을 확인해주세요.

[노출되는 안내페이지 이미지 예시]

 

초대 캠페인 등록 하기

UA 캠페인을 등록하기 위해서는 먼저 사전 단계로 앱 설정 메뉴의 UA설정과 CPA 설정에 해당 내용이 등록되어있어야합니다.

앱 설정하기

UA캠페인 등록을 위한 사전작업에 대해서 순차적으로 간략하게 설명합니다. 자세한 설명은 앱 설정하기 페이지를 참고하세요.

신규 게임의 경우 앱 설정에서 앱을 먼저 등록해야합니다.   게임은 마켓 구분없이 한 번만 등록하면 되며, 등록한 게임의 정보를 수정해야 하는 경우 게임 관리명을 클릭하면 수정 페이지가 노출됩니다. 기본 설정에서 게임명, 게임방향은 필수 항목이며 나머지는 추후에 입력하여도 무방합니다. UA를 사용하기위해서는 앱아이디 설정에서 앱아이디를 선택하고 다운로드 URL을 입력해야합니다.

CPA 설정

기본 설정을 저장하고 CPA 설정 탭으로 이동하여 CPA코드를 발급합니다. 발급한 CPA 코드는 게임팀에 전달하여 개발하도록 합니다.

  1. 앱 설정에서 사전 작업이 완료되었다면 프로모션의 UA 캠페인 설정 메뉴로 이동합니다.

 

초대 캠페인 등록하기

1. 캠페인 리스트

게임을 선택한 후, 신규 프로모션을 등록하려면 캠페인 등록 버튼을, 기존 프로모션을 수정하려면 프로모션 관리명을 클릭합니다.

2. 등록 및 수정

상세 내용을 입력 후 저장을 클릭합니다.

  • 타입 선택
    • 게임 친구 초대 : 게임 내 친구 초대로 사용할 프로모션입니다.
    • 보상 지급용 URL : 발급되는 URL을 클릭하고 게임을 설치한 유저에게 보상을 지급하는 프로모션입니다. (사전 예약 등에 사용)
  • 노출 문구 기본 언어 : 캠페인의 노출 문구 설정 시 디폴트로 노출하기 위한 언어를 선택합니다. 노출 문구를 사용하지 않는 게임은 미사용을 선택합니다.
  • 건별 달성 캠페인
    • 친구가 캠페인을 달성할 때마다 보상을 지급하는 캠페인입니다. 캠페인 추가 하기 버튼으로 여러 개의 캠페인을 구성할 수 있으며 서비스에 사용되고 있는 캠페인을 삭제 시 동작하지 않게 되므로 주의가 필요합니다.
    • 캠페인 선택 :  CPI 혹은 등록한 CPA를 선택해 캠페인을 구성합니다. CPI는 최초 게임 설치 후 실행을 체크하는 용도로 보상이 없더라도 반드시 설정되어야 합니다.
    • 초대 유저 보상을 다중 선택할 수 있으며, 지급할 보상을 선택하고 인풋박스에 보상량을 숫자로 기입합니다. ( ex. 아이템은 1 기입시 1개가 지급됩니다.)
    • 보상 횟수 제한에 숫자를 입력하여 초대 유저가 받을 수 있는 최대 보상 횟수를 제한할 수 있습니다.
    • 노출 문구는 게임에 직접 구현한다면 필수 사항이 아닙니다. 초대 문구 설정 중 제목, 설명, 이미지 중 사용을 원하는 것만 사용 가능하며 기본 언어로 설정한 언어는 위 세가지 중 하나 이상 등록되어야 합니다.
    • 초기화 : 보상이 가능한 최대 친구 수를 초과할 경우, 추가 보상이 지급되지 않습니다. 이런 경우에는 초기화 기능을 사용하여 보상 횟수를 초기화 할 수 있습니다. 초기화 기능은 유저 단위가 아닌 캠페인 단위로 일괄 적용되며 CPI, 건별 CPA, 목표달성 CPA 모두 사용할 수 있습니다.
      예를들어 보상 횟수 제한이 30회인 CPI 캠페인에 대해 초기화를 진행한다고 가정하겠습니다. 초기화가 진행되면 보상 횟수를 30회 달성한 유저와 10회를 달성한 유저 모두 달성 인원은 0명으로 초기화가 됩니다. 따라서 두 유저 모두 다시 친구초대를 수행하여 보상을 수령할 수 있습니다.
      초기화를 진행하더라도, 기존의 초대 정보는 로그 조회 메뉴를 통해 조회 가능합니다.

  • 목표 달성 캠페인
    • 캠페인을 달성한 친구 수가 목표에 도달할 때 보상을 지급하는 캠페인 입니다. 캠페인 추가하기 버튼을 클릭하여 여러 개의 캠페인을 구성 할 수 있습니다.

    • 캠페인 선택 :  목표 달성 캠페인은 여러 개의 캠페인 선택 가능합니다. +-버튼으로 캠페인을 추가하거나 제거합니다.
    • 목표수 : 해당 캠페인을 완수하기 위한 초대 수락 유저수 기입합니다.
    • 보상 횟수 제한 : 초대 유저가 받을 수 있는 최대 보상 횟수 기입합니다.

디퍼드 딥링크 설정하기

디퍼드 딥링크는 기존에 앱이 설치된 유저는 게임을 실행하고 앱이 설치되지 않은 유저는 각각의 스토어로 이동시킵니다.
디퍼드 딥링크 사용을 위해 마켓이 google 인 경우 SHA256, apple 의 경우 TeamID 를 입력 받습니다. 해당 기능은 Hive SDK 4.15.8 이상의 버전에서 제공됩니다.

1.프로모션 > 앱 설정을 클릭합니다. 목록에서 게임을 선택합니다.

2.UA 설정 탭으로 이동합니다. 디퍼드 딥링크 사용 설정에서 ‘사용’을 선택해 주세요.

3.기본설정 탭에서 디퍼드 딥링크를 사용할 appid 의 SHA256(Android)과 TeamID(iOS) 를 입력합니다.
iOS의 TeamID는 다음과 같이 Apple Developer 콘솔에서 확인 가능합니다.

마켓이 google 인 경우 SHA256 을 입력합니다. SHA256 의 경우 SHA certificate fingerprints 값을 입력하시면 됩니다.
마켓이 apple 인 경우 TeamID 를 입력합니다. TeamID 의 경우 App ID Prefix 값을 입력하시면 됩니다.

초대 캠페인 주의사항 및 안내

  1. 게임 친구 초대 타입의 프로모션은 게임 당 하나의 프로모션만 활성화 가능합니다. 비활성화 상태인 프로모션은 동작하지 않으니 주의바랍니다.
  2. 보상 지급용 URL 프로모션은 사전 예약 보상 등에 사용할 수 있는 프로모션으로, 해당 게임 설치 URL을 통해 유저가 설치하고 실행하면 보상을 지급할 수 있습니다.
  3. 보상 지급용 URL 프로모션을 선택하고 저장하면 초대 URL과 QR 코드가 발급됩니다.
  4. 게임 친구 초대 시 수락 유저(초대 받은 유저)에 보상 지급은 iOS 반려사항입니다.
  5. 보상 지급용 URL 프로모션은 초대 유저 보상은 설정할 필요가 없고 수락 유저 보상만 설정하면 됩니다.

초대 수동 매칭

매칭에 실패했을 때 초대유저,수락유저의 정보를 입력하여 직접 매칭할 수 있습니다.
프로모션 > 초대 수동 매칭을 클릭합니다.

  1. 초대유저와 수락유저의 정보를 입력합니다. VID, PlayerID와 DID가 필요합니다.

  2. 검색하면 수락유저의 디바이스 식별값(advertising ID/IP+OS버전)으로 확인한 로그내역이 노출됩니다. UA 매칭과 관련된 로그내역으로 특이사항을 확인할 수 있습니다.
    예시:동일 IP+OS버전으로 설치된 다운로드 내역 확인 → 설치 중복으로매칭 실패

  3. ‘UA 매칭’ 버튼을 클릭하면, 입력한 초대유저와 수락유저를 직접 매칭할 수 있습니다.

초대 캠페인 통계

UA 참여자에 대한 로그와 통계를 확인할 수 있습니다.

초대 로그 조회

UA에 참여한 유저에 대해 상세 조회를 할 수 있습니다.
프로모션 > 초대 로그 조회를 클릭합니다.


1. 초대자 혹은 초대 받은사람의 정보를 입력합니다. Hive ID, VID, PlayerID와 DID가 필요합니다.
2. DID 기준의 설치 기록입니다. 조회필드에 DID를 입력하지 않으면 조회되지 않습니다.
3. DID 기준의 보상 기록입니다. 조회필드에 DID를 입력하지 않으면 조회되지 않습니다.
4. Hive ID, VID, PlayerID 기준의 매칭 기록입니다. 초대자와 초대 받은사람이 정상적으로 매칭되었을 때, 양쪽의 정보를 모두 확인할 수 있습니다.
5. Hive ID, VID, PlayerID 기준의 보상 기록입니다. 보상이 정상적으로 지급 되었을 때, 초대자의 로그를 확인할 수 있습니다.

유저 초대 통계

일일 상세 지표

UA 참여 유저에 대한 통계를 확인할 수 있습니다.
프로모션 > UA 통계를 클릭합니다.


1. 게임명, 국가, 일자를 입력합니다.
2. 캠페인 상세 지표를 일별로 확인할 수 있습니다.

  • 클릭 : UA 초대링크를 클릭 한 사람의 수입니다
  • 매칭 : 초대 받은사람이 게임을 설치 후 실행하여 VID가 생성되면 매칭이 완료됩니다. 국가로 필터링 할 경우 초대 받은사람을 기준으로 합니다.
  • 보상 : CPI 혹은 CPA가 완료되어 보상을 받은 초대자 수입니다.
  • CPI : 초대받은 유저가 게임을 설치 후 실행은 했지만, VID 생성 전에 종료하여 단말기 매칭만 이뤄진 상태입니다.
  1. 조회 정보를 엑셀로 다운로드 할 수 있습니다. 다운로드 시 전체 국가에 대한 결과를 확인할 수 있습니다.

단계별 누적지표

  1. 캠페인 생성 후 전체 기간에 대한 누적 지표입니다. 직전일의 누적데이터까지 조회됩니다.

 

유입경로 지표

초대받은 사람이 UA 초대 링크를 클릭한 경로를 일자별로 확인할 수 있습니다.

  1. 카카오, 라인, 페이스북(페이스북 메신저 포함), 위챗 경로 구분이 가능하며 그 외 경로로 접근하는 경우 기타 항목으로 누적데이터를 확인할 수 있습니다.
  2. 기타 메신저 유입 지표는 개별모듈, SDK v1 1.18.2 , SDK v4 4.14.3 적용 게임 중, Hive가 제공하는 UA 공유 자체 팝업 사용 시 유입되는 지표입니다.

  3. 기타의 etc 지표는 기타 메신저 지표로 확인 불가한 누적 유입 지표입니다.