Integration Guide - adbcsdk/Offerwall GitHub Wiki

build.gradle μ„€μ •

build.gradle νŒŒμΌμ— μ•„λž˜μ˜ λ‚΄μš©μ„ μΆ”κ°€ν•©λ‹ˆλ‹€.

(Project script)

allprojects {
    repositories {
        ...
        maven {
            url "https://nexus.adbc.io/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** ⚠️