1. 广告位回调

1.1 ATAdInfo回调信息说明

方法	返回值类型	说明
getNetworkFirmId()	int	获取广告平台对应的ID，用于区分广告平台，参考文档末尾的 Network Firm Id Table
getNetworkPlacementId()	String	获取广告平台的广告位ID
getAdsourceId()	String	获取广告源ID. 可在开发者后台或Taku Open API 通过广告源ID查询具体的Network信息
getAdsourceIndex()	int	获取当前广告源在WaterFall中的排序（从0开始，0优先级最高）
getEcpm()	double	获取Taku预估eCPM。即每次广告展示的预估eCPM：常规广告源是Taku后台对应广告源填写的排序价格，竞价广告源是实时竞价返回的价格。eCPM的货币单位可通过currency获取，通常为元（CNY）或美元（USD），精度可通过precision获取。 eCPM含义：每千次广告展示收益。假设广告源A的eCPM=1美元，则展示一次广告源A之后，展示收益为0.001美元。
getEcpmPrecision()	String	获取eCPM精度 "publisher_defined"：开发者在Taku后台为广告源定义的eCPM（交叉推广的eCPM也属于该类型) "estimated": 在Taku后台开启广告源的自动价格功能后，Taku根据历史数据计算出的eCPM "exact"：实时竞价的eCPM (Meta广告平台除外) "ecpm_api"：针对Meta广告源生效，根据Meta的ReportAPI数据预估的历史eCPM API。Taku SDK v5.9.60及以上版本支持。
getCurrency()	String	获取 Taku收益货币单位。根据返回的货币单位，确定当前eCPM或收益的价格，通常为元（CNY）或美元（USD）。例如："USD"，则返回的价格为“美元”，getEcpm()和getPublisherRevenue()两个方法返回的价格单位均为“美元”。
isHeaderBiddingAdsource()	int	是否为头部竞价的广告源，1：是，0：否
getShowId()	int	获取每次展示广告时生成的独立ID
getPublisherRevenue()	double	获取 Taku广告位展示收益。即每次广告展示后，预估可获得的收益。单位可通过currency获取，通常为元（CNY）或美元（USD），精度可通过 precision 获取。
getCountry()	String	获取国家代码，例如：”CN"
getPlacementId()	String	获取 Taku广告位ID
getAdFormat()	String	获取广告类型，包括："Native"、"RewardedVideo"、"Banner""Interstitial"、"Splash"
getAdNetworkType()	String	获取 Network类型 "Network"：第三方广告平台 "Cross_Promotion"：交互推广 "Adx"：Taku Adx
getEcpmLevel()	int	获取广告源的eCPM层级(对应开发者后台聚合管理页面的优先级），头部竞价广告源默认为0
getSegmentId()	int	获取流量分组ID
getScenarioId()	String	获取广告场景ID
getScenarioRewardName()	String	获取广告场景的激励名称，仅Rewarded Video支持
getScenarioRewardNumber()	int	获取广告场景的激励数量，仅Rewarded Video支持
getSubChannel()	String	获取子渠道信息
getChannel()	String	获取渠道信息
getCustomRule()	String	获取 Placement+App维度的自定义规则的Json字符串
getABTestId()	String	获取 AB测试ID。具体AB测试ID可以从AB测试页面查询。
getExtInfoMap()	Map	获取广告的自定义信息，针对Adx、OnlineAPI、直投广告、交叉推广以及自定义广告平台，Adx、OnlineAPI、直投广告、交叉推广相关Key参考 ATAdConst.NETWORK_CUSTOM_KEY 获取Admob展示收益信息（展示后可获取），相关Key参考 Admob展示收益KEY 获取百度c2s加密的价格（展示后可获取），相关Key参考 BaiDu KEY
getLocalExtra()	Map	获取加载广告前传入的本地参数。
getPlacementType()	int	获取广告位类型 1：真实广告位 2：共享广告位
getSharedPlacementId()	String	获取共享广告位id，仅展示共享广告位缓存时返回
getBidFloor()	double	返回Taku后台配置竞价广告源竞价底价
getDismissType()	int	获取关闭类型，仅激励视频、插屏广告、开屏广告支持具体枚举值见ATAdConst.DISMISS_TYPE
getAdSourceAdType()	int	获取当前广告源广告类型 (v6.2.90+支持) 0：Native 1：Rewarded 2：Banner 3：Interstitial 4：Splash 当激励视频广告位使用激励视频广告源时，返回1；当激励视频广告位使用插屏广告源时，返回3，使用开屏广告源时，返回4；
getAdSourceCustomExt()	String	获取在Taku后台广告源配置的自定义参数（v6.2.90+支持）
getNetworkName()	String	（v6.3.10+）获取 Network名称
getShowCustomExt()	String	（v6.3.10+）获取展示时传入的自定义参数，对应ATShowConfig#setShowConfig()传入的参数
getEncEcpmInfo()	String	（v6.3.65+）获取加密后的ecpm信息
getSecretId()	int	（v6.3.65+）获取解密ecpm信息的私钥id，可以通过这个id在 "Taku后台-帐号管理-key" 找到相应的私钥去解密
getBidType()	int	（v6.4.60+）获取广告源竞价类型，0：常规源；1：S2S；2：C2S
toString()	String	获取所有回调信息的Json字符串，所有key值如下： "id"：对应getShowId() "publisher_revenue"：对应getPublisherRevenue() "currency"：对应 getCurrency() "country"：对应 getCountry() "adunit_id"：对应 getPlacementId() "adunit_format"：对应 getAdFormat() "precision"：对应 getEcpmPrecision() "network_type"：对应 getAdNetworkType() "network_placement_id"：对应 getNetworkPlacementId() "ecpm_level"：对应 getEcpmLevel() "segment_id"：对应 getSegmentId() "scenario_id"：对应 getScenarioId() "scenario_reward_name"：对应 getScenarioRewardName() "scenario_reward_number"：对应 getScenarioRewardNumber() "channel"：对应 getChannel() "sub_channel"：对应 getSubChannel() "custom_rule"：对应 getCustomRule() "network_firm_id"：对应 getNetworkFirmId() "adsource_id"：对应 getAdsourceId() "adsource_index"：对应 getAdsourceIndex() "adsource_price"：对应 getEcpm() "adsource_isheaderbidding"：对应 isHeaderBiddingAdsource() "abtest_id"：对应getABTestId() "ext_info"：对应 getExtInfoMap() "reward_custom_data"：对应ATAdConst.KEY.USER_CUSTOM_DATA "user_load_extra_data"：对应 getLocalExtra() "placement_type"：对应 getPlacementType() "shared_placement_id"：对应 getSharedPlacementId() "bid_floor"：对应 getBidFloor() "dismiss_type"：对应 getDismissType() "ad_source_type": 对应getAdSourceAdType() "ad_source_custom_ext": 对应getAdSourceCustomExt() "network_name": 对应getNetworkName() "show_custom_ext": 对应getShowCustomExt() "e_c": 对应getEncEcpmInfo() "s_id": 对应getSecretId()

1.1.1 ATAdConst.NETWORK_CUSTOM_KEY

Key	说明
OFFER_ID	Adx、OnlineAPI 、直投广告、交叉推广 Offer的广告 ID
CREATIVE_ID	Adx 、直投广告、 OnlineAPI Offer的素材 ID
IS_DEEPLINK_OFFER	判断Adx、OnlineAPI 、直投广告、交叉推广Offer的单子类型是否为Deeplink或JumpURL的单子 0：否 1：是

1.1.2 BaiDu KEY

Key	说明
EN_P_KEY	获取百度c2s加密的价格

2. 广告源回调

2.1 回调说明

激励视频广告，插屏广告，开屏广告，横幅广告，原生广告新增广告源层级事件回调监听

方法	说明
onAdSourceBiddingAttempt(ATAdInfo atAdInfo)	竞价广告源开始竞价回调 atAdInfo：广告的信息对象，可区分广告平台，主要包含第三方聚合平台的id信息见ATAdInfo信息说明
onAdSourceBiddingFilled(ATAdInfo atAdInfo)	竞价广告源竞价成功回调参数意义同上
onAdSourceBiddingFail(ATAdInfo adInfo, AdError adError)	竞价广告源竞价失败回调 atAdInfo：参数意义同上 adError：竞价失败信息，可通过AdError.getFullErrorInfo()获取全部错误信息，请参考 AdError
onAdSourceAttempt(ATAdInfo adInfo)	广告源开始加载回调参数意义同上
onAdSourceLoadFilled(ATAdInfo adInfo)	广告源广告填充回调参数意义同上
onAdSourceLoadFail(ATAdInfo adInfo, AdError adError)	广告源加载失败回调参数意义同上

2.2 示例代码

ATAdSourceStatusListener adSourceStatusListener = new ATAdSourceStatusListener() {
    @Override
    public void onAdSourceBiddingAttempt(ATAdInfo adInfo) {
        Log.i(TAG, "onAdSourceBiddingAttempt: " + adInfo.toString());
    }

    @Override
    public void onAdSourceBiddingFilled(ATAdInfo adInfo) {
        Log.i(TAG, "onAdSourceBiddingFilled: " + adInfo.toString());
    }

    @Override
    public void onAdSourceBiddingFail(ATAdInfo adInfo, AdError adError) {
        Log.i(TAG, "onAdSourceBiddingFail Info: " + adInfo.toString());
        Log.i(TAG, "onAdSourceBiddingFail error: " + adError.getFullErrorInfo());
    }

    @Override
    public void onAdSourceAttempt(ATAdInfo adInfo) {
        Log.i(TAG, "onAdSourceAttemp: " + adInfo.toString());
    }

    @Override
    public void onAdSourceLoadFilled(ATAdInfo adInfo) {
        Log.i(TAG, "onAdSourceLoadFilled: " + adInfo.toString());
    }

    @Override
    public void onAdSourceLoadFail(ATAdInfo adInfo, AdError adError) {
        Log.i(TAG, "onAdSourceLoadFail Info: " + adInfo.toString());
        Log.i(TAG, "onAdSourceLoadFail error: " + adError.getFullErrorInfo());
    }
};

atRewardVideoAd.setAdSourceStatusListener(adSourceStatusListener);//激励视频广告
//atInterstitial.setAdSourceStatusListener(adSourceStatusListener);//插屏广告
//atSplashAd.setAdSourceStatusListener(adSourceStatusListener);//插屏广告
//atNative.setAdSourceStatusListener(adSourceStatusListener);//原生广告
//atBannerView.setAdSourceStatusListener(adSourceStatusListener);//横幅广告

3.三方收益回传

在以下广告类型的相应回调获取收益值等相关信息进行三方收益回传操作

横幅广告

mBannerView.setAdRevenueListener(new ATAdRevenueListener() {
    @Override
    public void onAdRevenuePaid(ATAdInfo adInfo) {
        // 获取收益值
        // adInfo.getPublisherRevenue();
        // adInfo.getEcpm();
    }
});

原生广告

mNativeAd.setAdRevenueListener(new ATAdRevenueListener() {
    @Override
    public void onAdRevenuePaid(ATAdInfo adInfo) {
        // 获取收益值
        // adInfo.getPublisherRevenue();
        // adInfo.getEcpm();
    }
});

插屏广告

mInterstitialAd.setAdRevenueListener(new ATAdRevenueListener() {
    @Override
    public void onAdRevenuePaid(ATAdInfo adInfo) {
        // 获取收益值
        // adInfo.getPublisherRevenue();
        // adInfo.getEcpm();
    }
});

激励视频

mRewardVideoAd.setAdRevenueListener(new ATAdRevenueListener() {
    @Override
    public void onAdRevenuePaid(ATAdInfo adInfo) {
        // 获取收益值
        // adInfo.getPublisherRevenue();
        // adInfo.getEcpm();
    }
});

开屏广告

mSplashAd.setAdRevenueListener(new ATAdRevenueListener() {
    @Override
    public void onAdRevenuePaid(ATAdInfo adInfo) {
        // 获取收益值
        // adInfo.getPublisherRevenue();
        // adInfo.getEcpm();
    }
});

Android接入指南