小程序生活服务代运营服务商接入指南

收藏
我的收藏

接入概述​

抖音生活服务,是一个为用户提供真实、优质、丰富的信息,创造美好生活的平台。为了更好地助力生活服务行业商家的经营,抖音建设了代服务商体系,代运营服务商作为生态中的重要成员,为商家提供多元能力的运营解决方案,帮助商家快速入局抖音平台,把握市场增长机会,实现全局经营和生意增长。​

经营流程​

整个经营过程可以简单描述为:先申请成为开发者,再认证代运营服务商角色,自研小程序,最后引入商家在小程序内经营。​

角色解释​

角色
角色类型
业务说明
需入驻的平台
商家​
经营角色​
指实际经营并提供履约服务的商家。​
代运营服务商​
指为商家提供上单商品服务并赚取佣金等收入的代运营服务商。​
可以自研发小程序,也可以找代开发服务商代研发小程序。​
    1.抖音林客
说明:无需入驻抖音开放平台·服务商平台
代开发服务商​
开发角色​
指为商家、代运营服务商提供小程序代开发服务的服务商。​

视频教程​

接入流程​

整个开发接入过程如下流程所示:​

一、服务商入驻​

如需进行开放代运营,首先需分别入驻抖音林客抖音开放平台·开发者平台。详情请参见代运营服务商入驻。​

二、小程序开通​

小程序是后续开发和经营的主要场所,服务商入驻成功后,就可以创建小程序。​
小程序创建前,请确保行业角色认证完成(即:“行业角色”已显示为“生活服务代运营服务商”),否则小程序不会自动赋予该行业角色对应权限。
行业角色点亮后,接入指南中涉及的接口权限将会自动开通(除 poi 匹配权限需要单独申请,申请流程参见“五、商品同步权限开通”)
小程序创建时,“服务类目”必须选择“生活服务、餐饮、酒店旅游”类目下的一或多个(至少一个,可多选),建议选择:“生活服务-生活服务-吃喝玩乐平台”或“餐饮-餐饮-美食团购平台”,具体步骤参见创建小程序。​

三、商家入驻​

如商家已经拥有抖音来客账户,可以跳过此步。​
代运营服务商所服务的商家需要拥有抖音来客账户,如商家尚未拥有抖音来客账户,按如下操作指南先入驻抖音来客:​

四、代运营合作关系建立​

建立合作关系后才能上架商品和设置佣金。​
商家入驻抖音来客后,服务商就可以与商家建立合作关系。详情请参见建立代运营合作关系 。​

五、商品同步权限开通​

开通 POI 匹配能力​

在地理信息系统中,一个 POI(Point of Interest,兴趣点)可以是一栋房子、一个商铺等,在抖音本地生活业务中,POI 是商家经营本地生活业务的重要场景。​
为保障用户体验,当前开通 POI 货架能力需要特殊审批,请提交问卷申请,预计 1~3 个工作日完成审核。申请分为下面 2 种场景:​
开发过程申请:开发过程中,需要先申请小程序 POI 能力,且为保障其他用户不被分发,只允许部分测试用户可见。填写问卷申请开通 POI 能力。时间要求:工作日(周一至周五)的 48h 内会完成权限审批开通,请届时自验证能力情况。​
正式放量申请:放量申请需要在验收通过后才能申请,参考本指南【11.验收】部分。​

获取 token​

后续 POI 匹配和店铺同步接口需要使用 access_token,详情请参见获取 access_token。​
其中需要用到 appid 和 app_secret ,获取方式如下:​
    1.登录抖音开放平台,在右上角点击「控制台」。​
    2.在「我的应用」页面点击「小程序」,在「小程序」页签中点击目标小程序。​
    3.在小程序详情左侧的导航栏中选择「 开发」>「开发设置」。​
    4.在「小程序key」页面获取「AppID」和「AppSecret」。​
对于小程序场景,接口请求参数中的 client_key 和 client_secret,请传递上面获得小程序 appid 和 app_secret​

发起匹配

通过 POI 匹配接口完成服务商与商家店铺的绑定关系。​
请求示例如下:​
{ "match_data_list": [ { "address": "庐山路华晨大拇指商业广场5楼", //来自于抖音来客>店铺管理>详细地址 "amap_id": "", "city": "阿克苏地区", "extra": "", //没有extra,留空即可 "latitude": 27.84, // "address"对应的纬度 "longitude": 113.12, // "address"对应的经度 "poi_id": "7146145966125500xxx", //来自于抖音来客>店铺管理>门店id "poi_name": "测试POI_2", //来自于抖音来客>店铺管理>门店名称 "province": "新疆维吾尔自治区", "supplier_ext_id": "test9" //店铺的唯一ID } ] }
参数poi_id需要与抖音来客的门店 ID 一致,否则会造成匹配 POI 与商家匹配的不一致等问题,门店 id 的获取方式有两种:​
1、如需少量获取:可在抖音来客直接查看,如下图所示:​
2、如需大量获取:可通过接口实现,通过门店信息查询查看方法。​

查询匹配结果

POI 查询有 2 种方式。​
方式 1: 前面【发起 POI 匹配】接口会返回 task_id,通过店铺匹配任务结果查询进行查询。请求参数的 supplier_task_ids 填写上面返回的 task_id 即可。当 mismatch_status_desc 出现“匹配已完成”字段,说明该店铺在之前的匹配任务已经完成匹配,请不要重复提交匹配。当 mismatch_status_desc 出现“匹配进行中”字段,说明该店铺已经发起过匹配,并且之前的匹配任务还未完成匹配,请等待之前的匹配任务完成。​
方式 2: 前面“发起 POI 匹配”接口的入参包含 supplier_ext_id,也支持通过外部店铺 id 查询匹配结果,接口地址:店铺匹配状态查询。​

店铺同步​

通过商铺同步接口完成店铺同步。​
角色认证完成后,权限已经自动发放,接口中提到的权限申请忽略即可。​

六、商品库同步​

如小程序未发布(例如首次开发):由于小程序未发布,小程序商详页打不开,会导致商品审核失败,需要申请一个免审商品,按下方“测试商品审核豁免”部分走流程,当免审商品审核通过后,请使用免审商品,尽快将小程序发布。​
如小程序已发布:所有的商详页就均可用小程序展示,无需提交免审商品,走正式的商品审核流程即可了(审核速度较快),按下方“商品发布流程”部分操作。​
在发起“十二、验收”前,请务必创建一个在 poi 货架上可见的正式商品,用于验收。​

商品发布流程​

参考文档同步:代运营服务商商品发布流程 。​
创建商品接口 biz_line使用 5,指定为小程序商品,否则会提示“此订单不属于闭环核销订单”。

测试商品审核豁免​

如果小程序商品详情页未上线,由于没有商品详情页,直接同步商品,会提示账户审核失败: 【小程序链接-落地页】您好,素材页面需详细展示以及说明推广产品或服务,请修改,谢谢。
但是如果没有商品,无法完成小程序的开发和上线。因此需要申请测试商品审核豁免,具体操作流程如下:​
测试商品审核豁免申请流程:​
    1.接入商品发布流程,代运营服务商商品发布流程 。​
    2.在调用商品创建时,入参投放渠道(show_channel)传 2,仅直播间可见(避免测试时对线上用户可见)。为了保障后续测试顺利,创建商品时需上传有效的商品图片(图片 URL 须小于等于 512 字节)。​
    3.调用商品创建接口后,需要商家在抖音来客进行审核,参见 代运营服务商商品发布流程 。​
    4.商家审核通过后,若通过草稿箱查询审核结果为账户审核失败: 【小程序链接-落地页】您好,素材页面需详细展示以及说明推广产品或服务,请修改,谢谢。则需要申请测试商品免审。请填写商品白名单问卷:测试商品免审-能力申请,平台会将这个失败的审核单修改为审核通过。​

关于免审商品,有以下须知:

此问卷填写后,一般工作日当天 17:00 开通,一般 18:00 就会完成操作通过。​
原则上一个小程序每一个商品类目只支持不超过 2 个测试商品,过多申请会自动拒绝。​
如果小程序已经发布上线,并能预览商品详情页,会拒绝测试商品免审,请直接使用线上商品进行测试。​
测试完成后,为了不影响正常用户,请及时将该商品下线。​

七、分佣比例设置​

佣金比例将会决定在代运营合作期间对于商户的抽佣金额,佣金比例设定分为「商品单独抽佣」和「整体固定抽佣」。其中「商品单独抽佣」需单独逐一设置合作过程中的每个商品的佣金比例。具体参见文档设置分佣比例 。​

八、交易能力接入​

详情请参见代运营交易系统接入指南 。​

九、撮合能力接入​

十、其它能力接入​

【必接】客服能力接入​

详情请参见客服能力接入。​

【必接】评价能力​

接入评价能力,详情请参见评价能力。​
注意:此评价能力为必接。如果未接入,会降低商品的流量分发,影响实际销售业绩,请务必保障接入。

【必接】获取手机号能力接入​

为了保护用户体验,获取手机号必须使用统一组件。详情请参见获取手机号。​

【必接】资质亮照​

在小程序内,将小程序开发中的相关资质进行亮照。参考本地生活小程序资质要求,完成亮照, 如下图示例:​
在小程序具体的每个商品详情页内,将合作商家的相关资质进行亮照,请参见企业主体开放服务类目,如下图示例:​

十一 、小程序发布​

上述步骤均完成后,就可以发布小程序。​
如果小程序是第一次提审,里面仅有测试商品,为避免被拒绝,请注意以下三点:​
    1.测试商品尽量使用真实商品信息。​
    2.更新日志中添加“代运营商家第一次提审,可接受测试商品”,方便审核同学识别。​
    3.当小程序发布完成后,请尽快下线测试商品,上线正式商品(否则小程序可能会被下架),并使用正式商品,发起 十二、验收。​
小程序发布前,规范参考:​

十二、验收​

注意:小程序发布后(即小程序提交版本审核,完成正式上线后),请务必先完成此步验收(方式为提交下方验收问卷),在发起验收前,请务必创建一个在 poi 货架上可见的正式商品,用于验收。​
为了保证用户体验,小程序需要经过验收,确定核心功能都已正确实现,才能对抖音用户可见。​
在发起验收前,请按此文档自查,文档里的功能是否均已完成接入:代运营商家-POI 能力验收要求,确保都接入后,再提交验收问卷。​
提交验收:请填写代运营能力验收问卷,验收通过后平台会放开服务商 POI 展示限制,请按照申请表格要求留下联系方式,方便告知验收结果。​