应用管理
最近更新时间：2024.04.18 15:50:01
首次发布时间：2022.12.19 11:53:57
微信公众号服务授权有什么作用
微信公众号授权后，活动营销平台可帮助客户实现业务运营，获取到客户公众号的openid作为微信用户参与的活动标识，支持活动在微信内进行投放。
微信公众号授权入口
- 进入GMP，点击「通道管理」，点击「添加微信公众号」
微信公众号服务授权方式
因微信接口限制，当前仅支持已认证服务号的第三方授权：
授权完成后，创建活动、玩法时可选择该公众号：
通道开启/关闭
关闭通道
H5活动页：N个；若存在活动则不允许关闭
互动玩法：N个；若存在玩法则不允许关闭
不区分活动和玩法的状态，只要有使用到这个公众号则不允许关闭
开启通道
H5活动页：N个；不执行重启
互动玩法：N个；不执行重启
仅增加弹窗展示内容，公众号通道开启不需重启活动和玩法
添加手机APP应用有什么作用？
魔方支持活动在您的自有APP内进行投放，支持用户在APP内参与抽奖、投票等玩法，帮助您实现APP内的拉新、促活等营销场景。接入手机APP需前置完成手机APP应用接入配置。
如何添加手机APP应用？
1. 进入落地页设置-应用管理，点击「新建手机APP」按钮
2. 完成应用配置并添加应用
| 字段名称 | 说明 |
|---|---|
| 应用名称 | 用于平台内显示，建议填写APP名称，方便标识 |
| 登录认证方式 | 由APP端提供调用方法内置在SDK中，调用方法提供access_token，在后端node通过登录认证服务地址校验access_token后返回用户信息 |
| 用户SDK | 因活动在您的APP内打开，需进行SDK的配置及调用，详情可见下方SDK规则说明，请按此规则封装后缀为.js的SDK文件，应符合es5语法，可以使用babel-polyfill等工具进行转换 |
| 关联接口配置 | 选择该应用关联的接口配置信息，没有完成接口联调和配置时，该应用发布的活动H5页面将获取不到客户端的用户登录信息 |
User Agent唯一标识 | 活动会先获取app客户端UA匹配设置好的识别符，来跟该标识进行匹配，如果匹配到才能被识别为App端内环境
为了避免其他APP内设置UA也有相同字段而被误判为端内，User Agent 唯一标识可以尽可能写长一些 |
| 端外跳转链接 | 非必填，在端外触发登录时自动跳转至此链接，可使用deeplink来唤起app；唤起app后活动地址url将会以参数origin_url拼接到跳转链接上，可用于app打开后callback活动页面 |
| 活动下线后的跳转链接 | 非必填，可以自定义活动下线后自动跳转的页面地址，不填写时不自动跳转 |
| 端外跳app回调参数名 | 非必填，上方“端外跳转链接”的场景中，可自定义callback活动地址参数名 |
| 指定用户id类型 | 确认对接的APP端可获取到的用户uid类型，用于H5页面埋点上报、CDP人群匹配时使用的id类型，需确认APP端在CDP的ID图谱中定义的id类型并保持一致，若没有则默认按“finder_uid”进行 |
| 应用图标 | 非必填，用于平台内显示，建议上传APP LOGO图，方便管理 |
用户SDK规范 #
客户需按照约定在JS SDK中实现下方表格中的所有方法，js全局命名空间为MagicJSBridge
方法名称 | 描述 |
|---|---|
openLogin | 唤起app登陆面板 |
getUserInfo | 获取app内当前用户登录信息 |
share | 唤起分享面板 |
openLogin #
入参描述
无
返回值描述
interface OpenLoginResp { code: number; // 0: 成功 -1: 失败 data: null; }
getUserInfo #
入参描述：无
返回值描述
interface GetUserInfoResp { code: number; // 0: 成功 -1: 失败 data: { uid: string; // 用户身份id deviceId?: string; // 设备id(可选字段) userName?: string; // 用户名称(可选字段) avatar?: string; // 用户头像(可选字段) phone?: string; // 手机号(可选字段) [key: string]: any; // 可拓展透传其他字段 } }
share #
入参描述
无
返回值描述
interface ShareResp { code: number; // 0: 成功 -1: 失败 data: null; }
示例 #
import aweme from '@bridge/aweme'; window.MagicJSBridge = { async openLogin() { const { code } = await aweme.app.openLogin(); return { code, data: null } }, async share() { const { code } = await aweme.app.share({ platform: 'share_native' }); return { code, data: null } }, async getUserInfo() { const { code, ...rest} = await aweme.app.getUserInfo(); return { code, data: { uid: rest.user_id, ...rest } } } }