在调查猴子响应中获取消息ID

时间:2017-02-08 18:05:15

标签: surveymonkey

我正在使用调查猴子v3 API发送调查电子邮件。在从一个收集者发送调查电子邮件时,我正在为同一收件人发送两条不同的调查邮件。但是,在使用api" / surveys / {id} / responses / bulk"收集调查猴子的调查回复时,我无法在其中找到messageID。那我怎么能找到哪个响应属于收集器的哪个消息呢?我必须使用不同的API吗?

1 个答案:

答案 0 :(得分:0)

跟踪特定邮件的用例是什么?您有recipient_id和第一个/最后一个/电子邮件字段。

您可以在/collectors/{collector_id}/recipients/{recipient_id}获取收件人详细信息。除了使用/collectors/{collector_id}/messages/{message_id}/recipients

搜索您的邮件之外,我无法(据我所知)查询此信息。

一般来说,当您向邮件添加收件人时,它们会与收集器共享。未真正跟踪响应的特定邮件,跟踪ID是收集器的recipient_id

如果您对邮件统计信息感兴趣(例如哪条邮件获得更好的回复率),您可以使用message stats endpoint

关于说出不同产品的不同消息,遗憾的是消息ID与响应无关,但有两个选项:

1)为每种产品使用不同的收集器(如果有很多则不理想) 2)在收件人上使用额外的字段(参见示例):

示例:

POST /v3/collectors/<collector_id>/messages/<message_id1>/recipients
{
    "first_name": "Test",
    "last_name": "Tester",
    "email": "test@example.com",
    "extra_fields": {
        "product": "shoes"
    }
}

POST /v3/collectors/<collector_id>/messages/<message_id2>/recipients
{
    "first_name": "Test",
    "last_name": "Tester",
    "email": "test@example.com",
    "extra_fields": {
        "product": "shirts"
    }
}

然后,当您获取回复时,您将在元数据中获取该信息,例如:

{
  "id": "<response_id>",
  "recipient_id": "<recipient_id>",
  "collector_id": "<collector_id>",
  ...
  "metadata": {
    "contact": {
      "product": {
        "type": "string",
        "value": "shoes"
      },
      "email": {
        "type": "string",
        "value": "test@example.com"
      }
    }
  }
}

需要注意的一点是,联系人的额外字段当前不会显示在/responses/bulk端点中,只显示单个responses/<id>端点。此外,对于额外的字段,您无法过滤product=shoes或其他内容的响应。这些是当前API的一些限制 - 但希望它至少对现在有用。