Skip to content

CartySdk接入说明

要求

  • Android Studio Giraffe+
  • Gradle 7+, minSdk 21

添加SDK依赖

groovy

dependencies {
    implementation "io.carty.bidad:carty-sdk:+"
}

申请权限

xml

<uses-permission android:name="android.permission.INTERNET" /><!-- 必要 -->
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" /><!-- 可选 -->
<uses-permission android:name="com.google.android.gms.permission.AD_ID" /><!-- 可选 -->

初始化

建议在Application的onCreate方法中调用SDK初始化。

  • Java
java

CTAdConfig adConfig = new CTAdConfig.Builder()
        .setAppId("YOUR_APP_ID")// [必要] carty开发者后台生成的appId
        .setChannel("YOUR_APP_CHANNEL")// [可选] 媒体应用渠道
        .setDebug(BuildConfig.DEBUG)// [可选] debug日志开关
        .build();

CTAdSdk.init(applicationContext, adConfig, new CTAdSdk.CTInitListener() {
    @Override
    public void onInitSuccess() {
    }

    @Override
    public void onInitFailed(CTAdError adError) {
    }
});
  • Kotlin
kotlin

val adConfig = CTAdConfig.Builder()
    .setAppId("YOUR_APP_ID")// [必要] carty开发者后台生成的appId
    .setChannel("YOUR_APP_CHANNEL")// [可选] 媒体应用渠道
    .setDebug(BuildConfig.DEBUG)// [可选] debug日志开关
    .build()
CTAdSdk.init(this, adConfig, object : CTAdSdk.CTInitListener {
    override fun onInitSuccess() {
    }
    override fun onInitFailed(adError: CTAdError) {
    }
})

全局配置

建议在SDK初始化前调用。

  • Java
java

// 是否使用系统浏览器打开落地页
CTGlobalSettings.getInstance().setSystemBrowser(true);
// 媒体侧记录的用户ID,激励广告关联用户奖励使用
CTGlobalSettings.getInstance().setExternalUid("test_uid");
  • Kotlin
kotlin

// 是否使用系统浏览器打开落地页
CTGlobalSettings.getInstance().isSystemBrowser = true
// 媒体侧记录的用户ID,激励广告关联用户奖励使用
CTGlobalSettings.getInstance().externalUid = "test_uid"

GitHub示例

CartySDKAndroid