本指南解释了如何使用 Snov.io API 获取营销活动分析和收件人互动数据。
Snov.io 的分析和报告 API 可让您访问推广效果数据。通过 API 请求，您可以获取邮件和领英营销活动的进度、互动指标和收件人活动信息。
1）通过电子邮件和领英监控营销活动效果
2）将收件人互动数据同步到您的 CRM 系统
3）构建内部仪表盘和报告
4）根据回复、打开或点击情况协调工作流程
使用身份验证方法获取访问令牌。将其作为 Bearer 令牌包含在所有请求中。该令牌有效期为 1 小时（3600 秒）。
查看营销活动及进度
查看所有营销活动
获取您 Snov.io 帐户中的所有营销活动列表，包括其 ID 和基本详细信息。
使用此方法获取请求其他方法所需的营销活动 ID。
它提供哪些数据：
- 营销活动 ID
- 营销活动名称
- 营销状态
- 创建日期
查看营销进展
查看特定营销活动的当前状态和完成进度。
使用此方法监控营销活动是否正在运行、已完成、已暂停或需要关注。
必填参数：
- campaign_id — 营销活动 ID
它提供哪些数据：
- status：当前营销状态（进行中、暂停、已完成、已存档）
- progress：显示到达最后一个步骤的潜在客户百分比，以及因退订、回复、自动回复、取消订阅、删除或手动移除而提前结束营销活动的潜在客户百分比
- unfinished：计划接受后续步骤的接收者人数
营销统计数据和报告
使用以下方法获取营销活动参与度和效果指标。
获取营销活动分析
获取所有营销活动的汇总效果统计数据。
使用此方法可以生成报告、监控推广 KPI，并将活动统计数据同步到外部仪表板或分析工具。
必填参数：
指定要检索统计信息的日期范围。
- date_from — 报告期起始日期（YYYY-MM-DD）
- date_to — 报告期结束日期（YYYY-MM-DD）
可选参数用作过滤器，以缩小返回数据的范围。
- campaign_id — 获取特定营销活动的分析数据
- campaign_owner — 获取特定团队成员的分析数据
- sender_email — 获取特定发件人电子邮箱帐户的分析数据
- sender_linkedin — 获取特定领英个人资料的分析数据
它提供哪些数据：
回复中包含电子邮件和领英渠道的汇总绩效数据：
- 总体营销指标：触达潜在客户总数、已安排电子邮件发送数量、已发送电子邮件数量以及检测到的退信总数
- 电子邮件互动指标：打开次数、点击次数、回复次数、退订次数、打开率、点击率和回复率
- 领英活动指标：已发送的连接请求、已接受的连接、已发送的消息和已收到的回复
获取营销接收者的活动
获取营销活动中所有收件人的详细互动数据，包括电子邮件和领英互动。
使用此方法将互动数据同步到您的 CRM、分析平台或报告工具。
必填参数：
campaign_id — 营销活动 ID
它提供哪些数据：
- 潜在客户详情：姓名、电子邮箱地址
- 每个收件人的邮箱活动：已发送邮件、已打开邮件、已点击邮件、已回复邮件、已退回邮件
- 每个收件人的领英活动：已发送和已接受的连接请求、已发送的消息和已收到的回复
- 每次互动事件的时间戳
获取营销活动回复
检索特定营销活动中收到的电子邮件回复。
如果您只需要电子邮件回复数据，而不需要领英回复数据，可以使用此方法将回复数据导入您的 CRM 或自动化工作流程。要获取领英回复（包括人脉请求、私信和 InMail），请使用“获取所有活动回复”方法。
必填参数：
campaign_id — 营销活动 ID
它提供哪些数据：
- 潜在客户详情：姓名、电子邮箱地址
- 电子邮件标题和邮件正文
- 触发回复的序列步骤（step_number）
- AI检测到的回复情感（mood）
- 回复时间戳
获取所有营销回复
检索特定营销活动中通过电子邮件和 LinkedIn 渠道收到的所有回复。
使用此方法监控潜在客户的回复，并将回复数据导入您的 CRM 或自动化工作流程。
必填参数：
campaign_id — 营销活动 ID
它提供哪些数据：
- 潜在客户详情：姓名、电子邮箱地址
- 回复方式：电子邮件回复或领英回复
- 电子邮件主题和邮件正文
- 领英回复内容
- 触发回复的序列步骤（step_number）
- AI检测到的回复情感（mood）
- 回复时间戳
获取电子邮件打开
获取有关营销活动中打开电子邮件的收件人的数据。
使用此方法可以监控电子邮件互动情况并衡量邮件打开率。
必填参数：
campaign_id — 营销活动 ID
它提供哪些数据：
- 潜在客户详情：姓名、电子邮箱地址
- 邮件打开次数
- 首次打开和最近一次打开的时间戳
获取链接点击量
获取有关点击营销邮件中链接的收件人的数据。
使用此方法跟踪点击率、互动情况和内容表现。
必填参数：
campaign_id — 营销活动 ID
它提供哪些数据：
- 潜在客户详情：姓名、电子邮箱地址
- 点击的网址
- 每个收件人的点击次数
- 点击时间戳
接收电子邮件
获取营销活动中发送的电子邮箱列表。
使用此方法验证发送记录并跟踪发送活动。
必填参数：
campaign_id — 营销活动 ID
它提供哪些数据：
- 潜在客户详情：姓名、电子邮箱地址
- 使用的发件人帐户
- 电子邮件主题
- 序列步骤编号
- 发送时间戳
获取已完成的潜在客户信息
检索已完成营销活动所有步骤的潜在客户。
利用这些数据来识别已完成该序列的接收者，他们可能需要后续跟进或参加另一项活动。
必填参数：
campaign_id — 营销活动 ID
它提供哪些数据：
- 潜在客户详情：姓名、电子邮箱地址
- 潜在客户完成序列的日期
- 最终序列步骤已完成