초대 캠페인 등록 및 관리

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

게임 초대 프로세스¶

1. 게임 초대 기획¶

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

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

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

3. 게임 초대 구현¶

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

4. 테스트 진행¶

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

게임 초대 기획¶

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

담당 : 게임팀 담당자 혹은 사업 담당자

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

초대 타입¶

• 게임 친구 초대 : 초대 링크를 통해 친구를 게임에 초대하고 보상을 받을 수 있습니다. 초대자별로 초대 링크가 발급됩니다.
• 보상 지급용 링크 : 링크를 클릭하여 설치한 유저에게 보상을 지급할 수 있습니다. 별도의 초대자는 존재하지 않으며 하나의 URL이 발급됩니다.
• 초대 코드 발급 : 게임 실행 후 초대 코드를 입력하여 친구 매칭을 진행하고, 보상을 받을 수 있습니다. 별도의 링크가 필요하지 않으며 초대자별 초대 코드가 발급됩니다.

초대 링크 발급하기¶

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

기본 설정하기¶

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

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

초대 캠페인 등록하기¶

1. 캠페인 리스트¶

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

2. 등록 및 수정¶

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

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

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

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

안내 페이지¶

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

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

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

CPA 설정¶

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

디퍼드 딥링크 설정하기¶

디퍼드 딥링크는 기존에 앱이 설치된 유저는 게임을 실행하고 앱이 설치되지 않은 유저는 각각의 스토어로 이동시킵니다. 디퍼드 딥링크 사용을 위해 마켓이 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. 보상 지급용 URL 프로모션은 초대 유저 보상은 설정할 필요가 없고 수락 유저 보상만 설정하면 됩니다.

초대 코드 발급하기¶

'초대 코드 발급' 캠페인을 등록하면 유저별로 고유한 초대 코드를 발급할 수 있습니다.
발급받은 초대 코드를 공유해 새로운 유저를 게임에 초대하고, 초대받은 유저가 코드를 입력하면 보상을 받습니다.
어떤 행동을 수행했는지에 따라 보상을 설정할 수 있으며, 초대한 유저와 초대받은 유저 모두 보상을 받도록 설정할 수 있습니다.

초대 캠페인 등록하기¶

1. 캠페인 리스트¶

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

2. 등록 및 수정¶

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

• 타입 선택 : '초대 코드 발급'을 선택합니다. 초대자별로 초대 코드를 발급하는 캠페인입니다.
• 활성화 : 게임 당 하나의 캠페인만 활성화 가능합니다. 비활성화 상태인 캠페인으로 발급한 코드는 매칭 및 보상이 지급되지 않습니다.

• 보상 추가하기
  • 보상 설명 : 보상을 설명하는 단어나 문장을 입력해주세요. 콘솔에서 관리 목적으로 입력하는 값입니다.
  • 보상 구분 :  
    • 행동 보상 : 초대 받은 친구가 지정된 행동을 할 때 보상을 지급하는 방식입니다. 초대자와 수락자 모두에게 보상을 지급할 수 있습니다.
    • 목표수 달성 보상 : 보상 행동을 한 친구가 지정된 수만큼 모이면 보상을 지급합니다. 초대자에게만 보상을 지급하는 캠페인으로 지속적인 친구 유지 및 게임 참여를 독려합니다.
  • 보상 행동 : 어떤 행동을 수행해야 보상을 지급할지 설정합니다.
    • 매칭 : 초대 코드를 입력하여 친구 매칭이 성공했을 때 보상을 지급합니다. 계정을 변경하여 매칭하면 계속 지급이 가능한 보상이므로 보상을 적게 설정하거나, 수락자 보상만 설정하는 것을 권장합니다.
    • 설치 : 코드 매칭일을 기준으로 7일 이내에 수락자가 앱을 설치했을때 보상을 지급합니다. SDK 4.25.0.0 이상 버전을 적용한 게임에서 설치 보상 지급이 가능합니다.
    • CPA 달성 : 수락자가 특정 행동(CPA)을 달성했을때 보상을 지급합니다. '콘솔>프로모션>프로모션 설정>CPA 설정'에서 등록된 CPA가 선택 항목으로 노출됩니다.
  • 보상 대상 : 보상을 지급할 대상과 보상 아이템을 선택합니다. 보상으로 지급할 수량을 숫자로 기입합니다. ( ex. 아이템은 1 기입시 1개가 지급됩니다.)
  • 보상 횟수 제한 : 초대자가 보상을 지급받는 횟수를 제한할 수 있습니다. 초대받는 친구가 늘어나더라도 초대자에게는 설정된 횟수까지만 보상이 지급됩니다.
  • 아이템 보상 지급 메시지 : 우편함으로 보상 아이템을 지급받을때 노출되는 문구를 설정합니다. 메시지를 등록하려면 '콘솔>빌링>아이템>아이템 지급 메시지'에서 등록해주세요.
  • 목표수 : 목표수 달성 보상을 선택했을때 설정하는 값입니다. 목표수만큼 수락자를 확보했을때 보상을 지급합니다.

• 삭제 : 등록한 보상을 삭제합니다.
• 초기화 : 보상이 가능한 최대 친구 수를 초과할 경우, 추가 보상이 지급되지 않습니다. 이런 경우에는 초기화 기능을 사용하여 보상 횟수를 초기화 할 수 있습니다.

CPA 설정¶

'콘솔>프로모션>프로모션 설정>CPA 설정' 탭으로 이동하여 CPA코드를 발급합니다. 발급한 CPA 코드는 게임팀에 전달하여 개발하도록 합니다.
 

초대 코드 발급, 초대 코드 입력¶

콘솔에서 초대 코드 캠페인 등록을 완료하셨다면, 이제 유저에게 코드를 발급하고 코드를 입력할 수 있는 페이지 개발이 필요합니다. API 가이드>Hive Server API>프로모션>초대 코드 기반 매칭를 참고하여 초대 코드 발급 페이지, 초대 코드 입력 페이지 개발을 진행해 주세요.
[예시 화면: 초대 코드 발급 페이지]

[예시 화면: 초대 코드 입력 페이지]  

초대 코드 이용 시 주의사항¶

1. 어뷰징 방지를 위해 보상 지급할 계정에 대해 '계정 검증'을 진행해 주세요.
2. '매칭 보상'은 보상을 최소로 설정하거나, 수락자에게만 보상을 지급하세요.
   • 매칭 보상은 초대 코드만 입력하여 매칭이 진행됐을때 보상이 지급됩니다.
     동일 디바이스로 계정을 변경해가며 매칭 시도를 하는 등 어뷰징 우려가 있으므로 가급적 적은 보상을 지급하는 것을 권장합니다.
     수락자는 계정당 최초 한번만 매칭 보상을 받을수 있기때문에 상대적으로 어뷰징 우려가 적으므로, 수락자만 보상을 지급하도록 설정하는 것도 방법입니다.
3. 설치 보상은 모바일 SDK 4.25.0.0 이상에서만 가능합니다.
   • 기기 기반 약관 노출 게임은 모바일 SDK 4.25.0.0 이상에서 계정별 설치 로그 수집하고, 설치 보상이 가능합니다.
     SDK 4.25.0.0 미만에서 설치 보상을 설정할 경우 보상에 실패합니다.
   • 계정 기반 약관 노출 게임인 경우, 버전에 관계없이 설치 보상이 가능합니다.
   • PC는 현재 설치 보상을 지원하지 않습니다. 추후 지원할 예정입니다.
4. 운영중인 캠페인의 보상 정보를 변경하면, 이미 지급한 보상수와 달성된 목표수는 유지됩니다.
   • 보상수와 목표수를 모두 초기화하고 싶다면 '초기화' 버튼을 클릭해 주세요.
5. 보상 횟수 제한은 초대자에게만 적용되는 기능입니다.
   • 친구가 계속 늘어나면서 초대자에게 제한없이 보상이 지급될 수 있으므로, 지급 가능한 횟수를 설정하는 기능입니다.
   • 수락자의 경우 해당 설정값과 관계없이, 최초 1회에 한해서는 보상 지급이 가능합니다.

초대 수동 매칭¶

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

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

3. '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 참여 유저에 대한 통계를 확인할 수 있습니다. 프로모션 > UA 통계를 클릭합니다.

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

단계별 누적지표¶

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

유입경로 지표¶

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

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

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