安卓

Hive Adkit for ADOP: Android¶

安装¶

下载并解压Hive Adkit的最新版本。
将Adkit.gradle文件复制到项目应用的路径中。
在项目应用的build.gradle文件中添加以下内容。

apply from: '(path to adkit.gradle file)/adkit.gradle'

dependencies {
    // ...(코드 생략)

    // Hive AdKit 라이브러리 추가
    implementation "com.com2us.android:hive-adkit-adop:1.5.1"
}

设置¶

在 Android 项目中创建的 AndroidManifest.xml 文件中添加 ca-app-pub-XXXXX~YYYYY 格式的 AdMobId 值和 ADOP APP_DOMAIN。

Warning

从 AdKit 1.5.1 版本开始，之前使用的 APP_KEY 已更改为 APP_DOMAIN。APP_DOMAIN 与现有的 APP_KEY 不兼容，因此为了初始化 Hive AdKit，您需要重新申请 APP_DOMAIN。有关 APP_DOMAIN 的信息，请联系 TechLabs 平台业务部运营团队。

<application>
    …
    <meta-data
        android:name="com.google.android.gms.ads.APPLICATION_ID"
        android:value="ca-app-pub-XXXXX~YYYYY"/>
    <meta-data
        android:name="com.google.android.gms.ads.AD_MANAGER_APP"
        android:value="true"/>
    <meta-data
        android:name="com.adop.sdk.APP_DOMAIN"
        android:value="INSERT_YOUR_APP_DOMAIN"/>
    …
</application>

应用¶

ADOP Proguard 设置¶

如果您正在使用Proguard，则需要添加以下ADOP Proguard设置。

-keep class com.adop.sdk.** { *; }
-keep class ad.helper.openbidding.** { *; }
-keep class com.adop.sdk.adapter.**{ *; }
-keepnames class * implements java.io.Serializable
-keepclassmembers class * implements java.io.Serializable {
    static final long serialVersionUID;
    private static final java.io.ObjectStreamField[] serialPersistentFields;
    !static !transient <fields>;
    private void writeObject(java.io.ObjectOutputStream);
    private void readObject(java.io.ObjectInputStream);
    java.lang.Object writeReplace();
    java.lang.Object readResolve();
}
-keepclassmembers class * {
    @android.webkit.JavascriptInterface <methods>;
}

# Pangle
-keep class com.bytedance.sdk.** { *; }
-keep class com.bykv.vk.openvk.component.video.api.** { *; }

# Tapjoy
-keep class com.tapjoy.** { *; }
-keep class com.moat.** { *; }
-keepattributes JavascriptInterface
-keepattributes *Annotation*
-keep class * extends java.util.ListResourceBundle {
protected Object[][] getContents();
}
-keep public class com.google.android.gms.common.internal.safeparcel.SafeParcelable {
public static final *** NULL;
}
-keepnames @com.google.android.gms.common.annotation.KeepName class *
-keepclassmembernames class * {
@com.google.android.gms.common.annotation.KeepName *;
}
-keepnames class * implements android.os.Parcelable {
public static final ** CREATOR;
}
-keep class com.google.android.gms.ads.identifier.** { *; }
-dontwarn com.tapjoy.**

ADOP 测试广告键¶

必须使用ADOP发放的广告密钥而不是AdMob。

var bannerZoneId = "944fe870-fa3a-4d1b-9cc2-38e50b2aed43"
var interstitialZoneID = "e9acd7fc-a962-40e4-aaad-9feab1b4f821"
var rewardVideoZoneId = "7d9a2c9e-5755-4022-85f1-6d4fc79e4418"
var appOpenAdZoneId = "33906f96-dae8-4790-8ce4-d1f287ba00b2"

Hive AdKit 初始化¶

Hive 在进行 AdKit 初始化时，如果是欧洲和英国（EEA & UK）地区，将自动显示 GDPR 同意弹窗。在其他地区将直接进行初始化。

如果游戏以欧洲和英国（EEA & UK）地区为目标，请确保 GDPR 同意弹窗已根据GDPR 消息编写指南进行设置。

import com.com2us.hive.adkit.*

// 상용
AdKit.InitializeWithShowGDPRConsent(this.activity, false, null) {
    /* 
    동의 = 1, 비동의 = 0, 알수없음 = -1, 필요없음 = -2
    초기화 완료 콜백으로 GDPR 동의 상태 결과 값 consentState가 전달됩니다. 결과값에 따른 별도 처리가 필요하지 않습니다. 
    */
    Log.d("HIVEAdKit", "InitializeWithShowGDPRConsent onComplete consentState : $it")
}

// GDPR EEA 테스트모드
AdKit.InitializeWithShowGDPRConsent(this.activity, true, gdprTestDeviceId) {
    /* 
    동의 = 1, 비동의 = 0, 알수없음 = -1, 필요없음 = -2
    초기화 완료 콜백으로 GDPR 동의 상태 결과 값 consentState가 전달됩니다. 결과값에 따른 별도 처리가 필요하지 않습니다. 
    */
    Log.d("HIVEAdKit", "InitializeWithShowGDPRConsent onComplete consentState : $it")
}

可以在分析日志发生时包含用户的附加信息并传递。传递JSONObject类型的数据。

>val data = JSONObject()
data.put("level", 1)
data.put("gold",100)
AdKit.SetAdditionalInfo(data)

RewardVideo 类型广告¶

这是一个在观看超过一定时间后会给予奖励的奖励型广告。一次只能加载一个广告。

// RewardVideo Instance Create
var rewardVideo:RewardVideo? = null
rewardVideo = RewardVideo.Initialize(this.activity, rewardVideoZoneId, object : EventHandlers() {
    override fun onAdLoaded() {}
    override fun onAdOpening() {}
    override fun onAdClosed() {}
    override fun onAdFailed() {}
    override fun onAdClick() {}
    override fun onAdReward() {}
})

// RewardVideo Load
rewardVideo?.LoadAd("NativeRewardVideo-Load")

// RewardVideo Show
rewardVideo?.Show("NativeRewardVideo-Show")

可以传递包括广告位置数据在内的信息。在Load成功时刻和通过Show展示时刻传递设置的字符串。

插页式广告¶

占据整个屏幕的全屏广告。

// Interstitial Instance Create
var interstitial:Interstitial? = null
interstitial = Interstitial.Initialize(this.activity, interstitialZoneId, object : EventHandlers() {
    override fun onAdLoaded() {}
    override fun onAdOpening() {}
    override fun onAdClosed() {}
    override fun onAdFailed() {}
    override fun onAdClick() {}
})

// Interstitial Load
interstitial?.LoadAd("NativeInterstitial-Load")

// Interstitial Show
interstitial?.Show("NativeInterstitial-Show")

可以传递包含广告位置数据的内容。在Load成功时刻和通过Show设置的字符串传递展示时刻。

这是一个占据屏幕部分的滚动横幅。可以通过输入BannerPosition值或特定的yPos值来调整横幅位置。当输入yPos值来调整横幅位置时，横幅位置会在底部对齐状态下向上移动指定的yPos值。

// BannerPosition을 설정하는 예제입니다.
// Banner Instance Create
var adaptiveBanner: AdaptiveBanner? = null

// Create AdaptiveBanner Instance at Top of View
adaptiveBanner = AdaptiveBanner.Initialize(this.activity, bannerZoneId, AdaptiveBanner.BannerPosition.Top, object : EventHandlers() {
   override fun onAdLoaded() {}
   override fun onAdOpening() {}
   override fun onAdClosed() {}
   override fun onAdFailed() {}
   override fun onAdClick() {}
})

// Create AdaptiveBanner Instance at Bottom of View
adaptiveBanner = AdaptiveBanner.Initialize(this.activity, bannerZoneId, AdaptiveBanner.BannerPosition.Bottom, object : EventHandlers() {
   override fun onAdLoaded() {}
   override fun onAdOpening() {}
   override fun onAdClosed() {}
   override fun onAdFailed() {}
   override fun onAdClick() {}
})

// AdaptiveBanner Load & Automatic show
adaptiveBanner?.LoadAd("NativeAdaptiveBanner-Load")

// Destroy AdaptiveBanner
adaptiveBanner?.Destroy()

// yPos 값을 지정하여 사용하는 예제입니다.
// Banner Instance Create
var adaptiveBanner: AdaptiveBanner? = null
adaptiveBanner = AdaptiveBanner.Initialize(this.activity, bannerZoneId, yPos, object : EventHandlers() {
   override fun onAdLoaded() {}
   override fun onAdOpening() {}
   override fun onAdClosed() {}
   override fun onAdFailed() {}
   override fun onAdClick() {}
})

// Banner Load
adaptiveBanner?.LoadAd("NativeAdaptiveBanner-Load")

// Banner Show
adaptiveBanner?.Show("NativeAdaptiveBanner-Show")

// Banner Hide
adaptiveBanner?.Hide()

// yPos 값에 따라 위치 변경
adaptiveBanner?.setPosition(yPos)

可以传递包括广告位置数据在内的信息。成功时刻通过Load传递，并通过Show传递设置的字符串。

AppOpen 类型广告¶

当应用状态从后台切换到前台时显示的应用打开广告。

// Create AppOpenAd Instance
var appOpenAd: AppOpenAd? = null    
appOpenAd = AppOpenAd.Initialize(this.activity, appOpenAdZoneId, object : EventHandlers() {
    override fun onAdLoaded() {}
    override fun onAdOpening() {}
    override fun onAdClosed() {}
    override fun onAdFailed() {}
})

// Automatically load & show AppOpenAd when the app comes to the foreground
appOpenAd?.LoadAd("NativeAppOpen-Load")

// Destroy AppOpenAd
appOpenAd?.Destroy()

测试广告¶

在开发过程中，重要的是要设置测试广告，以便点击测试广告不会向广告主收取费用。如果在非测试模式下过多点击广告，可能会因无效活动而导致账户被举报，从而阻止广告接收。有关测试广告的使用方法，请访问Google 开发者网站。

移除¶

恢复安装时设置的文件。

安卓