How to replace Adbrix Original SDK with DFINERY SDK
On the 31st of May, AdBrix original service has terminated.
This guide is written for the developers who want to know how to replace AdBrix Original SDK with DFINERY SDK.
reference: about DFINERY
Differences between AdBrix Original and DFINERY
the way how we release SDK
To implement AdBrix Original SDK on the app, a developer had to download jar files or Framework files depending on the platforms. In DFINERY, a developer can download SDK through Android gradle and Cocoapds. We are updating our SDK to provide more sophisticated features regularly, and a developer can easily update to the latest version of SDK. (If you need SDK as files, send an email to support-tracker@adbrixsupport.zendesk.com)
we support more platforms than before
DFINERY SDK can be integrated on Android, iOS Native, Unity, React Native, Flutter, and Web platforms. We are planning to support more platforms to satisfy the advertisers' needs.
DFINERY: more powerful marketing tool
In the console, advertisers can make a report based on the data from the DFINERY SDK. We provide advertisers with more flexible and sophisticated reports and chances to start an in-app promotion service such as the Growth Action.
reference: more about DFINERY / DFINERY Growth Action
Comparing DFINERY with AdBrix Original
One AppKey / SecretKey
DFINERY gives you one AppKey and one SecretKey which can be used on Android, iOS, and Web platforms. You do not have to manage each appKey and SecretKey of each platform.
No more FirstTimeExperience / Retention API for both iOS and Android
DFINERY provides AdBrixRm.event API which has both FirstTimeExperience(FTE) API and Retention(RET) API. Advertisers still can make and see the FirstTimeExperiecne and Retention report in the console.
Change of SDK init (Android)
AdBrix Original analyzed when the app started running and finished running on every single activity of onResume and onPause using IgawComon.startSession and IgawComon.endSession method. In DFINERY SDK, Application Class is managing the moment when the app starts and finishes.
public class MyApplicationClass extends Application {
@Override
public void onCreate() {
super.onCreate();
AbxActivityHelper.initializeSdk(MyApplicationClass.this, "your_adbrix_remastered_app_key", "your_adbrix_remastered_secret_key");
}
}
public class MyApplicationClass : Application() {
override fun onCreate() {
super.onCreate()
AbxActivityHelper.initializeSdk(applicationContext , "your_adbrix_remastered_app_key", "your_adbrix_remastered_secret_key");
}
}
Implement Google InstallReferrer (Android)
Google InstallReferrer which had been integrated within the AndroidManifest.xml was deprecated. From now on, add " implementation 'com.android.installreferrer:installreferrer:2.2' " to the gradle dependency. If you want to know the details about a change of Google Install Referrer, please see the following document.
reference: Update Google Install Referrer
Set Siwft as basic language
DFINERY SDK is written by Swift. If you want to integrate iOS SDK into the Objective-C project, go to Build Settings and set the Always Embed Swift Standard Libraries "Yes".
DFINERY SDK implementation(Android)
Delete existing Libraries and API
Delete the AdBrix original SDK libraries on your project, including igawCommon, AdBrix, and Livbeops. You should get rid of the APIs which are based on the existing libraries.
gradle set-up
Open the [build.gradle (Project: ProjectName)] / [build.gradle (Module: app)] and set up each one like the following.
[build.gradle (Project: ProjectName)]
allprojects {
repositories {
google()
jcenter() // delete this.
mavenCentral()
}
}
[build.gradle (Module: app)]
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
dependencies {
implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
implementation 'com.android.installreferrer:installreferrer:2.2'
implementation 'io.dfinery:android-sdk:2.4.0.2'
}
// if you cannot use jetifier
android {
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
dependencies {
implementation 'com.google.android.gms:play-services-ads-identifier:18.0.1'
implementation 'com.android.installreferrer:installreferrer:2.2'
implementation('io.dfinery:android-sdk:2.4.0.2'){
exclude group: 'com.android.support'
}
}
SDK initialization
In the Application class, add the following code to initialize Android SDK.
You can see the appKey and secretKey on the DFINERY console page.
DFINERY Console : https://console.dfinery.io/
public class MyApplicationClass extends Application {
@Override
public void onCreate() {
super.onCreate();
AbxActivityHelper.initializeSdk(MyApplicationClass.this, "your_adbrix_remastered_app_key", "your_adbrix_remastered_secret_key");
}
}
public class MyApplicationClass : Application() {
override fun onCreate() {
super.onCreate()
AbxActivityHelper.initializeSdk(applicationContext , "your_adbrix_remastered_app_key", "your_adbrix_remastered_secret_key");
}
}
[[인용:안내:보통]] Congratulation!!!
If you have followed this guide here, you are ready to analyze your app using DFINERY SDK.
The following features are available from now on.
1. Make a report of DAU, MAU, daily user retention, and etc.
2. Make a report of user acquisition such as nCPI campaign performance
We have many APIs for the marketers to analyze user actions, please click and see the attached integration guide.
integration guide: DFINERY SDK Integration Guide[Android]
DFINERY SDK implementation(iOS)
delete existing Framework and API
Delete AdBrix Original SDK framework within the Cocoapods file, after that delete all the APIs from the AdBrix Original SDK.
Add DFINERY SDK
Add the following commands to the Podfile to download DFINERY SDK through CocoaPods.
Activate Swift Libraries
In the case of Objective-C, go to the project's Build Settings and turn it in Yes.
init SDK in AppDelegate
Add the following code within the AppDelegate class to initialize SDK.
You can find your appKey and secretKey on the DFINERY console page.
DFINERY Console : https://console.dfinery.io/
import AdBrixRM
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// Create AdBrixRM Instance
let adBrix = AdBrixRM.getInstance
// Set adbrix appKey & secretKey
adBrix.initAdBrix(appKey: "your_adbrix_remastered_app_key", secretKey: "your_adbrix_remastered_secret_key")
return true
}
#import <AdBrixRM/AdBrixRM-Swift.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// Override point for customization after application launch.
// Create AdBrixRM Instance
AdBrixRM *adBrix = [AdBrixRM sharedInstance];
// Set adbrix appKey & secretKey
[adBrix initAdBrixWithAppKey:@"your_adbrix_remastered_app_key" secretKey:@"your_adbrix_remastered_secret_key"];
return YES;
}
[[인용:안내:보통]] Congratulation!!!
If you have reached here, you are ready to analyze your app using DFINERY SDK.
The following features are available from now on.
1. Make a report of DAU, MAU, daily user retention, and etc.
2. Make a report of user acquisition such as nCPI campaign performance
We have many APIs for the marketers to analyze user actions, please click and see the attached integration guide.
integration guide: DFINERY SDK Integration Guide[iOS]
Support
If you have any questions about implementing SDK, please contact us with the email below.
email for support: support-tracker@adbrixsupport.zendesk.com