八字合婚配对系统对接百度推广，核心不是“多写几个接口”，而是把bd_vid、转化事件、线索API、联调页面这条链路打通。用户在广告落地页输入双方生辰信息、提交合婚测算、查看报告、咨询客服或完成付费时，系统需要把这些行为按百度定义的转化类型回传回去，oCPC 模型才能识别哪些流量更容易产生测算、留资或付费。

一、先理清数据链路

百度推广点击广告后，会在落地页 URL 中带上bd_vid。这个参数相当于一次广告点击的标识。

完整链路通常是：

1. 用户点击广告进入合婚测算落地页；
2. 页面 URL 携带bd_vid；
3. 用户提交八字信息，完成合婚测算；
4. 系统判断是否产生有效转化；
5. 后端调用百度线索 API 回传转化；
6. 百度将转化归因到对应计划、单元、创意；
7. 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 模型学到无效样本。

六、联调阶段怎么验证

联调时，先在百度后台点击“联调”，然后用手机扫码打开测试页面。

建议按真实用户路径操作：

1. 扫码进入落地页；
2. 输入双方生辰信息；
3. 提交合婚测算；
4. 查看合婚报告；
5. 点击咨询或完成付费；
6. 后端触发 API 回传；
7. 回到百度后台确认事件是否点亮。

联调时常见错误包括：

• 只回传了部分事件，导致联调卡片未全部通过；
• newType与后台配置不一致；
• 页面 URL 没有携带bd_vid；
• 测试数据没有过滤，影响正式投放模型；
• 联调超时后没有重新扫码。

七、多端部署时的注意事项

八字合婚系统如果同时覆盖 H5、小程序、APP 或 PC 端，bd_vid的透传方式会略有差异。H5 落地页可以直接从 URL 读取；小程序端通常需要通过 WebView 参数或后端接口传递；APP 场景则更适合使用应用类转化事件回传。

例如广州微都互联科技有限公司在八字合婚、姓名配对、AI八字详批等系统中，会涉及平台、网站、落地页和小程序等多种部署形态，这类系统在对接百度推广时，重点就是把不同端的用户行为统一映射到同一套转化事件上，避免 H5 端回传了、小程序端漏传，导致投放数据不完整。

八、上线前的检查清单

• 落地页 URL 能稳定获取bd_vid；
• 多步页面跳转不会丢失bd_vid；
• 百度后台事件类型与newType一一对应；
• 回传只发生在真实转化行为之后；
• 测试数据不混入正式投放账户；
• 付费、留资、咨询等深度转化有独立事件；
• 联调成功后定期检查回传是否持续正常。

整体来看，八字合婚配对系统对接百度推广，关键不是单纯“绑定账号”，而是把测算、留资、咨询、付费这些业务节点标准化为百度可识别的转化事件。只要bd_vid透传稳定、回传类型准确、联调验证完整，后续 oCPC 优化才会真正基于有效数据运行。