実験におけるオフラインゴールコンバージョンの処理

以前に紹介したように、Kameleoon の DATA API では、ユーザーが Kameleoon サーバーへデータを取得・書き込みできます。これを実現する主要なエンドポイントは Visit、Product Recommendation、Map の 3 つです。状況によっては、店舗内の取引や電話注文など、オフラインで発生したゴールコンバージョンイベントを Kameleoon に送信する必要があります。このチュートリアルで説明する Visit エンドポイントは、個々の訪問者のオフラインデータを送信します。送信するデータの構造に大きな柔軟性を提供する MAP エンドポイントとは対照的に、Visit エンドポイントでは、事前定義されたデータポイントのみを送信できます。これらには、コンバージョン、イベント、ページビューイベントに加えて、その他のいくつかのデータタイプが含まれます。この情報は、実験結果のフィルタリングや効果的な分析に役立ちます。この記事では、次の操作について説明します。

POST/visit/events エンドポイントを使用したオフラインゴールコンバージョンの送信。
GET/visit/visitor エンドポイントを使用したオフラインゴールデータの送信検証。

オフラインコンバージョンデータを Kameleoon サーバーに送信するには、siteCode と visitorCode を正しくフォーマットした POST リクエストを送信します。

https://eu-data.kameleoon.io/visit/events?siteCode=example_sitecode&visitorCode=example_visitor_code

Kameleoon スクリプトのドメインはプロジェクトによって異なる場合があります。作成日に応じて、プロジェクトは kameleoon.eu または kameleoon.io のいずれかでホストされています。Kameleoon アプリのプロジェクト設定に表示されているドメインを使用してください。北米の場合は、na-data.kameleoon.io または na-data.kameleoon.eu を使用します。

siteCode: 実験プロジェクトに関連付けられた一意の ID。このコードを取得する手順はこちらを参照してください。
visitorCode: アプリケーションを閲覧している各ユーザーに割り当てられる一意の文字列。ユーザーを実験とバリエーションに割り当てると同時に、レポート用にデータを追跡します。Kameleoon Web Experimentation では、訪問者コードはランダムに生成され、各ユーザーに割り当てられます。Kameleoon Feature Experimentation では、Web SDK が訪問者コードを生成するか、特にログインが必要な Web サイトの場合はカスタム ID を使用できます。

Kameleoon のクロスデバイス調整を利用しているプロジェクトでは、visitorCode の代わりに mappingIdentifier パラメーターを使用できます。詳細はこちらをご覧ください。

このエンドポイントは、複数の visitorCode の一括コンバージョンをサポートしています。これを行うには、リクエスト本文に各イベントを含めます。

ゴールデータを送信する際にリクエスト本文に必要なパラメーターには、次のものが含まれます。

nonce: 各イベントに固有の 16 進文字 16 文字のランダムな文字列。
eventType: イベントタイプを指定する文字列。この例では CONVERSION を使用します。
goalID: ゴールの一意の ID。ゴールへのアクセスと管理方法についてはこの記事を参照してください。
revenue: コンバージョン時に発生した収益を示すオプションの浮動小数点パラメーター。

この情報は、次の cURL リクエストに変換されます。

curl -X POST 'https://eu-data.kameleoon.io/visit/events?siteCode=f17c21u1ag&visitorCode=245fc&json=true' \
-H 'Content-Type: application/json' \
-H 'User-Agent: CustomUserAgent/1.0' \
-d '[{"nonce":"a2bb4d22083348ef","eventType":"CONVERSION","goalId":36151,"revenue":23.50}]'

リクエストが成功した場合はオブジェクトレスポンスが返されないため、次のセクションでは GET/visit/visitor エンドポイントを使用して成功を検証する方法を示します。

オフラインゴールコンバージョンデータの検証

POST リクエストの結果を検証するには、GET エンドポイントを使用します。リクエスト URL には次が含まれている必要があります。

siteCode: このコードを取得する手順については前のセクションを参照してください。
visitorCode: 前のセクションで使用したものと同じ訪問者コード。
maxNumberPreviousVisits: 返される過去の訪問の最大数を表す整数。
currentVisit: 現在の訪問に焦点を当てるには true に設定します。デフォルト値は false です。(注: これは Kameleoon Feature Experimentation でのみ利用可能です。)
conversion: 指定されたユーザーおよび Kameleoon アカウントで構成されたゴールに対するコンバージョンイベントを取得するには true に設定します。

Feature Experimentation がアクティブでない場合、Kameleoon が訪問を処理するまで(通常は 30 分間の非アクティブ後)お待ちください。コンバージョンデータは、最後に計算された過去の訪問に表示されます。

これは、次の cURL リクエストに変換されます。

curl -X GET 'https://eu-data.kameleoon.io/visit/visitor?siteCode=f17c21u1ag&visitorCode=245fc&maxNumberPreviousVisits=5&currentVisit=true&conversion=true' \
-H 'Content-Type: application/json' \
-H 'User-Agent: CustomUserAgent/1.0' \

GET リクエストが成功すると、前のリクエストで送信されたデータを含むレスポンスが返され、POST リクエストが成功したことが確認できます。

{
  "previousVisits": [
    {
      "siteCode": "f17c21u1ag",
      "visitorCode": "245fc",
      "timeStarted": 1740447713028,
      "conversionEvents": [
        {
          "itp": false,
          "time": 1740447713028,
          "data": {
            "goalId": 361517,
            "revenue": 23.50,
            "negative": false,
            "metadata": {}
          }
        }
      ]
    }
  ]
}

追加情報

ほとんどの場合、指定したゴールと訪問者のコンバージョンは、実験レポートで使用されます。Kameleoon は、いくつかのルールに基づいてコンバージョンを実験に関連付けます。

アクティブな訪問中のコンバージョン: 訪問者がアクティブで、実験のターゲットとなっている間にコンバージョンが発生した場合、Kameleoon はその訪問のコンバージョンを実験に関連付けます。
訪問終了後のコンバージョン: 以前に訪問者が実験に含まれていたが、後で別のチャネル(例: 電話または店舗内)で購入を行った場合、Kameleoon は、定義されたアトリビューションウィンドウ(デフォルト: 7 日間)内にそれが発生した場合、そのコンバージョンを実験に帰属させます。このシナリオでは、Kameleoon はコンバージョンに関連付けられた新しい訪問を作成します。

訪問者レベルでのデータ分析により、コンバージョンの全体像を把握できます。これには、実験が以前に訪問者をターゲットにしていた場合に、ターゲット外の訪問中に発生したコンバージョンも含まれます。Kameleoon がコンバージョンをカウントする方法の詳細については、こちらのリンクを参照してください。

​オフラインゴールコンバージョンデータの検証

​追加情報

オフラインゴールコンバージョンデータの検証

追加情報