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

Question

  

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

     

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

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

Answer 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":[
        // …
    ]
}