Question

我需要让那些在＆＃34; progressStatus＆＃34;上发生变化的Marketo Leads使用API的字段（内部成员资格）。我可以毫无问题地获得与程序相关的所有潜在客户（通过ProgramID API获取Leads），但我的需求是让那些潜在客户在＆＃34; progressionStatus＆＃34;柱。我正在考虑使用本程序的CreatedAt / UpdatedAt字段，然后获取与这些程序相关的所有线索。但我没有得到我想要的准确结果。此外，我尝试使用GET Lead changes API并使用＆＃34; fields＆＃34;参数到＆＃34; progressstatus＆＃34;但那个领域不存在。

有可能解决这个问题吗？提前谢谢。

Answer 1

您可以通过查询Get Lead Activities端点来获取进度状态发生变化的潜在客户列表。

Get Lead Changes端点可能听起来很合适，但该端点仅返回引导字段的更改。进度状态更改不会直接存储在潜在客户端，因此最终将无效。另一方面，Get Leads by ProgramId端点返回-amongst others- progressionStatus的实际值（父程序中的潜在客户的程序状态），而不是“ change ”本身，因此您无法基于此处理结果集。

好消息是，进展状态更改是活动类型，幸运的是我们有上面提到的Get Lead Activities端点（在API文档中也被称为Query ）可用于查询。此端点还允许按activityTypeIds进行过滤，以将结果集缩小为单个活动类型。

基本上，您必须调用GET /rest/v1/activities.json enpoint并将activityTypeIds和nextPageToken的值作为查询参数传递（显然在访问令牌旁边）。因此，首先需要获取名为“进度中的更改状态”的活动类型的内部标识。您可以通过查询GET /rest/v1/activities/types.json端点并查找具有名称的记录来执行此操作。（我不知道这个Id是否从实例变为实例，但在我们的实例中它是＃104）。此外，要获得nextPageToken，您还必须拨打GET /rest/v1/activities/pagingtoken.json，您必须指定最早的日期时间来检索活动。详细了解Paging Tokens。

一旦掌握了所有这些内容，您就可以提出这样的要求：

GET https://<INSTANCE_ID>.mktorest.com/rest/v1/activities.json?activityTypeIds=<TYPE_ID>&nextPageToken=<NEXTPAGE_TOKEN>&access_token=<ACCESS_TOKEN>

它给出的结果是一个包含如下项目的数组，这些数据很容易进一步处理。

{
    "id":712630,
    "marketoGUID":"712630",
    "leadId":824864,
    "activityDate":"2017-12-01T08:51:13Z",
    "activityTypeId":104,
    "primaryAttributeValueId":1104,
    "primaryAttributeValue":"PROGRAM_NAME",
    "attributes":[
        {"name":"Acquired By","value":true},
        {"name":"New Status ID","value":33},
        {"name":"Old Status ID","value":32},
        {"name":"Reason","value":"Filled out form"},
        {"name":"Success","value":false},
        {"name":"New Status","value":"Filled-out Form"},
        {"name":"Old Status","value":"Not in Program"}
    ]
}

了解有问题的leadId，您可以再次提出获取实际潜在客户记录的请求。

Marketo Leads - 如何查找progressionStatus字段

1 个答案: