三方广告（Triple Whale）对接指南

2026-10-15 15:01| 发布者: 万红刚| 查看: 7| 评论: 0

摘要: 三方广告（TripleWhale）对接指南1.适用范围“三方广告”连接器对应TripleWhale，用于读取广告归因数据。创建数据账户需要TripleWhaleAPIKey和目标店铺的ShopID。2.获取TripleWhale对接资质2.1生成APIKey登录TripleW ...

三方广告（Triple Whale）对接指南

1. 适用范围

“三方广告”连接器对应 Triple Whale，用于读取广告归因数据。创建数据账户需要 Triple Whale API Key 和目标店铺的 Shop ID。

2. 获取 Triple Whale 对接资质

2.1 生成 API Key

登录 Triple Whale，进入 Data → APIs，点击 Generate，填写用途说明，并为需要读取的接口选择相应的读取权限。当前连接器用于读取广告归因数据，可先核对 Pixel Attribution: Read；若还要读取 Summary Page 数据，也选择 Summary Page: Read。点击 Generate 创建密钥。

Triple Whale 官方示例中的 API Key 创建页及权限选项

截图展示旧版“Settings → API Keys”界面；当前入口以官方文档所述的 Data → APIs 为准。图中的权限勾选仅为官方示例，应按实际使用的接口选择。操作说明见Triple Whale 官方 API Key 创建指南。

创建成功后，在弹窗中复制密钥并安全保存。弹窗关闭后，原密钥无法再次查看；请勿把真实密钥放入截图或公开文档。

Triple Whale 官方示例中的 API Key 生成结果弹窗，密钥已遮挡

密钥保存规则见Triple Whale 官方 API Key 管理说明。

2.2 查找 Shop ID

登录 Triple Whale 并切换到目标店铺，查看浏览器地址栏中的 shop-id 参数；将等号后的完整值作为店铺 ID。例如地址中显示 shop-id=example.myshopify.com，则填写 example.myshopify.com。也可在 Store Settings → General 中核对店铺地址。请以目标店铺页面显示的实际值为准。

具体位置见Triple Whale 官方 Shop ID 查找说明；其API 字段说明也将 shop-id 作为店铺标识示例。

2.3 需要保存的资质字段

Triple Whale 字段	获取位置	连接器用途
API Key	Data → APIs → Generate	填写 API 密钥（apiKey）
Shop ID	目标店铺页面地址栏中的 `shop-id`	填写店铺 ID（shopId）

3. 创建连接器数据账户

3.1 选择平台

在观远连接器的数据账户管理中点击“新增数据账户”，所属平台选择“三方广告”。

观远连接器新增三方广告数据账户表单

3.2 字段映射关系

Triple Whale 字段	连接器字段	是否必填	官方获取入口	说明
无	账户名称	是	无	自行命名，用于识别数据账户。
API Key	API 密钥（apiKey）	是	查看官方 API Key 创建步骤	使用创建时复制并保存的密钥。
Shop ID	店铺 ID（shopId）	是	查看官方 Shop ID 查找说明	复制目标店铺地址中的完整 `shop-id` 值。

3.3 测试连接并保存

填写所有必填字段，点击“测试连接”；测试成功后点击“确定”保存。若测试连接失败，先确认 API Key 有效；若后续接口无法读取数据，再核对 API Key 权限和店铺 ID。

4. 常见问题

问题	处理建议
API Key 弹窗已关闭，找不到原密钥	按 Triple Whale 官方说明重新生成密钥，并更新连接器数据账户。
店铺 ID 填写后数据仍为空	核对当前 Triple Whale 店铺地址栏中的 `shop-id` 值，并检查 API Key 对该店铺和所需读取接口的访问权限。