트리거 기반 진입

**트리거 기반 진입(Trigger-based entry)**은 사용자가 특정 이벤트(예: 특정 행동 수행)를 수행할 때 Journey를 시작합니다.

팁

여러 개의 트리거 기반 진입 지점을 추가할 수 있습니다. 이 경우, 그중 어느 것이든 Journey를 시작하게 됩니다.

트리거 기반 진입을 설정하려면 캔버스에서 진입 요소를 찾아 트리거 역할을 할 이벤트를 선택하세요.

이벤트 구성 방법에 대한 자세한 내용은 이벤트 문서를 참조하세요.

선택한 이벤트에 속성이 있는 경우, 해당 속성을 사용하여 진입 조건을 좁힐 수 있습니다. 요소를 편집할 때 조건 추가를 클릭한 다음, 드롭다운 목록에서 속성을 선택하고 연산자와 값을 정의하세요.

사용 가능한 연산자는 유형별 태그 연산자를 참조하세요.

중요

• 개발팀과 협력하여 Journey의 시작 이벤트에 대한 /postEvent API 요청에 HWID(하드웨어 ID)가 올바르게 포함되었는지 확인하세요. 이것이 없으면 사용자는 Journey에 진입할 수 없습니다.
• UserID는 Customer Journey에서 사용자를 식별하는 데 적용되지 않습니다.

캠페인에 진입할 사용자 정의

특정 이벤트가 발생했을 때 어떤 사용자가 Journey에 진입해야 하는지 정의합니다.

캠페인에 진입할 사용자 드롭다운을 사용하여 두 가지 사용 가능한 모드 중 하나를 선택하세요:

이벤트를 수행하는 사용자 (기본값)

이벤트를 트리거한 사용자가 Journey에 진입하는 사용자입니다.

예시 사용자가 구매를 완료합니다(CheckoutSuccess 이벤트). 동일한 사용자(예: User ID: 123)가 감사 메시지, 제품 추천 또는 만족도 조사를 포함하는 구매 후 Journey에 진입합니다.

이벤트 속성의 사용자

이벤트를 트리거한 사용자를 등록하는 대신, 사용자 지정 이벤트 속성으로 하나 이상의 User ID를 전달할 수 있습니다. 해당 속성에 나열된 사용자가 Journey에 진입하게 됩니다.

이를 위해 이벤트 속성의 사용자를 선택하고 속성 키(예: recipient_ids, target_user_id)를 선택하세요. 이 키는 이벤트 페이로드 구조와 일치해야 합니다.

개발자 지원 필요

이벤트 속성의 사용자 모드를 올바르게 사용하려면 앱 또는 백엔드에서 올바른 페이로드 구조를 전송해야 합니다. 아래 예시를 개발팀과 공유해 주세요.

예시 페이로드 (단일 사용자)

{
  "application": "XXXXX-XXXXX",
  "event": "invitation",
  "attributes": {
      "targetId": 321
  },
  "userId": 123
}

사용자 321(targetId에서)이 Journey에 진입합니다.

예시 페이로드 (여러 사용자)

여러 User ID를 제공하는 경우, 문자열의 JSON 배열을 사용하세요.

{
    "application": "XXXXX-XXXXX",
    "event": "invitation",
    "attributes": {
        "targetIds": [1,2,3,4]
    },
    "userId": 123
}

사용자 1, 2, 3, 4가 Journey에 진입합니다.

사용 사례

댓글 알림

누군가 사용자의 게시물에 댓글을 달면 게시물 소유자에게 알림이 갑니다.

예시: 댓글 이벤트는 target_user_id 속성에 게시물 소유자의 ID를 포함합니다. 해당 사용자는 알림을 받기 위해 Journey에 진입합니다.

추천 프로그램

추천받은 사용자가 가입하거나 구매하면, 추천한 사람이 Journey에 추가됩니다.

예시: 사용자 123이 이벤트를 트리거하고, 추천인 456(referrer_id 속성에서)이 보상 캠페인에 진입합니다.

선물 구매

사용자가 선물을 구매하면, 수신자는 이벤트 페이로드의 recipient_user_id를 사용하여 Journey에 추가됩니다.

예시 사용자 123이 사용자 456을 위해 선물을 구매하면, 456은 알림, 온보딩 플로우 또는 감사 메시지를 받게 됩니다.

진입 가능 시간 설정

사용자가 트리거 기반 진입을 통해 Journey에 진입할 수 있는 시점을 제어합니다. 두 가지 옵션이 있습니다:

• 언제든지 진입 허용: 사용자는 트리거 이벤트가 발생할 때마다 Journey에 진입할 수 있습니다.

• 특정 기간으로 진입 제한: 사용자는 선택한 날짜 범위 내에서 트리거 이벤트가 발생한 경우에만 Journey에 진입할 수 있습니다.

  진입을 제한할 때는 시작일, 종료일, 시간대를 선택하세요. 진입 기간은 선택한 시간대를 기준으로 시작일의 00:00에 시작하여 종료일의 23:59에 끝납니다.

사용자가 동시에 가질 수 있는 세션 수 제어

각 사용자가 한 번에 하나의 Journey에만 참여할 수 있는지, 또는 여러 Journey에 병렬로 참여할 수 있는지 결정합니다.

드롭다운에서 다음 옵션 중 하나를 선택하세요:

• 사용자당 하나의 활성 세션
• 사용자당 여러 활성 세션

사용자당 하나의 활성 세션

각 사용자는 캠페인에서 하나의 활성 세션만 가질 수 있습니다. 새 세션을 시작하기 전에 현재 세션을 완료하거나 종료해야 합니다.

사용 사례

• 온보딩 플로우: 사용자가 현재 Journey를 마치기 전까지 다시 시작해서는 안 되는 경우
• 구독 갱신 알림: 사용자가 중복된 알림을 받지 않아야 하는 경우
• 기간 한정 혜택 또는 체험판: 사용자당 하나의 활성 캠페인 실행만 허용되는 경우
• 피드백 수집 캠페인: 각 사용자가 다시 진입하기 전에 한 번만 의견을 제공하도록 보장하는 경우

사용자당 여러 활성 세션

사용자는 캠페인에서 하나 이상의 활성 세션을 가질 수 있습니다. 각 세션은 고유한 이벤트 속성(예: order_id, product_id)으로 식별되어야 합니다.

이를 설정하려면:

1. 드롭다운에서 사용자당 여러 활성 세션을 선택합니다.

2. 세션 식별자 속성(예: order_id, product_id)을 선택합니다. 이 속성은 한 세션을 다른 세션과 구별하는 데 사용됩니다.

중요

이 속성은 모든 관련 Journey 이벤트(예: 트리거 대기 또는 전환 목표)에 포함되어야 합니다. 세션 식별자 속성이 누락되면 시스템은 이벤트를 특정 세션에 연결할 수 없습니다. 대신, 이벤트는 해당 사용자의 모든 활성 세션에 적용됩니다.

예시

• order_id = "1001"인 OrderPlaced → 세션 1 시작

• order_id = "1002"인 OrderPlaced → 세션 2 시작

order_id 없이 OrderReady 이벤트가 전송되면, 실제로는 하나의 주문만 준비되었더라도 세션 1과 세션 2 모두 “준비됨”으로 표시됩니다.

사용 사례

• 이커머스 구매: 각 주문이 자체 Journey를 시작하므로 한 사용자의 여러 주문을 독립적으로 추적할 수 있습니다. (속성: order_id)
• 추천 프로그램: 각 추천이 새 세션을 생성하여 한 사용자가 여러 친구를 추천할 수 있습니다. (속성: referral_id)
• 로열티 프로그램: 병렬로 실행되는 다른 거래의 포인트나 보상을 추적합니다. (속성: transaction_id)
• 티켓 예약: 각 예약이 자체 Journey를 시작하므로 사용자는 여러 티켓을 한 번에 관리할 수 있습니다. (속성: booking_id)
• 약속 예약: 모든 약속이 별도의 세션으로 처리됩니다. (속성: appointment_id)

사용자의 캠페인 재진입 여부 제어

이미 Journey에 있는 사용자가 진입 이벤트를 다시 트리거할 때 발생하는 일을 결정합니다.

드롭다운에서 다음 옵션 중 하나를 선택하세요:

• 재진입 허용 안 함 (기본값)
• 재진입 허용

재진입 허용 안 함

이미 Journey에 있는 사용자는 다시 진입하지 않습니다. 사용자가 활성 세션에 있고 진입 이벤트를 다시 트리거하면 새 트리거는 무시되고 사용자는 현재 세션을 계속 진행합니다.

사용 사례

• 환영 및 온보딩 시리즈: 신규 사용자가 Journey를 처음부터 끝까지 한 번만 거치고, 이벤트를 다시 트리거하더라도 처음으로 돌아가지 않고 현재 위치를 유지하는 경우
• 일회성 혜택: 각 고객이 이벤트를 여러 번 트리거하더라도 프로모션이나 할인을 한 번만 받아야 하는 경우
• 교육 및 육성 플로우: 구독자가 다시 시작하여 동일한 이메일을 다시 받지 않고 콘텐츠를 계속 진행하는 경우

재진입 허용

이미 Journey에 있는 사용자는 현재 세션에서 제거되고 새 세션으로 다시 진입하게 됩니다. 사용자가 진입 이벤트를 트리거할 때마다 현재 세션이 종료되고 새 세션이 시작됩니다.

사용 사례

• 가격 하락 알림: 재시작 시 이전 세션의 오래된 가격에 대해 계속 알리는 것이 아니라 새 가격을 반영해야 하는 경우
• 고객 재활성화 캠페인: 돌아온 비활성 사용자는 항상 시퀀스의 첫 번째 메시지부터 시작해야 하는 경우

참고

재진입은 이미 Journey에 있는 사용자에게 발생하는 일을 제어합니다. 사용자가 병렬로 실행할 수 있는 세션 수에는 영향을 미치지 않습니다. 이는 사용자가 동시에 가질 수 있는 세션 수 제어에서 구성됩니다.

진입 요소 구성을 마쳤으면 적용을 클릭하여 변경 사항을 저장하세요.

예시 시나리오: 여러 세션을 사용하는 이커머스 주문 Journey

사용자가 주문할 때마다 알림을 보내고 싶다고 상상해 보세요. 각 주문은 자체 Journey 세션을 가져야 합니다. 이를 위해 OrderPlaced 이벤트를 트리거로, order_id 속성을 세션 식별자로 사용합니다.

1. OrderPlaced 이벤트를 생성하고 order_id 속성이 포함되어 있는지 확인합니다. 이벤트 생성에 대해 자세히 알아보기

2. 이 이벤트를 Journey의 트리거로 설정합니다.

3. 세션 설정에서 사용자당 여러 활성 세션을 선택하고 order_id를 세션 식별자로 선택합니다.

이 설정에서는 각 신규 주문이 별도의 Journey 세션을 시작합니다.

• order_id = 1001인 OrderPlaced는 세션 1을 시작합니다
• order_id = 1002인 OrderPlaced는 세션 2를 시작합니다

4. 다음으로, 주문이 픽업 또는 배송 준비가 되었을 때를 추적하기 위해 트리거 대기 요소를 추가합니다. OrderReady 이벤트를 사용하며, 이 이벤트에도 동일한 order_id가 포함되어야 합니다. 이렇게 하면 각 주문이 올바른 세션에서 업데이트됩니다:

• order_id = 1001인 OrderReady는 세션 1에만 적용됩니다
• order_id = 1002인 OrderReady는 세션 2에만 적용됩니다

중요

이벤트에 order_id가 포함되어 있지 않으면, 시스템은 어떤 세션에 속하는지 알 수 없으며, 이벤트는 해당 사용자의 모든 활성 세션에 적용됩니다.

5. 마지막으로, 전환 목표를 추가합니다(예: OrderDelivered 이벤트). 이 이벤트에도 올바른 세션과 일치시킬 수 있도록 동일한 order_id가 포함되어야 합니다.

• OrderDelivered에 order_id = "1001"이 포함되면 세션 1에 대한 전환이 기록됩니다.

• OrderDelivered에 order_id = "1002"가 포함되면 세션 2에 대한 전환이 기록됩니다.

중요

order_id가 누락되면 전환은 의도한 세션만이 아닌 해당 사용자의 모든 활성 세션에 적용됩니다.