微信公众号授权后,活动营销平台可帮助客户实现业务运营,获取到客户公众号的openid作为微信用户参与的活动标识,支持活动在微信内进行投放。
因微信接口限制,当前仅支持已认证服务号的第三方授权:
授权完成后,创建活动、玩法时可选择该公众号:
魔方支持活动在您的自有APP内进行投放,支持用户在APP内参与抽奖、投票等玩法,帮助您实现APP内的拉新、促活等营销场景。接入手机APP或小程序需前置完成APP或小程序应用接入配置。
如何添加手机APP/小程序应用?
字段名称 | 说明 |
---|---|
应用名称 | 用于平台内显示,建议填写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 } } } }