Hive is available with Third-party Mobile App Attribution (MAA) which tracks user activities in your app.Third-party MAAs that Hive SDK provides are Adjust, Singular and AppsFlyer.

Prerequisite

  1. Make sure to get an attribution key to use. Refer to notice from each attribution dashboard to learn how to issue the attribution key.
  2. Refer to Event Configuration to register tracking event on the attribution dashboard.
  3. Add the key value and event value issued from attribution dashboard to Hive SDK Configuration File (hive_config.xml). Read more details of Configure Attribution.

Configuring Event

Be aware of the following features when registering event on attribution dashboard.

Event Registration Event Name Adjust Singular AppsFlyer
Required Purchase Setting Event Key Automatically registered when the event is in use. Automatically registered when the event is in use.
Optional Update
TutorialComplete
Setting Event Key
Register when the event is in use.
No registration Install
Open
Automatically sent without registration. Automatically sent without registration. Automatically sent without registration.
  • All values except TutorialComplete (Purchase, Install, Open and Update) are automatically called when generating event from Hive SDK, therefore, game studio has nothing to call any function.
  • Refer to Sending Event for Tracking Users in case of using TutorialComplete.
  • Refer to Configuring Attribution section to configure event name and its value. The event name and its value are sent to transmit the event newly generated.
  • Refer to Configuring Attribution section as well to learn how to configure Hive with the event information registered on the dashboard.

The following image is an example.

Configuring Attribution

If you like to utilize attribution, set the attribution on SDK configuration file, hive_config.xml first. Configuration items are composed with properties by service and properties of <event> which you like to use.

Properties by Service
Name Description
name Name of Thire-party Attribution

  • "Adjust"
  • "Singular"
  • "AppsFlyer"
id The AppID of games issued from the Third-party Attribution dashboard
e.g. "5725"
key The key of games issued from the Third-party Attribution dashboard
e.g. "ab7b08bdc812dc0c731a846b952a10d3"
secretId An element used for Adjust
For more details, enquire of Marketing Department at Com2uS Holdings (Regardless of Com2uS)
info1 An element used for Adjust
For more details, enquire of Marketing Department at Com2uS Holdings (Regardless of Com2uS)
info2 An element used for Adjust
For more details, enquire of Marketing Department at Com2uS Holdings (Regardless of Com2uS)
info3 An element used for Adjust
For more details, enquire of Marketing Department at Com2uS Holdings (Regardless of Com2uS)
info4 An element used for Adjust
For more details, enquire of Marketing Department at Com2uS Holdings (Regardless of Com2uS)
itunseConnectAppId An element used for AppsFlyer (iOS)
Properties of <event>
Name Description
name The name of tracking event registered on the Third-party Attribution dashboard
e.g. "TutorialComplete"
value The value of tracking event sending from Hive Client to the relevant attribution

  • Adjust: The event token
  • Singular: The event name
  • AppsFlyer: The event name

e.g. "TutorialComplete"

Activating Third-party Attribution

You can activate/deactivate Third-party Attribution with Hive API. To activate (or deactivate) the attribution, call setEnableTracker() function from Analytics API. Make sure to define the attribution one by one like the following format at the first parameter of this function.

  • Adjust: TrackingType.ADJUST
  • Singular: TrackingType.SINGULAR
  • AppsFlyer: TrackingType.APPSFLYER

Followings are sample codes to deactivate Adjust.

Unity®

API Reference: hive.Analytics.setEnableTracker

C++

API Reference: Analytics::setEnableTracker

Android

API Reference: com.hive.Analytics.setEnableTracker

iOS

API Reference: HIVEAnalytics:setEnableTracker

Sending Event for Tracking Users

It is recommended to send tracking event to attribution only when user activities meet the specific conditions, such as tutorial completion. Call sendEvent() method in the Analytics class to send the tracking event. As the first parameter of sendEvent(), input the value of name property from <event>, which is defined in hive_config.xml file.

Followings are sample codes sending TutorialComplete event to marketing attribution to inform the completion of tutorial.

Unity®

API Reference: hive.Analytics.sendEvent

C++

API Reference: Analytics::sendEvent

Android

API Reference: com.hive.Analytics.sendEvent

iOS

API Reference: HIVEAnalytics:sendEvent