이 섹션의 문서

더보기

AdBrix Original to DFINERY SDK 전환가이드

Avatar
DFINERY
  • 업데이트 시간
팔로우

 

2021년 5월 31일 AdBrix 오리지널 서비스가 종료됩니다.

AdBrix Original 서비스가 종료됨에 따라 이제 DFINERY로 SDK 전환을 진행해야 합니다. 아래 가이드에 따라 마이그래이션을 진행해 주시길 부탁드립니다.

 

참고자료 : 디파이너리 알아보기

 

 

AdBrix Original 과 DFINERY 와의 차이점

 

SDK 배포방식

기존 AdBrix Original SDK 는 jar 파일 혹은 Framework 파일로 SDK 를 배포하였으나 DFINERY SDK 는 Android gradle, Cocoapods 를 통해 SDK 를 배포하게됩니다. 이를 통해 DFINERY SDK를 항상 최신버전으로 유지한 상태에서 앱을 유지할 수 있습니다. (기존 파일 다운로드 방식 역시 지원합니다.)

 

더 많은 플랫폼 지원

기존 AdBrix Original SDK 에서는 Android / iOS Native, Unity 플랫폼을 지원하였으나 DFINERY SDK 는 여기에 React Native, Flutter 그리고 Web 플랫폼을 지원합니다.  향후 사용자의 다양한 니즈를 반영하여 더 많은 플랫폼을 지원할 예정입니다.

 

 

디파이너리의 강력한 Tool 이용

DFINERY SDK 에서 수집된 데이터는 DFINERY 콘솔을 통해 리포트를 확인하실 수 있습니다. DFINERY 콘솔은 기존 AdBrix 콘솔 리포트보다 강력한 리포트 커스텀화 기능을 통해 여러분이 보고자 하는 리포트를 생성하실 수 있습니다. 더불어 이렇게 수집된 리포트는 포스트백을 통한 광고, Growth Action 을 통한 내부 프로모션을 진행할 수 있습니다.

 

참고자료 : DFINERY 데이터 분석 및 대시보드 설정

참고자료 : DFINERY Growth Action

 

 

AdBrix 와 DFINERY 개발 변경점

 

AppKey / SecretKey 통합

기존 AdBrix Original SDK 에서는 플랫폼별 (Android / iOS) 로 앱키를 발급받아 이를 따로 관리하였습니다. DFINERY 에서는 하나의 AppKey / SecretKey 로 Android 와 iOS 그리고 Web 플랫폼에서 같이 사용할 수 있습니다. 

 

FirstTimeExperience / Retention API 삭제 (공통)

기존 AdBrix Original 에서 사용자의 최초 접속 후 실행한 이벤트를 분석하는 API 인 FirstTimeExperience (fte) / 사용자의 반복적인 이벤트를 분석했던 Retention (ret) API 는 AdBrixRm.event API 로 통합되었습니다. 그러나 걱정하지 마십시오.  DFINERY  콘솔의 강력한 리포팅 Tool 기능을 통해 여러분은 AdBrix 오리지널과 동일하게 FirstTimeExperience / Retention 리포트를 생성하여 보실 수 있습니다.

 

SDK init 방식 변경 (Android)

기존 AdBrix Original 에서는 각 액티비티별 onResume / onPause 에 IgawComon.startSession / IgawComon.endSession 을 연동하여 앱의 실행 / 종료 정보를 파악하였으나 DFINERY 에서는 각 앱별 Application Class에서 이를 관리하는 것으로 변경되었습니다.

 

Java Kotlin 
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");

    }
}

 

InstallReferrer 연동 방식 변경 (Android)

기존 AdBrix Original 에서 AndroidManfiest.xml 에서 선언하여 관리하던 Google InstallReferrer 이 Google 에서 Deprecated 되었습니다. 이에 따라 구글에서 제공하는 implementation 'com.android.installreferrer:installreferrer:2.2' 를 gradle 에 선언함으로써 이를 관리할 수 있게 변경되었습니다. 자세한 내용은 아래 가이드를 참고해 주시길 부탁드립니다.

 

참고자료 : 구글 인스톨 리퍼러 브로드캐스트 동작 방식 변경 안내

 

SDK 개발 언어 변경 (iOS)

iOS SDK 개발언어가 Objective-C 에서 Swift 로 변경되었습니다. 기존 Objective-C 프로젝트에서 DFINERY SDK 를 연동하실 경우 아래와 같이 Build Settings -> Always Embed Swift Standard Libries 설정을 Yes 로 바꿔 Swfit 라이브러리를 항상 활성화해야 합니다.

 

 

DFINERY SDK 연동 (Android)

 

기존 라이브러리 및 API 삭제

프로젝트에 기존에 다운로드 받으신 라이브러리를 삭제합니다. 라이브러리는 IgawCommon / AdBrix / LiveOps 라이브러리를 삭제합니다. 삭제된 라이브러리와 연결된 API 역시 삭제합니다.

 

mceclip0.png

 

gradle 설정

[build.gradle (Project: ProjectName)] / [build.gradle (Module: app)] 에 아래와 같이 설정합니다.

 

[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.5.1.8'
}

//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.5.1.8'){
      exclude group: 'com.android.support'
    }
}

 

SDK 초기화

이후 앱의 Application 클래스에서 아래와 같이 SDK 초기화 코드를 추가합니다.

appKey / secretKey 는 DFINERY Console 에서 확인하실 수 있습니다. 

 

DFINERY Console : https://console.dfinery.io/

 

Java Kotlin 
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");

    }
}

 

[[인용:안내:보통]] 축하합니다!!!

DFINERY 이용을 위한 기본적인 연동이 완료되었습니다.
이용할 수 있는 기능은 다음과 같습니다.
1. DAU, MAU, 일별 리텐션 등의 지표를 확인할 수 있는 리포팅
2. NCPI 와 같은 앱 유입 캠페인

이후 DFINERY SDK의 추가 API 연동을 위해서는 아래 가이드에 따라 연동을 진행해 주시길 부탁드립니다.
연동 가이드 : DFINERY SDK 연동가이드 [Android]

 

 

 

DFINERY SDK 연동 (iOS)

 

기존 Framework 및 API 삭제

Cocoapods 파일에 설정된 AdBrix 오리지널에서 사용한 Framework 를 삭제합니다. 삭제후 Framework 와 연결된 API 역시 삭제합니다.

 

mceclip2.png

 

Cocoapods 에 DFINERY SDK 추가

Cocoapods 에 DFINERY SDK 를 추가합니다.

 

platform :ios, '8.0'
target "myXcodeProject"do
pod 'AdBrixRmKit', '2.4.0.3'
end

 

Swift 라이브러리 활성화

Objective-C 로 만들어진 프로젝트일 경우 Build Settings 에서 Always Embed Swift Standard Libraries 를 Yes 로 설정하여 활성화 합니다.

 

AppDelegate 에서 SDK init

이후 앱의 AppDelegate 클래스에서 아래와 같이 SDK 초기화 코드를 추가합니다.

appKey / secretKey 는 DFINERY Console 에서 확인하실 수 있습니다. 

 

DFINERY Console : https://console.dfinery.io/

 

Swift Obj-C 
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;
}

 

[[인용:안내:보통]] 축하합니다!!!

DFINERY 이용을 위한 기본적인 연동이 완료되었습니다.
이용할 수 있는 기능은 다음과 같습니다.
1. DAU, MAU, 일별 리텐션 등의 지표를 확인할 수 있는 리포팅
2. NCPI 와 같은 앱 유입 캠페인

이후 DFINERY SDK의 추가 API 연동을 위해서는 아래 가이드에 따라 연동을 진행해 주시길 부탁드립니다.
연동 가이드 : DFINERY SDK 연동가이드 [iOS]

 

 

연동 지원

SDK 에 대한 연동 지원이 필요하실 경우 아래 E-mail 로 연락을 부탁드립니다.

연동 지원 이메일 : support@adbrixsupport.zendesk.com

 

 

 

 

관련 문서

클릭하여 고객지원팀에게 문의하기

답을 찾지 못하였나요? 걱정하지 마시고, 고객지원팀에게 문의주세요!

INDEX