イベント

イベントとは、カートへの追加や購入など、ユーザーがサービス内で行う具体的なアクションを指します。これらのイベントをもとに、カスタマージャーニーの自動化といった高度なマーケティングを実施できます。

ユーザーが特定のアクションを行うたびに、イベントを発生させます。

イベントが発生した瞬間に、次のコードを実行してください：

• （推奨） REST API：POST /v1/projects/PROJECT_ID/track
  • サーバーからAPI経由でイベントを送信すると、アプリのバージョンに依存しない、より正確な連携が可能になるため推奨します。
• Web SDK / Mobile SDK： FlareLane.trackEvent("test_event")

例：API経由でイベントを連携する

curl --request POST \
     --url https://api.flarelane.com/v1/projects/PROJECT_ID/track \
     --header 'Authorization: Bearer API_KEY' \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "events": [
    {
      "subjectType": "user",
      "subjectId": "userid1",
      "type": "purchase",
      "data": {
        "productId": "123",
        "productName": "Product Name",
        "amount": 10000
      }
    }
  ]
}
'

イベントとともに送信できるデータの値は、次の型をサポートしています。

• String（文字列）
• Number（数値）
• Time（時刻。次の2種類のいずれかを使用し、指定の形式に従ってください）
  • ISO8601形式の文字列：例 "2024-04-19T14:23:56+09:00"
  • ミリ秒単位のUnixタイムスタンプ：例 1681721331085
• Boolean（真偽値。true/false）
• Array（配列。型は統一する必要があります。すべて文字列、またはすべて数値）
• null（タグを削除します）

FlareLaneの顧客データ連携ページでは、発生したすべてのイベントを最近のイベント一覧で確認できます。特定のユーザーIDやデバイスIDで絞り込むこともできます。

同じページの下部にある連携済みイベントの一覧では、利用可能なイベントを確認できます。新しいイベントを連携すると、しばらくすると自動的に一覧へ追加されます。待たずに手動で一覧に追加して、すぐに利用することもできます。（一覧に追加されたことが、データが正しく連携されたことを必ずしも意味するわけではありません。）

セグメントフィルターのイベントフィルターを使うと、あらゆるグループを自由に作成できます。一定期間内にイベントが何回発生したか、イベントデータの詳細な条件など、さまざまな条件を設定できます。

カスタマージャーニーの自動化では、連携したイベントを使って、パーソナライズメッセージ（Liquid）構文によりメッセージ本文に詳細なデータを差し込めます。

使い方： {{ entry_event.data.dataName | default: defaultValue }}

FlareLaneが自動的に収集するイベントで、名前の先頭に付く@で区別されます。現在は次の5つのイベントが自動収集されており、今後さらに追加される予定です。

• @first_session：デバイスが作成されたときに発生します
• @clicked：プッシュ通知がクリックされたときに発生します
• @iam_displayed：アプリ内メッセージが表示されたとき
• @iam_clicked：アプリ内メッセージがクリックされたとき
• @iam_closed：アプリ内メッセージが閉じられたとき