참고: 2025년 4월 4일에 HubSpot에서 구축한 OneSignal 통합 기능이 일몰됩니다. 이 날짜 이후에는 앱이 더 이상 지원되지 않으며 HubSpot 계정의 데이터를 업데이트하지 않습니다. 앞으로는 원시그널에서 구축한 새로운 원시그널 통합을 설치하는 것이 좋습니다.
원시그널 통합을 통해 워크플로를 사용하여 원시그널 푸시 알림을 생성 및 전송하고, 연락처의 활동 타임라인에서 푸시 알림을 확인하고, 푸시 알림 참여도에 따라 사용자를 세분화할 수 있습니다
통합 요구 사항
앱 연결
- HubSpot 계정의 상단 탐색 모음에서 마켓플레이스 아이콘 marketplace을 클릭한 다음 앱 마켓플레이스를 선택합니다.
- 검색창에서 원시그널 통합을 찾아 선택합니다.
- 오른쪽 상단에서 앱 설치를 클릭합니다.
- 원시그널 계정에 로그인합니다.
- 팝업 상자에 원시그널 계정의 애플리케이션 ID와 API 키를 입력합니다.
- 필요한 경우 애플리케이션 추가를 클릭하여 다른 애플리케이션을 추가합니다.
- 앱 설치를 클릭합니다.
- 연결된 앱 페이지로 리디렉션됩니다.
원시그널 사용자와 허브스팟 사용자를 일치시킵니다
통합하려면 OneSignal 사용자와 HubSpot 연락처를 일치시켜야 합니다. 사용자 매칭에는 두 가지 옵션이 있습니다:
- 이메일 주소 기준: 사용자는 SDK를 사용하여 OneSignal의 setEmail 함수를 사용하여 원시그널 사용자를 이메일 주소와 연결해야 합니다. 이 매칭 옵션은 원시그널 알림 보내기 워크플로 작업에만 사용할 수 있습니다.
- 원시그널외부_사용자_아이디 기준: 사용자는 원시그널에서 외부_사용자_아이디와 일치시키려는 HubSpot 연락처 속성을 선택해야 합니다. 이렇게 하려면
- HubSpot 계정에서 상단 탐색 모음에 있는 settings 설정 아이콘을 클릭합니다. 왼쪽 사이드바 메뉴에서 통합 > 연결된 앱으로 이동합니다.
- OneSignal을 클릭합니다.
- 연락처 일치를 클릭합니다.
- 드롭다운 메뉴에서 원시그널 외부_사용자_id 속성과 일치시키는 데 사용하려는 HubSpot 연락처 속성을 선택합니다. 이 매칭 옵션은 원시그널 알림 보내기 및 원시그널 태그 편집 워크플로 작업 모두에 사용할 수 있습니다.
원시그널 푸시 알림 자동화
워크플로를 사용하여 원시그널 푸시 알림 전송을 자동화할 수 있습니다.
- 오른쪽 상단에서 워크플로 만들기를 클릭합니다.
- 왼쪽 패널에서 연락처 기반을 선택하고 오른쪽 상단의 다음을 클릭합니다.
- 등록 트리거를 설정합니다.
- 더하기 아이콘을 클릭하여 작업을 추가합니다.
- 오른쪽 패널에서 원시그널 알림 보내기를 선택합니다.
- 앱 선택 드롭다운 메뉴를 클릭하여 연결된 원시그널 앱을 선택합니다.
- 기존 원시그널 푸시 템플릿을 사용하시겠습니까, 아니면 새 푸시를 생성하시겠습니까? 드롭다운 메뉴를 클릭하고 템플릿 옵션을 선택합니다:
- 기존 템플릿을 선택하려면 템플릿 사용을 클릭합니다.
-
- 새 템플릿을 만들려면 사용자 지정 구성 사용을 클릭하고 필수 입력란을 작성합니다. 이러한 필드에 개인화 토큰을 사용할 수 있습니다.
- 저장을 클릭합니다.
- 워크플로에 추가 작업을 추가할 수 있습니다.
- 워크플로 설정을 마쳤으면 오른쪽 상단의 검토를 클릭합니다.
- 워크플로 설정을 검토하고 오른쪽 상단의 켜기를 클릭합니다.
푸시 알림이 연락처 기록의 타임라인에 활동으로 표시됩니다.
원시그널 태그를 자동화하여 인앱 메시징 트리거하기
워크플로를 사용하여 원시그널 앱에서 인앱 메시징을 트리거할 수 있습니다.
- 오른쪽 상단에서 워크플로 만들기를 클릭합니다.
- 왼쪽 패널에서 연락처 기반을 선택한 다음 오른쪽 상단의 다음을 클릭합니다.
- 등록 트리거를 설정합니다.
- 더하기 아이콘을 클릭하여 작업을 추가합니다.
- 오른쪽 패널에서 원시그널 태그 편집을 선택합니다.
- 앱 선택 드롭다운 메뉴를 클릭하여 연결된 원시그널 앱을 선택합니다.
- 편집하려는 { "키" : "값" } 쌍으로 JSON 문자열을 입력합니다. 원시그널 데이터 태그 사용에 대해 자세히 알아보세요.
- 저장을 클릭합니다.
- 워크플로에 추가 작업을 추가할 수 있습니다.
- 워크플로 설정을 마쳤으면 오른쪽 상단의 검토를 클릭합니다.
- 워크플로 설정을 검토하고 켜기를 클릭합니다.
원시그널 태그를 편집하면 원시그널에서 인앱 메시징을 강화할 수도 있습니다. 그 방법에 대한 단계는 원시그널의 가이드를 참조하세요.
HubSpot 양식 제출을 사용하여 HubSpot 연락처를 OneSignal 사용자와 연결하기
이 기능을 사용하려면 원시그널 웹 푸시 설정의 적절한 코드가 페이지의 헤드 HTML에 추가되어 있는지 확인하세요.
이메일 주소를 캡처하여 OneSignal에 전달하는 데는 두 가지 옵션이 있습니다:
- 양식 제출물 전체에 적용하려면 <head> ... </head>에 다음을 전역적으로 배치하세요:
window.addEventListener('message', event => {
if(event.data.type === 'hsFormCallback' && event.data.eventName === 'onFormSubmit') {
OneSignal.push(function() {
OneSignal.setEmail($("input[name=email]").val())
.then(function(emailId) {
// Callback called when email have finished sending
console.log("emailId: ", emailId);
});
}
});
- HubSpot 양식 중 하나에 대한 임베드 스크립트를 직접 편집합니다. 계정에서 포털 ID 와 양식 ID를 삽입해야 합니다. 다음은 예시입니다:
<script charset="utf-8" type="text/javascript" src="//js.hsforms.net/forms/v2.js"></script>
<script>
hbspt.forms.create({
region: "na1",
portalId: "YOUR PORTAL ID",
formId: "YOUR FORM ID",
onFormSubmit: function($form) {
OneSignal.push(function() {
OneSignal.setEmail($("input[name=email]").val())
.then(function(emailId) {
// Callback called when email have finished sending
console.log("emailId: ", emailId);
});
});
}
});
</script>
Integrations
마케팅 Hub
Professional
,
Enterprise
영업 Hub
Professional
,
Enterprise
Service Hub
Professional
,
Enterprise
Operations Hub
Professional
,
Enterprise