イベントストリーム

​

一般的なユースケース

1. カスタマージャーニーマッピングとパーソナライゼーション：イベントをCRMまたはカスタマーデータプラットフォーム（CDP）にストリーミングして、包括的な顧客プロファイルを構築し、さまざまなタッチポイントでキャンペーンをカスタマイズします。
2. 分析とレポート：メッセージイベント（送信、開封、クリックなど）をデータウェアハウスに送信して、エンゲージメントパターンやチャネル全体の長期トレンドを分析します。
3. コンプライアンスと規制レポート：すべてのメッセージ送信データをデータウェアハウスにストリーミングして、監査とコンプライアンスの目的で使用します。
4. AIと予測モデル：メッセージイベントデータを社内のAIまたは予測モデルに送信して、包括的な顧客コホートを作成し、チャーンリスクを理解します。メール配信停止やメッセージの却下など、潜在的なチャーンを示す可能性があります。
5. マーケティングオートメーション：エンゲージメントイベント（メッセージの開封やクリックなど）を他のツールに送信して、ユーザージャーニーの次のステップを自動的にトリガーするか、顧客プロファイルと最近のアクティビティを更新します。
6. データの断片化：貴重な顧客データは、多くの場合、別々のツール（カスタマーエンゲージメントプラットフォーム、CRM、分析ツール、データウェアハウスなど）に存在します。イベントストリーミングは、このデータを一元化し、貴重なファーストパーティデータへの可視性を高め、より迅速な収益成果を可能にします。
7. システム間の遅い通信：ライブエンゲージメントイベントを他のシステムに送信することで、バッチ更新を数時間または数日待つのではなく、イベントが発生した直後にアクションをトリガーできます。これにより、手動インポートまたはデータ同期への依存が排除されます。
8. 支出の膨張と技術的負債：複数の中間ツールを管理する代わりに、OneSignalをデータウェアハウスに直接接続できます。これにより、複数の統合またはカスタムデータパイプラインの管理に伴うコストのかかるオーバーヘッドが削減され、技術的負債が軽減され、製品とマーケティングのための貴重な技術リソースが保持されます。

​

技術チームと連携する方法

1. メリットを説明する：このデータを使用する戦略と、マーケティングキャンペーンを強化し、ユーザーエクスペリエンスをパーソナライズし、データを統合し、技術的負債を削減する方法を共有します。
2. 範囲を定義する：データの送信先、追跡するイベント、推定データ量を特定します。これにより、適切なエンドポイント設定の構成が容易になります。
3. 技術ドキュメントを提供する：OneSignalの技術ドキュメントとセットアップ手順を共有します。開発チームは、受信者エンドポイントとOneSignalのイベントストリームを構成し、データが正しくルーティングされるようにする必要があります。
4. データ量と管理について話し合う：システムがリアルタイムデータフローを処理できることを確認します。APIハンドラーは、低い応答時間を維持するために、追加のオンライン処理なしでイベントを記録することをお勧めします。
5. テストとトラブルシューティング：本番稼働前にすべてが円滑に機能していることを確認するためにテストを実施します。

​

セットアップ

​

要件

• サーバーHTTP(S)サーバーを指す有効なURLまたはIPアドレス
• URLとIPアドレスは公的にルーティング可能である必要があります
• ドメインには、認識されたトップレベルドメイン（例：「.com」、「.net」）が含まれている必要があります

​

イベントの選択

Webhookのトリガー

イベントの選択

​

イベントストリームフィルター

テンプレートでイベントをフィルタリング

テンプレートのテンプレートIDをコピー

• テンプレート – https://dashboard.onesignal.com/apps/{APP_ID}/templates/{TEMPLATE_ID}
• プッシュ – https://dashboard.onesignal.com/apps/{APP_ID}/notifications/{MESSAGE_ID}
• メール – https://dashboard.onesignal.com/apps/{APP_ID}/email/{MESSAGE_ID}
• SMS – https://dashboard.onesignal.com/apps/{APP_ID}/sms/{MESSAGE_ID}

​

イベントストリームの構成

​

認証ヘッダー

• Authorizationヘッダー：Authorizationヘッダーを追加します。YOUR_TOKENはシステムまたはサードパーティによって提供されます：
  • Basic {{YOUR_TOKEN}}
  • Bearer {{YOUR_TOKEN}}
  • ApiKey {{YOUR_API_KEY}}
• カスタムヘッダー：次のようなカスタムヘッダーを追加することもできます：
  • X-API-Key: {{YOUR_API_KEY}}

​

構成のテスト

Webhookの構成

​

許可されないヘッダー

• content-length
• referer
• metadata-flavor
• x-google-metadata-request
• host
• x-onesignal*

​

ボディ

イベントストリームボディオプション

イベントストリームのcURLプレビュー

​

パーソナライゼーション

​

ボディの例

{
  "Event Data": {
    "event.kind": "{{ event.kind }}",
    "event.id": "{{ event.id }}",
    "event.timestamp": "{{ event.timestamp }}",
    "event.datetime": "{{ event.datetime }}",
    "event.app_id": "{{ event.app_id }}",
    "event.subscription_device_type": "{{ event.subscription_device_type }}",
    "event.subscription_id": "{{ event.subscription_id }}",
    "event.onesignal_id": "{{ event.onesignal_id }}",
    "event.external_id": "{{ event.external_id }}"
  },
  "Message Data": {
    "message.id": "{{ message.id }}",
    "message.name": "{{ message.name }}",
    "message.title": "{{ message.title.en }}",
    "message.contents": "{{ message.contents.en }}",
    "template_id": "{{ message.template_id }}",
    "message.template_id": "{{ message.template_id }}",
    "message.url": "{{ message.url }}",
    "message.app_url": "{{ message.app_url }}",
    "message.web_url": "{{ message.web_url }}"
  }
}

カスタムボディ

​

JSONでのLiquid構文の使用

• 文字列 → 引用符で囲む必要があります。
• 数値 → 引用符で囲まないでください。
• オブジェクト → 引用符で囲んではいけません。

​

文字列

// 文字列値を引用符で囲む
{
  "user_id": "{{ user.onesignal_id }}"
}

{
  "user_id": {{ user.onesignal_id }}
}

​

数値とブール値

// 数値またはブール値を引用符で囲まない
{
  "user_score": {{ user.tags.score }}
}

{
  "user_score": "{{ user.tags.score }}"
}

​

オブジェクト

// オブジェクトを引用符で囲まない
{
  "user_data": {{ user.tags }}
}

{
  "user_data": "{{ user.tags }}"
}

1. 直接言語チェックを使用する：より良い互換性のために、userLangのような変数ではなく、条件内で常にuser.languageを直接チェックします。
2. シンプルから始める：基本的なフレーズから始めて、徐々に複雑さを追加します。
3. 過度のネストを避ける：解析の問題を防ぐために、条件をフラットに保ちます。
4. 最初に基本的な句読点をテストする：特殊文字を使用する前に、シンプルな文と句読点から始めます。
5. フォールバックを使用する：翻訳が欠落している場合に備えて、デフォルト言語（例：英語）を確保します。
6. 標準キーに固執する：信頼性のために、content/title/enのような標準OneSignalキーを使用します。

​

結果とデバッグ

イベントストリームログとメトリクス

​

再試行 / 無効化

​

成功のためのヒント

1. 通常、イベントストリームはサードパーティサービスではなく、自分のサーバーに接続することをお勧めします。
   1. サードパーティに直接接続することに問題はありませんが、次のことを管理するのが難しくなります：構成/デバッグがより困難になります
   2. リクエストの量はOneSignalでは管理されません。
      1. イベントストリームイベントは、ユーザーがジャーニーのステップに到達するとすぐに送信されるため、他のサービスを圧倒したり、レート制限に達したり、予期せずに請求書が増加したりする可能性があります。これは、SMSなどの別のメッセージングチャネルを使用しようとするときに特に一般的です。イベントストリームの柔軟性により、OneSignalはそれらで何を達成しようとしているかを知らないため、イベントストリームリクエストを受け入れて、サードパーティの接続制限、レート制限、およびキューを正しく処理する独自のシンプルなサービスを作成することをお勧めします。
2. 多くのサービスには公開HTTP APIがあります。つまり、イベントストリームでそれらに接続できます。API ドキュメントとHTTPリクエストの作成方法の例を探して、開始するのに適切な場所を見つけてください。

​

テスト

URLはwebhook.siteの「Your unique URL」と一致します

プッシュメッセージイベントが選択されていますが、テストには任意のイベントを使用できます。

webhook.siteを使用した例

• Host：リクエストの送信元のIPアドレス。可能なIPのリストについては、REST API概要を参照してください。
• Request Content：イベントストリームのボディ内で送信されたデータ。