概要
OneSignal + Google AlloyDB統合により、AlloyDBデータベースからOneSignalのカスタムイベントAPIに直接カスタムイベントを自動的に同期できます。これにより、データベースに保存された実際のユーザーの行動に基づいて、自動化されたJourneysとパーソナライズされたメッセージングキャンペーンをトリガーできます。 購入、製品表示、サブスクリプションの変更、またはカスタムユーザーアクションなどのイベントを同期して、プッシュ通知、メール、アプリ内メッセージ、SMSを介してオンボーディングシーケンス、再エンゲージメントキャンペーン、トランザクションメッセージ、ターゲットを絞ったプロモーションを自動的にトリガーできます。要件
- Access to Event Streams for outbound message events (Plan limitations and overages apply)
- Access to Custom Events for inbound event syncing (Plan limitations and overages apply)
- Updated Account Plan (not available on free apps)
Google AlloyDB
- AlloyDBインスタンスを持つGoogle Cloud Platformアカウント
- Google Cloudが要求するAuth Proxyが設定されていること
- ユーザーを作成してアクセスを許可するためのデータベース権限
- AlloyDBインスタンスへのネットワークアクセス
セットアップ
AlloyDB権限の設定
OneSignalは、AlloyDBデータベースからイベントデータを読み取る必要があります。イベントテーブルへの読み取り専用アクセスを持つ専用のONESIGNALユーザーアカウントを作成することをお勧めします。
1
OneSignalデータベースユーザーを作成する
強力で一意のパスワードを持つ専用ユーザーアカウントを作成します：
2
スキーマアクセスを許可する
OneSignalユーザーにイベントデータスキーマからの読み取りアクセスを許可します：
<your_event_schema>を、イベントテーブルを含む実際のスキーマに置き換えてください。3
関数権限を許可する（必要な場合）
イベントデータにストアドプロシージャまたは関数を使用する場合：
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 Field | Description | Required | |
|---|---|---|---|
name | event_name | Event identifier | Yes |
external_id | user_id | User identifier | Yes |
timestamp | event_timestamp | When event occurred | No |
properties | event_data | No |
高度なネットワーク設定
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にお問い合わせいただくか、アプリ内チャットをご利用ください。