시작하기

캐시블록 Android용 SDK에서 제공하는 서비스를 연동하기 전 완료해야 하는 설정에 대해 알아 보세요.

🌈 ADCash V2.1.0.0 이상 버전을 위한 가이드 입니다.

---

2.1.0.0 이전 버전의 가이드 -> Previous Version

요구사항

요구 사양은 CashBlock Android용 SDK의 최신 상태를 기준으로 명시됩니다.

---

안정적인 광고 플랫폼 및 개선된 수익화 기능의 탑재와 Android OS와의 호환성을 위해 최신 버전으로 업데이트하는 것을 권장합니다.

• minSdkVersion -> 16 (JelleyBean)

  • Android 5.0(API Level 21) 이상을 권장합니다.

  • Android 5.0 미만의 버전에서 "실시간 고객 응대 서비스", "일부 광고 노출"이 제한 됩니다.

• Android Studio -> 3.2 이상

  • 최신 버전의 IDE 사용을 권장합니다.

• Android gradle plugin -> 4.0.1 이상

• Google Play 타겟 API 수준 -> compileSdkVersion 33

• Kotlin version 1.6.20

• Support AndroidX

---

연동키 발급

CashBlock Android SDK을 연동하려면 연동하려는 앱의 고유 식별자가(AppId/AppSecret) 필요합니다. 연동키는 아바티 영업 담당자([e-mail])를 통해 발급이 가능 합니다. 정식으로 발급된 연동키를 사용해야만 정산이 가능 합니다.

---

• AppID -> ADCash를 연동하는 앱별로 부여하는 고유 식별자입니다.

• AppSecret -> ADCash를 연동하는 앱별로 부여하는 고유 식별자의 값을 검증하는 고유값입니다.

key	value
AppID	98d4d4c35d594451b21f54718e2bc986
AppSecret	c395dbe200ad4493ade96fb92c988fcf1c8df2d3687d49a9ab6f31f7c05e2bf4

---

원격 저장소(Repository) 설정

build.gradle

프로젝트 수준의 "build.gradle" 파일에 다음 항목을 추가 합니다.

// build.gradle(project)
allprojects {
  repositories {
    google()
    mavenCentral()
    maven { url "https://jitpack.io" }
    maven { url 'https://artifact.bytedance.com/repository/pangle' }
    maven { url 'https://devrepo.kakao.com/nexus/content/groups/public/' }
    maven { url 'https://dl.cloudsmith.io/public/avatye/Android-CashBlock/maven/' }
    maven {
      url "s3://repo.cauly.net/releases"
      credentials(AwsCredentials) {
        accessKey "AKIAWRZUK5MFKYVSUOLB"
        secretKey "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"
      }
    }
  }
}

settings.gradle

AGP 7.1.0 이상 또는 Android Studio Bumblebee 이상 사용시

// setting.gradle
pluginManagement {
  repositories {
    gradlePluginPortal()
    google()
    mavenCentral()
  }
}
dependencyResolutionManagement {
  repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
  repositories {
    google()
    mavenCentral()
    maven { url "https://jitpack.io" }
    maven { url 'https://artifact.bytedance.com/repository/pangle' }
    maven { url 'https://devrepo.kakao.com/nexus/content/groups/public/' }
    maven { url 'https://dl.cloudsmith.io/public/avatye/Android-CashBlock/maven/' }
    maven {
      url "s3://repo.cauly.net/releases"
      credentials(AwsCredentials) {
        accessKey "AKIAWRZUK5MFKYVSUOLB"
        secretKey "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"
      }
    }
  }
}

---

기본 모듈 적용

명시된 버전을 사용해주세요.

---

2.1.0.8 (released : 2024.03.04)

기본 블록을 앱(모듈) 수준의 "build.gradle" 파일에 설정하세요.

dependencies {
  implementation 'com.avatye.cashblock:unit-adcash:{SDK-VERSION}'
}

SDK 초기화

Application의 “onCreate()"에서 ADCash Android SDK를 초기화 하세요.

---

Application Class 설정이 없을 경우 앱이 실행되지 않으며, 앱이 강제 종료 되는 문제가 발생합니다. Android 5.0(API Level 21) 하위 버전을 지원하는 앱의 경우 Multidex 적용이 필요합니다. 사용중인 Application Class가 없다면 새로운 Application Class를 생성 후 AndroidManifest.xml 항목에 추가 합니다.

ADCashSDK(builder)

KOTLIN

ADCashSDK.Builder

class ADCashSDK.Builder(
  // android context
  val context: Context, 
  // 앱 고유 식별자
  val appId: String, 
  // 앱 고유 식별자 검증키
  val appSecret: String
): Builder

---

ADCashSDK.Builder Option

// ADCashSDK.Builder option
// 앱의 스토어주소를 설정 합니다.
ADCashSDK.Builder.setStoreUrl(url: String)
// 연령 제한 설정
// 기본값 true(광고 노출)
// isVerified -> false 광고 노출이 제한됩니다.
ADCashSDK.Builder.setAgeVerified(isVerified: Boolean)

---

Usage

// application - initialze
class App: Application() {
  override fun onCreate() {
    super.onCreate()
    val builder = ADCashSDK.Builder(
      context = this,
      appId = "98d4d4c35d594451b21f54718e2bc986",
      appSecret = "c395dbe200ad4493ade96fb92c988fcf1c8df2d3687d49a9ab6f31f7c05e2bf4"
    )
    // 앱의 스토어주소를 설정 합니다.
    builder.setStoreUrl(url = "https://www.avatye.com")
    // 초기화를 진행합니다.
    builder.build()
  }
}

JAVA

ADCashSDK.Builder

public class ADCashSDK.Builder(
  // android context
  Context context,
  // 앱 고유 식별자
  String appId,
  // 앱 고유 식별자 검증키
  String appSecret
)

---

ADCashSDK.Builder Option

// ADCashSDK.Builder option
// 앱의 스토어주소를 설정 합니다.
ADCashSDK.Builder.setStoreUrl(final String url)
// 연령 제한 설정
// 기본값 true(광고 노출)
// isVerified -> false 광고 노출이 제한됩니다.
ADCashSDK.Builder.setAgeVerified(final Boolean isVerified)

---

Usage

// application - initialze
public class App extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    final ADCashSDK.Builder builder = new ADCashBuilder(
      //context
      this,
      //appid
      "98d4d4c35d594451b21f54718e2bc986",
      // appsecret
      "c395dbe200ad4493ade96fb92c988fcf1c8df2d3687d49a9ab6f31f7c05e2bf4"
    );
    // 스토어주소를 설정 합니다.
    builder.setStoreUrl("https://www.avatye.com");
    // 초기화를 진행합니다.
    builder.build();
  }
}