首页 > 用户手册 > 开发者文档 > 集成php SDK

集成php SDK

1.集成SDK的准备工作

1.1获取AppKey

集成GeekDataSDK之前，您首先需要到GeekData官网(https://www.geekdata.com)注册并且添加新应用，获得Appkey。

1.2 下载相关lib

点击下载SDK

2.PHP SDK安装

2.1 解压sdk包,获得GdService.php文件，将该文件集成进自己的项目当中。

2.2 使用PHP SDK, 请参考随包附带的demo.php。

创建array 传入需要统计的key和value

$a = array(
    'appKey'=>'aabbccddeeff1122',
    'appChannel'=>'channelId',
    'sessionId'=>'101',
    'visitType'=>'1',
    'eventType'=>'click',
        .
        .
        .
    'utm'=>'');

postEvent($a,"8.8.8.8",4);

您可以随时通过以下方法进行key value 的替换和删除

$a['utm'] = 'abc'; 
unset($a['utm']);

以下为详细的key value 对照表

firstPartyCookie = "";//geekdataid 必须是16位字符串，建议使用16位md5码        
sessionId = "";//会话id
eventType = "";//事件类型
currentUrl = "";//当前页面（当前页面url）
onlineTimes = "";//页面停留时间 （单位毫秒 如 29088）
visitorType = "";//1-新用户，0-老用户
appChannel = "";//渠道id（如 baidu，yingyongbao）
deviceType = "";//设备类型 （如 Phone，Tablet）
deviceName = "";//设备型号名称（如 小米 红米4）
deviceBrand = "";//设备厂商 （小米）
appVersion = "";//app 版本（如 v1.0.1）
ua = "";//ua信息
resolution = "";//屏幕分辨率 （如1920x1080）
networkType = "";//网络类型（1：2g，2：3g，3：4g，4：wifi，5：未知）
cookiePlugin = "";//是否支持cookie（1：支持，0：不支持）
directorPlugin = "";//是否支持director插件（1：支持，0：不支持）
flashPlugin = "";//是否支持flash插件（1：支持，0：不支持）
gearsPlugin = "";//是否支持gears插件（1：支持，0：不支持）
javaPlugin = "";//是否支持javaPlugin插件（1：支持，0：不支持）
pdfPlugin = "";//是否支持pdfPlugin插件（1：支持，0：不支持）
quicktimePlugin = "";//是否支持quicktimePlugin插件（1：支持，0：不支持）
realplayerPlugin = "";//是否支持realplayerPlugin插件（1：支持，0：不支持）
silverlightPlugin = "";//是否支持silverlightPlugin插件（1：支持，0：不支持）
windowsmediaPlugin = "";//是否支持windowsmediaPlugin插件（1：支持，0：不支持）
loadTime = "";//页面加载时间
longitude = "";//经度（如 127.386848）
latitude = "";//纬度（如 49.159826）
frequency = "";//session浏览次数（如 1，2）
browserEngine = "";//浏览器引擎
browserName = "";//浏览器名称
browserVersion = "";//浏览器版本
registerTime = "";//注册时间
registerRegion = "";//注册地点
innerReferUrl = "";//站内跳转的refer_url
firstReferUrl = "";//最早一次referurl
firstAccessTime = "";//    首次访问时间（如 2017-08-17）
utm = "";//utm信息

事件发送：

postEvent($a,"8.8.8.8",4)

第一个参数：为事件的所有统计信息的array

第二个参数：为客户端ip，用于统计客户端位置信息

第三个参数：tp为平台参数，用来区分平台（ 1-WEB,2-H5,3-IOS,4-ANDROID,5-WEIXIN）

3.自定义事件统计

3.1 自定义事件id获得：

使用自定义事件功能请先登录GeekData官网(https://www.geekdata.com)， “自定义设置->自定义事件” 页面中添加相应的事件id，然后服务器才会对相应的事件请求进行处理。

例：

$a = array(
    'appKey'=>'aabbccddeeff1122',
    'appChannel'=>'channelId',
    'sessionId'=>'101',
    'visitType'=>'1',
    'eventType'=>'yyq',
        .
        .
        .
    'm_Q1'=>'1',
    'm_Q2'=>'2',
    'm_Q3'=>'3',
    'utm'=>'');

    postEvent($a,"8.8.8.8",4);

特别提醒：value 为自定义内容，根据统计需求填写，values 是用来做运算的，一定要设定为数字。例如您的事件属性是“点击次数” 那么您的value 就应该传 “1”，如果您传的是“2” 在统计事件点击次数时我们会根据value做sum，导致最终统计出的数据是真实数据的2倍。例如您的事件属性定义为“商品价格” 你的商品价格可能是 1元，3元，10.1元，那么value 应该传 1，3，10.1

3.2 事件统计结果可在GeekData后台查看。

4.自定义属性统计

4.1 自定义属性id获得：

使用自定义属性功能请先登录GeekData官网（www.geekdata.com）， “自定义设置->自定义属性” 页面中添加相应的事件id，然后服务器才会对相应的事件请求进行处理。

例：

$a = array(
    'appKey'=>'aabbccddeeff1122',
    'appChannel'=>'channelId',
    'sessionId'=>'101',
    'visitType'=>'1',
    'eventType'=>'click',
        .
        .
        .
    'attributeId1'=>'100',
    'attributeId2'=>'101',
    'attributeId3'=>'102',
    'utm'=>'');

    postEvent($a,"8.8.8.8",4);

属性被定义以后所有的事件都会带上相关属性，当属性值发生改变时请重新设置属性值。

5.绑定用户信息

例：

$a = array(
    'appKey'=>'aabbccddeeff1122',
    'appChannel'=>'channelId',
    'sessionId'=>'101',
    'visitType'=>'1',
    'eventType'=>'click',
        .
        .
        .
    'userId'=>'123456',
    'userRegisterUrl'=>'geekdata',
    'userGender'=>'男',
    'userAge'=>'25',
    'userType'=>'管理',
    'userLevel'=>'5级',
    'userProvince'=>'天津',
    'userCity'=>'东丽区',
        .
        .
        .
    'utm'=>'');

    postEvent($a,"8.8.8.8",4);

6.技术支持

发现问题可联系我公司客服或技术人员进行解答。

3.2. 安装php SDK