API를 사용하여 캠페인 트리거

API 트리거 캠페인 기본 정보

포함 Journey Optimizer, 캠페인을 만든 다음 를 사용하는 사용자 트리거에 따라 외부 시스템에서 캠페인을 호출할 수 있습니다. 대화형 메시지 실행 REST API. 이를 통해 암호 재설정, OTP 토큰 등과 같은 다양한 운영 및 트랜잭션 메시지 요구 사항을 처리할 수 있습니다.

이렇게 하려면 먼저 Journey Optimizer에서 API 트리거 캠페인을 만든 다음 API 호출을 통해 실행을 시작해야 합니다.

API 트리거 캠페인에 사용할 수 있는 채널은 이메일, SMS 및 푸시 메시지입니다.

API 트리거 캠페인 만들기

캠페인 구성 및 활성화

API 트리거 캠페인을 만드는 프로세스는 API 페이로드에서 수행되는 대상 선택을 제외하고 예약된 캠페인과 동일하게 유지됩니다. 캠페인을 만드는 방법에 대한 자세한 내용은에서 확인할 수 있습니다. 이 섹션.

API 트리거 캠페인을 만들려면 다음 단계를 수행하십시오.

  1. 을(를) 사용하여 새 캠페인 만들기 API 트리거됨 유형.

  2. 메시지를 보내는 데 사용할 채널과 채널 표면을 선택한 다음 을 클릭합니다 만들기.

  3. 캠페인에 대한 제목과 설명을 지정한 다음 콘텐츠 편집 보낼 메시지를 구성합니다.

    노트

    메시지를 개인화하는 데 활용할 수 있는 API 페이로드에 추가 데이터를 전달할 수 있습니다. 자세히 알아보기

    콘텐츠에 수많은 상황별 데이터 또는 방대한 컨텍스트 데이터를 사용하면 성능에 영향을 줄 수 있습니다.

  4. 다음에서 대상자 섹션에서 세그먼트에서 개인을 식별하는 데 사용할 네임스페이스를 지정합니다.

    다음 새 프로필 만들기 옵션을 사용하면 데이터베이스에 없는 프로필을 자동으로 만들 수 있습니다. 캠페인 실행 시 프로필 만들기에 대해 자세히 알아보기

  5. 캠페인의 시작 및 종료 날짜를 구성합니다.

    캠페인에 대한 특정 시작 및/또는 종료 날짜를 구성하는 경우 이 날짜 외에는 실행되지 않으며, API에 의해 캠페인이 트리거되면 API 호출이 실패합니다.

  6. 클릭 활성화하려면 검토 캠페인이 올바르게 구성되었는지 확인한 다음, 활성화합니다.

이제 API에서 캠페인을 실행할 준비가 되었습니다. 자세히 알아보기

캠페인 실행

캠페인이 활성화되면 생성된 샘플 cURL 요청을 검색하고 API에 사용하여 페이로드를 빌드하고 캠페인을 트리거해야 합니다.

  1. 캠페인을 연 다음, 다음에서 샘플 요청을 복사하여 붙여넣습니다. cURL 요청 섹션.

  2. 이 cURL 요청을 API에 사용하여 페이로드를 빌드하고 캠페인을 트리거합니다. 자세한 내용은 대화형 메시지 실행 API 설명서.

    노트

    캠페인을 생성할 때 특정 시작 날짜 및/또는 종료 날짜를 구성했다면 이 날짜 이후에 실행되지 않고 API 호출이 실패합니다.

API가 트리거된 캠페인에서 컨텍스트 속성 사용

API 트리거 캠페인을 사용하면 API 페이로드에서 추가 데이터를 전달하고 캠페인 내에서 이를 사용하여 메시지를 개인화할 수 있습니다.

고객이 암호를 재설정하고자 하고 서드파티 도구에서 생성된 암호 재설정 URL을 전송하고자 하는 이 예를 살펴보겠습니다. API 트리거된 캠페인을 사용하면 이렇게 생성된 URL을 API 페이로드에 전달하고 이를 캠페인에 활용하여 메시지에 추가할 수 있습니다.

노트

프로필 활성화 이벤트와 달리 REST API에서 전달된 컨텍스트 데이터는 일회성 통신에 사용되며 프로필에 대해 저장되지 않습니다. 네임스페이스가 누락된 경우 최대 네임스페이스 세부 정보로 프로필이 만들어집니다.

캠페인에서 이러한 데이터를 사용하려면 해당 데이터를 API 페이로드에 전달하고 표현식 편집기를 사용하여 메시지에 추가해야 합니다. 이렇게 하려면 {{context.<contextualAttribute>}} 구문, 여기서 <contextualAttribute> 은 전달할 데이터를 포함하는 API 페이로드의 변수 이름과 일치해야 합니다.

다음 {{context.<contextualAttribute>}} 구문은 문자열 데이터 형식에만 매핑됩니다.

중요

요청에 전달된 컨텍스트 속성은 50kb를 초과할 수 없습니다.

다음 context.system 구문은 Adobe 내부 사용으로만 제한되며 컨텍스트 속성을 전달하는 데 사용해서는 안 됩니다.

지금은 왼쪽 레일 메뉴에서 사용할 수 있는 컨텍스트 속성이 없습니다. 속성은 개인 맞춤화 표현식에서 직접 입력해야 하며, 다음에서 검사를 수행하지 않습니다. Journey Optimizer.

캠페인 실행 시 프로필 만들기

경우에 따라 시스템에 없는 프로필로 트랜잭션 메시지를 보내야 할 수도 있습니다. 예를 들어 알 수 없는 사용자가 웹 사이트에서 암호를 재설정하려고 하는 경우입니다.

데이터베이스에 프로필이 없는 경우, Journey Optimizer에서 캠페인을 실행할 때 프로필을 자동으로 만들어 이 프로필로 메시지를 보낼 수 있습니다.

중요

이 기능은 다음에 제공됩니다. 매우 작은 볼륨 프로필 만들기 대량의 프로필이 이미 플랫폼에 존재하는 대용량 트랜잭션 전송 사용 사례의 경우.

캠페인 실행 시 프로필 만들기를 활성화하려면 새 프로필 만들기 옵션이에 있음 대상자 섹션.

노트

알 수 없는 프로필이 AJO 대화형 메시징 프로필 데이터 세트 데이터 세트, 각 아웃바운드 채널(이메일, SMS 및 푸시)에 대한 기본 네임스페이스(이메일, 전화 및 ECID) 각각 3개

이 페이지에서는