本文目录
1
功能概述
推广代码页面面向两类使用场景：一类是直接投放系统生成的落地页 URL；另一类是把系统能力嵌入外部 H5、原生页或平台建站页面。页面中所有复制按钮复制的都是当前落地页专属内容，请以页面实际生成结果为准。
| 代码类型 | 用途 | 典型使用者 |
|---|---|---|
| 广告落地页 URL | 用于广告后台投放链接或人工预览落地页。 | 投放人员 |
| 基础 JS 代码 | 把微信展示、访问统计、转化事件、条件跳转等能力注入外部页面。 | 页面制作或技术人员 |
| 推广标签代码 | 在外部页面指定位置插入二维码、微信号、手机号、QQ、客服姓名等内容。 | 页面制作人员 |
| 调起微信参数 | 生成打开小程序、企业微信客服、企微获客助手名片的按钮或链接。 | 投放与页面制作人员 |
简单理解：如果落地页完全由智客云量生成，主要复制投放 URL；如果页面在外部制作，则必须复制基础 JS，并按需要补充标签代码和调起代码。
2
入口与界面
在 推广管理 > 落地页管理 中找到目标落地页，点击“代码”进入本页。系统会先完成权限校验，再打开该落地页对应的推广代码页面。
图 1 · 生产环境推广代码页面
页面操作：每段代码右侧都有复制图标；带浏览器图标的链接可以直接打开预览；部分原生页链接还提供“保存为 HTML”和“下载二维码”功能。
3
广告落地页 URL
顶部“广告落地页URL”区域展示当前页面可用于投放或预览的访问地址。具体显示内容会受页面域名、OSS 绑定和服务号配置影响。
| 链接 | 说明 | 使用建议 |
|---|---|---|
| A1 原始页面 URL | 页面配置中的原始 URL。截图中为 https://cos.zkyl.vip。 | 适合直接投放已有外部页面，或检查原始承接页是否可访问。 |
| A2 系统访问 URL | 当页面绑定域名时，系统会生成可直接访问的投放地址。 | 适合投放系统生成或系统托管的落地页。 |
| 服务号点击链接 URL | 服务号类型页面会显示微信授权链接，包含广告平台点击参数占位符。 | 用于需要通过服务号授权链路进入落地页的投放场景。 |
注意：投放后台要求保留点击参数时，不要手动删改链接中的占位符，例如
__CLICK_ID__、__CALLBACK__ 等。4
基础 JS 代码
基础 JS 是外部页面接入智客云量能力的第一步。复制页面中的 <script ...></script> 代码，并放到广告页 </head> 标签前一行。
复制基础 JS
点击“基础JS代码”区域右侧复制图标。
粘贴到页面 head 中
放在 </head> 的前一行，不要放在页面底部，也不要放到不可执行的文本区域。
发布并测试
发布广告页后，打开页面检查微信展示、按钮点击、二维码展示和转化行为是否正常。
冲突提示：生成脚本会检测页面中是否已经存在其他轮播或统计代码。若同时保留旧版代码，可能导致页面微信展示或统计异常。
5
推广标签与公开方法
推广标签用于在外部页面指定位置输出系统分配的微信信息。选择标签类型和位置编码后，页面会生成对应 HTML 片段。
| 标签类型 | 生成内容 | 适用场景 |
|---|---|---|
| 名片二维码 | <img class="zkser-wx-qr"> | 展示当前分配微信的二维码。 |
| 企微获客链接二维码 | <img class="zkser-wx-qr wxcard"> | 非微信环境长按二维码跳转到企微获客链接名片。 |
| 微信号、手机号、QQ号 | <span class="zkser-wx-alias"> 等文本标签。 | 在页面文案或按钮旁展示联系方式。 |
| 客服姓名、客服性别 | 输出客服基础资料。 | 需要个性化展示客服信息的页面。 |
| 线索表单 | <div class="zkser-order"> | 在外部页面嵌入线索表单位置。 |
位置编码用于区分页面内多个微信展示位置，例如位置 1、位置 2。页面生成的展示标签、按钮代码和跳转链接会按位置取对应微信。
| 页面能力 | 作用 |
|---|---|
| 获取展示微信 | 让外部页面展示当前系统分配的微信信息。 |
| 打开加粉入口 | 按指定位置打开微信、小程序、企微客服或营销通。 |
| 打开企微获客名片 | 按指定位置打开企业微信获客链接联系人资料卡片。 |
| 提交转化事件 | 在复制微信号、打开微信、长按识别等行为发生时记录转化。 |
| 初始化完成处理 | 微信信息加载完成后，可让页面继续执行自定义展示逻辑。 |
6
调起微信参数
“调起微信参数”区域提供两类方案：已置入基础 JS 的外部 H5 页面使用点击事件代码；无法置入基础 JS 的平台原生页使用系统生成的跳转链接。
| 方案 | 代码形态 | 适用场景 |
|---|---|---|
| 外部 H5 打开企微获客助手名片 | 页面生成的点击事件代码 | 页面已插入基础 JS，需要按钮或图片点击打开获客名片。 |
| 原生页链接打开企微获客助手名片 | 页面生成的跳转链接 | 广告平台原生页、建站页或其他无法放 JS 的页面。 |
| 服务号方式打开企微获客助手名片 | 微信授权链接。 | 服务号承接链路，需要在微信授权环境中打开名片。 |
| 外部 H5 打开微信、小程序、企微客服或营销通 | 页面生成的点击事件代码 | 页面已插入基础 JS，需要点击后打开对应加粉入口。 |
| 原生页链接打开微信、小程序、企微客服或营销通 | 页面生成的跳转链接 | 无法放 JS 的页面，用链接方式完成跳转。 |
保存为 HTML：原生页链接旁的导出按钮会保存一个自动跳转 HTML 文件。把该文件上传到自有域名或存储空间后，可在广告后台填写它的完整访问路径。
7
平台专用参数
页面会根据当前落地页的平台和微信应用类型显示额外参数。未满足条件的区域不会显示。
| 区域 | 显示条件 | 说明 |
|---|---|---|
| 小程序参数 | 当前微信应用类型为小程序。 | 展示小程序名称、原始 ID、path 地址，以及部分平台的 urlScheme 获取地址。 |
| 服务号点击链接 URL | 当前微信应用类型为服务号。 | 展示微信授权点击链接，用于服务号授权链路。 |
| Vivo 营销平台监控链接 | 当前渠道为 Vivo。 | 展示广告投放链接和监控链接回调地址。 |
| 原生页名称 | 按广告平台变化。 | 腾讯显示“蹊径／原生页”，百度显示“基木鱼”，头条显示“橙子建站”，其他平台显示对应平台原生页。 |
8
重置链接标识
链接标识用于区分当前落地页的投放代码和访问链接。点击页面上的重置按钮后，系统可以重新生成一组新的链接标识；如需手动填写，应按页面提示输入 32 位字母或数字。
图 2 · 重置链接标识提示
- 重置后，旧标识对应的基础 JS、跳转链接和二维码都需要同步替换。
- 系统会校验手动输入的标识必须是 32 位字母或数字，且不能与已有落地页重复。
- 重置成功后会重新生成配置脚本和页面 HTML。
- 已经投放中的广告后台链接、外部 H5 代码、原生页跳转 HTML 都要逐一检查。
高风险操作：不要在广告正在投放时随意重置链接标识。必须有替换计划，否则线上页面可能无法正常展示微信或无法统计转化。
9
常见问题
外部 H5 页面只复制推广标签可以吗？
不可以。推广标签依赖基础 JS 初始化微信信息。外部页面必须先插入基础 JS，再使用二维码、微信号、按钮点击等标签和方法。
什么时候用 JumpToWxapp 链接，什么时候用 onclick 代码？
能改 H5 源码并放置基础 JS 时，优先用 onclick 代码；广告平台原生页或建站页无法放 JS 时，使用系统生成的 JumpToWxapp 或 JumpToWxcard 链接。
为什么复制后页面没有显示微信？
检查基础 JS 是否放在 head 中、页面是否还保留旧轮播代码、当前落地页是否启用、项目是否启用，以及微信加粉设置中是否有可用微信。
重置链接标识后旧二维码还能用吗？
旧二维码中的链接仍然指向旧标识，通常需要重新下载或重新生成二维码，并替换到投放素材或原生页中。
10
注意事项
- 复制基础 JS 时要复制完整
<script>标签，不要只复制其中的 URL。 - 外部页面不要同时保留多套智客云量旧代码或其他微信轮播代码。
- 位置编码要与页面设计保持一致，例如按钮写位置 1，二维码标签也应对应位置 1。
- 服务号和广告平台参数链接通常包含占位符，不要手动替换或删除。
- 上线前用真实手机环境测试一次复制微信、打开微信、长按二维码、企微获客名片和转化回传。