What is User Acquisition?¶

You can attract new users by having users share their Invite URL or QR Code on their SNS with the Invite Feature offered by Hive SDK. Rewards are given to both the one who invited his or her friend and to the one who was invited when the invited user installs the game and meets certain condition (conditions and rewards can be set up at Hive Console), such as reaching a specific level.

The target of invitation is not limited to Hive users. A unique Invite URL and a QR Code are issued per user to identify the user that invited others.

If an iOS user participates via the Invite URL, the following notice page will be exposed to prevent loss of matching.

UA should provide users with easy-to-achieve goals and give proper compensation to enhance their interest and engagement.

UA features¶

• Issue and share the invitation URL/QR code of games
• Cost Per Install (CPI), which rewards both user and invited friend if the friend installed the game
• Cost Per Action (CPA), which rewards both user and invited friend if the friend achieved a mission while playing the game

UA Invitation process¶

To reward, you need to implement ITEM.

Registering User Acquisition Campaign¶

You can register UA campaign on Hive Console. provides two types of campaign.

• Achievement campaign by count - If the invited friends achieve the campaign goal, both user and new friends get rewards
• Achievement campaign by mission - If the number of friends who completed missions meet the setting numbers, both user and new friends get rewards

For more information how to configure a campaign, see Hive Console Promotion.

Implementing User Acquisition¶

Implement invitations and campaign UI for UA in the game, and encourage users to install apps.

Receiving Campaign information and Invitation URL/QR Code¶

To receive invitation URL/QR code and campaign information, call getAppInvitationData() method in the Promotion class. You can create invitation page or campaign screen based on the information from Hive SDK.

Followings are sample codes to request the URL/QR code and campaign information to Hive SDK.

using hive;    
    Promotion.getAppInvitationData((ResultAPI result, AppInvitationData appInvitationData) => {    
        if (result.isSuccess()) {    
            // call successful    
        }    
});

#include "HivePromotion.h"

FHivePromotion::GetAppInvitationData(FHivePromotionOnAppInvitationDataDelegate::CreateLambda([this](const FHiveResultAPI& Result, const FHiveAppInvitationData& AppInvitationData) {
        if (Result.IsSuccess()) {
                // API  call success
        }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    Promotion::getAppInvitationData([=](ResultAPI result, AppInvitationData appInvitationData) {    
        if (result.isSuccess()) {    
        // call successful    
        }    
});

import com.hive.Promotion    
    import com.hive.ResultAPI    
    Promotion.getAppInvitationData(object : Promotion.AppInvitationDataListener {    
         override fun onAppInvitationData(result: ResultAPI, appInvitationData: Promotion.AppInvitationData?) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

import com.hive.Promotion;    
    import com.hive.ResultAPI;    
    Promotion.INSTANCE.getAppInvitationData((result, appInvitationData) -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

import HIVEService    
    PromotionInterface.getAppInvitationData() { result, appInvitationData in    
        if result.isSuccess() {    
        // call successful    
        }    
}

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEPromotion getAppInvitationData: ^(HIVEResultAPI *result, HIVEAppInvitationData *appInvitationData) {    
        if ([result isSuccess]) {    
        // call successful    
        }    
}];

After calling getAppInvitationData() method, data is sent through AppInivitationData object.

The Composition of AppInvitationData Object¶

Sharing media files by social media¶

Hive SDK provides a sharing function by social media, unavailable with Receiving Campaign information and Invitation URL/QR Code. Use the showUAShare() method in the Promotion class provided by Hive SDK v4.11.7 with the following SNS.

• Kakao Talk
• LINE
• Facebook
• Facebook Messenger
• WhatsApp
• WeChat

With Hive SDK v4.11.2 and later but earlier than v4.11.7, the function is available by using shareText() and shareMedia() method in the PlatformHelper class.

Sharing media files are available only when the file is saved on user device. To share a URL, use text sharing function or download files from the URL. Followings are sample codes to implement file share by social media.

using hive;    
    // invitation message    
    String inviteMessage = appInvitationData.inviteMessage;    
    // invitation link    
    String inviteCommonLink = appInvitationData.inviteCommonLink;    
    Promotion.showUAShare(inviteMessage, inviteCommonLink, (ResultAPI result) => {    
         if (result.isSuccess()) {    
            // call successful    
        }    
});

#include "HivePromotion.h"

FString InviteMessage = TEXT("InviteMessage"); // AppInvitationData.InviteMessage;
FString InviteLink = TEXT("InviteLink"); // AppInvitationData.InviteCommonLink;

FHivePromotion::ShowUAShare(InviteMessage, InviteLink, FHivePromotionOnUAShareDelegate::CreateLambda([this](const FHiveResultAPI& Result) {
        if (Result.IsSuccess()) {
                // API call success
        }
}));

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    // invitation message    
    string inviteMessage = appInvitationData.inviteMessage.c_str();    
    // invitation link    
    string inviteCommonLink = appInvitationData.inviteCommonLink.c_str();    
    Promotion::showUAShare(inviteMessage, inviteCommonLink, [=](ResultAPI const &result) {    
        if (result.isSuccess()) {    
        // call successful    
        }    
});

import com.hive.Promotion    
    import com.hive.ResultAPI    
    // invitation message    
    val invitationMessage = appInvitationData?.inviteMessage ?: ""    
    // invitation link    
    val inviteCommonLink = appInvitationData?.inviteCommonLink ?: ""    
    Promotion.showUAShare(invitationMessage, inviteCommonLink, object: Promotion.PromotionShareListener{    
         override fun onPromotionShare(result: ResultAPI) {    
             if (result.isSuccess) {    
                 // call successful    
             }    
         }    
})

import com.hive.Promotion;    
    import com.hive.ResultAPI;    
    // invitation message    
    String inviteMessage = appInvitationData.getInviteMessage();    
    // invitation link    
    String inviteCommonLink = appInvitationData.getInviteCommonLink();    
    Promotion.INSTANCE.showUAShare(inviteMessage, inviteCommonLink, result -> {    
         if (result.isSuccess()) {    
             // call successful    
         }    
});

import HIVEService    
    // invitation message    
    let inviteMessage = appInvitationData.inviteMessage    
    // invitation link    
    let inviteCommonLink = appInvitationData.inviteCommonLink    
    PromotionInterface.showUAShare(inviteMessage, inviteCommonLink) { result in    
        if result.isSucces() {    
        // call successful    
        }    
}

#import <HIVEService/HIVEService-Swift.h>    
    // invitation message    
    NSString *inviteMessage = appInvitationData.inviteMessage;    
    // invitation link    
    NSString *inviteCommonLink = appInvitationData.inviteCommonLink;    

    [HIVEPromotion showUAShare: inviteMessage inviteLink: inviteCommonLink handler: ^(HIVEResultAPI *result) {    
         if ([result isSuccess]) {    
            // call successful    
            }    
}];

Designing an Invitation screen¶

Invitation screen is displayed for users to invite friends to the game. Utilize qrcode or inviteCommonLink from AppInvitationData object to design the invitation screen. You can implement a game invitation screen in a game using the qrcode or inviteCommonLink of AppInivitationData object that is passed as a result of the getAppInvitationData() method call. Invitation page has no limit, but the information below should be clearly stated.

• A campaign with description of the following; the goals that an invite must achieve, a description of the goal, the rewards of achieving that goal, the number of times the invitation has been completed, and the number of invitations needed to achieve the goal.
• An invitation with description of the following; a list of friends who can be invited and specify the method or procedure for sending actual invitations.

Campaigns and invitation may consist of different screens depending on the game plan, or may be composed together on the same screen.

• An example of initial screen with inviteCommonLink

  It is recommended to display the invitation URL as shown in the example screen above and design the UI in the game so that the user can copy the URL to the clipboard.

Designing a Campaign screen¶

AppInvitationData class defines eachCampaignList and stageCampaignList variables. The data type of eachCampaignList variable is AppInvitationCampaign class, and that of stageCampaignList is AppInvitationCampaignState. Each of them contains campaign and campaign achievement information. A campaign screen is composed by using the following information.

The composition of AppInvitationCampaign object¶

The composition of AppInvitationCampaignStage object¶

Checking UA Sender's information¶

Information of User Acquisition Sender is now available in the client API as well. Install and run the app by clicking the UA link a new user received first, then implement the SDK initialization and the login. Next, call the setEngagementReady(true) method in the Promotion class. After that, you can confirm the UA sender's information through the AppInvitationSenderInfo object by calling the getAppInvitationSenderInfo method.

Followings are sample codes to check UA sender's information.

using hive;    
    Promotion.getAppInvitationSenderInfo((result, senderInfo) => {    
        if (!result.isSuccess()) {    
            return;    
        }    
        if (senderInfo != null && !string.IsNullOrEmpty(senderInfo.vid)) {    
        // Successful call and check inviter information    
        }    
});

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    Promotion::getAppInvitationSenderInfo([this](ResultAPI result, AppInvitationSenderInfo senderInfo) {    
        if (!result.isSuccess()) {    
        return;    
        }    
        if (senderInfo != NULL && !senderInfo.vid.empty()) {    
        // Successful call and check inviter information    
        }    
});

import com.hive.Promotion    
    import com.hive.ResultAPI    
    Promotion.getAppInvitationSenderInfo(object : Promotion.AppInvitationSenderInfoListener {    
         override fun onAppInvitationSenderInfo(result: ResultAPI, appInvitationSenderInfo: Promotion.AppInvitationSenderInfo?) {    
             if (!result.isSuccess) {    
                 return    
             }    
             if (appInvitationSenderInfo != null && appInvitationSenderInfo.senderVid.isNotEmpty()) {    
                 // Successful call and check inviter information    
             }    
         }    
})

import com.hive.Promotion;    
    import com.hive.ResultAPI;    
    Promotion.INSTANCE.getAppInvitationSenderInfo((result, appInvitationSenderInfo) -> {    
         if (!result.isSuccess()) {    
             return;    
         }    
         if (appInvitationSenderInfo != null && !(appInvitationSenderInfo.getSenderVid().isEmpty())) {    
             // Successful call and check inviter information    
         }    
});

import HIVEService    
    PromotionInterface.getAppInvitationSenderInfo() { result, senderInfo in    
        if !result.isSuccess() {    
            return    
        }    
        if     
            let senderInfo = senderInfo,            
            let vid = senderInfo.vid, !vid.isEmpty     
        {    
            // Successful call and check inviter information    
        }    
}

#import <HIVEService/HIVEService-Swift.h>    
    [HIVEPromotion getAppInvitationSenderInfo: ^(HIVEResultAPI *result, HiveAppInvitationSenderInfo *senderInfo) {    
         if (![result isSuccess]) {    
             return;    
         }    
        if (senderInfo != nil && [senderInfo.vid length] > 0) {    
        // Successful call and check inviter information    
        }    
}];

The composition of AppInvitationSenderInfo Object¶

Notifying CPA achievement¶

When an invited friend installs a game or you reach the goal of the campaign, the game must inform the Hive Server of the CPA achievement in order to be rewarded. Be sure to complete the following works before giving rewards.

• Set to reward with CPA achievement registered on Hive Console
• Implement ITEM

If both works are completed, call CPA Achievement Notice API when CPA is achieved.