如何使用API​​从Marketo获取电子邮件营销洞察数据?

时间:2017-07-26 14:03:53

标签: marketo

  

我正在尝试从平台上获取“电子邮件效果报告”   使用API​​按电子邮件类型分析KPI,如CTR等   (时事通讯,电子邮件营销等)。

     

我浏览了文档,但是我找不到端点   我可以拿到它。

有没有人知道是否有办法获取此信息?

1 个答案:

答案 0 :(得分:1)

没有端点可以直接查询报告。然而,好消息是,构成“电子邮件性能报告”的“事物”,即:电子邮件递送,退回,打开和点击,可通过API查询。
这意味着您必须自己构建报告,但是您可以获取要处理的数据集。

这些“东西”被称为活动类型(在Lead上测量的活动),可以通过查询Get Lead Activities端点来获取,这也被称为Query }在API文档中 它位于GET /rest/v1/activities.json网址,您必须传递nextPageTokenactivityTypeIds作为查询参数。

nextPageToken表示日期时间。通话后将返回该日期之后的活动。要获得一个,您必须拨打GET /rest/v1/activities/pagingtoken.json,在那里您必须指定从中检索活动的最早日期时间。详细了解Paging Tokens

要弄清楚activityTypeIds的值,首先需要获取您感兴趣的活动类型的内部ID。为了做到这一点,您必须查询GET /rest/v1/activities/types.json端点并查找名称活动类型,如Send EmailEmail DeliveredEmail BouncedUnsubscribe EmailOpen EmailClick 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":[
        // …
    ]
}