メインコンテンツへスキップ

​
概要

OneSignal + Google AlloyDB統合により、AlloyDBデータベースからOneSignalのカスタムイベントAPIに直接カスタムイベントを自動的に同期できます。これにより、データベースに保存された実際のユーザーの行動に基づいて、自動化されたJourneysとパーソナライズされたメッセージングキャンペーンをトリガーできます。 購入、製品表示、サブスクリプションの変更、またはカスタムユーザーアクションなどのイベントを同期して、プッシュ通知、メール、アプリ内メッセージ、SMSを介してオンボーディングシーケンス、再エンゲージメントキャンペーン、トランザクションメッセージ、ターゲットを絞ったプロモーションを自動的にトリガーできます。

​
要件

​
Google AlloyDB

  • AlloyDBインスタンスを持つGoogle Cloud Platformアカウント
  • Google Cloudが要求するAuth Proxyが設定されていること
  • ユーザーを作成してアクセスを許可するためのデータベース権限
  • AlloyDBインスタンスへのネットワークアクセス

​
セットアップ

​
AlloyDB権限の設定

OneSignalは、AlloyDBデータベースからイベントデータを読み取る必要があります。イベントテーブルへの読み取り専用アクセスを持つ専用のONESIGNALユーザーアカウントを作成することをお勧めします。
1

OneSignalデータベースユーザーを作成する

強力で一意のパスワードを持つ専用ユーザーアカウントを作成します：
-- OneSignalユーザーを作成
CREATE USER ONESIGNAL WITH PASSWORD '<強力で一意のパスワード>';
2

スキーマアクセスを許可する

OneSignalユーザーにイベントデータスキーマからの読み取りアクセスを許可します：
-- OneSignalユーザーがイベントスキーマを表示できるようにする
GRANT USAGE ON SCHEMA "<your_event_schema>" TO ONESIGNAL;

-- OneSignalユーザーがこのスキーマ内のすべての既存テーブルを読み取れるようにする
GRANT SELECT ON ALL TABLES IN SCHEMA "<your_event_schema>" TO ONESIGNAL;

-- OneSignalユーザーがこのスキーマに追加された新しいテーブルを読み取れるようにする
ALTER DEFAULT PRIVILEGES IN SCHEMA "<your_event_schema>" GRANT SELECT ON TABLES TO ONESIGNAL;
<your_event_schema>を、イベントテーブルを含む実際のスキーマに置き換えてください。
3

関数権限を許可する（必要な場合）

イベントデータにストアドプロシージャまたは関数を使用する場合：
-- OneSignalユーザーがこのスキーマ内の関数を実行できるようにする
GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA "<your_event_schema>" TO ONESIGNAL;

-- OneSignalユーザーがこのスキーマに追加された新しい関数を実行できるようにする
ALTER DEFAULT PRIVILEGES IN SCHEMA "<your_event_schema>" GRANT EXECUTE ON FUNCTIONS TO ONESIGNAL;

​
Auth Proxyをセットアップする

1

Auth Proxyを設定する

AlloyDBはサードパーティ接続にAuth Proxyが必要です。これをセットアップするには、GoogleのAuth Proxyドキュメントに従ってください。
Auth Proxyは必須です - OneSignalはAuth Proxyなしでは直接AlloyDBに接続できません。
2

接続の詳細をメモする

以下の接続情報を保存します：
  • Host：Auth Proxyエンドポイント
  • Port：Auth Proxyポート（通常は5432）
  • Database：AlloyDBデータベース名
  • Username：ONESIGNAL（上記で作成）
  • Password：設定したパスワード

​
OneSignal AlloyDB接続を設定する

1

統合に移動する

In OneSignal, go to Data > Integrations and click Add Integration.
2

Google AlloyDBを選択する

利用可能な統合のリストからGoogle AlloyDBを選択します。
3

接続の詳細を入力する

AlloyDB接続情報を提供します：
  • Host：Auth Proxyエンドポイント
  • Port：Auth Proxyポート
  • Database：AlloyDBデータベース名
  • Username：ONESIGNAL
  • Password：ユーザーパスワード
  • SSL：有効（推奨）
4

接続をテストする

Test Connectionをクリックして、OneSignalがAlloyDBインスタンスにアクセスできることを確認します。

​
イベントデータマッピング

接続したら、AlloyDBテーブルの列をOneSignalカスタムイベントフィールドにマッピングする必要があります：
1

イベントテーブルを選択する

OneSignalに同期したいイベントデータを含むテーブルを選択します。
2

必須のイベントフィールドをマッピングする

カスタムイベントに必須のフィールドをマッピングします：
  • Event Name：イベントタイプを含む列（例：「purchase」、「signup」）
  • User Identifier：External User ID、Email、またはPhone Number列
  • Event Timestamp：イベントが発生した時刻（オプション）
3

イベントペイロードデータをマッピングする

追加の列をイベントペイロードプロパティにマッピングします：
  • カスタムイベントプロパティ（product_id、price、categoryなど）
  • コンテキストデータ（source、campaignなど）
  • 行動メトリクス（value、quantityなど）
4

同期設定を構成する

イベント処理頻度と配信設定を設定します。

​
Event data mapping

Map your to OneSignal’s custom events format:
OneSignal FieldDescriptionRequired
nameevent_nameEvent identifierYes
external_iduser_idUser identifierYes
timestampevent_timestampWhen event occurredNo
propertiesevent_dataNo

​
高度なネットワーク設定

​
IPアドレス許可リスト

AlloyDBインスタンスがIP許可リストを使用している場合は、OneSignalのIPアドレスを追加してください。現在のIP範囲は、OneSignalダッシュボードのData > Integrations > Network Accessで確認できます。

​
SSHトンネリング

OneSignalは、追加のセキュリティのためにSSHトンネルを介したAlloyDBへの接続をサポートしています：
1

SSHユーザーを作成する

SSHホストサーバーでOneSignal用の専用ユーザーアカウントを作成します。
2

SSHトンネルを設定する

OneSignal AlloyDB接続設定で、Use SSH Tunnelを有効にして、以下を提供します：
  • SSH Host
  • SSH Port
  • SSH Username
3

SSHキーを追加する

OneSignalはSSHキーペアを生成します。公開鍵をSSHホストのauthorized_keysファイルにOneSignalユーザー用にコピーします。

​
制限事項

  • パフォーマンス：ピーク使用時に本番データベースへの接続を避ける
  • 権限：OneSignalはイベントテーブルへの読み取り専用アクセスが必要
  • Auth Proxy：すべてのAlloyDB接続に必須

​
FAQ

​
イベントテーブルの構造が変更された場合はどうなりますか？

OneSignalはスキーマの変更を検出し、フィールドの再マッピングが必要になる場合があります。統合設定でフィールドマッピングを更新してください。

​
OneSignalはどのくらいの頻度でイベントを同期しますか？

OneSignalは、設定された同期頻度に基づいて新しいイベントをチェックします。最小間隔は15分です。

​
サポートが必要ですか？

AlloyDB統合のセットアップについてサポートが必要な場合は、support@onesignal.comにお問い合わせいただくか、アプリ内チャットをご利用ください。