线索鸭操作文档 - 媒体账号授权

为了实现线索的自动拉取，您需要建立线索鸭与媒体平台（如百度、巨量引擎等）的数据通路。本章节将指导您完成媒体账号的授权配置。

1. 核心概念

在操作之前，请理解以下两个术语：

• 媒体凭据 (Media Credential)：指您与媒体平台建立的“通行证”。例如，授权一个百度营销主账号，系统会获得一个凭据。
• 媒体子账号 (Media Account)：一个凭据（主账号）下通常管理着多个广告主 ID（Advertiser ID）。线索鸭在获得凭据授权后，会自动同步这些子账号，您可以批量开启或关闭特定子账号的线索同步。

部署版本差异说明：
本地部署版本：由于 OAuth 授权涉及回调地址，您需要先去各广告平台（如百度、巨量等）申请开发者账号并创建应用，将获取的 AppID 和 Secret 配置到线索鸭后台。
云端/SaaS版本：线索鸭已内置提供官方应用凭据，您直接点击授权即可使用。
Webhook方式：不受上述限制，所有版本均可直接生成 URL 使用

2. 通用授权流程 (OAuth 模式)

适用于：百度营销、巨量引擎、腾讯广告、快手、抖音来客。

1. 进入授权页面：在左侧导航栏选择 “上游接入 -> 媒体账号授权”。
2. 新增授权：点击页面右上角的 “新增授权” 按钮。
3. 选择平台：在弹出的对话框中选择对应的媒体平台（例如“百度营销”）。
4. 跳转授权：系统将自动跳转至该媒体平台的官方登录页面。
5. 确认授权：使用您的广告平台主账号登录，并确认授权给线索鸭。
6. 自动同步：授权成功后，页面会自动回到线索鸭，系统将立即开始同步该凭据下的所有媒体子账号。

3. 表单凭据流程 (Form 模式)

适用于：EC SCRM 等通过 API Key 对接的系统。

1. 获取参数：首先在第三方平台（如 EC 开放平台）获取 CorpId、AppId 和 AppSecret。
2. 输入配置：在新增授权弹窗中选择该平台，手动输入上述参数。
3. 点击保存：系统验证参数有效性后完成绑定。
   

4. 主流平台授权要点

5. 常见问题 (FAQ)

Q: 授权后发现子账号不全怎么办？

A: 可以在凭据列表点击 “刷新同步” 按钮，系统会再次向媒体平台请求最新的广告主清单。

Q: 授权显示“已过期”是什么意思？

A: 媒体平台的授权令牌（Token）通常有有效期（如 30 天）。过期后，线索将停止拉取。此时只需在列表点击 “重新授权”，再次登录确认即可恢复，无需删除原有账号。

Q: 删除凭据会影响已接入的线索吗？

A: 删除凭据会同时解绑其下的所有子账号，相关的接入渠道将失效。但已经拉取入库的线索数据不会被删除。

完成授权后：
您的账号列表现在已排排坐好。接下来，请点击 [配置接入渠道]，为这些账号设定具体的字段映射和同步逻辑。