【运营必看】珊瑚自助对接手册
<h4>一、注册珊瑚后台，</h4>
<p>发送邮件到 v_hjyvhuang@tencent.com; evanyfzeng@tencent.com; xiongma@tencent.com
抄送 venusqu@tencent.com、ilonawang@tencent.com
邮件主题：珊瑚后台注册
邮件正文内容： 注册邮箱号+公司名称+开通时长（可以先写1年），备注：应用APP名称+APP包名。
注：建议尽快注册，一方面接入方能了解后台，另一方面腾讯侧可进行资源分配</p>
<pre><code>一个工作日内，审核结果会通过邮件形式答复。一般中午和晚上集中审核
珊瑚后台登录地址：https://jifen.m.qq.com</code></pre>
<h4>二、确认对接方案：</h4>
<p>入口：自助对接平台--方案确认</p>
<ol>
<li>选择是否已有积分体系；（是，走任务回调模式。否，走积分托管珊瑚模式）</li>
<li>勾选需要对接模块对应对接方式。（此处请严谨，不要随便勾选。商城暂无Android-SDK、广告（任务）不要选api）</li>
<li>确定对接方案后，跟腾讯对接同学消息同步一下。
同步格式：对接模块（对接方式）。
比如：手机管家，自有积分体系，对接：积分任务（安卓SDK）+兑换（h5模板，带签到页）+活动（h5）+小游戏（h5）</li>
</ol>
<p>说明：积分任务广告，只能用客户端SDK对接，或者jssdk对接。（不要用h5商城模板任务模块和api）</p>
<h4>三、获取产品参数</h4>
<p>入口：自助对接平台--基础配置</p>
<ol>
<li>产品配置，产品ID，就是产品参数appid。产品KEY，就是APPsecret（秘钥）。（这部分信息，能看，不能改）</li>
<li>企业配置，常规接入方用不上，不用管它。</li>
<li>商城配置，积分汇率、货币名称，接入方可自行配置。</li>
<li>活动配置，货币名称，接入方可自行配置。</li>
</ol>
<h4>四、接入方服务接口开发与配置：一定要配置接口</h4>
<p>入口：自助对接平台--接口配置
前面选择的，是否有积分体系，对接模块，决定了需要提供的接口。</p>
<ol>
<li>
<p>对接兑换商城、活动需要的接口
1.）自有积分体系：需要提供 <strong><a href="https://www.showdoc.com.cn/1procedure2develop?page_id=3125203821480258" title="查积分、扣积分、返还积分">查积分、扣积分、返还积分</a>、登录校验</strong>，4个接口。
2.）无积分体系：提供 <strong><a href="https://www.showdoc.com.cn/1procedure2develop?page_id=3125133239575152" title="登录校验接口">登录校验接口</a></strong>。
3.）接入方自己在后台配置即可。</p>
</li>
<li>对接积分任务、小游戏需要的接口
1.）自有积分体系：需要提供 <strong><a href="https://www.showdoc.com.cn/1procedure2develop?page_id=3125134758885194" title="任务回调接口、salt">任务回调接口、salt</a></strong>。
2.）无积分体系：提供 <strong><a href="https://www.showdoc.com.cn/1procedure2develop?page_id=3125133239575152" title="登录校验接口">登录校验接口</a></strong>。
3.） <strong>任务相关接口（暂未开放接入方填写，接入方把接口给腾讯对接人配置）</strong></li>
</ol>
<h4>五、珊瑚后台配置</h4>
<h5>（一）<a href="https://www.showdoc.com.cn/1procedure2develop?page_id=3124816851585503" title="任务配置">任务配置</a>（配置了任务，才能请求到任务，进行任务测试）</h5>
<ol>
<li>公有广告任务：积分任务管理--普通任务分配--创建任务--填写任务信息--创建。</li>
<li>私有任务类型：积分任务管理--普通任务分配--创建任务--点3次上一步--添加任务类型--下一步--添加任务样式--下一步--关联任务与样式--下一步--创建任务。</li>
<li>自有任务类型的ID、样式名称，请看任务配置手册，<strong>请按规则命名</strong>，<strong>不按规则后果严重</strong>。</li>
</ol>
<h5>（二）<a href="https://www.showdoc.com.cn/1procedure2develop?page_id=3124815048990991" title="配置商品">配置商品</a>（配置了商品，才能获取到商品，进行商城测试）</h5>
<ol>
<li>库存资源--分配商品--选择库存商品--可用腾讯库存--免费库--选择--填写信息--确认分配--上线。</li>
<li>商城运营--积分商品--商品上下架--分区配置--添加新配置 （h5商城模板对接的，分区在客户端无体现。API对接的，自行做界面可以用上分区展示）。</li>
<li>商城运营--积分商品--商品上下架--积分商品配置--添加新物品--配置商品信息--完成--上线。</li>
</ol>
<h5>（三）<a href="https://www.showdoc.com.cn/1procedure2develop?page_id=3125187133385136" title="活动配置">活动配置</a>（如果需要对接活动，请配置）</h5>
<ol>
<li>入口：商城运营—爆款活动—创建活动—活动入口—创建</li>
<li>选择积分消耗体系--创建</li>
<li>商城首页展示（如果不是h5商城模板对接，或不在首页展示，开发拼接活动链接）</li>
</ol>
<h5>（四）<a href="https://www.showdoc.com.cn/1procedure2develop?page_id=4148283519463131" title="游戏配置">游戏配置</a>（已停用）</h5>
<ol>
<li>入口：商城运营—爆款活动—创建活动—活动入口—创建</li>
<li>选择积分产生体系--创建</li>
<li>开发拼接游戏链接</li>
</ol>
<h5>（五）<a href="https://www.showdoc.com.cn/1procedure2develop?page_id=4876321650925319" title="商城模块配置">商城模块配置</a>（使用h5模板对接的才需要配置装修）</h5>
<ol>
<li>商城运营--积分商城--商城装修--模块选择勾选--保存。</li>
<li>注意：如果选择了页面签到，<strong>一定</strong>在任务中配置好【签到任务、连续签到3天、连续签到7天】3个任务。</li>
<li>如果SDK对接了任务广告的，<strong>不可以</strong>勾选【积分任务模块】</li>
<li>如果SDK对接了102任务，<strong>不可以</strong>在使用h5签到模块【签到页面】</li>
</ol>
<h4>六、开发对接</h4>
<h5>（一）SDK对接，看SDK对接文档。2.0珊瑚SDK对接，记得看SDK包中的Word文档（SDK已停用）</h5>
<ol>
<li>任务与广告关联；</li>
<li>广告拉取、广告执行、广告上报；（非珊瑚公有任务，没有广告）</li>
<li>任务完成判断，任务提交；</li>
<li>服务接口开发（任务回调接口+salt、登录校验接口）；</li>
<li>SDK对接积分任务广告，接入方做UI。</li>
</ol>
<h5>（二）h5（h5模板、jssdk）对接，看h5对接文档</h5>
<p><strong>对接积分任务、小游戏（商业化SDK已停用）</strong></p>
<ol>
<li>任务与广告关联；</li>
<li>任务拉取、广告拉取、广告执行、广告上报；（非珊瑚公有任务，没有广告）
<a href="https://www.showdoc.com.cn/1procedure2develop?page_id=4669981048120936" title="积分任务SDK">对接方式1：积分任务SDK</a>
<a href="https://www.showdoc.com.cn/1procedure2develop?page_id=4446091612178555" title="任务/会员体系api">对接方式2：任务/会员体系api</a></li>
<li>任务完成判断，任务提交；</li>
<li>服务接口开发（任务回调接口+salt、登录校验接口）；</li>
<li>自测提交任务、广告执行。广告上报测试后，找腾讯同学查询数据；</li>
<li>jssdk对接，接入方做UI（h5小游戏不用自己做UI）。</li>
<li>对接小游戏，一定要实现客户端的下载能力和广告上报。</li>
<li>对接活动，如果有广告兜底（互动广告），一定要实现客户端的下载能力和广告上报</li>
</ol>
<p><strong>对接兑换商城、活动</strong></p>
<ol>
<li>api对接，接入方做UI（h5兑换商城模板、h5活动，这3个不用做UI）；</li>
<li>服务接口开发（查积分、扣积分、返还积分、登录校验接口；</li>
<li>自测商品兑换（测几个兑换成功，返还积分，在珊瑚后台，兑换记录中，对兑换成功的操作返还积分）；</li>
<li>对接活动（互动广告兜底），一定要实现客户端的下载能力和广告上报。
5.如果模板对接，只需要对接<a href="https://www.showdoc.com.cn/1procedure2develop?page_id=3125202755200141" title="商城首页接口">商城首页接口</a>
6.如果自行实现界面，使用<a href="https://www.showdoc.com.cn/1procedure2develop?page_id=3137649036200374" title="列表/详情/兑换/记录">列表/详情/兑换/记录api</a></li>
</ol>
<h4>七、广告上报（不对接广告资源，无需本步骤）（SDK已停用）</h4>
<ul>
<li><strong>凡是有广告的对接，都需要做广告上报联合测试</strong></li>
<li>测试方法：接入方开发工作后，集中完成任务、活动、游戏中的广告曝光到安装激活，提供信息给腾讯对接人查询数据。</li>
<li>接入方提供如下上报测试信息。表头改为测试的广告名称即可。guid在 TMSDK log中搜索。h5对接的提供上报imei</li>
</ul>
<p>对接好之后，<strong>接入方</strong>集中测试广告；并<strong>提供如下信息给腾讯同学</strong></p>
<p>测试时间：X日-X点X分~X点X分
测试imei：
测试guid：</p>
<table>
<thead>
<tr>
<th></th>
<th>102卡券广告</th>
<th>104视频广告</th>
<th>103下载广告</th>
<th>活动卡券</th>
<th>小游戏视频</th>
</tr>
</thead>
<tbody>
<tr>
<td>曝光</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>点击</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>开始下载</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>下载成功</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>安装</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>激活</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
<tr>
<td>视频播放</td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
<td></td>
</tr>
</tbody>
</table>
<p>说明：格子中记录接入方测试时，操作广告的次数</p>
<h4>八、邮件报备 商业化广告放量量级（不对接广告资源，无需本步骤）</h4>
<p>对接了商业化广告的，放量前，需要向珊瑚同学发邮件报备放量量级，以免流量失控造成损失</p>