管理事务型消息

关于事务型消息传递

创建并发布交易事件后，您需要将触发此事件集成到您的网站中。

例如，您希望在您的客户中的某位离开您的网站后，在购买购物车中的产品之前，触发“购物车放弃”事件。 为此，您的Web开发人员必须使用REST事务性消息API。

1. 开发者根据POST方法发送请求，该方法触发事务事件的发送。
2. 对POST请求的响应包含主密钥，该主密钥允许开发者通过GET请求发送一个或多个请求。 这样，他就能获得事件状态。

发送事务事件

交易事件通过具有以下URL结构的POST请求发送：

POST https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>

• <organization>:您的个人组织ID。请参阅此章节 。

• <transactionalapi>:事务性消息API endPoints。

  事务性消息API端点的名称取决于您的实例配置。 它对应于值“mc”后跟您的个人组织ID。 让我们举一个Geometrixx公司的示例，其组织ID为“geometrixx”。 在这种情况下，POST请求如下：

  POST https://mc.adobe.io/geometrixx/campaign/mcgeometrixx/<eventID>

  (请注意，在API预览期间，事务性消息API端点也可见)

• <eventid>:要发送的事件类型。创建事件配置时将生成此ID（请参阅此部分）。

POST请求标题

请求必须包含“Content-Type:application/json”标题。

必须添加字符集，例如​utf-8。 请注意，此值取决于您使用的REST应用程序。

-X POST \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>' \
-H 'Content-Type: application/json;charset=utf-8' \
-H 'Content-Length:79' \

POST请求主体

事件数据包含在JSONPOST主体中。 事件结构取决于其定义。 资源定义屏幕中的API预览按钮提供了请求示例。 请参阅此章节 。

可以将以下可选参数添加到事件内容，以管理链接到事件的事务性消息的发送：

• expiration （可选）：在此日期之后，将取消事务事件的发送。
• scheduled （可选）：从此日期开始，将处理交易事件，并发送事务性消息。

对POST请求的响应

POST响应返回创建时的事务事件状态。 要检索其当前状态(事件数据、事件状态……)，请在GET请求中使用POST响应返回的主键：

GET https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>/

示例请求

POST请求发送事件。

-X POST https://mc.adobe.io/<ORGANIZATION>/campaign/mcAdobe/EVTcartAbandonment \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Cache-Control: no-cache' \
-H 'X-Api-Key: <API_KEY>' \
-H 'Content-Type: application/json;charset=utf-8' \
-H 'Content-Length:79'

{
  "email":"test@example.com",
  "scheduled":"2017-12-01 08:00:00.768Z",
  "expiration":"2017-12-31 08:00:00.768Z",
  "ctx":
  {
    "cartAmount": "$ 125",
    "lastProduct": "Leather motorbike jacket",
    "firstName": "Jack"
  }
}

响应POST请求。

{
  "PKey":"<PKEY>",
  "ctx":
  {
    "cartAmount": "",
    "lastProduct": "",
    "firstName": ""
  }
  "email":"",
  "scheduled":"2017-12-01 08:00:00.768Z",
  "expiration":"2017-12-31 08:00:00.768Z",
  "href": "mcAdobe/EVTcartAbandonment/<PKEY>",
  "serverUrl":" https://myserver.com ",
  "status":"pending",
  "type":""
}

事务事件状态

在响应中，“状态”字段允许您了解事件是否已处理：

• 待定:事件处于挂起状态 — 事件在刚触发该状态时即会启用该状态。
• 处理:事件正在等待投放 — 正在将其转换为消息并发送消息。
• 暂停:事件进程正在暂停。它不再被处理，而是保留在Adobe Campaign数据库的队列中。 如需详细信息，请参阅此部分。
• 已处理:已处理事件，消息已成功发送。
• 忽略:事件被投放忽略，通常在地址处于隔离时。
• deliveryFailed:处理投放时发生事件错误。
• routingFailed:路由阶段失败 — 例如，当找不到指定的事件类型时，可能会出现这种情况。
• tooOld:事件在处理之前已过期 — 这可能出于各种原因，例如，发送失败多次(这导致事件不再是最新的)或服务器在过载后无法再处理事件。
• targetingFailed:Campaign Standard未能扩充用于消息定位的链接。