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

概要

OneSignal + SingleStore統合により、SingleStoreデータベースからOneSignalにカスタムイベントを同期して、ユーザー行動に基づいた自動化されたメッセージングキャンペーンとJourneysをトリガーできます。 SingleStoreは、リアルタイム分析と高性能アプリケーション向けに設計された分散SQLデータベースです。

要件

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

SingleStore

  • SingleStoreDB CloudまたはSingleStoreDB v7.1+
  • 適切な権限を持つデータベースユーザー
  • 構造化された行動データを含むイベントテーブル
  • OneSignalからSingleStoreクラスターへのネットワーク接続

セットアップ

1

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

強力で一意のパスワードを持つ専用ユーザーアカウントを作成します:
-- Create census user with the ability to sign in with a password
CREATE USER CENSUS IDENTIFIED BY '<strong-unique-password>';
2

イベントデータへの権限を付与する

イベントデータを含むスキーマへの読み取り専用アクセスを提供します:
-- Grant read-only access to schema with event data
GRANT SELECT ON analytics.* TO CENSUS;

-- Repeat for additional schemas if needed
GRANT SELECT ON events.* TO CENSUS;
イベントデータを含む複数のスキーマがある場合は、各スキーマに対してGRANT SELECTステートメントを繰り返します。
3

OneSignalに接続する

OneSignalで、Data > Integrationsに移動し、Add Integrationをクリックします。SingleStoreを選択し、次の接続詳細を提供します:
  • Host: SingleStoreクラスターエンドポイント
  • Port: 3306(デフォルト)
  • Database: データベース名
  • Username: CENSUS
  • Password: ステップ1のパスワード

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

をOneSignalのカスタムイベント形式にマッピングします:
OneSignalフィールド説明必須
nameevent_nameイベント識別子はい
external_iduser_idユーザー識別子はい
timestampevent_timestampイベントが発生した時刻いいえ
propertiesevent_dataいいえ

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

-- Example SingleStore event table
CREATE TABLE analytics.user_events (
    event_id BIGINT AUTO_INCREMENT PRIMARY KEY,
    event_name VARCHAR(100) NOT NULL,
    user_id VARCHAR(255) NOT NULL,
    event_timestamp TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    event_data JSON,
    session_id VARCHAR(255),
    device_type VARCHAR(50)
);

SQLクエリモード

カスタムSQLクエリを記述してイベントデータを変換します:
-- Example: Recent high-value events
SELECT
    event_name,
    user_id,
    event_timestamp,
    event_data
FROM analytics.user_events
WHERE event_timestamp >= DATE_SUB(NOW(), INTERVAL 7 DAY)
    AND JSON_EXTRACT_STRING(event_data, 'value') > '100'
ORDER BY event_timestamp DESC;

高度なネットワーク構成

OneSignalは、リージョン制約やIPアドレス許可リストを含む高度なネットワーク制御を使用しているSingleStoreインスタンスに正常に接続できます。 ネットワークアクセスの構成の詳細については、SingleStore管理者またはOneSignalサポートにお問い合わせください。

制限事項

  • リアルタイム分析クエリは、トラフィックが多い期間中にクラスターのパフォーマンスに影響を与える可能性があります
  • JSON操作は、分散実行用に最適化する必要があります

FAQ

複数のSingleStoreスキーマに接続できますか?

はい、イベントデータを含む各スキーマに対してGRANT SELECTステートメントを実行することで、CENSUSユーザーに複数のスキーマへのアクセスを許可できます。

OneSignalはSingleStore Cloudをサポートしていますか?

はい、OneSignalはSingleStoreDB Cloudとオンプレミスの SingleStoreDB v7.1+インストールの両方をサポートしています。