🔥$200/月畅享Tenjin完整访问权限 - 解锁全部功能，无隐藏费用，随时可取消 查看定价和功能

注册
查看类别

Android – Topon（中文）

阅读时间 4 分钟

本指南介绍了如何从 TopOn 向 Tenjin 发送展示级收入数据（ILRD）。该集成通过监看 TopOn SDK 的特定回调函数 onAdRevenuePaid(ATAdInfo adInfo) 来实现，该回调函数会在每次广告展示产生收入时触发。随后，包含详细收入数据的 ATAdInfo 对象会被传递给 Tenjin SDK。

本指南提供了将广告展示层级收入数据（ILRD）从 TopOn 发送到 Tenjin 的实现方法。该集成通过监听 TopOn SDK 的一个特定回调 onAdRevenuePaid(ATAdInfo adInfo) 来工作，每当一次广告展示产生收益时，该回调便会触发。这个包含详细收益数据的 ATAdInfo 对象随后会被传递给 Tenjin SDK。

步骤 1：验证项目依赖项 #

在您应用模块的 build.gradle 文件中，请确保已包含必要的依赖项。

  1. 最新版 TopOn SDK 最新的 TopOn SDK
  2. 广告网络适配器：您 必须 为计划通过 TopOn 进行聚合的每个广告网络（例如：AdMob、AppLovin、Unity Ads、Meta 等）添加相应的适配器。 广告平台适配器： 您 必须 为每个希望通过 TopOn 进行聚合的广告平台添加相应的适配器（例如：AdMob、AppLovin、Unity Ads、Meta 等）。
Java
// Example: app/build.gradle
dependencies {
    // 1. TopOn (AnyThink) SDK Core

    implementation 'com.anythink.sdk:core:6.4.17'

    // 2. Adapters for ALL supported ad networks 所有支持的广告平台的 Adapter
    implementation 'com.anythink.sdk:adapter-admob:6.4.17'
    implementation 'com.anythink.sdk:adapter-applovin:6.4.17'
    implementation 'com.anythink.sdk:adapter-unityads:6.4.17'
    implementation 'com.anythink.sdk:adapter-meta:6.4.17'

    // ... add every other adapter you use 添加您使用的所有其他 adapter
}

步骤 2：初始化 SDK #

在您的主 Activity 的 onCreate 方法中，初始化 Tenjin 和 TopOn 的 SDK。

Java
import com.anythink.core.api.ATSDK;
import com.tenjin.android.TenjinSDK;
// ... other imports

public class YourMainActivity extends Activity {
    private TenjinSDK tenjinInstance;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        // ... your other setup code

        // 1. Initialize Tenjin 初始化 Tenjin
        tenjinInstance = TenjinSDK.getInstance(this, "<Your Tenjin API Key>");

        // 2. Initialize TopOn 初始化 TopOn
        ATSDK.init(getApplicationContext(), "<Your TopOn App ID>", "<Your TopOn App Key>");

        // 3. Load your ads 加载您的广告
        loadAllAdFormats();
    }
    // ...
}

Step 3: 为每种广告格式实现收益追踪 #

You must implement the revenue listener for every Ad Format you use. If tracking is missing for even one format (e.g., Rewarded Video), all impressions from it will be missed by Tenjin. The correct method is to set an ATAdRevenueListener and call Tenjin’s eventAdImpressionTopOn() method from inside the onAdRevenuePaid() callback.

Java
private void loadBannerAd() {
    ATBannerView mBannerView = new ATBannerView(this);
    mBannerView.setPlacementId("<Your_Banner_Placement_ID>");
    // ... add the banner view to your layout ...

    // Set the revenue listener 设置收益监听
    mBannerView.setAdRevenueListener(new ATAdRevenueListener() {
        @Override
        public void onAdRevenuePaid(ATAdInfo adInfo) {
            // Send revenue data to Tenjin for every impression, including auto-refreshes
            // 为每一次广告展示（包括自动刷新）向 Tenjin 发送收益数据
            if (tenjinInstance != null) {
                tenjinInstance.eventAdImpressionTopOn(adInfo);
            }
        }
    });

    mBannerView.loadAd();
}

B. 插屏广告 (Interstitial) #

Java
private void loadInterstitialAd() {
    ATInterstitial mInterstitialAd = new ATInterstitial(this, "<Your_Interstitial_Placement_ID>");

    // Set the revenue listener
    // 设置收益监听器
    mInterstitialAd.setAdRevenueListener(new ATAdRevenueListener() {
        @Override
        public void onAdRevenuePaid(ATAdInfo adInfo) {
            // Send revenue data to Tenjin
            // 向 Tenjin 发送收益数据
            if (tenjinInstance != null) {
                tenjinInstance.eventAdImpressionTopOn(adInfo);
            }
        }
    });

    mInterstitialAd.load();
}

C. 奖励视频广告 (Rewarded Video) #

Java
private void loadRewardedVideoAd() {
    ATRewardVideoAd mRewardVideoAd = new ATRewardVideoAd(this, "<Your_Rewarded_Placement_ID>");

    // Set the revenue listener
    // 设置收益监听器
    mRewardVideoAd.setAdRevenueListener(new ATAdRevenueListener() {
        @Override
        public void onAdRevenuePaid(ATAdInfo adInfo) {
            // Send revenue data to Tenjin
            // 向 Tenjin 发送收益数据
            if (tenjinInstance != null) {
                tenjinInstance.eventAdImpressionTopOn(adInfo);
            }
        }
    });

    mRewardVideoAd.load();
}

D. 原生广告 (Native) 和开屏广告 (Splash) #

对于您使用的任何其他广告格式，例如原生广告（ATNativeAd）和开屏广告（ATSplashAd），您都必须遵循 完全相同的模式。每个广告对象都需要有自己的 ATAdRevenueListener。

步骤 4：解决 SDK 代理冲突 #

如果您使用其他也需要追踪 TopOn 广告收益的服务（例如 Firebase, GameAnalytics 等），可能会遇到冲突。一个事件只能设置一个监听器。

  • 问题： 广告展示数据在某个服务中显示正常，但在 Tenjin 中却有缺失。
  • 解决方案： 不要设置多个监听器。相反，找到您的其他服务接收 onAdRevenuePaid 回调中 ATAdInfo 对象的位置。在同一个地方，添加对 Tenjin 的调用，以确保两个服务都能收到数据。
Java
// Example of resolving a listener conflict
// 解决监听器冲突的示例
public void onAdRevenuePaid(ATAdInfo adInfo) {
    // 1. Call for your other service
    // 1. 为您的其他服务发起调用
    callMyOtherAnalyticsService(adInfo);

    // 2. [CRITICAL] Add the call to Tenjin in the same place
    // 2. [关键] 在同一个地方添加对 Tenjin 的调用
    if (tenjinInstance != null) {
        tenjinInstance.eventAdImpressionTopOn(adInfo);
    }
}
您的感觉是什么