HubSpotとOneSignalを接続する。
更新日時 2023年 9月 4日
以下の 製品でご利用いただけます(別途記載されている場合を除きます)。
Marketing Hub Professional , Enterprise |
Sales Hub Professional , Enterprise |
Service Hub Professional , Enterprise |
Operations Hub Professional , Enterprise |
OneSignalとの連携により、ワークフローを使ったOneSignalプッシュ通知の作成と送信、コンタクトのアクティビティータイムライン上でのプッシュ通知の表示、プッシュ通知へのエンゲージメントに基づくユーザーのセグメント化が可能です。
連携の要件
- OneSignalをHubSpotに接続するには、スーパー管理者であるか、App Marketplace Accessの権限を持っている必要があります。
アプリを接続する
- HubSpotアカウントにて、上部のナビゲーションバーに表示されるマーケットプレイスアイコンmarketplaceをクリックし、[アプリマーケットプレイス]を選択します。
- 検索バーを使って、OneSignalの連携を探し、選択します。
- 右上の[アプリをインストール]をクリックします。
- OneSignalのアカウントにログインしてください。
- ポップアップボックスに、ご使用のOneSignalアカウントの[アプリケーションID]と[APIキー]を入力します。
- 必要に応じて、[アプリケーションの追加]をクリックして、別のアプリケーションを追加します。
- [アプリをインストール]をクリックします。
- [接続済みアプリ]ページにリダイレクトされます。
OneSignalのユーザーとHubSpotのユーザーをマッチングさせます。
連携には、OneSignalのユーザーとHubSpotのコンタクトをマッチングさせる必要があります。ユーザーは、2つのマッチング方法を選択できます。
- Eメールで : ユーザーはOneSignalのSDKを使ってOneSignalのsetEmail関数を使い、OneSignalユーザーとEメールの関連付けをする必要があります。このマッチングオプションは、Send OneSignal通知ワークフローアクションでのみ利用可能です。
- By OneSignal external_user_id : ユーザーは、OneSignalのexternal_user_idとマッチさせたいHubSpotのコンタクトプロパティを選択する必要があります。次の手順に従ってください。
- HubSpotアカウントで、[データ管理]>[連携]の順に進みます。
- [OneSignal]をクリックします。
- コンタクトマッチング]をクリックします。
- ドロップダウンメニューから、OneSignalとのマッチングに使用するHubSpotのコンタクトプロパティを選択します。外部ユーザーIDプロパティーを使用します。このマッチングオプションは、OneSignal通知の送信とOneSignalタグの編集の両方のワークフローアクションで利用可能です。
OneSignalのプッシュ通知を自動化する
ワークフローを利用して、OneSignalのプッシュ通知の送信を自動化することができます。
- HubSpotのアカウントにて、[自動化]>[ワークフロー]の順に進みます。
- 右上の[ワークフローを作成]をクリックします。
- 左側のパネルで、[コンタクトベース]を選択し、右上の[次へ]をクリックします。
- 登録トリガーを設定します。
- +プラスアイコンをクリックしてアクションを追加する。
- 右側のパネルで、[Send OneSignal notification(OneSignal通知を送信)]を選択します。
- Select Appドロップダウンメニューをクリックして、接続しているOneSignalのアプリを選択します。
- 既存のOneSignal Push Templateを使用するか、新しいPushを作成するか?ドロップダウンメニューをクリックし、テンプレートオプションを選択します。
- 既存のテンプレートを選択する場合は、「テンプレートを使用する」をクリックします。
-
- 新しいテンプレートを作成するには、「Use custom configuration」をクリックし、必要なフィールドを入力します。これらのフィールドにはパーソナライゼーショントークンを使用することができます。
- [保存]をクリックします。
- ワークフローにアクションを追加することができます。
- ワークフローの設定が完了したら、右上の[確認]をクリックします。
- ワークフローの設定を確認し、右上の[有効にする]をクリックします。
OneSignalタグによるアプリ内メッセージの自動化
ワークフローを使用して、OneSignalアプリでアプリ内メッセージングをトリガーします。
- HubSpotのアカウントにて、[自動化]>[ワークフロー]の順に進みます。
- 右上の[ワークフローを作成]をクリックします。
- 左のパネルで「コンタクトベース」を選択し、右上の「次へ」をクリックします。
- 登録トリガーを設定します。
- アクションを追加するには、+プラスアイコンをクリックします。
- 右側のパネルで、「OneSignalタグの編集」を選択します。
- Select Appドロップダウンメニューをクリックし、接続する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>