cocos2dx C++ 接入指引

从github获取文档和插件

使用openinstall第三方插件文档集成时,如何快速获取AppKey、Associated Domains和scheme,下图为iOS相关配置信息(Android同理):

一、Android 集成

集成 openinstall SDK 到 cocos2d-x Android 项目中,请参考Android 集成指南

二、iOS 集成

集成 openinstall SDK 到 cocos2d-x iOS 项目中,请参考iOS 集成指南

三、使用指南

1. 导入头文件

在所有需要使用到 openinstall api 的文件中,需要导入 openinstall 头文件

#include "OpenInstall.h"

注:请根据文件目录结构适当调整引用路径

2. 初始化

AppDelegateinitGLContextAttrs的方法中进行初始化。

void AppDelegate::initGLContextAttrs()
{
    GLContextAttrs glContextAttrs = {8, 8, 8, 8, 24, 8, 0};

    GLView::setGLContextAttrs(glContextAttrs);

    // openinstall Initialize
    openInstall2dx::OpenInstall::init();

}

四、功能集成

1. 快速安装

如果只需要快速安装功能,无需其它功能(App传参安装、渠道统计、一键拉起),完成初始化即可(包括iOS.md和Android.md中的初始化配置工作)

2. 一键拉起

一键拉起的配置见iOS.md和Android.md相关文档

获取拉起数据
同样,在AppDelegateinitGLContextAttrs方法中,OpenInstall::init();之后注册拉起回调,这样当 拉起App 时,会回调方法,并可在回调中获取拉起数据

    openInstall2dx::OpenInstall::registerWakeUpHandler([](openInstall2dx::AppData appData){
        std::string channelCode = appData.getChannelCode();
        std::string bindData = appData.getBindData();
    });

3. App传参安装高级版功能

获取安装参数
在应用需要安装参数时,调用以下 api 获取由 SDK 保存的安装参数,可设置超时时长,单位秒

    openInstall2dx::OpenInstall::getInstall(8,[](openInstall2dx::AppData appData){
        std::string channelCode = appData.getChannelCode();
        std::string bindData = appData.getBindData();
    });

4. 渠道统计高级版功能

SDK 会自动完成访问量、点击量、安装量、活跃量、留存率等统计工作,其它业务相关统计由开发人员代码埋点上报

4.1 注册上报
根据自身的业务规则,在确保用户完成 App 注册的情况下调用相关api

    openInstall2dx::OpenInstall::reportRegister();

4.2 效果点上报
统计终端用户对某些特殊业务的使用效果,如充值金额,分享次数等等。调用接口前,请先进入 openinstall 管理后台 “效果点管理” 中添加效果点,第一个参数对应管理后台效果点ID

    openInstall2dx::OpenInstall::reportEffectPoint("effect_test", 1);

五、导出apk/ipa包并上传

  • 代码集成完毕后,需要导出安装包上传openinstall后台,openinstall会自动完成所有的应用配置工作。
  • 上传完成后即可开始在线模拟测试,体验完整的App安装/拉起流程;待测试无误后,再完善下载配置信息。

下面是apk包的上传界面(后台截图):

上传安装包