ネイティブセグメンテーション条件でユーザーをターゲット化する

​

Kameleoon SDK でのデータ管理

​

主要用語

• ターゲティング条件: ターゲティングに使用される特定のユーザー属性またはセッション属性（例：コンバージョン、ブラウザ、カスタムデータ）。
• クライアントサイド: Web ブラウザまたはモバイルアプリで動作する標準 SDK のデータ処理。
• クライアントサイド (クロスデバイス): 複数のデバイスにわたって一貫した訪問者プロファイルを維持するクライアントサイド実装のデータ処理。
• サーバーサイド: SDK がバックエンドサーバー上で動作する際のデータ処理。クライアントサイド SDK と異なり、サーバーサイド SDK は通常、セッション終了後に訪問者情報を削除します。
• Web のみ: ページ URL やページタイトルなど、ブラウザでのみ生成されるデータに基づくターゲティング条件です。Web SDK はこのデータを自動的に収集します。Android、iOS、Flutter の各 SDK はブラウザがデータを生成しないため、これらの条件をサポートしません。React Native SDK はこれらの条件を実験的にサポートしています。サーバーサイド SDK はこれらの条件をサポートしており、addData() でデータを受け取るか、getRemoteVisitorData() で以前の Web セッションから取得します。

​

データ収集の要件

​

履歴データのために getRemoteVisitorData() を使用する

​

データ処理の定義

​

クライアントサイド SDK

• いいえ（自動）: SDK がこのデータを自動的に収集します。リモートリクエストや明示的な addData() 呼び出しは不要です。
• いいえ: SDK はこのデータを自動的には収集しません。addData()、trackConversion()、または getVariation() のような評価メソッドを使用してこのデータを追加する必要があります。リモートリクエストは不要です。
• はい: getRemoteVisitorData() を呼び出す必要があります。この要件は、サーバーで生成されるデータ（「Likelihood to convert」など）や、複数のデバイス間でセッションを統一して前のデバイスからアクションを取得する場合に適用されます。

​

サーバーサイド SDK

• いいえ（自動）: 「SDK type」のみに適用されます。SDK がこれを自動的に収集します。
• いいえ: このデータを提供するには addData() または trackConversion() を使用します。リモートリクエストは不要です。
• いいえ/はい: データはサーバー上で直接提供することも、リモートリクエストによって取得することもできます。このシナリオは、クライアントサイド SDK が現在の訪問中にすでに情報を収集している場合に発生します。
• はい: getRemoteVisitorData() を呼び出す必要があります。サーバーサイド SDK は 限られたデータストレージ を持つため、過去の訪問や実験の排他性などの履歴的なアクションを特定するためにリモート呼び出しが必要です。

​

リモートデータ取得の利点

• 最新の情報: 決定に Data API からのリアルタイムデータを使用できます。
• クロスデバイスの一貫性: 他のデバイスやセッションから収集されたデータにアクセスできます。
• 履歴アクセス: ローカル SDK の状態がクリアされていても、過去の URL 訪問など、以前のユーザー行動を取得できます。

​

エッジターゲティングの制約

​

エッジでの訪問者データの取得元

​

エッジでの getRemoteVisitorData()

• レイテンシ: getRemoteVisitorData() の呼び出しは、Data API から訪問者の履歴データを取得するのに通常 100～200 ms かかります。フラグとバリエーションの評価自体は通常ミリ秒単位で完了するため、リクエストごとにリモートデータ取得を追加すると、レイテンシがほとんどのエッジのユースケースが目標とする範囲を大きく超えてしまいます。
• 永続的な共有メモリがない: エッジプラットフォームはいつでもワーカーインスタンスを破棄して再作成できるため、フレームワークがリクエストをまたいで保存できる永続的な共有メモリを提供していない限り、getRemoteVisitorData() の結果をリクエスト間でキャッシュすることは信頼できません。

​

訪問者データをエッジワーカーに渡す

1. たとえば以前のページ読み込み時やクライアントサイド SDK の呼び出し時など、上流で訪問者属性を収集します。
2. エッジワーカーは外部呼び出しを行わずに受信リクエストから Cookie を読み取れるため、通常は Cookie として属性をエッジリクエストに渡します。
3. エッジワーカー内で属性を読み取り、フィーチャーフラグまたは実験を評価する前に、それらを使って addData() を呼び出します。

import { CustomData } from '@kameleoon/nodejs-sdk';

// Inside the edge worker, before evaluating any feature flag
const visitorCode = getCookie(request, 'kameleoonVisitorCode');
const plan = getCookie(request, 'customerPlan');

const customData = new CustomData(1, plan);
client.addData(visitorCode, customData);

const variation = client.getVariation({ visitorCode, featureKey: 'my_feature_key' });

​

制約はエッジフレームワークとプランによって異なる

​

ハイブリッド実験モード

• 実装プロセスを効率化します。
• エンジンが収集した datalayer 変数やフロントエンドの目標などのクライアントサイドデータに、SDK レベルで直接アクセスできます。

• SDK と Kameleoon JavaScript タグの両方を実装する必要があります。