발송 전 Canvas에서 프로필 데이터 새로고침

여정이 며칠 또는 몇 주에 걸쳐 진행되는 경우, 사용자가 Canvas에 진입한 후 프로필 데이터가 변경될 수 있습니다. Context 단계를 사용하여 프로필에서 일치하는 오브젝트를 조회한 다음, 오디언스 경로 또는 결정 분할로 메시징을 분기할 수 있습니다.

이 예제 소개

가상의 보험 브랜드인 ClaimsJumpr은 보험이 갱신일로부터 28일 전에 액션 기반 Canvas를 시작합니다. 이 28일 동안 ClaimsJumpr은 여러 알림을 보냅니다. 보험 가입자는 Canvas에 진입한 후 해당 보험의 자동 갱신을 변경할 수 있으므로, Canvas 항목 속성정보만 사용하는 메시지는 잘못된 상태를 나타낼 수 있습니다.

각 고객 프로필은 보험을 오브젝트 배열 커스텀 속성(policies)으로 저장합니다. 각 오브젝트에는 트리거 이벤트의 고유 policy_id와 auto_renewal 값(opted_in 또는 opted_out)이 포함됩니다. 이 예제에서는 이후 메시지 단계 전에 Context 단계를 추가하여, Liquid가 Canvas 컨텍스트(항목 이벤트)의 policy_id를 기준으로 policies에서 현재 오브젝트를 읽도록 합니다.

이 패턴의 구성:

1. 항목 policy_id를 Canvas 컨텍스트에 유지합니다.
2. Context 단계와 Liquid where 필터를 사용하여 policies에서 일치하는 오브젝트를 선택합니다.
3. auto_renewal을 문자열 유형의 컨텍스트 변수(auto_renewal)로 저장합니다.
4. 이 문서에서 중복된 중단 Liquid가 아닌, 오디언스 경로 또는 결정 분할 컨텍스트 변수 필터로 메시지를 분기합니다.

고려 사항

• 프로덕션이 아닌 워크스페이스에서 Canvas를 테스트합니다. 오브젝트에 auto_renewal이 없는 프로필도 포함하여 테스트하세요.
• policies의 policy_id 값은 고유해야 where가 하나의 오브젝트를 반환합니다.
• 다른 Canvas가 동일한 트리거 이벤트에서 사용자 업데이트 단계를 사용하여 policies를 작성하는 경우, 첫 번째 메시지 전에 프로필이 업데이트되지 않을 수 있습니다. 진입 후 첫 번째 메시지 단계에는 항목 컨텍스트 속성정보를 사용하세요. 이 Context 단계는 프로필 업데이트가 적용될 시간이 지난 이후 단계에 사용합니다.
• 컨텍스트 변수 이름에는 문자, 숫자, 밑줄만 사용할 수 있습니다(최대 100자). Context 단계당 최대 10개의 변수를 정의할 수 있습니다.
• 이 문서의 Liquid는 예시입니다. 사용자 경로를 미리 보고 속성 이름과 값에 대한 테스트 발송을 수행하세요.

설정

이 예제는 다음을 가정합니다:

1단계: 이후 메시지 전에 Context 단계 배치

Canvas에서 현재 자동 갱신 상태를 반영해야 하는 메시지 단계 바로 앞에 Context 단계를 추가합니다. 이후 발송에는 항목 속성정보에만 의존하지 마세요.

2단계: 컨텍스트 변수 정의

Context 단계에서:

1. 컨텍스트 변수 이름을 auto_renewal로 설정합니다.
2. 데이터 유형을 문자열로 설정합니다.
3. 일치하는 보험을 선택한 다음 auto_renewal을 출력하는 Liquid를 입력합니다. assign 소스를 추가 {{ }} 태그로 감싸지 마세요.

1
2

{% assign matched_policies = custom_attribute.${policies} | where: "policy_id", context.${policy_id} %}
{{ matched_policies[0].auto_renewal }}

context.${policy_id}는 항목 이벤트 속성정보이며 컨텍스트 변수로 사용할 수 있습니다. where는 policy_id가 해당 값과 일치하는 오브젝트를 유지합니다. Context 단계는 첫 번째 일치 항목의 auto_renewal 필드를 저장합니다.

4. 미리보기를 선택하고, policies에 해당 policy_id가 있는 테스트 사용자의 값을 확인합니다.

이름, 유형 및 Liquid 제한에 대한 자세한 내용은 Context 및 컨텍스트 변수를 참조하세요.

3단계: 컨텍스트 변수로 분기

Context 단계 후, auto_renewal에 대한 오디언스 경로 또는 결정 분할 필터로 사용자를 분할합니다(예: opted_in 대 opted_out). 각 경로에 해당하는 알림을 배치합니다.

팁

필터 설정 및 데이터 유형 일치에 대한 자세한 내용은 컨텍스트 변수 필터를 참조하세요. 그룹 평가 방식에 대한 자세한 내용은 오디언스 경로 및 결정 분할을 참조하세요.

메시지 단계에서 분기 대신 발송을 중단하면 사용자는 여전히 다음 캔버스 단계로 이동합니다. 자세한 내용은 메시지 중단 및 사용자 진행 방식을 참조하세요.

4단계: 미리보기 및 테스트

사용자 경로 미리보기와 테스트 발송을 사용하여 다음을 확인합니다:

• 일치하는 오브젝트의 auto_renewal이 opted_in 및 opted_out인 경우
• policies에 없는 policy_id(빈 또는 공백 컨텍스트 값)
• auto_renewal이 누락된 오브젝트

이후 알림이 Canvas 진입 시점의 상태뿐만 아니라 프로필과 일치하는지 확인합니다.

관련 문서

• Context
• 컨텍스트 변수
• Canvas 항목 속성정보
• 오디언스 경로
• 결정 분할
• 메시지 단계
• 메시지 중단
• 오브젝트 배열
• 사용자 업데이트