Bidding Android iOS 快应用 SDK H5 SDK Media API 常见问题

iOS聚合接入简介

iOS支持的广告类型映射关系

优量汇广告类型 优量汇聚合功能入口类 穿山甲入口类 快手入口类 百青藤入口类
激励视频 GDTRewardVideoAd BUGDT_NativeExpressRewardVideoAdAdapter KSGDT_RewardVideoAdAdapter BDGDT_RewardVideoAdAdapter
插屏全屏 GDTUnifiedInterstitialAd 插屏模板渲染
BUGDT_NativeExpressInterstitialAdAdapter
插屏自渲染
BUGDT_UnifiedInterstitialAdAdapter
KSGDT_UnifiedInterstitialAdAdapter BDGDT_UnifiedInterstitialAdAdapter
插屏半屏 GDTUnifiedInterstitialAd 插屏模板渲染
BUGDT_NativeExpressInterstitialAdAdapter
插屏自渲染
BUGDT_UnifiedInterstitialAdAdapter
KSGDT_UnifiedInterstitialAdAdapter BDGDT_UnifiedInterstitialAdAdapter
开屏 GDTSplashAd BUGDT_SplashAdAdapter KSGDT_SplasshAdAdapter BDGDT_SplashAdAdapter
原生自渲染 GDTUnifiedNativeAd BUGDT_UnifiedNativeAdAdapter KSGDT_UnifiedNativeAdAdapter BDGDT_UnifiedNativeAdAdapter
模板信息流 GDTNativeExpressAd BUGDT_NativeExpressAdAdapter KSGDT_NativeExpressAdAdapter BDGDT_NativeExpressAdAdapter
横幅 GDTUnifiedBannerView BUGDT_UnifiedBannerAdAdapter 不支持 BDGDT_UnifiedBannerAdAdapter

版本支持情况

快手 SDK:Demo 工程版本为 v3.3.44
穿山甲 SDK:Demo 工程版本为 v5.3.0.3
百青藤SDK:Demo工程版本为 v5.14
注意:因为不同版本中有接口差异,如穿山甲在 v4.1.0.2以上中针对激励视频增加了回调的参数,开发者在切换版本时需要在 Adapter 中自行适配。

详细流程

开发者接入注意事项:

  1. 下载优量汇SDK
    a. Unity开发者,下载Unity SDK


    b. XCode开发者,下载标准版或数据上报版SDK;

  2. 在开发者平台-创建广告位组时配置自定义类名,配置自定义类名有两种方式:
    a. 使用demo中默认的adapter类名,见上方表格映射,此时不需要修改adapter;
    b. 使用自定义adapter类名,此时需要将demo中的adapter类名也要改成自定义后的类名,自定义adapter类名建议使用'AdnName'+'GDT_'+'xxxAd'+'Adapter'的格式,注意输入时不要多引入空格;

  3. 在 Podfile 中添加穿山甲及快手的pod引入,在XCode工程设置中添加相关权限配置,具体需要依据版本参照穿山甲开发者接入文档,快手 SDK 开发者接入文档(无线上链接,需参照离线文档)接入
    (1)podfile 添加依赖示例

    pod 'Ads-CN', '5.3.0.3'
    pod 'KSAdSDK', '3.3.44'
    pod 'BaiduMobAdSDK', '5.14'
    

    (2)XCode工程添加配置,请参照穿山甲 SDK 接入文档中 《XCode设置》及《全局配置》章节及快手 SDK 接入文档中《接入 SDK 》

  4. 若下载的是Unity SDK,将Unity SDK中的 MediationAdapter 文件夹直接复制到开发者项目工程中,并修改类名为步骤2中指定的类名,将GDTUnion-unity.unityPackage文件导入到Unity IDE中。



    若非Unity SDK,将demo中的MediationAdapter 文件夹复制并引入到开发者项目工程中,并修改类名为步骤2中指定的类名。

  5. 启动 Demo 工程,使用您在优量汇开发者平台上申请的广告位组 ID (mediation id) 进行广告拉取测试(若使用测试账号测试,请务必在测试完成后切换至正式账号)。
  6. 请求广告异常排查步骤
    a. 检查接入的优量汇广告类型是否包含在上面表格中,以及开发者申请的第三方的广告位是否和表格中与优量汇广告类型对应的第三方渠道入口类匹配;
    b. 检查拉广告时传入的广告位ID是否为您在优量汇平台申请的广告位组ID(mediation id);
    c. 检查穿山甲及快手的SDK是否接入正确;
    d. 检查穿山甲及快手的adapter是否接入正确;

    实时竞价获取 eCPM

    eCPM 价格可以通过优量汇聚合 的 getECPMLevel() 方法获取。优量汇 实时竞价返回的价格为参竞者的二价。胜出 ADN 如果是瀑布流,则获取值为胜出的 ADN 当前广告位在聚合平台上的设价。

    激励视频服务端验证说明

    开发者使用激励视频服务端验证需要向各个 ADN 平台进行申请。在某个 ADN 的激励视频播放后发放奖励时,对应的 ADN 服务端会向开发者服务端发送请求进行验证。因各 ADN 的服务端验证实现方式不同,所以开发者需要进行适配,例如:
    (1) 优量汇 SDK 会回调开发者 APP transId,需要 APP 上报至开发者服务端进行校验;
    (2) 穿山甲 SDK 不会回调开发者 transId,所以不需要 APP 上报服务端;

 文档反馈

腾讯公司 版权所有