目录
此内容是否有帮助?

# PHP

提示

在接入前, 请先阅读接入前准备

您可以在 GitHub (opens new window) 获取 PHP SDK 源码。

最新版本:2.2.1

更新时间:2023-04-11

资源下载:源代码 (opens new window)

# 一、集成SDK

  1. 使用 composer 集成
{
    "require": {
        "thinkinggame/ta-php-sdk": "v2.2.1"
    }
}
  1. 您也可以从GitHub (opens new window)中获取 SDK 的源码,并集成到您的项目中。只需要将 TaPhpSdk.php 放到你项目所在的目录即可。本 SDK 兼容 PHP >5.5,部分功能依赖 curl 扩展。
  2. 安装Logbus

我们推荐使用SDK+LogBus的形式,完成服务端数据的采集上报.您可以参考以下文档完成Logbus的安装:LogBus使用指南

# 二、初始化

以下是SDK初始化的示例代码:

require_once "vendor/autoload.php";

use Exception;
use ThinkingEngine\ThinkingDataAnalytics;
use ThinkingEngine\FileConsumer;
use ThinkingEngine\TALogger;
use ThinkingEngine\DebugConsumer;
use ThinkingEngine\BatchConsumer;
use ThinkingEngine\ThinkingDataException;

$consumer = new FileConsumer("LOG_DIRECTORY", 200, true, "te");
TALogger::$enable = false;
$teSDK = ThinkingDataAnalytics($consumer, true);

LOG_DIRECTORY为写入本地的文件夹地址。您只需将 LogBus 的监听文件夹地址设置为此处的地址,即可使用 LogBus 进行数据的监听上传。

# 三、常用功能

为了保证访客 ID 与账号 ID 能够顺利进行绑定,如果您的游戏中会用到访客 ID 与账号 ID,我们极力建议您同时上传这两个 ID,否则将会出现账号无法匹配的情况,导致用户重复计算,具体的 ID 绑定规则可参考用户识别规则一章。

# 3.1 发送事件

您可以调用track来上传事件,建议您根据先前梳理的文档来设置事件的属性以及发送信息的条件,以下是发送事件的示例代码:

$account_id = 2121;
$distinct_id = 'SJ232d233243';
$properties = array();
$properties['age'] = 20;
$properties['Product_Name'] = 'c';
$properties['update_time'] = date('Y-m-d H:i:s', time());
$json = array();
$json['a'] = "a";
$json['b'] = "b";
$jsonArray = array();
$jsonArray[0] = $json;
$jsonArray[1] = $json;
$properties['json'] = $json;
$properties['jsonArray'] = $jsonArray;

try {
    $teSDK->track($distinct_id, $account_id, "viewPage", $properties);
} catch (Exception $e) {
    echo $e;
}
  • 事件的名称是字符串类型,只能以字母开头,可包含数字,字母和下划线 "_",长度最大为 50 个字符。
  • Key 为该属性的名称,为字符串类型,规定只能以字母开头,包含数字,字母和下划线 "_",长度最大为 50 个字符,对字母大小写不敏感,TE会统一转化为小写字母
  • Value 为该属性的值,支持字符串、数字、布尔、时间、对象、对象组、数组

用户属性的要求与事件属性保持一致

# 3.2 设置用户属性

对于一般的用户属性,您可以调用 user_set 来进行设置,使用该接口上传的属性将会覆盖原有的属性值,如果之前不存在该用户属性,则会新建该用户属性,类型与传入属性的类型一致,此处以设置用户名为例:

$properties = array();
$properties['once_key'] = 'twice';
$properties['age'] = 10;
$properties['money'] = 300;
$properties['array1'] = ['str1', 'str2'];
try {
    $teSDK->user_set($distinct_id, $account_id, $properties);
} catch (Exception $e) {
    //handle except
    echo $e;
}

# 四、最佳实践

以下示例代码包含以上所有操作,我们推荐按照如下步骤使用:

require_once "vendor/autoload.php";

use Exception;
use ThinkingEngine\ThinkingDataAnalytics;
use ThinkingEngine\FileConsumer;
use ThinkingEngine\TALogger;
use ThinkingEngine\DebugConsumer;
use ThinkingEngine\BatchConsumer;
use ThinkingEngine\ThinkingDataException;

$consumer = new FileConsumer("LOG_DIRECTORY", 200, true, "te");
TALogger::$enable = false;
$teSDK = ThinkingDataAnalytics($consumer, true);

$account_id = 2121;
$distinct_id = 'SJ232d233243';
$properties = array();
$properties['age'] = 20;
$properties['Product_Name'] = 'c';
$properties['update_time'] = date('Y-m-d H:i:s', time());
$json = array();
$json['a'] = "a";
$json['b'] = "b";
$jsonArray = array();
$jsonArray[0] = $json;
$jsonArray[1] = $json;
$properties['json'] = $json;
$properties['jsonArray'] = $jsonArray;

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

$properties = array();
$properties['once_key'] = 'twice';
$properties['age'] = 10;
$properties['money'] = 300;
$properties['array1'] = ['str1', 'str2'];
try {
    $teSDK->user_set($distinct_id, $account_id, $properties);
} catch (Exception $e) {
    //handle except
    echo $e;
}

$teSDK->flush();

#