管理事务型消息 managing-transactional-messages

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：
API

创建对象：

有经验的
开发人员

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

NOTE

此部分中详细介绍了事件配置。

例如，您希望每当客户在购物车中购买产品之前离开您的网站时，都会触发“购物车放弃”事件。要执行此操作，作为Web开发人员，您必须使用REST事务型消息API。

根据POST方法发送请求，这将触发事务性事件的发送。
对POST请求的响应包含主键，该主键允许您通过GET请求发送一个或多个请求。然后，即可获取事件状态。

发送事务性事件 sending-a-transactional-event

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

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

<组织>：您的个人组织ID。请参阅此小节。
<transactionalAPI>：事务性消息API端点。

事务性消息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预览按钮提供了一个请求示例。请参阅此小节。

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

过期（可选）：在此日期之后，将取消发送事务性事件。
已计划（可选）：从此日期起，将处理事务型事件并发送事务型消息。

NOTE

“expiration”和“scheduled”参数的值遵循ISO 8601格式。 ISO 8601指定使用大写字母“T”来分隔日期和时间。但是，可以从输入或输出中删除它以提高可读性。

对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":""
}

事务性事件状态 transactional-event-status

在响应中，“status”字段让您知道事件是否已处理：

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

recommendation-more-help

3ef63344-7f3d-48f9-85ed-02bf569c4fff