更新日時 2023年 9月 4日
OneSignalとの連携により、ワークフローを使ったOneSignalプッシュ通知の作成と送信、コンタクトのアクティビティータイムライン上でのプッシュ通知の表示、プッシュ通知へのエンゲージメントに基づくユーザーのセグメント化が可能です。
連携の要件
- OneSignalをHubSpotに接続するには、スーパー管理者であるか、App Marketplace Accessの権限を持っている必要があります。
アプリを接続する
- HubSpotアカウントにて、メインのナビゲーションバーに表示されるマーケットプレイスアイコンをクリックし、［アプリマーケットプレイス］を選択します。
- 検索バーを使って、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通知を送信）］を選択します。
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 sendingconsole.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 sendingconsole.log("emailId: ", emailId);});});}});</script>
