如何通过 API 获取营销活动分析数据

了解如何使用 API 请求从您的 Snov.io 帐户检索统计数据。

本指南解释了两个请求：

获取营销活动分析

查看营销进展

让我们回顾一下它们的使用案例和主要参数。

获取营销活动分析

请求类型：GET

请求的 URL：https://api.snov.io/v2/statistics/campaign-analytics

链接到 API 文档。

这个请求为您提供了详细的 Snov.io 营销活动分析数据。您可以使用它来检索整个营销成功的数据或根据营销、发件人、团队成员或时间段筛选结果。

它还可以帮助您使用帐户中的数据自动生成报告，并将您的 Snov.io 关键绩效指标集成到您的报告流程中。

请求参数

这个请求中的所有参数都是可选的。如果未提供任何参数，则请求将返回所有营销和帐户的历史统计数据。

要在响应中筛选数据，请在请求的参数中应用相关过滤器。详细的参数列表请参见 API 文档。

例如，使用请求参数中的“campaign_id”字段指定您要获取统计数据的营销 ID。可以为特定或多个营销添加 ID（多个ID之间用逗号分隔）。

要检索特定团队成员的数据，请使用“campaign_owner”字段。输入团队成员在 Snov.io 中加入团队时使用的邮箱地址。

在我的团队页面上查找团队成员的邮箱。如果您是 Snov.io 中的团队负责人或启用了“查看团队记录”权限，则可以使用“营销所有者”过滤器。

请求结果

响应将包括您在 Snov.io 中推广的所有默认指标，涵盖邮件和领英自动化的统计数据。

结果中返回的每个指标数据取决于所应用的筛选器。如果包含零 (0) 个值，则表示根据请求参数没有可用的数据。调整您的请求以访问更多营销数据。

通用数据字段：联系的潜在客户总数（通过邮件或领英）。

邮件数据字段：通过邮件联系、已发送的邮件、首封邮件、跟进、已送达、已退回、邮件打开、链接点击、邮件回复、取消订阅和自动回复。

领英数据字段：通过领英联系、领英回复（针对所有类型的消息）、连接请求、失败的连接请求、接受的请求、发送的消息；领英浏览量、关注量、点赞量。

查看API 响应中提供的完整字段列表。可以在 Snov.io 应用程序的报告仪表盘上找到此数据的直观表示。

查看营销进展

请求类型：GET

请求的 URL：https ://api.snov.io/v2/campaigns/[campaign_id]/progress

链接到 API 文档。

使用此请求获取有关营销活动进展的数据。它将告诉您有多少收件人已完成营销，有多少仍在进行中，以及有多少收件人已停止参与。

请求参数

此请求需要一个参数：营销 ID，即您的 Snov.io 帐户中营销的唯一标识符。

使用请求参数中的“campaign_id”字段指定您想要查看进度的营销。一个请求可以为一个营销提供数据。发出更多请求以查看更多营销的进展。

请求结果

响应中的进度字段显示为已完成指定营销序列或已停止序列的潜在客户的百分比。停止序列的原因包括：邮件被退回、潜在客户回复、自动回复或取消订阅、从营销中删除或移至另一个潜在客户列表。

查看API 响应中提供的完整字段列表。

响应中的未完成字段显示营销仍在进行中的收件人数量。这些收件人尚未到达自动化营销序列的末尾，并且序列尚未停止（由于进度字段中列出的原因）。

响应结果还提供了请求时的当前营销“状态” 。要了解更多关于可能的营销状态，请参阅知识库文章。