闪玩广告SDK接入文档

SDK说明

SDK开发者：厦门点即玩科技有限公司

SDK名称：闪玩广告SDK

SDK主要功能： 用于广告投放活动，包括广告展示、监测、归因及投放效果分析与优化功能，提供个性化推荐服务。

用户信息与隐私策略

如果您是开发者，在为用户提供服务前请阅读《闪玩广告SDK隐私政策》 与 《闪玩广告SDK合规使用说明》，了解SDK对个人信息收集范围、处理目的以及权限使用情况。请您向用户提供服务时，告知相关信息并取得用户同意。

如果您是用户，请在使用我们的服务前阅读《闪玩广告SDK隐私政策》 与 《闪玩广告SDK合规使用说明》，了解SDK对个人信息收集范围、处理目的以及权限使用情况。充分理解后再开始使用我们的服务。

闪玩广告SDK下载地址：swad-sdk1.4.zip

测试工具下载地址：64位自测工具2.2.2.apk

接入步骤:

1.初始化

下载swad-sdk1.3.zip,并将swadsdk_release1.4.aar文件复制到您项目Project/app/libs文件夹下
然后在app的build.gradle里依赖

dependencies {
    ...
    implementation files('libs/swadsdk_release1.4.aar')
}

确保App首次冷启动时，在用户阅读您App的《隐私政策》并取得用户授权之后，才调用正式初始化函数

 SwAdConfigure.getInstance().init(Context context, String appId);

初始化广告SDK。一旦App获取到《隐私政策》的用户授权，后续的App冷启动，开发者应尽早调用初始化函数SwAdConfigure.getInstance().init(context, appId)；
appid为开发者平台上针对申请的应用生成的唯一业务ID。如下图：

2.跳转广告

跳转开屏广告:

SwAdConfigure.getInstance().startSplashAd(Activity activity, String adId, SplashListener splashListener);

  SplashListener 回调函数

onAdLoaded 广告加载完成

onNoAdError广告加载错误

onAdShow 广告展示

onAdClick广告点击

onAdDismiss广告关闭

onAdloadTimeOut广告加载超时

跳转激励视频广告:

 SwAdConfigure.getInstance().startRewordAd（Activity activity, String adId, RewardListener rewardListener）

  RewardListener 回调函数

onAdLoaded 广告加载完成

onAdLoadFailed广告加载错误

onAdShow 广告展示

onAdClick广告点击

onAdDismiss广告关闭

onVideoReward广告获得奖励

onVideoPlayEnd视频播放完成

跳转信息流广告:

SwAdConfigure.getInstance().startNativeAd(Activity activity, String adId, NativeAdListener nativeAdListener)

  NativeAdListener 回调函数

onAdLoaded 广告加载完成

onAdLoadFailed广告加载错误

onAdShow 广告展示

onAdClicked广告点击

onAdDismiss广告关闭

onAdVideoStart广告视频开始播放

onAdVideoEnd广告视频播放结束

跳转插屏广告:

SwAdConfigure.getInstance().startInterstitialAd（Activity activity, String adId, InterstitialListener interstitialListener）

  InterstitialListener 回调函数

onAdLoaded 广告加载完成

onAdLoadFailed广告加载错误

onAdShow 广告展示

onAdClick广告点击

onAdDismiss广告关闭

onAdVideoStart广告视频开始播放

onAdVideoEnd广告视频播放结束

onAdVideoError广告视频错误

自测工具的用处

用于检测接入的广告是否正确，可用于调式模式和正式模式的检测。
用法：下载自测工具安装到手机上，然后启动您的应用进行广告播放。广告如果能正确展示表示接入成功，反之接入异常。

- 如何开启调试模式？

  初始化方法的appId参数传入`000000`，调用相应启动广告的方法时，广告位id传空字符或者任意字符串即可。如下传参。

  SwAdConfigure.getInstance().init(Context context, "000000");

常见问题

• 启动广告吐司提示广告id不匹配
  请联系我们核查广告位是否配置正确,
  联系市场QQ：346333708、648130654、2728469732

• 如何查看sdk相关日志信息
  当发生错误时，可通过logcat 过滤TAG SwAdConfigure 显示报错信息或者通过相应监听回调打印错误信息

• 断网或者弱网情况下启动广告sdk弹出实名认证弹窗
  防止用户通过断开网络逃避实名检测