目录
此内容是否有帮助?

# PHP

最新バージョン：2.1.1

更新日付：2022-11-10

ダウンロード：Source Code (opens new window)

# SDK実装

  1. composerを利用して実装します
{
    "require": {
        "thinkinggame/ta-php-sdk": "v2.1.1"
    }
}
  1. もしくはGitHub (opens new window)からSDKのソースコードを取得し、プロジェクトに実装できます。TaPhpSdk.phpを所在のプロジェクトのカタログに入れてください。本SDKはPHP >5.5に対応しており、一部の機能はcurl拡張を依頼します。
  2. Logbusをインストール

TEシステムにより迅速かつ正確なデータを転送するために、SDK＋LogBusの併用でサーバデータのデータレポートを推奨しております。

# 初期設定

以下はSDKの初期設定のフォーマットコードとなります：

require "TaPhpSdk.php";
$te = new ThinkingDataAnalytics(new FileConsumer(LOG_DIRECTORY));

LOG_DIRECTORYはローカルアクセスファイルのアドレスとなります。LogBusのモニターアドレスをこのアドレスに設定すれば自動でアップロードされます。

# メイン機能

ゲストIDとアカウントIDをうまく紐付けるために、もしゲーム内でゲストIDとアカウントID両方を使われる場合は、それらのIDを同時にアップロードするのを推奨しております。同時にアップロードしない場合は、ユーザーを重複にカウントされてしまう可能性があります。

# 3.1 イベント送信

trackを利用してイベントの送信を行います。事前にデータプランをご用意の上、送信してください。以下はモデルコードとなります。

$account_id = "ABC12345";
$distinct_id = "SDIF21dEJWsI232IdSJ232d2332";

$properties = array();

$properties["#time"] = date("Y-m-d H:i:s",time());

$properties["#ip"] = "123.123.123.123";

$properties["Product_Name"] ="Shoes";
$properties["Price"] = 30;
$properties["OrderId"] ="abc_123";

try{
  $te->track($distinct_id,$account_id,"Payment",$properties);
}catch (Exception $e){
    echo $e;
}
  • イベント名称はstringタイプで、英文字と数字、 "_"を含め、最大50文字
  • Key は当プロパティの名称でstringタイプで、英文字と数字、 "_"を含め、最大50文字。TEシステムは一律で小英文字に統一されます
  • Value は当プロパティの値で、String, Number, Bloon, Time, object, array, list objectを対応しております。

ユーザープロパティはイベントプロパティと一致する必要があります

# 3.2 ユーザープロパティを設定

一般のユーザープロパティに関しては、user_setを利用して設定することができますが、 UserSetは元の値を上書きされます。本来該当プロパティに値がない場合は、プロパティが新規作成されます。以下はコード例となります。

$properties = array();

$properties["user_name"] = "TA";
try{
  $te->user_set($distinct_id,$account_id,$properties);
}catch (Exception $e){
    echo $e;
}

$properties["user_name"] = "TE";
try{
  $te->user_set($distinct_id,$account_id,$properties);
}catch (Exception $e){
    echo $e;
}

# コード例のまとめ

以下のコード例で全ての操作が含まれます、以下の順で利用推奨しております。

require "TaPhpSdk.php";
$te = new ThinkingDataAnalytics(new FileConsumer(LOG_DIRECTORY));

$account_id = "ABC12345";

$distinct_id = "SDIF21dEJWsI232IdSJ232d2332";

$properties = array();

$properties["#time"] = date("Y-m-d H:i:s",time());

$properties["#ip"] = "123.123.123.123";

$properties["Product_Name"] ="Shoes";
$properties["Price"] = 30;
$properties["OrderId"] ="abc_123";

try{
  $te->track($distinct_id,$account_id,"Payment",$properties);
}catch (Exception $e){
    echo $e;
}

$user_properties = array();

$user_properties["user_name"] = "ABC";
try{
  $te->user_set($distinct_id,$account_id,$user_properties);
}catch (Exception $e){
    echo $e;
}

$te->flush();