Invite Campaign Registration and Management

UA (Game Invite Link) is an effective feature to attract more game users. Please check out the following process to use the feature.

Invite Link process¶

1. Develop UA¶

• Develop UI for UA
• Develop Invite Achievement Campaign and Reward
• Develop Methods to Share the UA
• Develop Game Intro Page

2. Register UA backoffice¶

• Register an App
• Register CPA (When using CPA)
• Register a Promotion for the Campaign and Reward Settings

3. Implement UA¶

• Implement the UA development
• Apply UA API

4. Run tests¶

• Check whether URL and QR code info for invite is normal.
• Check whether the results such as the number of invite completion times is normal.
• Check whether CPA logs are transferred properly.
• Check whether rewards have been given out properly for completing the UA campaign, etc.

Develop UA¶

In this stage, you’ll be able to develop content of a campagin, rewards, UA UI, etc.

Person in Charge: Develop team or a person in charge of business

[Campaign Image Example – Chain Strike]

Invitation type¶

• Invite Game Friend: You can invite friends to the game via an invitation link and receive rewards. An invitation link is issued per inviter.
• Reward Link: Rewards can be issued to users who install via the link. There is no separate inviter and a single URL is issued.

Invite Link Settings¶

To issue an invite link, you need to configure the following items.

App ID Information¶

This is the App ID information for invite links.\ Registered App IDs for the game will be displayed. Through the "Invite Link," users are redirected to the market link connected to each App ID.

Referrer URLs and deferred deep links are not required but are recommended as additional features to improve tracking and user acquisition experience.

• Referrer-only download URL : Enter the referrer-only download URL (Market://details?id...). The referrer URL is a feature provided by Google that allows tracking of the user acquisition path by embedding a specific tracking code.
• SHA256 or TeamID : Required for using deferred deep links. Enter SHA256 for Google and TeamID for Apple. If a user clicks the invite link without the app installed, they will be redirected to the market. After installation, the deferred deep link delivers the invite link information, enabling tracking of the acquisition path.

Invite Link Settings¶

Guide Page¶

This feature configures the guide page displayed when a user clicks the invite link. You must display an appropriate guide page depending on whether rewards are configured.\ The guide page type only determines the UI type and does not control reward distribution. Therefore, ensure that the reward setting in the invite link campaign matches the guide page type.

If you are only using the invite URL generation feature without rewards, set the guide page type to No Reward.

Guide Page without Reward	Guide Page with Reward

Deferred Deep Link Settings¶

Invite links use the deferred deep link feature. If the app is not installed, users are redirected to the market. After installation, the deferred deep link delivers the invite link information, allowing tracking of the acquisition path.

To use this feature, you must first enter SHA256 and iOS Team ID values in the App ID Settings tab.

When enabled, iOS devices may request clipboard access permission.

Go to Market¶

If your game is available in multiple markets, users can select a market on the invite link page before installation.

• Android Market Settings : Select the Android market to open from the help page.
• Market Image : Upload the image for the selected market. Recommended size: 108 × 108. ※ Default images are provided for Google Play, Amazon Appstore, Galaxy Store, Huawei AppGallery, and ONE Store.

When 1 market is selected	When 2 or more markets are selected

Invite Image & Message¶

Register the image and message displayed when sending an invite to a friend. The registered content is also applied to the guide page.

Invite Message¶

Enter the invite message (up to 100 characters).

This message is displayed on the guide page and also appears at the top of the message when sending an invite link to a friend.
Depending on the SNS messenger, the message may not be displayed.

If a language is not registered, the default message for that language will be used. Changes are applied immediately upon update.

Default message: %s invites you. Playing together doubles the fun!

Invite Image¶

This image is displayed on both the guide page and in the invite message sent to friends.
Recommended size: 1024 × 1024 pixels

If no image is registered, the game icon will be used instead.
If the "Use Game Icon" checkbox is selected, the game icon will always be displayed regardless of uploaded images.

Game Description¶

This text appears along with the image when sharing the link on social media or messenger.

Enter the game introduction (up to 100 characters). If not provided for a specific language, English will be used by default.

[Example of KakaoTalk invite message]

Issue invitation link¶

To grant rewards when a specific goal is achieved, the corresponding goal action must be registered in Promotion Settings > CPA Settings.

Register Invite Campaign¶

1. Campaign list¶

Select a game and click “Registration” Button to register a new promotion or click a Promotion Management Name to modify the existing promotion.

2. Registration and modification¶

Enter the details and click “Save”.

• Selecting a Type
  • Invite Game Friend: It’s a promotion used for inviting friends to the game.
  • Link to send rewards: It’s a promotion that gives out rewards to users who clicked on issued URL and installed the game. (Used for pre-registration, etc.)
• Exposed text Basic Language
  • Select a language you’d like to expose by default when you set the exposed text for the campaign. Select “Don't Use” for the games that don’t have any text to expose.
• Individual Achievement Campaign
  • • It’s a campaign that gives out rewards each time a friend achieves a campaign. You can arrange multiple campaigns with the “Add Campaign” Button and please note that the campaign won’t work if you delete the campaign that’s used for the service.
    • Select a Campaign: Compose campaigns by selecting CPI or registered CPA. CPIs must be selected even if there’s no reward since it is a method to check the gameplay after installing the game for the first time.
    • You can select multiple user invite rewards. Select a reward to give and enter the amount in number in the input box. (Ex. 1 Item will be given when you enter 1.)
    • You can restrict the MAX number of rewards an invite user can receive by entering a number in the reward limit. Once the maximum number of rewards is reached, no more rewards can be received by either the invited user or the inviter.
    • Exposed texts aren’t required if you were to implement them in the game directly. You can choose to enter info only for the categories you want, including title, details, and image. However, you must enter one of the 3 for the language you set as a basic language.
    • Reset: If you exceed the maximum number of friends you can be compensated for, no additional compensation will be given. In this case, you can use the reset function to reset the compensation count. The reset function will be applied on a campaign basis and not user basis.
      For example, let's say you want to reset a campaign with 30 compensation count limit. Once the count resets, the number of target friends will become 0 for both a user who achieved 30 compensation count limit and a user who achieved 10 compensation count. Therefore, both users can re-invite friends to receive compensation. Even if you reset the compensation count, existing invitation information can be viewed through the log search menu.

• [Backoffice - Exposed Text Settings]

• [Exposed Text Example]

• Goal Achievement Campaign
  • It’s a campaign that gives rewards when you reach the goal for the number of friends that achieved the campaign. You can compose multiple campaigns by clicking the “Add Campaign” Button.

• • Select a Campaign: You can select multiple campaigns for Goal Achievement Campaign. Use “+/-“ Button to add or delete campaigns.
  • Goal Number: Enter the number of users to accept the invite for campaign achievement.
  • Reward Amount Limit: Enter the MAX number of rewards that the invite user can receive

Information page¶

UA collects IP addresses to track users. However, users won’t be able to collect rewards if they change the network settings from IP to LTE or from LTE to IP while downloading the app or before being moved to the market after clicking the invitation link. Thus, an Information Page that informs users when they click the invitation link needs to be exposed.

The information page will be shown to Android & iOS users and you can set this function at Console>Promotion> App Settings> UA Settings Tab. Please check the Promotion Settings category for more info.

[Example of an Information Page]

CPA settings¶

Save the default settings and move to the CPA settings tab to issue a CPA code. The issued CPA code will be provided to the game team for development.

Precautions for using the invitation link¶

1. You can only activate 1 promotion for each game regarding promotions that invite game friends. Please note that promotions that are inactive will not work.
2. URL Promotions that distribute rewards can be used for pre-registration, etc., and rewards will be given when the user installs and runs the game via the game download URL.
3. Invite URL and a QR Code will be issued when you select URL Promotions that distribute rewards and save.
4. For URL Promotions that distribute rewards, you don’t have to set the rewards for users who invite, and you only have to set up the rewards for users who accept the invite. Promotion for Compensation Payment does not need to set invitation user compensation but only accept user compensation.

초대 링크 설정¶

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

앱아이디 정보¶

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

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

기본 설정¶

안내페이지¶

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

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

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

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

디퍼드 딥링크 사용 설정¶

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

마켓 이동¶

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

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

선택한 마켓이 1개일 때	선택한 마켓이 2개 이상일 때

초대 이미지&문구 등록¶

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

초대문구 등록¶

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

초대 이미지 등록¶

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

게임 소개 등록¶

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

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

UA matching registration¶

When UA matching fails, you can directly match by entering the information of the invited user and accepted user. Click on the Promotion-> UA Matching Registration. The invitation code does not support manual matching.

1.Enter the info of the Invited User and Accepted User. VID, PlayerID and DID are required. Enter the invitation type. 2. If you search, the log details confirmed by the device identification value (advertising ID/IMEI/IP+OS version) of the accepted user are exposed. You can check the specifics with log details related to UA matching. Ex. Check the download history installed with the same IP+OS version → Matching failed due to duplicate installation 3. If you click the UA Matching Button, you can directly match the entered invited user with the accepted user.

Search UA log¶

You can search details about the UA participants. Click on the Promotion-> UA Log.

1. Enter the info of the inviter or invitee. Hive ID, VID, PlayerID and DID are required.
2. Installation history based on the DID. Results won't be searched unless you enter the DID in the search field.
3. Reward history based on the DID. Results won't be searched unless you enter the DID in the search field.
4. Match history based on the Hive ID, VID and PlayerID. You can check the info of both sides when the inviter and the invitee are properly matched.
5. Reward history based on the Hive ID, VID and PlayerID. You can check the inviter's log when the reward is given properly.  

UA campaign statistics¶

You can check the log and statistics about the UA participants.

Daily index details¶

You can check the statistics about the UA Statistics. Click on the Promotion-> UA Matching Registration.

1. Enter the game title, country and date.

2. You can check the detailed index of the campaign by date.

   • Click: The no. of people that clicked the UA invitation link.
   • Matching: The matching will be completed once the VID is created after the invitee installs and runs the game. If you filter by country, results will be shown based on the invitee.
   • Reward: The no. of inviters who received rewards as the CPI or CPA is completed.
   • CPI: Status where only the device matching is completed because an invitee installed and ran the game but ended the game before the VID is created.

3. You can download the searched info as excel. Once downloaded, you can check results on all countries.  

Cumulative index per stage¶

1. It's a cumulative index about the entire period since the campaign creation. Cumulative data up to the day before will be searched.

Inflow path indicator¶

You can check the route how the invitee clicked on the UA invitation link by date. 1. The route can be distinguished into Kakao, LINE, Facebook (FB Messenger included) and WeChat. Invitees accessed via other routes will be distinguished as others and you can also check the corresponding cumulative data. 2. Other messenger inflow indexes are introduced when using the UA sharing pop-up provided by Hive among games applied with individual modules, SDK v1 1.18.2 and SDK v4 4.14.3.

1. The ETC index is a cumulative inflow index that cannot be identified as other messenger index.