Configuration

Build Dependencies

If you are using Unity, please follow the guide here: https://noctua-labs.gitbook.io/noctua-labs/noctua-labs/sdk-integration/preparation/unity Then go back here and jump to "Configurations" section below.

If you already configured the project by using Unity Configuration guide, you can skip these steps and go straight to "Configurations" section below.

• In your root-level (project-level) Gradle file in<project>/build.gradle, add the Google services plugin as a dependency:

buildscript {
    dependencies {
        classpath 'com.google.gms:google-services:4.2.0'
    }
}

• In your module (app-level) Gradle file usually in <project>/<app-module>/build.gradle, add the dependencies as below:

apply plugin: 'com.google.gms.google-services'
dependencies {
    //adjust
    implementation 'com.adjust.sdk:adjust-android:4.31.1'
    implementation 'com.android.installreferrer:installreferrer:2.2'
    implementation 'com.google.android.gms:play-services-ads-identifier:17.0.1'
    // facebook
    implementation 'com.facebook.android:facebook-android-sdk:14.1.0'
    // firebase
    implementation 'com.google.firebase:firebase-analytics:20.1.0'
}

Update Your Manifest

• Configure by copying these to your AndroidManifest.xml

<!-- Must be configured -->
<uses-permission android:name="android.permission.WAKE_LOCK" />

<!-- Enable Adjust Events -->
<meta-data
    android:name="noctua_adjust_events_enabled"
    android:value="true" />

<!-- Enable Firebase Events -->
<meta-data
    android:name="noctua_firebase_events_enabled"
    android:value="true" />

<!-- Enable Facebook Events -->
<meta-data
    android:name="noctua_facebook_events_enabled"
    android:value="true" />

<meta-data
    android:name="adjust.Token"
    android:value="@string/adjust_token"/>
<meta-data
    android:name="adjust.purchase.event.token"
    android:value="@string/adjust_purchase_token"/>
    
<!--adjust config sandbox mode, production mode remove this or configured value
to 0 -->
<meta-data
    android:name="adjust.Debug"
    android:value="1"/>
    
<meta-data 
    android:name="com.facebook.sdk.ClientToken"
    android:value="@string/facebook_client_token"/>
    
<activity
android:name="com.facebook.FacebookActivity"
android:configChanges="keyboard|keyboardHidden|screenLayout|screenSize|orientation"/>
<activity
    android:name="com.facebook.CustomTabActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.VIEW"/>
        <category android:name="android.intent.category.DEFAULT"/>
        <category android:name="android.intent.category.BROWSABLE"/>
        <data android:scheme="@string/fb_login_protocol_scheme"/>
    </intent-filter>
</activity>
<meta-data
    android:name="com.facebook.sdk.ApplicationId"
    android:value="@string/facebook_app_id"/><!-- added since facebook v13.0.0 -->
<meta-data
    android:name="com.facebook.sdk.ClientToken"
    android:value="@string/facebook_client_token"/>
    

• Add the following configuration to the /app/res/values/strings.xml file in your app project.

<?xml version="1.0" encoding="utf-8"?>
<resources xmlns:tools="http://schemas.android.com/tools"
tools:ignore="MissingTranslation">
    <string name="adjust_token">your_adjust_token</string>
    <string name="adjust_purchase_token">your_adjust_purchase_token/string>
    
    <string name="facebook_app_id">your_facebook_app_id</string>
    <string name="fb_login_protocol_scheme">your_facebook_app_id</string>
    <string name="facebook_client_token">your_facebook_client_token</string>
    
</resources>

• Application Module configuration copy google-services.json to the app module directory, the json file must be placed in the main Module and package names must be consistent

Firebase's google-services.json

SDK Checker for Debugging

Set debug mode to active event checker Please add this to Androidmanifest.xml

<!--value 1 to active event checker, production mode remove this or configured value to 0 -->

<meta-data
  android:name="isSDKChecker"
  android:value="1"/>

Event Mapping

Optional if you only use Scale (User Acquisition) feature from Labs.

This Event Mapping only used for the Game Analytics feature.

The event names are mapped using an automatically loaded events.csv file. This approach avoids hardcoding the event names, making it more convenient for use across multiple services and platforms.

To map event names, ensure that an events.csv file is included in your project. This file should contain the mapping of event identifiers to their respective names.

events.csv