注: HubSpotが開発したOneSignal連携は、2025年4月4日に廃止されます。この日付を過ぎると、このアプリはサポートされなくなり、HubSpotアカウントのデータは更新されなくなります。今後は、 OneSignalが構築した新しいOneSignal統合 をインストールすることをお勧めします。
OneSignalとの連携により、ワークフローを使ったOneSignalプッシュ通知の作成と送信、コンタクトのアクティビティータイムライン上でのプッシュ通知の表示、プッシュ通知へのエンゲージメントに基づくユーザーのセグメント化が可能です。
連携の要件
アプリを接続する
- HubSpotアカウントにて、上部のナビゲーションバーに表示されるマーケットプレイスアイコンmarketplaceをクリックし、［アプリマーケットプレイス］を選択します。
- 検索バーを使って、OneSignalの連携を探し、選択します。
- 右上の［アプリをインストール］をクリックします。
- OneSignalのアカウントにログインしてください。
- ポップアップボックスに、ご使用のOneSignalアカウントの［アプリケーションID］と［APIキー］を入力します。
- 必要に応じて、［アプリケーションの追加］をクリックして、別のアプリケーションを追加します。
- ［アプリをインストール］をクリックします。
- ［接続済みアプリ］ページにリダイレクトされます。
OneSignalのユーザーとHubSpotのユーザーをマッチングさせます。
連携には、OneSignalのユーザーとHubSpotのコンタクトをマッチングさせる必要があります。ユーザーは、2つのマッチング方法を選択できます。
- By OneSignal external_user_id : ユーザーは、OneSignalのexternal_user_idとマッチさせたいHubSpotのコンタクトプロパティーを選択する必要があります。それには、次の手順に従います。
- HubSpotアカウントにて、上部のナビゲーションバーに表示される設定アイコンsettingsをクリックします。左側のサイドバーメニューで、［連携］＞［接続されたアプリ］の順に進みます。
- ［OneSignal］をクリックします。
- コンタクトマッチング］をクリックします。
- ドロップダウンメニューから、OneSignalとのマッチングに使用するHubSpotのコンタクトプロパティーを選択します。外部ユーザーIDプロパティーを使用します。このマッチングオプションは、OneSignal通知の送信とOneSignalタグの編集の両方のワークフローアクションで利用可能です。
OneSignalのプッシュ通知を自動化する
ワークフローを利用して、OneSignalのプッシュ通知の送信を自動化することができます。
- HubSpotのアカウントにて、［自動化］＞［ワークフロー］の順に進みます。
- 右上の［ワークフローを作成］をクリックします。
- 左側のパネルで、［コンタクトベース］を選択し、右上の［次へ］をクリックします。
- 登録トリガーを設定します。
- ［＋］プラスアイコンをクリックしてアクションを追加します。
- 右側のパネルで、［Send OneSignal notification（OneSignal通知を送信）］を選択します。
- 「アプリを選択」ドロップダウンメニューをクリックして、接続しているOneSignalのアプリを選択します。
- 既存のOneSignal Push Templateを使用するか、新しいPushを作成するか？ドロップダウンメニューをクリックし、テンプレートオプションを選択します。
- 既存のテンプレートを選択する場合は、「テンプレートを使用する」をクリックします。
-
- 新しいテンプレートを作成するには、「Use custom configuration」をクリックし、必要なフィールドを入力します。これらのフィールドにはパーソナライゼーショントークンを使用することができます。
- ［保存］をクリックします。
- ワークフローにアクションを追加することができます。
- ワークフローの設定が完了したら、右上の［確認］をクリックします。
- ワークフローの設定を確認し、右上の［有効にする］をクリックします。
プッシュ通知は、コンタクトレコードのタイムライン上にアクティビティーとして表示されます。
OneSignalタグによるアプリ内メッセージの自動化
ワークフローを使用して、OneSignalアプリでアプリ内メッセージングをトリガーします。
- HubSpotのアカウントにて、［自動化］＞［ワークフロー］の順に進みます。
- 右上の［ワークフローを作成］をクリックします。
- 左のパネルで「コンタクトベース」を選択し、右上の「次へ」をクリックします。
- 登録トリガーを設定します。
- アクションを追加するには、［＋］プラスアイコンをクリックします。
- 右側のパネルで、「OneSignalタグの編集」を選択します。
- 「アプリを選択」ドロップダウンメニューをクリックし、接続するOneSignalアプリを選択します。
- 編集する{ "key" : "value" } ペアを使用してJSON文字列を入力します。OneSignalのデータタグの使用方法について詳しく説明します。
- ［保存］をクリックします。
- ワークフロー にアクションを追加できます。
- ワークフローの設定が完了したら、右上の［確認］をクリックします。
- ワークフローの設定を確認し、［オンにする］をクリックします。
OneSignalのタグを編集することで、OneSignalのアプリ内メッセージングを強化することもできます。その手順については、OneSignalのガイドを参照してください。
HubSpotフォーム送信を使用して、HubSpotコンタクトをOneSignalユーザーにリンクします。
この機能を使用するには、OneSignal Web Pushの設定から適切なコードをページのhead HTMLに追加していることを確認してください。
Eメールアドレスを取得してOneSignalに渡すには、次の2つのオプションがあります。
- フォームの送信にまたがって適用されるように、以下のようにグローバルに配置します<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
Marketing Hub
Professional
,
Enterprise
Sales Hub
Professional
,
Enterprise
Service Hub
Professional
,
Enterprise
Operations Hub
Professional
,
Enterprise
