트랜잭션 메시지 관리

트랜잭션 이벤트를 만들고 게시하면 이 이벤트 트리거를 웹 사이트에 통합해야 합니다.

노트

이벤트 구성은에 자세히 설명되어 있습니다. 이 섹션.

예를 들어 장바구니에서 제품을 구매하기 전에 고객 중 한 명이 웹 사이트를 떠날 때마다 "장바구니 포기" 이벤트를 트리거해야 합니다. 이렇게 하려면 웹 개발자로서 REST 트랜잭션 메시지 API를 사용해야 합니다.

  1. POST 방법에 따라 요청을 전송하여 트랜잭션 이벤트 보내기.
  2. POST 요청에 대한 응답에는 기본 키가 포함되어 있으므로, GET 요청을 통해 하나 이상의 요청을 보낼 수 있습니다. 그런 다음 를 가져올 수 있습니다 이벤트 상태.

트랜잭션 이벤트 보내기

트랜잭션 이벤트는 다음 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는 이벤트 구성을 만들 때 생성됩니다( 이 섹션).

POST 요청 헤더

요청에는 "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' \

POST 요청 본문

이벤트 데이터는 JSON POST 본문 내에 포함되어 있습니다. 이벤트 구조는 해당 정의에 따라 다릅니다. 리소스 정의 화면의 API 미리 보기 단추는 요청 샘플을 제공합니다. 이 섹션을 참조하십시오.

다음 선택적 매개 변수를 이벤트 콘텐츠에 추가하여 이벤트에 연결된 트랜잭션 메시지 전송을 관리할 수 있습니다.

  • 만료 (선택 사항): 이 날짜 이후, 트랜잭션 이벤트 전송이 취소됩니다.
  • 예약됨 (선택 사항): 이 날짜부터 트랜잭션 이벤트가 처리되고 트랜잭션 메시지가 전송됩니다.
노트

"만료" 및 "예약된" 매개 변수의 값은 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":""
}

트랜잭션 이벤트 상태

응답에서 "상태" 필드를 사용하면 이벤트가 처리되었는지 여부를 알 수 있습니다.

  • 보류 중: 이벤트가 보류 중입니다. 이벤트가 트리거되었을 때 이 상태가 발생합니다.
  • 처리: 이벤트가 게재 보류 중입니다. 메시지가 메시지로 변환되고 메시지가 전송됩니다.
  • 일시 중지됨: 이벤트 프로세스를 일시 중지하고 있습니다. 더 이상 처리되지 않고 Adobe Campaign 데이터베이스의 큐에 보관됩니다. 이 작업에 대한 자세한 정보는 이 섹션을 참조하십시오.
  • 처리된: 이벤트가 처리되고 메시지가 성공적으로 전송되었습니다.
  • 무시됨: 일반적으로 주소가 격리될 때 게재 시 이벤트가 무시되었습니다.
  • deliveryFailed: 이벤트를 처리하는 동안 게재 오류가 발생했습니다.
  • routingFailed: 라우팅 단계가 실패했습니다. 지정된 이벤트 유형을 찾을 수 없는 경우 이 오류가 발생할 수 있습니다.
  • tooOld: 이벤트를 처리할 수 있기 전에 만료됨 - 예를 들어 전송 실패 시 여러 번(이 경우 이벤트가 더 이상 최신 상태가 아닌 경우) 또는 오버로드된 후 서버에서 이벤트를 더 이상 처리할 수 없는 등 다양한 이유로 이 이벤트가 발생할 수 있습니다.
  • targetingFailed: Campaign Standard이 메시지 타깃팅에 사용되는 링크를 보강하지 못했습니다.

이 페이지에서는