시작하기(~2.0.0.15)

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

🌀 ADCash 2.0.0.0 ~ 2.0.0.15 버전의 가이드입니다.

요구사항

📘 요구 사양은 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 :CashBlock Android SDK를 연동하는 앱별로 부여하는 고유 식별자입니다.

• AppSecret :CashBlock Android SDK를 연동하는 앱별로 부여하는 고유 식별자의 값을 검증하는 고유값입니다.

연동키 유형	테스트 연동키
AppID	98d4d4c35d594451b21f54718e2bc986
AppSecret	c395dbe200ad4493ade96fb92c988fcf1c8df2d3687d49a9ab6f31f7c05e2bf4

---

원격 저장소(Repository) 설정

build.gradle(project) 구성 사용

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

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 이상 사용시(settings.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.0.0.15 버전까지만 지원 됩니다.

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

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

SDK 초기화

📘 Application의 “onCreate()"에서 ADCashSDK.initialize()"를 호출해 ADCash Android SDK를 초기화 하세요.

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

initialize

KOTLIN

ADCashSDK.initialize(
  context: Context, 
  appId: String, 
  appSecret: String, 
  storeUrl:String? = null
): Unit

JAVA

void ADCashSDK.initialize(Context context, String appId, String appSecret);
void ADCashSDK.initialize(Context context, String appId, String appSecret, String storeUrl);

PARAMETER NAME	PARAMETER TYPE	DESCRIPTION
context	Context	Android Context
appId	String	앱 고유 식별자
appSecret	String	앱 고유 식별자 검증키
storeUrl	String(nullable)	앱스토어 주소(광고 미디에이션에 필요)

KOTLIN

// application - initialze
class App: Application() {
  override fun onCreate() {
    super.onCreate()
    ADCashSDK.initialize(
      context = this,
      appId = "98d4d4c35d594451b21f54718e2bc986",
      appSecret = "c395dbe200ad4493ade96fb92c988fcf1c8df2d3687d49a9ab6f31f7c05e2bf4",
      storeUrl = "https://www.avatye.com"
    )
  }
}

// application(multidex) - initialize
class App: MultidexApplication() {
  override fun onCreate() {
    super.onCreate()
    ADCashSDK.initialize(
      context = this,
      appId = "98d4d4c35d594451b21f54718e2bc986",
      appSecret = "c395dbe200ad4493ade96fb92c988fcf1c8df2d3687d49a9ab6f31f7c05e2bf4",
      storeUrl = "https://www.avatye.com"
    )
  }
}

JAVA

// application - initialze
public class App extends Application {
  @Override
  public void onCreate() {
    super.onCreate();
    CashBlockSDK.initialize(
      /** context **/ this,
      /** appid **/ "98d4d4c35d594451b21f54718e2bc986",
      /** appsecret **/ "c395dbe200ad4493ade96fb92c988fcf1c8df2d3687d49a9ab6f31f7c05e2bf4",
      /** storeUrl **/ "https://www.avatye.com"
    );
  }
}

// application(multidex) - initialize
public class App extends MultidexApplication {
  @Override
  public void onCreate() {
    super.onCreate();
    CashBlockSDK.initialize(
      /** context **/ this,
      /** appid **/ "98d4d4c35d594451b21f54718e2bc986",
      /** appsecret **/ "c395dbe200ad4493ade96fb92c988fcf1c8df2d3687d49a9ab6f31f7c05e2bf4",
      /** storeUrl **/ "https://www.avatye.com"
    );
  }
}