活动

最近更新： 2024年11月4日
  • 主题：

创建对象：

  • 管理员

Marketo允许与潜在客户记录相关的各种活动类型。  几乎每个更改、操作或流程步骤都根据商机的活动日志进行记录，并且可以通过API检索或在智能列表以及智能营销活动过滤器和触发器中使用。  活动始终通过leadId与潜在客户记录相关联，对应于记录的Id字段，并具有其自身的唯一ID。

潜在活动类型非常多，它们可能因订阅而异，并且每种活动类型的定义都各不相同。 虽然每个活动都有自己的唯一id、leadId和activityDate，但primaryAttributeValueId和primaryAttributeValue值在含义上有所不同。

Marketo还允许通过自定义活动元数据API创建自定义活动类型。 添加自定义活动通过添加自定义活动API完成。

大多数活动将在一段时间后清除。

描述

要检索实例的可用类型及其定义的列表，您可以使用获取活动类型端点。

GET /rest/v1/activities/types.json

  "requestId": "6e78#148ad3b76f1",
  "success": true,
  "result": [
    {
      "id": 2,
      "name": "Fill Out Form",
      "description": "User fills out and submits form on web page",
      "primaryAttribute": {
        "name": "Webform ID",
        "dataType": "integer"
      },
      "attributes": [
        {
          "name": "Client IP Address",
          "dataType": "string"
        },
        {
          "name": "Form Fields",
          "dataType": "text"
        },
        {
          "name": "Query Parameters",
          "dataType": "string"
        },
        {
          "name": "Referrer URL",
          "dataType": "string"
        },
        {
          "name": "User Agent",
          "dataType": "string"
        },
        {
          "name": "Webpage ID",
          "dataType": "integer"
        }
      ]
    }
  ]
}

现实世界的应对措施包括更多定义。 在此示例中，显示的类型为“填写表单”，其主要属性为“Webform ID”，该属性是指所填写表单的Marketo ID，可用于与Marketo中的特定资源相关联。 此外，还有此类型的特定活动记录及其数据类型的每个可能属性的定义。 请注意，如果字段为空，则单个活动记录中会忽略该特定属性。

查询

要从Marketo检索活动，请调用获取潜在客户活动端点。 您需要首先为要开始从中检索活动的日期时间检索分页令牌。 然后在nextPageToken查询参数中传递分页令牌。 此外，您最多可以将activityTypeIds查询参数中的10个活动类型ID作为逗号分隔列表传递。

您可以选择包括listId查询参数以仅搜索特定静态列表中包含的记录，或者包括leadIds查询参数并仅搜索一组指定潜在客户中的活动。 您最多可以将30个潜在客户ID作为逗号分隔列表传递。

GET /rest/v1/activities.json?activityTypeIds=1&nextPageToken=WQV2VQVPPCKHC6AQYVK7JDSA3I3LCWXH3Y6IIZ7YSGQLXHCPVE5Q====

{
  "requestId": "24fd#15188a88d7f",
  "result": [
    {
      "id": 102988,
      "marketoGUID": "102988",
      "leadId": 1,
      "activityDate": "2023-01-16T23:32:19Z",
      "activityTypeId": 1,
      "primaryAttributeValueId": 71,
      "primaryAttributeValue": "localhost/munchkintest2.html",
      "attributes": [
        {
          "name": "Client IP Address",
          "value": "10.0.19.252"
        },
        {
          "name": "Query Parameters",
          "value": ""
        },
        {
          "name": "Referrer URL",
          "value": ""
        },
        {
          "name": "User Agent",
          "value": "Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/39.0.2171.95 Safari/537.36"
        },
        {
          "name": "Webpage URL",
          "value": "/munchkintest2.html"
        }
      ]
    }
  ],
  "success": true,
  "nextPageToken": "WQV2VQVPPCKHC6AQYVK7JDSA3J62DUSJ3EXJGDPTKPEBFW3SAVUA====",
  "moreResult": false
}

对于第一次调用，请使用获取分页令牌API获取nextPageToken。 对于对此端点的后续调用，请使用响应中的nextPageToken returned。 此终结点始终返回the nextPageToken。

如果moreResult属性为true，则表示有更多的结果可用。 继续调用此终结点，直到moreResult属性返回false，这意味着没有可用的结果。 从此API返回的nextPageToken应始终在此调用的下一个迭代中重用。

在某些情况下，此API可能会以少于300个活动项进行响应，但也会将moreResult属性设置为true。  这表示可以返回的活动更多，并且可以通过在后续调用中包含返回的nextPageToken来查询终结点以获取更新的活动。

请注意，在每个结果数组项中，id integer属性将替换为marketoGUID string属性作为唯一标识符。