トラッキング分析

仕組み

トラッキング分析は、ユーザーが作成したイベントを収集、集計して、プログラムのパフォーマンスと照会数を向上させます。収集されたデータは、確固たる統計がより魅力的なため、アフィリエイト・ネットワークの強化手段としても利用できます。

以下のイベントを処理できます:

  • ランディングページへ移行
  • ランディングページから店へ移行

使用に適した方

  • パートナーのうち、パートナーネットワークが統合され、アフィリエイトネットワークプログラムが設定されたもの。
  • パートナーのうち、パートナーネットワークが統合され、無料ゲームを持ったもの

使用するには

トラッキング分析を統合する場合は次を実行してください:

  1. JSONウェブトークン(JWT)の取得
  2. リクエストパラメータのtracking_idをウェブサイトのクッキーへ保存。tracking_idを持つリクエストの例:https://playnewz.com?utm_source=n6LI9yVu&utm_campaign=5b9bff5f9d31b&tracking_id=19e2DLjNTk2YOdXA4d8J3NReNkXNafhC
  3. 新規ユーザー作成後、user_idtracking_id登録イベント送信メソッド経由で送る。
    • エクソラのトラッキングAPI応答待機中はユーザー登録に干渉できないので、同期せずにリクエストを送信することをお勧めします。
    • 他の方法としては、タイムアウトをご使用ください。エクソラのトラッキングAPI応答待ちが指定時間より長引くと、新規ユーザーを追跡できないのでご注意ください。
  4. カスタムイベントの作成と管理をする場合は、次のトラッキングAPIメソッドを実装してください:イベントの作成初期化送信
  5. ウェブサイトにトラッキングスクリプトを実装

トークンの取得

HTTPリクエスト

POST https://tracking-api.xsolla.com/v1/tokens

パラメータ 説明
Authorization API_KEY。パブリッシャーアカウントから、APIキーを獲得できます。
sourceType データソース名。"client"、"server"の可能性があります。クライアントソースは、信頼がおけないと考えられ、保管庫にある全関連イベントは「信頼あり:否」がついています。サーバーソースは、信頼がおけると考えられ、保管庫にある全関連イベントは「信頼あり:正」がついています。
sourceName データソース名。
projectId プロジェクトID。

例:トークン獲得中

POST https://tracking-api.xsolla.com/v1/tokens
Authorization: Basic 12kj3hlk1j2hlkjhlk1j2h3lkj
{
  "sourceType": "client",
  "sourceName": "landing",
  "projectId": 1
}

HTTP/1.1 201 Token created
{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsaW5rIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2 g_dj1kUXc0dzlXZ1hjUSJ9.aVigY6UVY3jgoEKoBv31cZnROL3I6WKtcr5K-Z7B1du"
}

応対コード 説明
201 トークンが作成されました
400 質問パラメターが無効です
401 プロジェクトキーが無効です

登録イベント送信

こちらを実行するにはトークンを獲得する必要があります。

HTTPリクエスト

POST https://tracking-api.xsolla.com/v1/events

パラメータ 説明
Authorization 以前獲得されたトークン。
type イベントの種類(ここでは'registration')。
traits オブジェクト。ユーザーIDデータ:
  • trackingId - ゲームのウェブサイトにリダイレクトされるユーザーの tracking_id 。リダイレクト後にエクソラがこれをリクエストパラメータで送信します。
  • userId - トークン作成に割り当てられるユーザーID
context オブジェクトは空にしてください。
properties オブジェクトは空にしてください。

curl -X POST \
https://tracking-api.xsolla.com/v1/events \
-H 'authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzb3VyY2VUeXBlIjoiY2xpZW50Iiwic291cmNlIjoicHVibGlzaGVySWRfMjM0MF9wcm9qZWN0SWRfMjAyMDFfbXVsdGkiLCJpYXQiOjE1NDMyMzAxODN9.0LheoQnDKJHIHWNMSIrhcrBEu_th3xUHykhLby1nik4' \
-H 'content-type: application/json' \
-d '{ "type": "registration", "traits": { "trackingId": "19e2DLjNTk2YOdXA4d8J3NReNkXNafhC", "userId": "20181126" }, "properties": {}, "context": {} }'

イベント作成中

こちらを実行するにはトークンを獲得する必要があります。

HTTPリクエスト

POST https://tracking-api.xsolla.com/v1/events

パラメータ 説明
Authorization 以前獲得されたトークン。
type イベントの種類。
traits オブジェクト。ユーザーIDデータ:電話番号、Eメール、ゲーム内IDなど。
context オブジェクト。文脈上のデータ。
properties オブジェクト。イベントの特性。
createdAt 日にち。フォーマット:RFC3339またはISO8601ごとに決定。

イベント例:ランディングページへ移行

POST https://tracking-api.xsolla.com/v1/events
Authorization: Bearer
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsaW5rIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g_d j1kUXc0dzlXZ1hjUSJ9.aVigY6UVY3jgoEKoBv31cZnROL3I6WKtcr5K-Z7B1yU
{
  "type": "landing_visit",
  "traits":{
    },
  "properties":{
    },
  "context": {
    "user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36", "user_locale":"ru"
  }
}

イベント例:支払いステーションへ移行

POST https://tracking-api.xsolla.com/v1/events
Authorization: Bearer
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsaW5rIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g_d j1kUXc0dzlXZ1hjUSJ9.aVigY6UVY3jgoEKoBv31cZnROL3I6WKtcr5K-Z7B1yU
{
  "type": "buy_btn",
  "traits":{
    },
  "properties":{
    "pkg_type":"bronze"
    },
  "context": {
    "user_agent":"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/58.0.3029.110 Safari/537.36", "user_locale":"ru"
  }
}

応対コード 説明
204 イベントが追加されました
400 イベントが無効です
401 トークンが無効です

イベントの初期化中

こちらを実行するにはトークンを獲得する必要があります。

xnt("init", YOUR_TOKEN);

イベント送信中

xnt("sendEvent", EVENT_TYPE, EVENT_PROPERTIES);

パラメータ 説明
EVENT_TYPE イベント名(ストリング)。例"landing_visit"。
EVENT_PROPERTIES イベント特性(JSオブジェクト)。

xnt("sendEvent", "landing_visit");
xnt("sendEvent", "buy_btn", { pkg_type: $(this).data('id') });

イベントパラメーター

パラメータ 説明
source イベントソース(支払いステーション、landing_pageなど)。
type イベントの種類(user_visit、ヒット数など)。
traits ユーザーデータ(Eメール、user_id、ニックネームなど)。
context イベント環境(ip、gaClientIdなど)。
properties イベント特性(合計、レベルアップなど)。
createdAt ソースによって経過したイベント時間。
timestamp システムが受理したイベント時間。

イベントを'context' & 'traits' パラメーターで補完するには、以下の方法を使って下さい:

xnt("putContext", CONTEXT_OBJECT);
xnt("putTraits", TRAITS_OBJECT);

パラメータ 説明
CONTEXT_OBJECT イベント環境(JSオブジェクト)。
TRAITS_OBJECT ユーザーデータ(JSオブジェクト)。
Note: コンテキストの'userAgent'と'userLocale'は自動的に追加されます。これら2つの方法で追加されたデータは、イベントデータと組み合わせられます。

スクリプト実施中

ランディングページに以下のスクリプトを履行する:

<script>
(function(i,s,o,g,r,a,m){i['XsollaNetworkTrackingObject']=r;i[r]=i[r]||function(){(i[r].q=i[r].q||[]).push(ar guments)},i[r].l=1*new Date();a=s.createElement(o),m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.inse rtBefore(a,m)})(window,document,'script','https://cdn.xsolla.net/network/xtracking-0.1.js','xnt');
xnt("init", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsaW5rIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g_ dj1kUXc0dzlXZ1hjUSJ9.aVigY6UVY3jgoEKoBv31cZnROL3I6WKtcr5K-Z7B1du");
xnt("sendEvent", "buy_btn", { pkg_type : "gold" });
</script>