概要
OneSignal + PostgreSQL統合により、PostgreSQLデータベースからOneSignalにカスタムイベントを同期して、ユーザーの行動に基づいて自動化されたメッセージングキャンペーンとJourneysをトリガーできます。要件
- 访问自定义事件(目前处于测试阶段)
- 升级账户计划(免费应用不可用)。
PostgreSQL
- **PostgreSQL 9.6+**または互換性のあるデータベース
- 適切な権限を持つデータベースユーザー
- OneSignalからPostgreSQLインスタンスへのネットワークアクセス
- 構造化された行動データを含むイベントテーブル
OneSignalを本番PostgreSQLデータベースに接続することは強く推奨しません。イベント同期クエリは分析的な性質を持ち、本番パフォーマンスに影響を与える可能性があります。分析ワークロード用に設定されたデータベースでのみ使用してください。
セットアップ
1
OneSignal専用ユーザーを作成する
適切な権限を持つ専用ユーザーアカウントを作成します:
2
イベントデータへの権限を付与する
イベントデータを含むスキーマへの読み取りアクセスを提供します:
3
OneSignalに接続する
在 OneSignal 中,前往 数据 > 集成,然后点击 添加集成。
- リストからPostgreSQLを選択します
- 接続詳細を入力します:
- Host:PostgreSQLサーバーのホスト名
- Port:通常は5432
- Database:データベース名
- Username:
CENSUS - Password:作成したパスワード
- 接続をテストします
- イベントデータを含むテーブルを設定します
事件数据映射
将您的 映射到 OneSignal 的自定义事件格式:| OneSignal 字段 | 描述 | 必需 | |
|---|---|---|---|
name | event_name | 事件标识符 | 是 |
external_id | user_id | 用户标识符 | 是 |
timestamp | event_timestamp | 事件发生时间 | 否 |
properties | event_data | 否 |
イベントテーブルスキーマの例
SQLクエリモード
イベントデータを変換するためのカスタムSQLクエリを作成します:高度なネットワーク構成
OneSignalは、高度なネットワーク制御を使用してPostgreSQLインスタンスに接続できます:- IP許可リスト:OneSignalのIPアドレスをファイアウォールと
pg_hba.confに追加します - SSHトンネリング:プライベートネットワークの踏み台ホストを介して接続します
- VPC構成:クラウド環境内での直接接続
- TLS暗号化:SSL/TLSを使用した安全な接続
SSHトンネルのセットアップ
プライベートネットワーク上のPostgreSQLインスタンスの場合:- SSHユーザーを作成:SSHホスト上に専用ユーザーを設定します
- トンネルを構成:OneSignal統合設定で「Use SSH Tunnel」を有効にします
- キーペアをインストール:OneSignalの公開鍵を
~/.ssh/authorized_keysに追加します - 接続をテスト:トンネル接続を確認します
注意事項
- 複数のスキーマ:イベントデータを含む各スキーマに対して権限付与を繰り返します
- クロススキーマ参照を持つビュー:古いPostgreSQLバージョンでは追加の読み取り権限が必要な場合があります
- Azure PostgreSQL:AzureインスタンスにはUsername@hostname形式を使用します
- AWS RDS:標準のusername形式を使用します
- パフォーマンス:大規模なイベント処理には読み取りレプリカの使用を検討してください
制限事項
- 分析クエリのオーバーヘッドのため、本番データベースへの接続は避けてください
- 複雑なクロススキーマクエリには追加の権限が必要な場合があります
- 高頻度のイベント処理には接続プーリングが推奨されます