Using Marketing Attribution¶

Events are all activities that users perform while playing games, such as game installations, game updates, and item purchases. Marketing attribution is a function that collects these event logs and sends them to the server to track user activities. The tracking data from marketing attribution can be analyzed and utilized in various ways. For example, you can track events such as level-ups and item enhancements that occur within the game to predict user behavior and guide users to enjoy the game more.

Using the Hive SDK, you can use third-party app marketing attribution that can track user entry paths into user apps and user activities. The third-party app marketing attribution supported by the SDK includes five options: Adjust, Singular, AppsFlyer, Firebase Analytics, and Airbridge.

Features and support scope¶

The features provided by marketing attribution are as follows:

• Automatic event tracking: Automatically tracks basic events such as app installation, app opening, app updates, and in-app purchases, and sends data to the attribution server.
• Manual event tracking: Directly defines events that you want to collect in the game, tracks them, and sends data to the attribution server.
• PG payment purchase completion information collection: Purchase completion events can be collected even when using PG payments.
• Attribute transmission: When manually tracking events, additional event information can be collected through attributes.
• Ad exposure information transmission: When ads are displayed in games, measures and transmits ad platform type, ad exposure location, exposure timing, ad revenue per exposure, etc.
• SDK Signature: A solution to prevent spoofing (ad fraud that sends false events to ad servers). Prevents ad fraud by verifying valid signature information to distinguish between true/false events.
• App uninstall tracking: Sends silent push notifications once a day to check whether the app has been uninstalled.
• Deferred deep link: Directs users who have not installed the app to the app store to encourage installation, and when they run the installed app, redirects users to the designated content location.
• Market-specific traffic measurement settings: Sets identifiers to analyze app installation performance for markets (Google Play Store, One Store, Huawei Store, Galaxy Store, etc.).

The types and features of supported marketing attribution third-party apps differ depending on whether the game app is in a mobile or PC environment.

Mobile¶

The mobile environment supports all five marketing attribution apps, and the features provided by each app are as follows:

PC¶

The PC environment supports only two options: Airbridge and Appsflyer (Steam).

Community and web shop¶

In Community & Web Shop, only Airbridge's automatic event tracking feature is available for marketing attribution. Additionally, events can be collected in both mobile and PC environments.

Community automatic collection events¶

The events that Airbridge can automatically collect from community sites are as follows:

Web shop automatic collection events

The events that Airbridge can automatically collect from web shop sites are as follows:

Enabling third-party attribution¶

You can enable or disable third-party attribution using the Hive API. To enable or disable third-party attribution, call the setEnableTracker() function of the Analytics API. For the first parameter of the function, define the attribution you want to enable or disable with the following strings:

• Adjust: ADJUST
• Singular: SINGULAR
• AppsFlyer: APPSFLYER
• Firebase: FIREBASE
• Airbridge: AIRBRIDGE

The following is example code to disable specific attribution:

using hive;    
    String trackerName = "ADJUST";    

Analytics.setEnableTracker(trackerName, false);

#include "HiveAnalytics.h"

FString TrackingTypeName = TEXT("ADJUST");
FHiveAnalytics::SetEnableTracker(TrackingTypeName, false);

#include <HIVE_SDK_Plugin/HIVE_CPP.h>    
    using namespace std;    
    using namespace hive;    
    string trackerName = "ADJUST";    

Analytics::setEnableTracker(trackerName, false);

import com.hive.Analytics    
    val trackerName = "ADJUST"    

Analytics.setEnableTrackerWithName(trackerName, false)

import HIVEService    
    let trackerName = "ADJUST"    
AnalyticsInterface.setEnableTracker(name: trackerName, enable: false)

import HIVEService
let trackName = "ADJUST”
AnalyticsInterface.setEnableTracker(name: trackerName, enable: false)

#import <HIVEService/HIVEService-Swift.h>    
    NSString *trackerName = @"ADJUST";    

[HIVEAnalytics setEnableTrackerWithName: trackerName enable: NO];

Applying marketing attribution to Windows¶

The steps to apply marketing attribution in a Windows environment are as follows:

1. Go to Releases > Plugins > Marketing Attribution > Windows.
2. Download the marketing attribution plugin you want to use.
3. Extract the downloaded file.
4. Add the DLL files from the extracted files to {game app executable path}/plugins/trackers.