The SDK is available as an AAR (recommended) and JAR library. The library is available in the MavenCentral and GitHub repository.

Step 1. Gradle Build Dependencies

If you use Gradle for building apps specify the following dependencies in the build.gradle file in the dependencies block.

dependencies {
    implementation ‘androidx.preference:preference-ktx:1.1.1
    implementation 'com.android.installreferrer:installreferrer:2.2'
    implementation 'com.google.android.gms:play-services-base:17.6.0'
    implementation 'com.google.code.gson:gson:2.8.6'
    implementation 'com.google.firebase:firebase-core:19.0.0'
    // if you use AAR (recommended) or JAR downloaded from GitHub, please add:
    implementation fileTree(dir: "libs", include: ["*.aar"]) 
    // or just add the dependency
    implementation 'com.devtodev:android-analytics:2.0.0'
}

dependencies {
    implementation ’androidx.preference:preference:1.1.1
    implementation 'com.android.installreferrer:installreferrer:2.2'
    implementation 'com.google.android.gms:play-services-base:17.6.0'
    implementation 'com.google.code.gson:gson:2.8.6'
    implementation 'com.google.firebase:firebase-core:19.0.0'
    // if you use AAR (recommended) or JAR downloaded from GitHub, please add:
    implementation fileTree(dir: "libs", include: ["*.aar"]) 
    // or just add the dependency
    implementation 'com.devtodev:android:2.0.0'
}

Step 2. SDK Initialization

Use the following way to initialize the library in the first Activity onCreate() method:

class MainActivity : Activity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
      
        val analyticsConfiguration = DTDAnalyticsConfiguration()
        analyticsConfiguration.logLevel = DTDLogLevel.Error
        DTDAnalytics.initialize("App ID", analyticsConfiguration, context)
    }
}

public class MainActivity extends Activity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        
        DTDAnalyticsConfiguration configuration = new DTDAnalyticsConfiguration();
        configuration.setLogLevel(DTDLogLevel.Error);
        DTDAnalytics.initialize("App ID", configuration, context);
    }
}

• You can find the App ID in the settings of the respective app in devtodev (Settings → SDK → Integration → Credentials).

• config - is a DTDAnalyticsConfiguration object instance that is used for specifying additional properties during initialization.

DTDAnalyticsConfiguration

Example:

let config = DTDAnalyticsConfiguration()
config.currentLevel = 1
config.userId = "CustomUserID"
config.trackingAvailability = DTDTrackingStatus.Enable
config.logLevel = .error
DTDAnalytics.initialize(applicationKey: "appKey", configuration: config)

Step 3. SDK Initialization

Add the following strings to the proguard-rules.pro file of your app

-keep class com.devtodev.** { *; }
-dontwarn com.devtodev.**

1. Download the latest version of devtodev SDK from the repository

2. Add DTDAnalytics.xcframework to the project (with Do Not Embed specified)

3. Add frameworks:

• AppTrackingTransparency.framework

• AdSupport.framework

4. Add initialization todidFinishLaunchingWithOptions method:

let config = DTDAnalyticsConfiguration()
config.logLevel = .error
DTDAnalytics.initialize(applicationKey: "App ID", configuration: config)

DTDAnalyticsConfiguration *config;
config.logLevel = DTDLogLevelError;
[DTDAnalytics applicationKey:@"App ID" configuration:config];

• An App ID can be found in the settings of the respective app in devtodev (Settings → SDK → Integration → Credentials).

• config - an object instance of DTDAnalyticsConfiguration, which is used for specifying additional properties during the initialization.

DTDAnalyticsConfiguration

Example:

let config = DTDAnalyticsConfiguration()
config.currentLevel = 1
config.userId = "CustomUserID"
config.trackingAvailability = .enable
config.logLevel = .error
DTDAnalytics.initialize(applicationKey: "appKey", configuration: config)

DTDAnalyticsConfiguration *config;
config.currentLevel = @1;
config.userId = @"CustomUserID";
config.trackingAvailability = DTDTrackingStatusEnable;
config.logLevel = DTDLogLevelError;
[DTDAnalytics applicationKey:@"App ID" configuration:config];

Integration features

For Objective-C

1. Create Bridging-Header. To do this, you need to add any swift file to the project (don’t delete it later) and choose ‘Create Bridging Header’ in the offered dialog box.

2. Make sure that the ‘Build Settings’ for ‘Defines Module’ value evaluates to ‘YES’.

3. While importing, use: #import <DTDAnalytics/DTDAnalytics-Swift.h>

For SwiftUI

For SDK to function properly, it needs to be integrated at the earliest moment of the app launch. It is recommended that you use the following method of main entry point initialization:

@main
struct TestSwiftUIApp: App {
    init() {
        let config = DTDAnalyticsConfiguration()
        config.logLevel = .debug
        DTDAnalytics.initialize(applicationKey: "appKey", configuration: config)
    }

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

var config = new DTDAnalyticsConfiguration();
config.LogLevel = DTDLogLevel.Error;
DTDAnalytics.Initialize("App ID", config);

var config = new DevToDev.Analytics.DTDAnalyticsConfiguration();
config.LogLevel = DTDLogLevel.Error;
config.CurrentLevel = 2;
config.UserId = "CustomUserId";
config.TrackingAvailability = DTDTrackingStatus.Enable;
DevToDev.Analytics.DTDAnalytics.Initialize("App ID", config);

var config = new DTDAnalyticsConfiguration();
config.LogLevel = DTDLogLevel.Error;
DTDAnalytics.Initialize("App ID", config);

var config = new DevToDev.Analytics.DTDAnalyticsConfiguration();
config.LogLevel = DTDLogLevel.Error;
config.CurrentLevel = 2;
config.UserId = "CustomUserId";
config.TrackingAvailability = DTDTrackingStatus.Enable;
config.ApplicationVersion = "1.2.34";
DevToDev.Analytics.DTDAnalytics.Initialize("App ID", config);

1

Please do the following to integrate your web application with devtodev:

1. Add the application to the Space using the wizard for adding applications.

2. To integrate SDK, add the following line to the tag of your page:

<script type="text/javascript" src="https://cdn.devtodev.com/sdk/web/v2/devtodevsdk.js">
</script>

3. Init the SDK.

Initialization

In order for SDK for WEB to start working, it is necessary to perform initialization right after the page is loaded and you have a basic user identifier at your disposal.

window.devtodev.initialize("App ID", config);

• You can find the App ID in the settings of the respective app in devtodev (Settings → SDK → Integration → Credentials).

• config - is an object that is used for specifying additional properties during initialization.

Config

Example:

var config = {};
config.userId = "Unique user identifier";
config.currentLevel = 2;
config.trackingAvailability = true;
config.LogLevel = "Error";
window.devtodev.initialize("App ID", config);

Plugin installation

Unzip the DTDAnalytics.zip archive to the Plugins folder of your project.

For a C++ project type, add the DTDAnalytics name to the list of dependency module names to the <module_name>.Build.cs file of the module in which you plan to use the plugin.

Example:

Data types

class UDTDAnalyticsLibrary

A class that implements analytic methods.

Header file:

class UDTDUserCardLibrary

A class that implements user card methods.

The class header:

enum class EDTDTrackingStatus : uint8

SDK tracking status.

Header file:

Values:

• Unknown = 0 - leave tracking unchanged

• Enable = 1 - tracking enabled

• Disable = 2 - tracking disabled

Example:

enum class EDTDLogLevel : uint8

SDK logging level.

Header file:

Values:

• Unknown = 0 - leave logging level unchanged

• No = 1 - logging disabled

• Error = 2 - logging of errors

• Warning = 3 - logging of warnings and errors

• Info = 4 - logging of information messages, warnings and errors

• Debug = 5 - logging of debugging messages, informational messages, warnings and errors

Example:

enum class EDTDAccrualType : uint8

Types of resource accumulation.

Header file:

Values:

• Earned = 0 - earned resources

• Bought = 1 - purchased resources

Example:

enum class EDTDSocialNetwork : uint8

Predefined social media.

Header file:

Values:

• Facebook = 0

• Vkontakte = 1

• Twitter = 2

• Googleplus = 3

• Whatsapp = 4

• Viber = 5

• Evernote = 6

• Googlemail = 7

• Linkedin = 8

• Pinterest = 9

• Reddit = 10

• Renren = 11

• Tumblr = 12

• Qzone = 13

Example:

enum class EDTDGender: uint8

User gender.

Header file:

Values:

• Unknown = 0

• Male = 1

• Female = 2

Example:

enum class EDTDReferralProperty : uint8

Referral properties.

Header file:

Values:

• Source = 0

• Medium = 1

• Content = 2

• Campaign = 3

• Term = 4

Example:

struct FDTDOptionalInt32

An optional parameter of int32 type

Header file:

For your convenience, we implemented the conversion constructor:

Example:

struct FDTDOptionalString

An optional parameter of FString type.

Header file:

For your convenience, we implemented the conversion constructor:

Example:

struct FDTDAnalyticsConfiguration

Configuration of the analytics plugin.

Header file:

Example:

FDTDCustomEventParams

Custom parameters of a custom event.

Header file:

Example:

struct FDTDStartProgressionEventParams

Parameters of the progression start event.

Header file:

Example:

struct FDTDFinishProgressionEventParams

Parameters of the progression completion event.

Header file:

Example:

Delegates

Header file:

Definitions:

SDK initialization

SDK initialization without parameters:

SDK initialization with parameters:

SDK Initialization

1.

2. Create a script with the following code and attach it to the GameObject that will survive the entire life cycle of the app.

You can find the AppID in the settings of the respective app in devtodev (Settings → SDK → Integration → Credentials).

config - an object instance of DTDAnalyticsConfiguration, which is used for specifying additional properties during the initialization.

DTDAnalyticsConfiguration

Example:

Specific integration features of certain platforms

Windows Standalone

SDK Activity

The SDK can’t control app activity in case you use Windows Standalone therefore this responsibility is shifted to the developer. While initializing the SDK, the activity starts automatically and after that, the activity status will not auto-change. To track app activity, the developer can use the following methods: DTDAnalytics.StartActivity and DTDAnalytics.StopActivity. It is recommended to use the DTDAnalytics.StopActivity method to stop activity when the app goes into the background or gets closed. You can use the DTDAnalytics.StartActivity method to resume activity when the app gets reopened from the taskbar.

For other platforms, there is no need to manually call the DTDAnalytics.StartActivity and DTDAnalytics.StopActivity methods.

Android

iOS

To integrate with Xcode, the SDK uses PostProcessBuild in the DTDPostProcessAnalytics and DTDPostProcessMessaging scripts. If you use custom PostProcessBuild scripts, add them callbackOrder of less than 98 to avoid conflicts.

CocoaPods

is the easiest way to add devtodev into your iOS project.

1. Firstly, install CocoaPods using:

2. In the project directory execute the command:

3. In the created Podfile add the dependency:

4. Finally, run the command in your Xcode project directory:

CocoaPods should download and install the devtodev library, and create a new Xcode workspace. Open this workspace in Xcode.

Swift Package Manager

In progress...

Manual installation

3. Add frameworks:

• AppTrackingTransparency.framework

• AdSupport.framework

4. Add initialization todidFinishLaunchingWithOptions method:

• An App ID can be found in the settings of the respective app in devtodev (Settings → SDK → Integration → Credentials).

• config - an object instance of DTDAnalyticsConfiguration, which is used for specifying additional properties during the initialization.

DTDAnalyticsConfiguration

Example:

Integration features

For Objective-C

1. Create Bridging-Header. To do this, you need to add any swift file to the project (don’t delete it later) and choose ‘Create Bridging Header’ in the offered dialog box.

2. Make sure that the ‘Build Settings’ for ‘Defines Module’ value evaluates to ‘YES’.

3. While importing, use: #import <DTDAnalytics/DTDAnalytics-Swift.h>

For SwiftUI

For SDK to function properly, it needs to be integrated at the earliest moment of the app launch. It is recommended that you use the following method of main entry point initialization: