콘텐츠로 이동

초대 캠페인 등록 및 관리

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

게임 초대 링크 프로세스

1. 게임 초대 기획

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

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

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

3. 게임 초대 구현

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

4. 테스트 진행

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

 

게임 초대 기획

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

항목 설명 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. 최대 초대 목표 수
(아래 캠페인 예시 참고)
캠페인의 제목, 설명, 이미지는 게임에서 직접 구현 가능한 선택사항

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

 


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

 

초대 타입

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

 

초대 링크 설정

초대 링크를 발급하기 위해 다음 항목을 설정해야 합니다.

앱아이디 정보

게임에 등록된 앱아이디 항목이 노출됩니다. '초대 링크'를 통해 각 앱아이디에 연결된 마켓 링크로 이동합니다. 리퍼러 URL과 디퍼드 딥링크는 필수 설정은 아니지만, 초대 링크의 추적성과 사용자 유입 경험을 개선할 수 있는 부가 기능으로 함께 설정하는 것을 권장합니다.

  • 리퍼러 전용 다운로드 URL : 리퍼러 전용 다운로드 URL(Market://details?id…)를 입력합니다. 리퍼러 URL은 구글에서 제공하는 기능으로 특정 트래킹 코드를 심어 유저가 어떤 경로를 통해 마켓으로 유입하였는지 추적이 가능합니다.
  • SHA256 or TeamID : 디퍼드 딥링크 사용을 위해 마켓이 google 인 경우 SHA256, apple 의 경우 TeamID 를 입력 받습니다. 앱이 설치되지 않은 상태에서 초대 링크를 클릭하면 마켓으로 이동하고, 설치 완료 후 디퍼드 딥링크를 통해 해당 초대 링크 정보가 전달되어 유입 경로를 확인할 수 있습니다.

Warning

초대 링크 캠페인을 등록할 게임 AppID 상태값은 반드시 '라이브' 상태여야 합니다.(설정메뉴 : 프로모션 설정 > AppID 관리 > AppID 목록 > AppID 정보에서 상태 설정)
'프로모션 설정 > 기본 설정 > 앱 아이디 설정'에 동일 마켓의 AppID가 2개일 경우, 초대 링크 클릭 시 유저가 유입하는 실 마켓 다운로드 URL을 판단해야되기 때문에 반드시 해당 상태값을 '라이브'로 변경해주세요.

 

초대 링크 설정

안내페이지

이용자가 초대 링크를 클릭하였을 때, 노출되는 안내페이지를 설정하는 기능입니다. 보상 설정 유무에 따라 적합한 안내페이지를 노출해야합니다. 안내페이지 타입은 안내페이지의 유형만 설정하며 실제 보상지급 여부를 설정하는 것은 아니니, 초대 링크 캠페인에서 보상 여부과 안내페이지의 타입을 동일하게 설정해야합니다.

보상있는 안내페이지에는 보상 수령을 위한 가이드 내용이 포함되어있기때문에, 보상 기능을 사용하지 않고 초대 URL 생성 기능만 사용할 경우에는 안내페이지 타입을 보상없음으로 설정하세요.

  • 보상없음으로 설정하고 UA 캠페인 설정에서 보상을 설정하면 보상은 정상 지급됨
  • 보상있음으로 설정하고 UA 캠페인 설정에서 보상을 설정하지 않으면 보상은 지급되지 않음

보상없는 안내페이지 보상있는 안내페이지

 

디퍼드 딥링크 사용 설정

초대 링크는 디퍼드 딥링크 기능을 이용하여 앱이 설치되지 않은 상태에서 초대 링크를 클릭하면 마켓으로 이동하고, 설치 완료 후 디퍼드 딥링크를 통해 해당 초대 링크 정보가 전달되어 유입 경로를 확인할 수 있습니다. 디퍼드 딥링크 기능을 사용하려면 앱아이디 설정 탭에서 SHA256 및 iOS Team ID 값을 먼저 입력해야 합니다. 사용 설정 시, iOS 환경에서는 클립보드 접근 권한 요청이 발생할 수 있습니다.

마켓 이동

여러 마켓에서 서비스하고 있는 게임인 경우, 초대 링크 페이지에서 마켓을 선택하여 설치할 수 있습니다.

  • 안드로이드 마켓 설정 : 노출할 마켓을 선택해주세요.
  • 마켓 이미지 : 노출할 마켓의 이미지를 입력해주세요. 마켓 이미지 사이즈는 108*108입니다. ※플레이스토어, 아마존 앱스토어, 갤럭시 스토어, 화웨이 앱스토어, 원스토어는 기본 이미지가 설정되어 있습니다.
선택한 마켓이 1개일 때 선택한 마켓이 2개 이상일 때
Warning

  • 클릭 시, 앱아이디별 입력된 마켓URL로 이동합니다. 입력된 값이 없으면, 안내 페이지에 마켓 버튼이 노출되지 않습니다.
  • 마켓이 구글인 경우, '리퍼러 전용 다운로드 URL→(없으면)일반 URL'순으로 입력값을 확인합니다.
  •  

    초대 이미지&문구 등록

    친구에게 초대 메시지를 보냈을 때, 표시되는 이미지와 문구를 등록합니다. 등록한 이미지와 문구는 안내 페이지에도 적용됩니다.

    초대문구 등록

    안내 페이지에 노출되는 문구이며, 친구에게 초대 링크를 보낼 경우 메시지 상단에 노출됩니다. 최대 100자까지 등록 가능하며, SNS 메신저의 특성에 따라 초대문구가 노출되지 않을 수 있습니다. 등록하지 않은 언어의 초대 문구는 언어별 기본 문구로 노출되며, 업데이트 시 바로 반영됩니다.
    기본 문구 : %s%에 초대합니다. 함께 플레이 하면 즐거움이 두 배!

    초대 이미지 등록

    안내 페이지, 초대 메시지에 노출되는 이미지 입니다. 초대 이미지 사이즈는 '1024 x 1024 px'로 등록하는 것을 권장합니다. 상시로 업데이트 가능하며, 업데이트 시 바로 반영됩니다. 등록하지 않을 경우 게임 아이콘 이미지로 노출되며 '게임 아이콘 이용' 체크박스를 선택 후 저장하면 초대 이미지를 등록하더라도 무조건 게임 아이콘이 노출됩니다.

    게임 소개 등록

    친구에게 초대 링크를 보낼 경우 초대 메시지 하단에 노출되는 게임 소개 문구입니다. 최대 100자까지 등록 가능하며, SNS 메신저의 특성에 따라 게임 소개 문구가 노출되지 않을 수 있습니다. 등록하지 않은 언어의 게임 소개 문구는 영어로 노출됩니다.

    [초대 메시지를 발송한 카카오톡 예시 화면]

     

    초대 링크 발급하기

    특정 목표를 달성했을 때 보상을 지급하려면 '프로모션 설정>CPA 설정'에 해당 목표 행동이 등록되어 있어야 합니다.

    초대 캠페인 등록하기

    1. 캠페인 리스트

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

    2. 등록 및 수정

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

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

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

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

     

    안내 페이지

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

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

     

    CPA 설정

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

     

    초대 링크 이용 시 주의사항

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

     

    초대 수동 매칭

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

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

    Warning

    직접 매칭에서 실패하는 경우
    -초대 유저가 초대 링크를 생성한 적이 없으면 매칭할 수 없습니다.
    -수락유저가 게임 다운로드 내역이 없으면 매칭할 수 없습니다.
    -이미 매칭된 초대유저와 수락유저는 다시 매칭할 수 없습니다.

     

    초대 로그 조회

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

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

    유저 초대 통계

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

    일일 상세 지표

    초대 링크 참여 유저에 대한 통계를 확인할 수 있습니다.

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

     

    단계별 누적지표

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

     

    유입경로 지표

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

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

    Note

    주요 메신저 지표와 기타 메신저 유입 지표 누적기준이 다릅니다. 주요 메신저 지표는 초대 받은 사람이 UA 초대 URL을 클릭한 출처 SNS 지표이며, 기타 메신저 지표는 Hive SDK 자체 팝업에서 초대자가 초대URL을 공유하기 위해 선택한 SNS 입니다.