HubSpot: 구독 업데이트
HubSpot: 구독 업데이트 포인트 템플릿은 푸시 구독 상태와 Journey 단계를 기존 HubSpot 연락처에 기록하여, 영업 및 이메일 마케팅 담당자가 해당 사용자가 앱에서 이미 받고 있는 내용을 확인할 수 있도록 합니다.
이 포인트는 자체 HubSpot 비공개 앱 토큰으로 인증하며, 설정의 다른 곳에서 구성된 계정 수준의 HubSpot 통합은 사용하지 않습니다.
포인트 구성하기
Anchor link to- Integrations 섹션에서 HubSpot: 구독 업데이트를 캔버스로 드래그합니다.
- 포인트를 더블 클릭하고 Step Name을 입력합니다.
- Private app token에
crm.objects.contacts.write스코프를 가진 HubSpot 비공개 앱 토큰을 입력합니다. 이 토큰은 웹훅 비밀 헤더처럼 마스킹되어 저장됩니다.
- Look the contact up by에 식별자를 보유하는 HubSpot 속성의 내부 이름을 입력합니다. 기본값은
email이며, Pushwoosh User ID를 포함하는 자체 속성을 사용할 수도 있습니다. HubSpot은 고유한 값을 유지하는 속성으로만 연락처를 조회합니다.
- Identifier value에 조회할 값을 입력합니다. 예를 들어
{{device:user_id}}또는 Journey 참여자의 태그를 사용할 수 있습니다.
- Properties to write에서, 기록할 내용에 매핑된 HubSpot 속성의 내부 이름별로 행을 추가합니다. 이름은 비어 있지 않고 고유해야 합니다. 키/값 필드를 참조하세요. 태그 외에도, 값에는 푸시 구독 상태를 나타내는
{{device:push_subscribed}}, Journey 참여자가 여기를 통과한 순간을 나타내는{{now}}, 또는 위치를 나타내는{{journey:name}}/{{point:name}}을 사용할 수 있습니다. 단일 매크로를 포함하는 셀은 해당 매크로 자체의 유형을 유지합니다. 예를 들어,{{device:push_subscribed}}단독으로는 문자열"true"가 아닌 불리언(boolean)으로 도착합니다.
- 저장을 클릭합니다.
분기 연결하기
Anchor link to저장하면 포인트가 캔버스에 두 개의 분기를 표시합니다. 각 분기에 다음 단계를 연결하세요:
- Updated: 식별자가 기존 HubSpot 연락처와 일치하고 HubSpot이 업데이트된 연락처를 반환했습니다. 예를 들어, Journey의 나머지 부분을 계속 진행합니다.
- Not found: HubSpot이 404(일치하는 연락처 없음)로 응답했습니다. Journey 참여자는 이탈되지 않습니다. 이 포인트는 실제 실패한 요청처럼 재시도하거나 실패한 요청의 쿨다운을 기다리지 않습니다. 예를 들어, 다른 경로로 보내거나 먼저 연락처를 생성합니다.
Not found는 실패한 요청이 아닙니다. 실제 실패한 요청은 대신 Journey 참여자를 이탈시킵니다. 오류 및 실패한 요청을 참조하세요.
Updated 시, 이후 단계에서는 HubSpot 연락처의 ID를 **hubspot_contact_id**로 사용할 수 있습니다. 웹훅 응답 속성과 동일한 방식으로 사용하세요. 예를 들어, 사용자 프로필 업데이트를 사용하여 태그를 설정합니다.
Not found 시에는 해당 속성을 사용할 수 없습니다.
예시 시나리오: 옵트인 후 푸시 구독 상태를 HubSpot과 동기화하기
Anchor link to한 팀에서 영업 및 이메일 마케팅 담당자가 HubSpot 연락처에서 바로 특정 사용자가 푸시에 옵트인했는지 여부를 확인하고자 합니다.
- 트리거 기반 진입 요소를 추가하고
PushOptedIn이벤트에서 실행되도록 설정합니다. - 바로 뒤에 HubSpot: 구독 업데이트를 추가합니다. Look the contact up by는
email로 두고 Identifier value는{{tag:Email}}로 설정합니다. Properties to write에서push_subscribed를{{device:push_subscribed}}로 설정합니다. - 저장을 클릭한 다음, Updated를 Journey의 나머지 부분에 연결하고 Not found는 연락처를 먼저 생성하는 단계(예: HubSpot: 연락처 생성 또는 업데이트)에 연결합니다.
이것이 실행되면 HubSpot 연락처에 Journey 참여자의 현재 푸시 구독 상태가 표시되므로 영업 및 이메일 마케팅 담당자가 추측할 필요가 없습니다.