RCS クッキー統合

概要

Algonomy の Omnichannel Personalization システムでは、RCS（RichRelevance Client Session）パラメータは、セッションの継続性を維持し、匿名ユーザーの行動を追跡し、MVT（多変量テスト）の割り当てを管理するために使用されます。これにより、セッションやデバイスを超えたシームレスなパーソナライゼーション体験が可能になります。

定義

rcs: API 応答で返される圧縮およびハッシュ化されたコンテナ（114 文字のエンコードされた zip）。暫定ユーザー ID、MVT データ、およびその他のユーザー行動情報などのセッション関連情報を格納します。rcs は英数字で構成され、大文字小文字を区別し、ユーザーの操作に基づいて動的に更新されます。

Note: 注: Personalization Cloud はこのパラメータに依存してショッパーの利用・行動データを取得するため、rcs/rr_rcs 値の長さを制限しないでください。
rrGuid: rcs 内に含まれる暫定ユーザー ID。Algonomy プラットフォーム内で匿名パーソナライゼーションに使用されます。rrGuid の表示が Site Configuration により有効化されていれば、クライアントはオプションでアクセス可能です。

Note: 注: rrGuid の表示はデフォルトで無効です。有効化には Algonomy コンサルタントへ Site Configuration を通じて依頼してください。

サーバーサイド統合：クッキープロキシ

サーバーサイド実装では、マーチャントがクッキープロキシ（またはクッキーパススルー）として動作し、Algonomy Omnichannel Personalization サーバーがブラウザクッキーに間接的にアクセスできるようにします。これにより、Algonomy サーバーがユーザーのブラウザクッキーに直接アクセスできない場合でも、シームレスなパーソナライゼーションとセッションの継続が保証されます。

クッキープロキシの仕組み

ステップ 1: ブラウザリクエスト
- ユーザーのブラウザがクライアントのウェブサイトにページをリクエスト。リクエストには保存された rr_rcs クッキーが含まれます。クライアントは rcs のみを使用可能で、rrGuid は任意です。
ステップ 2: クライアントサーバーがリクエストを受信
- クライアントサーバーがブラウザリクエストから rr_rcs クッキー（およびあれば rrGuid）を読み取り、保存します。
ステップ 3: クライアントサーバーがパーソナライゼーションデータをリクエスト
- パーソナライゼーションデータが必要な場合、クライアントサーバーは Algonomy にサーバーサイド API リクエストを行い、以下を送信します：
  - ブラウザクッキーから取得した rr_rcs の値
  - rrGuid（使用可能でかつ有効化されていれば）
ステップ 4: Omnichannel Personalization サーバーが応答
- Omnichannel Personalization サーバーがリクエストを処理し、API 応答を返します。
- API 応答には以下が含まれます：
  - 更新された rcs 値（変更があれば）
  - rrGuid 値（表示が有効な場合）
ステップ 5: クライアントサーバーが更新値を保存
- クライアントサーバーが新しい rr_rcs クッキーをクライアントドメイン下に保存します。
- 必要に応じて rrGuid を保持し、将来の API 呼び出しに使用します。

RCS 使用フロー

既存のクッキーを確認: rr_rcs クッキーが存在し、有効な値を持っているかを確認します。
API リクエストを送信:
- クッキーが存在する場合、その rcs 値をリクエストに含めます。
- rrGuid を使用している場合（オプション）、それも含めます。
API 応答を処理:
- 応答から最新の rcs を取得します。
- rrGuid を取得（表示が有効な場合）。
ストレージを更新:
- 更新された rcs を rr_rcs クッキーに保存します。
- 将来の追跡のために rrGuid を保持することも可能です。

rrGuid の使用と表示

rrGuid は、サイトに対して rrGuid の表示が有効である場合に限り、rcs と同じレベルで API 応答に含まれます。
顧客は以下の選択が可能です：
- rcs のみを使用し、セッションの継続性のためにパススルークッキーとして利用。
- rcs と rrGuid の両方を使用し、暫定ユーザー ID の把握に活用。
rrGuid を rcs と共に API リクエストに渡す場合、Algonomy プラットフォームは提供された rrGuid を埋め込むために rcs 値を再生成します。他の rcs 情報は維持されます。

RCS の保存と取得

Web（デスクトップおよびモバイル）: rr_rcs という名前のファーストパーティブラウザクッキーに保存されます。
アプリ: ローカルストレージに保存されます（アプリ環境ではクッキーは利用不可）。
rr_rcs クッキーのデフォルト有効期限は 364 日です。
以後のすべての API 呼び出しにおいて、常に rcs（および必要に応じて rrGuid）を取得して渡してください。毎回、応答に基づいて更新・保存します。

RCS の動作特性

動的であり、すべてのインタラクションで変更されるとは限りません。
rcs パラメータは複数セッションをまたいだトラッキングをサポートします。
クッキーが削除されると、新しい rcs および rrGuid が生成され、従来のトラッキングはリセットされます。
永続的な識別子ではありませんが、クッキーが存在する限りセッション継続を維持可能です。

RCS のクリーンアップとリセットルール

原則: ビジターの識別が変更された疑いがある場合は、空の rcs を渡してください。

セッション継続性における rcs の管理：

シナリオ	アクション
前のセッションを継続	前回の API 応答から受け取った rcs 値をそのまま渡す。rcs を変更または修正しない。
新しい匿名セッションを開始	空の rcs 値を渡す。
公共の端末でユーザーがログアウト	rcs 値をクリアして、ユーザー間のセッション持ち越しを防止。
新しいアプリのインストール	初回使用時に空の rcs を渡す。
同一ユーザーの端末（アプリ利用）	明示的にリセットが必要でない限り、既存の rcs を保持する。

まとめ

rcs および rrGuid パラメータは、Web やアプリ環境においてパーソナライズされた体験を提供するために不可欠です。rcs はセッションの継続性に必須であり、rrGuid は暫定ユーザー ID の追跡に役立つ任意の識別子です。これらの値を正しく処理・送信することで、正確なトラッキングとプライバシー準拠が実現します。これらのガイドラインに従うことで、Algonomy パーソナライゼーションの導入を効果的かつ安全に行えます。