ライフサイクル（サーバーサイド）

1. ブラウザー側の連携ブリッジとは別に存在する理由

MousePlayer には既に、お客様のページで動作する SDK に書き込むライフサイクル連携ブリッジがあります。Klaviyo、Braze、Customer.io、その他6サービスに対応しています。こちらは同じ役割を当社のサーバーから果たします。特に大きな二つのプラットフォームでは、ブラウザー経由の方法自体が使えないためです。

• ActiveCampaign には、イベント用のブラウザー API がありません。 同社の vgo() は、アカウントとメールアドレスを設定し、トラッキングを開始できますが、イベントは送信できません。イベントは、別のイベントキーを使い、サーバー側だけで Event Tracking API を介して送信します。
• Mailchimp にはありますが、使えるイベント名が決まっています。 サイトトラッキングのピクセルは、 PAGE_VIEWED、 PRODUCT_VIEWED、 PURCHASED およびその他いくつかの事前定義された名前を受け付けます。独自のイベントを入れる場所はありません。当社のデータを無理に PAGE_VIEWED に当てはめると、お客様自身のデータモデルに虚偽を入れることになります。

2. 必要なもの

入力欄は三つあり、どれを入力するかはプラットフォームによって異なります。

三つ目の欄は、表示に使うイベント名です。短くしてください： 最大32文字。これは当社ではなく API の制限です。送信時ではなく保存時に短縮します。そうしなければ、フォームに表示される内容と、実際に届く内容が違ってしまうためです。

3. 実行される場合と、されない場合

セッションが識別された時点です。サイトが MousePlayer.setUserId()を呼び出したとき、分析連携ブリッジが distinct ID を読み戻したとき、またはお客様のサーバーが identify エンドポイントを呼び出したときに実行します。それまでは、録画が誰のものか分かりません。

メールアドレスがある場合のみ

四つのプラットフォームはいずれも、メールアドレスで連絡先を指定します。顧客 ID が契約番号の場合は送信しません。失敗するしかないタスクをキューに入れても、ログに不要な情報が増えるだけだからです。

すべてのイベントに ID が付きます

タスクを再試行しても、同じセッションが二重に数えられないようにするためです。

4. 相手側に届く内容

再生リンクを、次の名前のプロパティに含む一つのイベントです： mouseplayer_session_url。開くと、まさにそのセッションの録画に移動できます。

そこから先は、利用先のプラットフォーム自身の処理です。イベントを自動化のトリガーやセグメントの条件に使うか、チームが連絡先から録画を開けるようにするだけでも構いません。

キーは当社のサーバーから外へ出ません

AES-256-GCM で暗号化して保存し、保存後は再表示しません。また、タスクを運ぶ内部キューには意図的に含めず、ワーカーがデータベースから直接取得します。

HTTP 200 は配信完了を意味しません

ActiveCampaign は、イベントを拒否するときもステータス200と {"success":0} を返します。当社はステータスだけでなくレスポンス本文を読み取るため、拒否は見えない成功ではなく、配信ログの失敗として表示されます。