API 기반 진입을 사용하여 고객 여정 트리거하기
API 기반 진입을 사용하면 특정 비즈니스 이벤트가 발생하는 순간 고객 여정을 시작할 수 있습니다. 캠페인을 시작하려면 특별한 API 요청을 보내야 합니다.
설정하기
Anchor link to- API 기반 진입으로 여정을 생성합니다.
-
API 기반 진입 단계를 더블 클릭합니다. 진입 구성 창이 열립니다.
-
콘텐츠 플레이스홀더를 사용하여 여정이 시작될 때마다 푸시 및 이메일 콘텐츠를 수정할 수 있습니다. 각 플레이스홀더의 값은 요청에서 변경할 수 있습니다. 이 옵션이 필요하지 않은 경우 이 단계를 건너뛸 수 있습니다.
예를 들어, 새로운 팟캐스트 에피소드가 출시될 때 구독자에게 알리는 여정을 생성하고 있습니다. 콘텐츠 플레이스홀더를 사용하면 여정을 시작할 때마다 팟캐스트 제목을 변경할 수 있습니다.
먼저, API 기반 진입 설정 창에서 플레이스홀더 이름을 추가합니다. 편리한 이름을 사용할 수 있습니다.
이제 푸시 또는 이메일 프리셋을 생성하고 수정하려는 텍스트 대신 플레이스홀더를 삽입합니다. 플레이스홀더는 필요에 따라 다음 형식 중 하나여야 합니다:
{placeholder_name|format_modifier|}– 캠페인 시작 시 플레이스홀더 값이 지정되지 않은 경우, 사용자는 그 자리에 빈 공간을 보게 됩니다.{placeholder_name|format_modifier}– 플레이스홀더 값이 지정되지 않았고 사용자에게 이미 할당되지 않은 경우(플레이스홀더로 태그를 사용한 경우), 메시지가 전송되지 않습니다.
형식 수정자
- CapitalizeFirst – 플레이스홀더 값의 첫 글자를 대문자로 만듭니다.
- CapitalizeAllFirst – 플레이스홀더 값이 두 단어 이상으로 구성된 경우 모든 단어의 첫 글자를 대문자로 만듭니다.
- UPPERCASE – 모든 글자를 대문자로 전환합니다.
- lowercase – 모든 글자를 소문자로 전환합니다.
- regular – 요청에 지정된 대로 수정 없이 플레이스홀더 값을 정확하게 삽입합니다.

여정에서 푸시 또는 이메일 단계를 구성할 때 생성된 프리셋을 선택하고 이벤트 속성으로 메시지 개인화 옵션을 켭니다. 여정을 시작할 때 요청에서 수정하려는 플레이스홀더를 선택합니다. 소스로 API 기반 진입을 선택하고 동적 속성으로 플레이스홀더 이름을 선택합니다:
Apply를 클릭하여 변경 사항을 저장합니다.
4. 진입 구성 창에서 요청 템플릿을 복사하여 수정합니다:

예를 들어, _Wishlist_에 Socks 항목을 추가한 사용자를 대상으로 여정을 설정하려면 “filter” 값은 다음과 같아야 합니다:
"filter": "A("12345-12345") * "T("Wishlist", EQ, "Socks")"이 예에서는 앱에 Wishlist 태그가 구성되어 있어야 합니다.
- 플레이스홀더를 설정한 경우 원하는 콘텐츠를 값으로 지정합니다:

- 메시지 전송률 제한 옵션이 활성화된 경우, 매초 한 번에 여정에 진입하는 사용자 수가 제한됩니다. 초당 5000명의 기본값을 사용하거나 다른 숫자를 설정할 수 있습니다.

- 캠페인을 자주 다시 시작할 계획이고 동일한 사용자가 여정에 여러 번 진입하는 것을 원하지 않는 경우, 빈도 제한을 설정하세요.
예를 들어, 특정 제품의 가격 인하에 대해 사용자에게 알리는 캠페인을 생성했습니다. 다른 오디언스 필터로 여러 요청을 보내 여정을 몇 번 다시 시작하고 싶습니다. 이 경우, 여러 필터와 일치하는 사용자에게 알림이 반복적으로 전송되지 않도록 빈도 제한을 추가할 수 있습니다.
- 특정 비즈니스 이벤트가 발생할 때마다 여정을 시작하려면 웹훅을 사용하여 요청을 자동화하세요. 이벤트가 발생하면 웹훅이 자동으로 여정을 시작하는 요청을 보내야 합니다.
자동화가 필요하지 않은 경우 요청을 수동으로 보낼 수도 있습니다.