智能运营 UI 业务包

配合 智能运营平台管理运营计划，App SDK 配套提供了对应的 App 弹窗、Banner、启动闪屏、邀评弹窗以及 App Push。

您可以通过智能运营平台，将用户感兴趣或需要的内容精确传递给他们，并且能够实时监测运营计划的效果数据，从而提升关键指标和整体运营效果。

功能说明：

• App 闪屏：展示 App 启动时的⼴告。

  

• App Banner：展示横幅式⼴告。

  

• App 弹窗：展示弹出式⼴告，⽀持配置标题、内容和多个按钮。

  

• App 邀评弹窗：引导⽤户为 App 进⾏评价打分。

  

• App Push：推送⼴告。

  

集成业务包

创建工程

在 Android Studio 中建立您的工程，接入智能生活 App SDK，并完成业务包 框架接入。

配置 module 的 build.gradle

dependencies {
    api enforcedPlatform("com.thingclips.smart:thingsmart-BizBundlesBom:${biz_bom_version}")
    api "com.thingclips.smart:thingsmart-bizbundle-marketing"
    implementation 'com.thingclips.smart:thingsmart-analysis-sdk:5.14.1'
    api "com.thingclips.smart:thingsmart:${sdk_version}}"
}

功能调用

本文所提供的 SDK 能力都务必配合智能运营平台使用。

• 关于平台操作，参考 管理运营计划。
• 关于 App 开发，参考 Demo。

用户数据授权管理

上文提到，在用户同意隐私政策之后，要主动调用数据分析授权 API，来授予涂鸦开发者平台数据分析的权利。该章节主要介绍如何进行用户数据授权相关的操作。

开启数据分析授权

PrivacyAuthorizationManager.getInstance().openAuthorization(new IStatusChangeCallback() {
            @Override
            public void onSuccess() { }

            @Override
            public void onError(String errorCode, String errorMsg) { }
        });

关闭数据分析授权

PrivacyAuthorizationManager.getInstance().closeAuthorization(new IStatusChangeCallback() {
            @Override
            public void onSuccess() { }

            @Override
            public void onError(String errorCode, String errorMsg) { }
        });

从云端获取用户授权状态

PrivacyAuthorizationManager.getInstance().checkAuthorization(new IAuthorizationStatusCheckCallback() {
            @Override
            public void onSuccess(boolean hasAlreadyOperation, boolean authorizationStatus) {

            }

            @Override
            public void onError(String errorCode, String errorMessage) {

            }
        });

IAuthorizationStatusCheckCallback 回调参数：

参数	说明
hasAlreadyOperation	false：用户未操作过授权，需要提示用户授权 true：用户曾经操作过是否授权
authorizationStatus	服务端记录的用户授权状态

获取本地缓存授权状态

boolean status = PrivacyAuthorizationManager.getInstance().currentAuthorizationStatus();

初始化营销广告数据

从智能运营平台初始化拉取营销广告数据，包括获取闪屏广告和 Banner 广告。

AdvertisementManager.initData();

销毁营销广告数据

当确认不再使用该营销广告业务时，例如退出登录状态等，建议执行该销毁操作。

AdvertisementManager.unInit();

闪屏广告

在执行营销广告数据初始化之后，即可调用以下接口来展示闪屏广告 View。

获取闪屏广告

IAdSplashView view  =  AdvertisementManager.getAdSplashView(activity);

参数	说明
activity	需要展示闪屏广告的 activity

展示闪屏广告

view.showSplashView(this, new OnADSplashViewActionListener() {
            @Override
            public void onADSplashImageClick(String actionUrl) {
                if (TextUtils.isEmpty(actionUrl)) {
                    return;
                }
                //Set your app's scheme when initializing the app
                //UrlRouter.setScheme("smartlife");
                AdRoute.multiRoute(SplashActivity.this, actionUrl);
            }

            @Override
            public void onADSplashViewDismiss(boolean initiativeDismiss) {
                //Do something by yourself
                finish();
            }
        });

参数	说明
actionUrl	闪屏广告可能配置的是可点击的图片链接

Banner 广告

在执行营销广告数据初始化之后，即可调用该接口获取营销 Banner View。

View bannerView = AdvertisementManager.getADBannerView(context, pushTarget);

参数	说明
context	上下文信息
pushTarget	支持展示 Banner 广告的页面类型，例如可支持在 我的、首页 以及 场景 这三个页面进行配置，您可自定义这三种类型对应在自己的目标页面。

如何配置广告

如何展示 Banner 广告

只需将此 bannerView 添加到需要展示的 View 容器中。

弹窗广告

该服务也必须要在用户授权数据分析的情况才会生效，主要实现营销弹窗和邀评功能。在智能运营平台配置相关的营销推送服务后，弹窗和邀评会自动弹出，并不需要您实现相关 UI View。

初始化营销推送服务

MarketingPushManager.init();

指定营销推送弹窗展示的目标页面

MarketingPushManager.pushTargetActivity(pushTarget, activity);

参数	说明
pushTarget	支持展示营销弹窗广告的页面类型，例如可支持在 我的、首页 以及 场景 这三个页面进行配置，您可自定义这三种类型对应在自己的目标页面。
activity	实际展示营销弹窗的目标页面的上下文。当该页面在前台时，会判断是否有相关营销弹窗需要展示。

注销营销推送服务

当确认不再使用该营销推送业务时，例如退出登录状态等，建议执行该销毁操作。

MarketingPushManager.unInit();

App Push 广告

在 App Push 推送广告，同样需要用户授权数据分析。相关推送通道集成，参考 集成 Push 章节。

解析推送消息

在智能运营平台配置的推送消息是一串字符串，此处提供的 API 将该字符串对象化，方便您理解消息推送的内容。

MarketingPushBean pushBean = MarketingPushManager.parsePushNotificationMessage(message);

参数	说明
message	消息推送的内容

消息推送点击事件处理

当在智能运营平台配置了可点击的链接或者跳转其他业务包的路由，则可以通过该方法执行点击跳转操作。

MarketingPushManager.clickPushNotification(context, pushBean);

参数	说明
context	应用上下文
pushBean	消息推送解析后的对象

如何配置运营推送