追跡分析

どのように動作するか

トラッキング分析を使用すると、ユーザーが生成したイベントを収集または集計し、キャンペーンのパフォーマンスや紹介数を評価できます。収集されたデータは、確固たる統計がより魅力的なため、アフィリエイトネットワークの強化手段としても利用できます。

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

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

入手方法

トラッキング分析を統合するには、次のようにします:

  1. JSON ウェブ トークンを取得する(JWT)。
  2. リクエストパラメータからウェブサイトのクッキーにtracking_idを保存します。tracking_id付きリクエストの例: :https://playnewz.com?utm_source=n6LI9yVu&utm_campaign=5b9bff5f9d31b&tracking_id=19e2DLjNTk2YOdXA4d8J3NReNkXNafhC
  3. 新規ユーザーが作成されたら、登録イベント送信メソッド経由でuser_idtracking_idを送信します。
    • エクソーラ Tracking API のレスポンスを待っている間にユーザー登録の邪魔にならないように、リクエストを非同期で送信することをお勧めします。
    • それ以外の場合は、タイムアウトを使用します。エクソーラ Tracking API レスポンスの待ち時間が指定された時間よりも長い場合、新しいユーザーは追跡されないことに注意してください。
  4. カスタムイベントを作成して管理するには、以下のTracking APIメソッドを実装します:イベントを作成初期化および 送信します。
  5. ウェブサイトにトラッキングスクリプトを実装します。

トークンを取得する

HTTPリクエスト

Copy
Full screen
Small screen
1POST https://tracking-api.xsolla.com/v1/tokens
ヘッダー説明
ContentTypeapplication/json
AuthorizationAuthorization: Basic <your_authorization_basic_key>ヘッダーで、<your_authorization_basic_key>マーチャントID:APIキーのペアで、Base64の基準に従ってエンコードしています。パブリッシャーアカウントに移動して、次のパラメータを見つけます:必須
注意

APIキーの操作については、APIリファレンスを参照してください。

キーに関する推奨事項:

  • 生成されたAPIキーは、お客様側で保存してください。APIキーは、パブリッシャーアカウントで作成時に一度だけ表示することができます。
  • APIキーは秘密にしておいてください。APIキーは、お客様の個人アカウントとパブリッシャーアカウントのプロジェクトへのアクセスを提供します。
  • APIキーはサーバーに保存する必要があり、決してバイナリやフロントエンドに保存してはいけません。

必要なAPIコールにproject_idパスパラメータが含まれていない場合は、会社のすべてのプロジェクトで有効なAPIキーを使用して認証を設定します。

パラメータ説明
sourceTypeデータソースのタイプ。以下の値を取ることができます:
  • client。このソースタイプは信頼できないと見なされ、ストレージ内のすべてのそれぞれのイベントのステータスはtrusted: falseです。
  • server。このソースタイプは信頼できると見なされ、ストレージ内のすべてのそれぞれのイベントのステータスはtrusted: trueです。
sourceNameデータソース名。
projectIdプロジェクトID。
Copy
Full screen
Small screen

http

  • http
  • php
 1POST https://tracking-api.xsolla.com/v1/tokens
 2
 3Headers:
 4Content-Type: application/json
 5Authorization: Basic 12kj3hlk1j2hlkjhlk1j2h3lkj
 6
 7Body:
 8{
 9  "sourceType": "client",
10  "sourceName": "landing",
11  "projectId": 1
12}
13
14HTTP/1.1 201 Token created
15{
16  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsaW5rIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2 g_dj1kUXc0dzlXZ1hjUSJ9.aVigY6UVY3jgoEKoBv31cZnROL3I6WKtcr5K-Z7B1du"
17}
 1<?php
 2
 3$curl = curl_init();
 4
 5$merchantId = 1;
 6$projectId = 2;
 7$apiKey = '<apiKey>';
 8
 9$payload = [
10    'sourceType' => 'server',
11    'sourceName' => 's1',
12    'projectId' => $projectId,
13];
14
15curl_setopt($curl, CURLOPT_USERPWD, $merchantId . ":" . $apiKey);
16
17
18curl_setopt_array($curl, array(
19    CURLOPT_URL => "https://tracking-api.xsolla.com/v1/tokens",
20    CURLOPT_RETURNTRANSFER => true,
21    CURLOPT_ENCODING => "",
22    CURLOPT_MAXREDIRS => 10,
23    CURLOPT_TIMEOUT => 30,
24    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
25    CURLOPT_CUSTOMREQUEST => "POST",
26    CURLOPT_POSTFIELDS => json_encode($payload),
27    CURLOPT_HTTPHEADER => [
28        "Content-type: application/json"
29    ],
30));
31
32
33$response = curl_exec($curl);
34$err = curl_error($curl);
35
36curl_close($curl);
37
38if ($err) {
39    echo "cURL Error #:" . $err;
40} else {
41    echo $response;
42}
応対コード説明
201トークンが作成されました
400質問パラメターが無効です
401プロジェクトキーが無効です

登録イベント送信

そのためにはまずトークンを入手する必要があります。

HTTPリクエスト

Copy
Full screen
Small screen
1POST https://tracking-api.xsolla.com/v1/events

メソッドの送信中に、次の手順が完了します:

  1. エンドユーザーは、トラフィックソース(クリエイターのストリーム、プロモーションページなど)で見つけたトラッキングリンクをフォローします。アクションにはクリックIDが与えられます。
  2. トラッキングIDはプロキシページ側で形成され、パラメータでランディングページに渡されます。
  3. ユーザーはランディングページにアクセスして新規登録します。
  4. ゲーム開発者は、追跡APIを介して登録イベントを送信することにより、パラメータでユーザーIDトラッキングIDを渡します。

ヘッダー説明
Authorization以前獲得されたトークン。
パラメータ種類説明
type文字列以前獲得されたトークン。
traitsオブジェクトユーザーIDデータ:
  • trackingId — ゲームのウェブサイトにリダイレクトされるユーザーの Tracking ID。リダイレクト後にエクソーラがこれをリクエストパラメータで送信します。
  • userIdトークン作成に割り当てられるuser ID
contextオブジェクト空欄にする。
propertiesオブジェクト空欄にする。
Copy
Full screen
Small screen

http

  • http
  • php
 1POST https://tracking-api.xsolla.com/v1/events
 2
 3Headers:
 4Content-Type: application/json
 5Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsaW5rIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g_d j1kUXc0dzlXZ1hjUSJ9.aVigY6UVY3jgoEKoBv31cZnROL3I6WKtcr5K-Z7B1yU
 6
 7Body:
 8{
 9  "type": "registration",
10  "traits": {
11    "trackingId": "19e2DLjNTk2YOdXA4d8J3NReNkXNafhC",
12    "userId": "20181126"
13  },
14  "properties": {
15  },
16  "context": {
17  }
18}'
 1<?php
 2
 3$curl = curl_init();
 4
 5$token  = '<token>';
 6
 7$payload = [
 8    'type' => 'registration',
 9    'traits' => [
10        'trackingId' => "19e2DLjNTk2YOdXA4d8J3NReNkXNafhC",
11        'userId' => "20181126",
12    ],
13    'properties' => [],
14    'context' => [],
15];
16
17curl_setopt_array($curl, array(
18    CURLOPT_URL => "https://tracking-api.xsolla.com/v1/events",
19    CURLOPT_RETURNTRANSFER => true,
20    CURLOPT_ENCODING => "",
21    CURLOPT_MAXREDIRS => 10,
22    CURLOPT_TIMEOUT => 30,
23    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
24    CURLOPT_CUSTOMREQUEST => "POST",
25    CURLOPT_POSTFIELDS => json_encode($payload,JSON_FORCE_OBJECT),
26    CURLOPT_HTTPHEADER => [
27        "Authorization: Bearer {$token}",
28        "Content-type: application/json"
29    ],
30));
31
32$response = curl_exec($curl);
33$err = curl_error($curl);
34
35curl_close($curl);
36
37if ($err) {
38    echo "cURL Error #:" . $err;
39}

イベントを作成する

そのためにはまずトークンを入手する必要があります。

HTTPリクエスト

Copy
Full screen
Small screen
1POST https://tracking-api.xsolla.com/v1/events
ヘッダー説明
Authorization以前獲得されたトークン。
パラメータ種類説明
type文字列イベントの種類。
traitsオブジェクトユーザーIDデータ:電話番号、Eメール、ゲーム内IDなど。
contextオブジェクト文脈上のデータ。
propertiesオブジェクトイベントのプロパティ。
createdAt日付フォーマット:RFC3339またはISO8601ごとに決定。
イベント例:ランディングページへ移行
Copy
Full screen
Small screen
 1POST https://tracking-api.xsolla.com/v1/events
 2
 3Headers:
 4Content-Type: application/json
 5Authorization: Bearer
 6eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsaW5rIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g_d j1kUXc0dzlXZ1hjUSJ9.aVigY6UVY3jgoEKoBv31cZnROL3I6WKtcr5K-Z7B1yU 
 7
 8Body:
 9{
10  "type": "landing_visit",
11  "traits":{
12    },
13  "properties":{
14    },
15  "context": {
16    "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"
17  }
18}

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

Copy
Full screen
Small screen
 1POST https://tracking-api.xsolla.com/v1/events
 2
 3Headers:
 4Content-Type: application/json
 5Authorization: Bearer
 6eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsaW5rIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g_d j1kUXc0dzlXZ1hjUSJ9.aVigY6UVY3jgoEKoBv31cZnROL3I6WKtcr5K-Z7B1yU 
 7
 8Body:
 9{
10  "type": "buy_btn",
11  "traits":{
12    },
13  "properties":{
14    "pkg_type":"bronze"
15    },
16  "context": {
17    "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"
18  }
19}
応対コード説明
204イベントが追加されました
400イベントが無効です
401トークンが無効です

イベントを初期化する

そのためにはまずトークンを入手する必要があります。

Copy
Full screen
Small screen
1xnt("init", YOUR_TOKEN);

イベントを送信する

Copy
Full screen
Small screen
1xnt("sendEvent", EVENT_TYPE, EVENT_PROPERTIES);
パラメータ説明
EVENT_TYPEイベント名(ストリング)。例landing_visit
EVENT_PROPERTIESイベント特性(JSオブジェクト)。
Copy
Full screen
Small screen
1xnt("sendEvent", "landing_visit");
2xnt("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パラメータで補完するには、以下の方法を使って下さい:
Copy
Full screen
Small screen
1xnt("putContext", CONTEXT_OBJECT);
2xnt("putTraits", TRAITS_OBJECT);
パラメータ説明
CONTEXT_OBJECTイベント環境(JSオブジェクト)。
TRAITS_OBJECTユーザーデータ(JSオブジェクト)。
お知らせ
コンテキストのuserAgentuserLocaleは自動的に追加されます。これら2つの方法で追加されたデータは、イベントデータと組み合わせられます。

スクリプトを実装する

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

Copy
Full screen
Small screen
1<script>
2(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');
3xnt("init", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJsaW5rIjoiaHR0cHM6Ly93d3cueW91dHViZS5jb20vd2F0Y2g_ dj1kUXc0dzlXZ1hjUSJ9.aVigY6UVY3jgoEKoBv31cZnROL3I6WKtcr5K-Z7B1du");
4xnt("sendEvent", "buy_btn", { pkg_type : "gold" });
5</script>
この記事は役に立ちましたか?
ありがとうございます!
改善できることはありますか? メッセージ
申し訳ありません
この記事が参考にならなかった理由を説明してください。 メッセージ
ご意見ありがとうございました!
あなたのメッセージを確認し、体験を向上させるために利用させていただきます。
最終更新日: 2025年7月9日

誤字脱字などのテキストエラーを見つけましたか? テキストを選択し、Ctrl+Enterを押します。

問題を報告する
当社は常にコンテンツを見直しています。お客様のご意見は改善に役立ちます。
フォローアップ用のメールをご提供してください
ご意見ありがとうございました!
フィードバックを送信できませんでした
後でもう一度お試しいただくか、doc_feedback@xsolla.comまでお問い合わせください。