创建并发布交易事件后,您需要将触发此事件集成到您的网站中。
配置事件显示在本节中。
例如,您希望在您的客户中的某位离开您的网站后,在购买购物车中的产品之前,触发“购物车放弃”事件。 为此,您的Web开发人员必须使用REST事务性消息API。
交易事件通过具有以下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(请参阅此部分)。
请求必须包含“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' \
事件数据包含在JSONPOST主体中。 事件结构取决于其定义。 资源定义屏幕中的API预览按钮提供了请求示例。 请参阅此章节 。
可以将以下可选参数添加到事件内容,以管理链接到事件的事务性消息的发送:
“expiration”和“scheduled”参数的值采用ISO 8601格式。 ISO 8601指定使用大写字母“T”分隔日期和时间。 但是,可以从输入或输出中删除它,以提高可读性。
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":""
}
在响应中,“状态”字段允许您了解事件是否已处理: