メインコンテンツへスキップ
カスタムイベントは現在Early Accessです。 アクセスをリクエストするには、以下の情報と共にsupport@onesignal.comにお問い合わせください：
  • 会社名
  • 有効にしたいOneSignal App ID(s)

​
概要

カスタムイベントを使用すると、アプリ、ウェブサイト、または外部システムからの意味のあるユーザーアクションを追跡し、リアルタイムでそれらに対応できます。OneSignal外で発生する動作のユーザーイベントを送信し、よりターゲット化され、関連性が高く、タイムリーなメッセージングを提供するために使用します。 次のことができます：
  • OneSignal SDKを使用してアプリまたはウェブサイトから直接イベントを送信
  • 統合、CDP、またはデータウェアハウスからイベントをインポート
  • それらを使用してJourneysをトリガー、Wait Untilステップをアクティブ化、リアルタイムの動作に基づいてユーザーをセグメント化（セグメンテーションオプションは近日公開予定）
ユースケースの例：
  • ユーザーがサインアップ → オンボーディングJourneyを開始
  • ユーザーがチェックアウトを放棄 → リマインダーまたはオファーを送信
  • ゲーマーが新しいレベルに到達 → アプリ内報酬を送信
  • ユーザーがアカウントのキャンセルを試みる → 復帰キャンペーンをトリガー

​
カスタムイベントとは？

カスタムイベントは、ビジネスにとって重要な追跡されたユーザーアクション（または非アクション）です。一般的な例には次が含まれます：
  • 購入を行う
  • ゲームレベルを完了する
  • ワークアウトを開始する
  • サブスクリプションをキャンセルする
各イベントには、追加のコンテキストを提供するためのプロパティを含めることができます。 カスタムイベント構造：
  • name (string、必須) — イベント名、最大128文字
  • properties (object、オプション) — JSONのコンテキストデータ
  • ユーザー識別子 (必須) — external_idまたはonesignal_idのいずれか
例： 
{
  "event": "purchase",
  "properties": {
    "item": "T-shirt",
    "size": "small",
    "color": "blue",
    "price": 24.99
  }
}
カスタムイベントは次の方法で利用できます：
  • アプリまたはサイトからリアルタイムで生成（OneSignal Mobile/Web SDKs）
  • Segment、Amplitude、Databricksなどの統合から取り込み（近日公開予定）
  • ウェアハウスまたはCDPからインポート（近日公開予定）

​
タグとカスタムイベントの比較

TagsとCustom Eventsは、どちらもユーザーにデータを追加する方法です。ただし、いくつかの重要な違いがあります：
機能TagsCustom Events
データ使用セグメンテーションとパーソナライゼーションセグメントなしでJourneysをトリガー、Wait Untilステップ、Journeys内で直接パーソナライゼーション
データ保持期間永久30日以上（永久ストレージが利用可能）
データ形式キーバリューの文字列または数値JSON
データソースOneSignal SDK、API、または統合（制限あり）OneSignal SDK、API、または統合
データアクセスセグメンテーションとメッセージパーソナライゼーションJourneysとJourneyメッセージテンプレートのパーソナライゼーション、セグメンテーション（近日公開）
TagsとCustom Eventsの主な違いは、その深さとユースケースにあります。Tagsはユーザーのプロパティであり、名前、アカウントステータス、場所などです。Eventsはユーザーが行ったことであり、アイテムの購入、レベルの完了、友達の招待などです。tagsとeventsの両方は、セグメンテーションとパーソナライゼーションに使用できます。 実際には、両方を使用する可能性が高いです：
  • 静的であまり変更されないユーザープロパティにはTags
  • リアルタイムシナリオ、複雑なセグメンテーション、より洗練されたジャーニーワークフローにはCustom Events

​
OneSignalへのカスタムイベントの取得

APIを使用して直接イベントを生成したり、他のシステムからイベントを取り込んだりできます。
すべてのイベント — SDKから生成されたものでもData Warehouseから取り込まれたものでも — 請求目的では同じように扱われます。

​
OneSignal APIとSDK

次を介してイベントを送信します： 例：API経由で送信
curl
curl --request POST \
  --url https://api.onesignal.com/apps/{app_id}/custom_events \
  --header 'Content-Type: application/json' \
  --data '{
  "events": [
    {
      "name": "completed_onboarding",
      "external_id": "user_12345",
      "properties": {
        "plan": "Pro",
        "time_to_complete": 600
      }
    }
  ]
}'
​
name
string
required
イベントの識別子または名前。最大128文字。
​
external_id
string
イベントの対象となるユーザーの外部ID。ユーザーのExternal IDまたはOneSignal IDのいずれかが必要です。
​
properties
object
イベントに関するオプションのパラメータ（例：プラン名、製品ID、価格）。
このイベントは、external_id user_12345を持つユーザーを、カスタムイベントエントリールールトリガーまたはwait untilアクションとしてcompleted_onboardingを使用するJourneyに即座に追加します。

​
統合

イベントが既に他の場所で追跡されている場合は、サポートされている統合を介してそれらをインポートします。

​
イベントの表示と検証

イベントが流入し始めたら、OneSignalのいくつかのツールを通じてそれらを表示およびトラブルシューティングできます。

​
Event Listタブ

Organizationに移動

Event Listタブは、イベントタイプ別に整理されたイベントの高レベルダッシュボードを提供します。各イベントタイプについて、取り込まれたイベントの総数、最近取り込まれたイベント（そのプロパティとともにJSON形式で表示）、イベントのソース（SDK、API、または統合）、およびイベントタイプが最後に発生した時刻を確認できます。各イベントの詳細ビュー内では、その保持期間を更新するオプションもあります。 サブ詳細ビューでは、3つの主要な領域に関する追加の洞察が提供されます：
  • ソース内訳 – ソース別に取り込まれたイベントの数を表示し、展開してイベントの最新スキーマと最後に確認されたイベントのタイムスタンプを表示するオプションがあります。
  • アクティビティ – 最近取り込まれた10件のイベントをリストし、そのソースとタイムスタンプを表示します。各エントリを展開して、イベントの完全なJSONペイロードを表示できます。
  • 使用状況 – セグメントやJourneysなど、OneSignal内で特定のイベントが使用されている場所を表示します。ここから、関連するセグメントまたはJourneyに直接クリックして設定にアクセスできます。

​
Event Activityタブ

Organizationに移動

Event Activityタブは、OneSignalアプリに取り込まれた最新のイベントのライブフィードを提供します。フィードを展開して最大90日前のイベントを確認し、ソース、イベントプロパティ、または外部IDでフィルターを適用できます。このタブは、イベントソースを構成する際の問題のデバッグに特に役立ちます。イベントがアプリケーションに期待どおりに到達しているかどうかを検証できます。フィードは自動更新されないため、新しいイベントを送信した後に最新のアクティビティを確認するには、手動で更新する必要があります。

​
Event Storageタブ (近日公開予定)

OneSignal Applicationのイベントのストレージを管理するための専用ビュー。

​
OneSignalでのカスタムイベントの使用

​
イベントでJourneysをトリガー

イベントトリガーJourneysを使用すると、リアルタイムのアクティビティに基づいてユーザーに即座にメッセージを送信できます。セグメントの更新を待つ必要はありません。ユーザーが重要なアクションを実行した瞬間にJourneyを開始できます。

​
Wait Untilイベント

Wait Untilステップを使用して、特定のカスタムイベントまたは他のアクションまでJourney内のユーザーを一時停止します。
有効期限ウィンドウを定義することもできます。ユーザーが時間内に条件を満たさない場合、フォールバックパスを続行したり、代替メッセージを送信したり、Journeyを終了したりできます。

​
カスタムイベントによるセグメンテーション（Early Accessで利用可能）

カスタムイベントの発生に基づいてセグメントを作成できます。これにより、OneSignal SDKを使用したアプリケーションでの動作、またはOneSignal外でキャプチャされたイベントに基づいてユーザーをセグメント化できます。Custom Event Segmentationの詳細は、Segmentationページで利用できます。 Custom Event SegmentationのEarly Access Programへの参加に興味がある場合は、support@onesignal.comまたはOneSignalアカウント担当者にお問い合わせください。 Early Access中のこの機能の制限事項：
  • Email Warm UpおよびA/Bテストでは使用できません。
  • カスタムイベントセグメントはJourneysを強化するために使用できません。
  • カスタムイベントフィルターを他のセグメンテーションフィルター（ユーザープロパティやメッセージイベントなど）とまだ組み合わせることができません。

​
プランの利用可能性と保持コスト

カスタムイベントは、すべての有料プランで利用できます。詳細については、Billing FAQを参照してください。