Integration Guide - adbcsdk/Offerwall GitHub Wiki

build.gradle 설정

build.gradle 파일에 아래의 내용을 추가합니다.

(Project script)

allprojects {
    repositories {
        ...
        maven {
            url "http://repo.adbc.io:8081/repository/RewardOfferwall/"
        }
    }
}

(Module script)

dependencies {
    ...
    // adid 사용을 위해 필요
    implementation 'com.google.android.gms:play-services-ads-identifier:17.0.0'

    implementation 'com.adbc.sdk.reward.ow:adbc_reward:1.7@aar'
}



AndroidManifest.xml 설정

개인 식별과 리워드 적립을 위해 아래의 권한이 필요합니다. 권한 설정이 되지 않는 경우 SDK를 사용할 수 없습니다.

<uses-permission android:name="android.permission.INTERNET"/>
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>



Proguard 설정

-keep class com.adbc.sdk.reward.ow.** { *; }
-dontwarn com.adbc.sdk.reward.ow.**



SDK 사용법

SDK 초기화

리워드 오퍼월을 표시하고자 하는 Activity 에서 SDK 를 초기화합니다.

/**
* @params
*   - Context context
*   - String appCode ( 발급받은 매체 코드 )
*   - String userId ( 유저 구분을 위한 ID 값 - 매체 임의 생성 )
*   - OnAdbcRewardListener initListener
* */
AdbcReward.init(Context context, String appCode, String userId, OnAdbcRewardListener listener);

※ 유저 구분값 생성 규칙

  1. 각각의 유저별 고유한 값을 이용해야 합니다.
  2. 개인정보 및 ADID는 사용할 수 없습니다. ( 암호화 후 사용 가능 )
  3. 한글, 특수문자, 공백은 반드시 URL 인코딩 후 사용하셔야 합니다.

OnAdbcRewardListener 결과 값

SDK 초기화 시 결과 값을 listener 로 전달합니다.

/**
* @params
*   - boolean result
*   - String msg( 초기화 실패 시 에러 메시지 )
*   - offerwallBuilder offerwallBuilder( 오퍼월 Activity 호출을 위한 builder 객체 )
* */
public void onResult(boolean result, String msg, OfferwallBuilder offerwallBuilder){ ... }

OfferwallBuilder

SDK 초기화가 완료되면 OfferwallBuilder 객체를 반환합니다.

//오퍼월 상단 타이틀 영역 text ( 미입력 시 '무료 충전소' )
OfferwallBuilder.setTitle(String title);

//광고 참여에 대한 postback 전송 시 전달될 리퍼러 값 ( 매체 개별적 사용 용도의 값 )
OfferwallBuilder.setReferrer(String referrer);

//오퍼월 호출
OfferwallBuilder.showOfferwall(Activity activity);
⚠️ **GitHub.com Fallback** ⚠️