트랜잭션 이벤트를 만들고 게시하면 이 이벤트 트리거를 웹 사이트에 통합해야 합니다.
이벤트 구성은에 자세히 설명되어 있습니다. 이 섹션.
예를 들어 장바구니에서 제품을 구매하기 전에 고객 중 한 명이 웹 사이트를 떠날 때마다 "장바구니 포기" 이벤트를 트리거해야 합니다. 이렇게 하려면 웹 개발자로서 REST 트랜잭션 메시지 API를 사용해야 합니다.
트랜잭션 이벤트는 다음 URL 구조를 사용하는 POST 요청을 통해 전송됩니다.
POST https://mc.adobe.io/<ORGANIZATION>/campaign/<transactionalAPI>/<eventID>
<organization>: 개인 조직 ID입니다. 이 섹션을 참조하십시오.
<transactionalapi>: 트랜잭션 메시지 API 엔드포인트.
트랜잭션 메시지 API 엔드포인트의 이름은 인스턴스 구성에 따라 다릅니다. 개인 조직 ID가 뒤에 오는 "mc" 값에 해당합니다. "geometrixx"를 조직 ID로 사용하는 Geometrixx 회사의 예를 들어 보겠습니다. 이 경우 POST 요청은 다음과 같습니다.
POST https://mc.adobe.io/geometrixx/campaign/mcgeometrixx/<eventID>
트랜잭션 메시지 API 엔드포인트는 API 미리 보기 시에도 표시됩니다.
<eventid>: 전송할 이벤트 유형입니다. 이 ID는 이벤트 구성을 만들 때 생성됩니다( 이 섹션).
요청에는 "Content-Type: application/json" 헤더.
예를 들어 charset을 추가해야 합니다 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' \
이벤트 데이터는 JSON POST 본문 내에 포함되어 있습니다. 이벤트 구조는 해당 정의에 따라 다릅니다. 리소스 정의 화면의 API 미리 보기 단추는 요청 샘플을 제공합니다. 이 섹션을 참조하십시오.
다음 선택적 매개 변수를 이벤트 콘텐츠에 추가하여 이벤트에 연결된 트랜잭션 메시지 전송을 관리할 수 있습니다.
"만료" 및 "예약된" 매개 변수의 값은 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":""
}
응답에서 "상태" 필드를 사용하면 이벤트가 처리되었는지 여부를 알 수 있습니다.