sharetrace

Method

getInstallTrace

#概述

sharetrace 插件封装了 ShareTrace 的原生 SDK，使用本插件获取安装携带参数。 使用本插件需要到 https://sharetrace.com 申请 sharetrace 的开发者账号并创建应用并获取到appkey。

使用此插件之前需先配置 config.xml 文件，配置完毕，需通过云端编译生效，配置方法如下：

名称：sharetrace 参数：com.sharetrace.APP_KEY 配置示例:

字段描述:

com.sharetrace.APP_KEY：（必须配置）在 sharetrace 开放平台创建应用后，该平台会为每个应用分配一个appKey。

配置关联域名（Associated Domains），方法如下：

在widget\res下创建文件名为UZApp.entitlements的文件，UZApp.entitlements内容如下：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
    <dict>
        <key>com.apple.developer.associated-domains</key>
        <array>
            <string>applinks:[填入Sharetrace分配的applinks].stul.sharetrace.com</string>
        </array>
    </dict>
</plist>

#getInstallTrace

获取安装携带参数

getInstallTrace(callback(ret, err))

callback(ret, err)

ret:

类型：JSON 对象 内部字段：

{
    code: 200, //结果码，200为请求成功，其他均为失败
    msg: 'success',  //结果信息
    data: {
        paramsData:'',  //字符串类型；安装携带的参数
        resumePage: '', //字符串类型；下载来源页面
        channel:''      //字符串类型；渠道
    }
}

示例代码

var sharetrace = api.require('sharetrace');
sharetrace.getInstallTrace(function(ret){
    api.alert({msg:JSON.stringify(ret)});
});

#getWakeupTrace

获取一键调起参数

getWakeupTrace(callback(ret, err))

callback(ret, err)

ret:

类型：JSON 对象 内部字段：

{
    code: 200, //结果码，200为请求成功，其他均为失败
    msg: 'success',  //结果信息
    data: {
        paramsData:'',  //字符串类型；安装携带的参数
        resumePage: '', //字符串类型；下载来源页面
        channel:''      //字符串类型；渠道
    }
}


## 示例代码

``` javascript
<script type="text/javascript">
    apiready = function() {
        api.addEventListener({
            name:'appintent'
        }, function(ret, err) {
            getWakeupTrace(ret);
        });
    };

    function getWakeupTrace(intentRet) {
        var sharetrace = api.require("sharetrace");
        sharetrace.getWakeupTrace(intentRet, function(ret, err) {
            api.alert({msg: JSON.stringify(ret)});
        });
    }
</script>

可用性

Android系统，iOS系统

可提供的1.0.1及更高版本

更多详细信息情参考官方文档：https://sharetrace.com/docs/third/apicloud.html

是否仍需要帮助？ 请保持联络！
最后更新于 2024/07/31