MySQL

概要

OneSignal + MySQL統合により、MySQLデータベースからOneSignalへのカスタムイベントの同期が可能になり、ユーザーの行動に基づいた自動化されたメッセージングキャンペーンとJourneysをトリガーできます。 MySQLは、広く使用されているオープンソースのリレーショナルデータベース管理システムで、パーソナライズされたメッセージングキャンペーンを強化できる構造化されたイベントデータの保存に最適です。

要件

アウトバウンドメッセージイベント用のEvent Streamsへのアクセス（プランの制限と超過料金が適用されます）
インバウンドイベント同期用のCustom Eventsへのアクセス（プランの制限と超過料金が適用されます）
更新されたアカウントプラン（無料アプリでは利用できません）

MySQL Community 5.7以降、または最新バージョンのMariaDB
構造化された行動データを含むイベントテーブル
OneSignalからMySQLインスタンスへのネットワーク接続
TLS v1.2以上がサポートされている

セットアップ

OneSignal専用のユーザーを作成する

読み取り専用権限を持つ専用ユーザーアカウントを作成します：

-- Create census user with ability to sign in with a password
CREATE USER CENSUS IDENTIFIED BY '<strong, unique password>';

-- Grant read-only access to your event schema
GRANT SELECT ON <your_schema>.* TO CENSUS;

イベントデータを含む複数のスキーマがある場合は、各スキーマに対してGRANT SELECTステートメントを繰り返してください。

OneSignal接続を構成する

OneSignalで、Data > Integrationsに移動し、Add Integrationをクリックします。MySQLを選択し、接続の詳細を提供します：

Host: MySQLサーバーのホスト名
Port: MySQLポート（通常は3306）
Database: イベントテーブルを含むデータベース名
Username: CENSUS
Password: 上記で作成したパスワード

接続をテストする

Test Connectionをクリックして、OneSignalがMySQLデータベースに正常に接続し、イベントテーブルにアクセスできることを確認します。

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

をOneSignalのカスタムイベント形式にマッピングします：

OneSignalフィールド	説明	必須
`name`	`event_name`	イベント識別子	はい
`external_id`	`user_id`	ユーザー識別子	はい
`timestamp`	`event_timestamp`	イベントが発生した時刻	いいえ
`properties`	`event_data`	いいえ

イベントテーブルスキーマの例

CREATE TABLE user_events (
    id BIGINT AUTO_INCREMENT PRIMARY KEY,
    event_name VARCHAR(100) NOT NULL,
    user_id VARCHAR(255) NOT NULL,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    event_data JSON,
    session_id VARCHAR(255),
    device_type VARCHAR(50)
);

テーブルモード

イベントテーブルを直接選択すると、OneSignalはすべての行を個別のイベントとして同期します。

SQLクエリモード

カスタムSQLクエリを記述して、イベントデータを変換します：

-- Example: Recent high-value events
SELECT
    event_name,
    user_id,
    created_at as timestamp,
    event_data as payload
FROM user_events
WHERE created_at >= DATE_SUB(NOW(), INTERVAL 7 DAY)
    AND JSON_EXTRACT(event_data, '$.value') > 100
ORDER BY created_at DESC;

高度なネットワーク構成

OneSignalは、リージョン制約、IPアドレス許可リスト、またはSSHトンネリングを含む高度なネットワーク制御を使用して、MySQLインスタンスに正常に接続できます。 OneSignalは、安全な接続のためにTLSバージョン1.2以上を使用するMySQLをサポートしています。

FAQ

どのMySQLバージョンがサポートされていますか？

OneSignalは、MySQL Community 5.7以降、および最新バージョンのMariaDBをサポートしています。

プライベートネットワーク内のMySQLに接続できますか？

はい、OneSignalは、プライベートネットワーク内またはファイアウォールの背後にあるMySQLインスタンスに接続するためのSSHトンネリングとIP許可リストをサポートしています。

はじめに & 設定

メッセージングチャネル

ジャーニー

オーディエンス & カスタムイベント

分析 & 統合

プライバシー & セキュリティ

MySQL

概要

要件

MySQL

セットアップ

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

イベントテーブルスキーマの例

テーブルモード

SQLクエリモード

高度なネットワーク構成

FAQ

どのMySQLバージョンがサポートされていますか？

プライベートネットワーク内のMySQLに接続できますか？

​概要

​要件

​MySQL

​セットアップ

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

​イベントテーブルスキーマの例

​テーブルモード

​SQLクエリモード

​高度なネットワーク構成

​FAQ

​どのMySQLバージョンがサポートされていますか？

​プライベートネットワーク内のMySQLに接続できますか？

概要

要件

MySQL

セットアップ

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

イベントテーブルスキーマの例

テーブルモード

SQLクエリモード

高度なネットワーク構成

FAQ

どのMySQLバージョンがサポートされていますか？

プライベートネットワーク内のMySQLに接続できますか？