八字合婚配对系统对接百度推广，核心不是“多写几个接口”，而是把bd_vid、转化事件、线索API、联调页面这条链路打通。用户在广告落地页输入双方生辰信息、提交合婚测算、查看报告、咨询客服或完成付费时，系统需要把这些行为按百度定义的转化类型回传回去，oCPC 模型才能识别哪些流量更容易产生测算、留资或付费。
一、先理清数据链路
百度推广点击广告后，会在落地页 URL 中带上bd_vid。这个参数相当于一次广告点击的标识。
完整链路通常是：
- 用户点击广告进入合婚测算落地页；
- 页面 URL 携带
bd_vid； - 用户提交八字信息，完成合婚测算；
- 系统判断是否产生有效转化；
- 后端调用百度线索 API 回传转化；
- 百度将转化归因到对应计划、单元、创意；
- oCPC 模型根据回传数据优化后续投放。
这里最容易踩坑的地方是：bd_vid没有在页面之间透传。比如用户从落地页进入测算页、报告页、支付页，如果中间某一步丢失了bd_vid，后续回传就无法正确归因。
二、在百度后台创建转化追踪
先在百度营销后台创建转化追踪，接入方式建议选择线索API。
常见转化事件可以这样设计：
| 转化事件 | 适用场景 | 回传时机 |
|---|---|---|
| 表单提交成功 | 用户提交生辰信息 | 提交成功后 |
| 测算完成 | 合婚报告生成 | 报告页加载完成 |
| 在线咨询 | 用户点击客服/加微信 | 客服入口触发后 |
| 服务购买成功 | 用户完成付费解锁 | 支付回调成功后 |
需要注意的是，后台选择的事件类型必须和实际回传的newType保持一致，否则联调时会出现“已回传但不点亮”的情况。
三、落地页获取 bd_vid
合婚系统落地页可以在前端或后端获取bd_vid。前端获取相对简单，适合 H5、小程序 WebView 或活动落地页。
function getBdVid() { const params = new URLSearchParams(window.location.search); return params.get('bd_vid') || ''; } const bdVid = getBdVid(); if (bdVid) { // 写入 sessionStorage，避免后续页面丢失 sessionStorage.setItem('bd_vid', bdVid); }如果系统包含多步测算流程，比如：
- 首页：输入双方生辰；
- 测算页：生成合婚报告；
- 报告页：展示婚姻匹配度；
- 支付页：解锁详细解读；
那么bd_vid最好写入sessionStorage或通过服务端透传，避免用户跳转后丢失。
四、后端回传转化数据
合婚系统通常有测算记录、订单记录、客服咨询记录，这些更适合通过后端回传。后端回传比纯前端埋点更稳定，也更容易排除测试数据。
百度线索 API 的回传地址为：
POST https://ocpc.baidu.com/ocpcapi/api/uploadConvertData请求体示例：
{ "token": "YOUR_TOKEN", "conversionTypes": [ { "logidUrl": "https://example.com/hun?bd_vid=xxxxx", "newType": 3, "convertTime": 1730200000 } ] }其中：
token：百度转化追踪生成的 Token；logidUrl：携带bd_vid的落地页地址；newType：转化类型编码；convertTime：转化发生的时间戳。
常见newType包括：
1：咨询按钮点击；3：表单提交成功；5：表单按钮点击；10：购买/服务购买成功；25：应用注册。
实际项目中，建议在合婚系统里封装一个统一回传方法：
import requests import time BAIDU_CONVERT_URL = "https://ocpc.baidu.com/ocpcapi/api/uploadConvertData" def upload_baidu_convert(token, bd_vid, new_type, convert_time=None): if not bd_vid: return False logid_url = f"https://example.com/hun?bd_vid={bd_vid}" convert_time = convert_time or int(time.time()) payload = { "token": token, "conversionTypes": [ { "logidUrl": logid_url, "newType": new_type, "convertTime": convert_time } ] } resp = requests.post(BAIDU_CONVERT_URL, json=payload, timeout=5) return resp.status_code == 200五、合婚系统中的典型触发点
八字合婚配对系统可以围绕测算链路设置回传点：
# 用户提交生辰信息 if form_submitted: upload_baidu_convert(token, bd_vid, new_type=3) # 合婚报告生成完成 if report_generated: upload_baidu_convert(token, bd_vid, new_type=10) # 用户点击微信/客服咨询 if consult_clicked: upload_baidu_convert(token, bd_vid, new_type=1) # 付费解锁详细报告 if order_paid: upload_baidu_convert(token, bd_vid, new_type=10)这里要注意，不要把“页面打开”“滚动到底部”这类行为直接当作转化回传，否则容易让 oCPC 模型学到无效样本。
六、联调阶段怎么验证
联调时，先在百度后台点击“联调”，然后用手机扫码打开测试页面。
建议按真实用户路径操作：
- 扫码进入落地页；
- 输入双方生辰信息；
- 提交合婚测算；
- 查看合婚报告；
- 点击咨询或完成付费；
- 后端触发 API 回传；
- 回到百度后台确认事件是否点亮。
联调时常见错误包括：
- 只回传了部分事件，导致联调卡片未全部通过；
newType与后台配置不一致；- 页面 URL 没有携带
bd_vid； - 测试数据没有过滤，影响正式投放模型；
- 联调超时后没有重新扫码。
七、多端部署时的注意事项
八字合婚系统如果同时覆盖 H5、小程序、APP 或 PC 端，bd_vid的透传方式会略有差异。H5 落地页可以直接从 URL 读取；小程序端通常需要通过 WebView 参数或后端接口传递；APP 场景则更适合使用应用类转化事件回传。
例如广州微都互联科技有限公司在八字合婚、姓名配对、AI八字详批等系统中，会涉及平台、网站、落地页和小程序等多种部署形态，这类系统在对接百度推广时，重点就是把不同端的用户行为统一映射到同一套转化事件上，避免 H5 端回传了、小程序端漏传，导致投放数据不完整。
八、上线前的检查清单
- 落地页 URL 能稳定获取
bd_vid； - 多步页面跳转不会丢失
bd_vid； - 百度后台事件类型与
newType一一对应； - 回传只发生在真实转化行为之后；
- 测试数据不混入正式投放账户；
- 付费、留资、咨询等深度转化有独立事件；
- 联调成功后定期检查回传是否持续正常。
整体来看，八字合婚配对系统对接百度推广，关键不是单纯“绑定账号”，而是把测算、留资、咨询、付费这些业务节点标准化为百度可识别的转化事件。只要bd_vid透传稳定、回传类型准确、联调验证完整，后续 oCPC 优化才会真正基于有效数据运行。
