我正在尝试从平台上获取“电子邮件效果报告” 使用API按电子邮件类型分析KPI,如CTR等 (时事通讯,电子邮件营销等)。
我浏览了文档,但是我找不到端点 我可以拿到它。
有没有人知道是否有办法获取此信息?
答案 0 :(得分:1)
没有端点可以直接查询报告。然而,好消息是,构成“电子邮件性能报告”的“事物”,即:电子邮件递送,退回,打开和点击,可通过API查询。
这意味着您必须自己构建报告,但是您可以获取要处理的数据集。
这些“东西”被称为活动类型(在Lead上测量的活动),可以通过查询Get Lead Activities端点来获取,这也被称为Query }在API文档中
它位于GET /rest/v1/activities.json
网址,您必须传递nextPageToken
和activityTypeIds
作为查询参数。
nextPageToken
表示日期时间。通话后将返回该日期之后的活动。要获得一个,您必须拨打GET /rest/v1/activities/pagingtoken.json,在那里您必须指定从中检索活动的最早日期时间。详细了解Paging Tokens。
要弄清楚activityTypeIds
的值,首先需要获取您感兴趣的活动类型的内部ID。为了做到这一点,您必须查询GET /rest/v1/activities/types.json端点并查找名称的活动类型,如Send Email
,Email Delivered
,Email Bounced
, Unsubscribe Email
,Open Email
和Click Email
。 (我不知道这些ID是不是从一个实例变为另一个实例,但在我们的实例中这些是从#6到#11)。
一旦掌握了所有这些内容,您就可以提出这样的要求:
GET https://<INSTANCE_ID>.mktorest.com/rest/v1/activities.json?activityTypeIds=<TYPE_ID>&nextPageToken=<NEXTPAGE_TOKEN>&access_token=<ACCESS_TOKEN>
它给出的结果是一个包含如下项目的数组。可以根据primaryAttributeValue
属性将项目过滤为特定电子邮件,并进一步相应处理。
{
"id":7370416,
"marketoGUID":"7170506",
"leadId":291305,
"activityDate":"2017-12-17T00:00:00Z",
"activityTypeId":11,// #11 = `Click Email`
"campaignId":1790,
"primaryAttributeValueId":1638,
"primaryAttributeValue":"EMAIL_NAME",// Name of the Email as seen in Marketo
"attributes":[
// …
]
}