C SDK 使用样例
最后更新于:2018-08-02 11:01:50
下面,是针对一个典型的电商产品,在后台服务端,使用神策分析 C SDK 采集数据的样例
样例主要展示数据的记录能力,使用者需要根据自己的需求和具体的产品形态,来设计相应的事件和属性。
/*
* Copyright (C) 2015 SensorsData
* All rights reserved.
*/
#include <assert.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
#include <time.h>
#include "sensors_analytics.h"
int main(int args, char** argv) {
(void)(args);
(void)(argv);
SALoggingConsumer* consumer = NULL;
if (SA_OK != sa_init_logging_consumer("./demo.out", &consumer)) {
fprintf(stderr, "Failed to initialize the consumer.");
return 1;
}
SensorsAnalytics *sa = NULL;
if (SA_OK != sa_init(consumer, &sa)) {
fprintf(stderr, "Failed to initialize the SDK.");
return 1;
}
SAProperties* properties = NULL;
// 在这个 Demo 中,我们以一个典型的电商产品为例,描述一个用户从匿名访问网站,到下单购买商品,再到申请售后服务,
// 这样一个整个环节,使用神策分析(以下简称 SA)的产品,应该如何记录日志。
// 特别需要注意的是,这个 Demo 只是描述 SA 的数据记录能力,并不是说使用者要完全照搬这些 Event 和 Property
// 的设计,使用者还是需要结合自己产品的实际需要,来做相应的设计和规划
// 1. 用户匿名访问网站
const char* cookie_id = "ABCDEF123456789"; // 用户未登录时,可以使用产品自己生成的cookieId来标注用户
// 1.1 访问首页
// 前面有$开头的property字段,是SA提供给用户的预置字段
// 对于预置字段,已经确定好了字段类型和字段的显示名
{
properties = sa_init_properties();
if (NULL == properties) {
fprintf(stderr, "Failed to initialize the properties.");
return 1;
}
// 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
assert(SA_OK == sa_add_string("$os", "iOS", strlen("iOS"), properties));
// 操作系统的具体版本
assert(SA_OK == sa_add_string("$os_version", "10.0.0", strlen("10.0.0"), properties));
// 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
assert(SA_OK == sa_add_string("$ip", "123.123.123.123", strlen("123.123.123.123"), properties));
// 是否首次访问
assert(SA_OK == sa_add_bool("is_first_time", SA_FALSE, properties));
// 记录访问首页事件
assert(SA_OK == sa_track(cookie_id, "ViewHomePage", properties, sa));
sa_free_properties(properties);
}
// 1.2 记录用户首次登陆时间
{
properties = sa_init_properties();
if (NULL == properties) {
fprintf(stderr, "Failed to initialize the properties.");
return 1;
}
// 用户首次使用时间
assert(SA_OK == sa_add_date("first_time", time(NULL), 0, properties));
// 记录用户属性
assert(SA_OK == sa_profile_set_once(cookie_id, properties, sa));
sa_free_properties(properties);
}
// 1.3 搜索商品
{
properties = sa_init_properties();
if (NULL == properties) {
fprintf(stderr, "Failed to initialize the properties.");
return 1;
}
// 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
assert(SA_OK == sa_add_string("$os", "iOS", strlen("iOS"), properties));
// 操作系统的具体版本
assert(SA_OK == sa_add_string("$os_version", "10.0.0", strlen("10.0.0"), properties));
// 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
assert(SA_OK == sa_add_string("$ip", "123.123.123.123", strlen("123.123.123.123"), properties));
// 搜索引擎引流过来时使用的关键词
assert(SA_OK == sa_add_string("key_word", "XX手机", 8, properties));
// 记录搜索商品事件
assert(SA_OK == sa_track(cookie_id, "SearchProduct", properties, sa));
sa_free_properties(properties);
}
// 1.4 浏览商品
{
properties = sa_init_properties();
if (NULL == properties) {
fprintf(stderr, "Failed to initialize the properties.");
return 1;
}
// 通过请求中的UA,可以解析出用户使用设备的操作系统是windows的
assert(SA_OK == sa_add_string("$os", "iOS", strlen("iOS"), properties));
// 操作系统的具体版本
assert(SA_OK == sa_add_string("$os_version", "10.0.0", strlen("10.0.0"), properties));
// 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
assert(SA_OK == sa_add_string("$ip", "123.123.123.123", strlen("123.123.123.123"), properties));
// 商品名称
assert(SA_OK == sa_add_string("product_name", "XX手机", 8, properties));
// 商品Tag
assert(SA_OK == sa_append_list("product_tag", "大屏", 6, properties));
assert(SA_OK == sa_append_list("product_tag", "双卡双待", 12, properties));
// 商品价格
assert(SA_OK == sa_add_number("product_price", 5888, properties));
// 记录搜索商品事件
assert(SA_OK == sa_track(cookie_id, "ViewProduct", properties, sa));
sa_free_properties(properties);
}
// 2. 用户注册,注册后的注册 ID
const char* login_id = "123456";
// 2.1 通过,track_signup,把匿名ID和注册ID关联起来
{
properties = sa_init_properties();
if (NULL == properties) {
fprintf(stderr, "Failed to initialize the properties.");
return 1;
}
// 用户的注册渠道
assert(SA_OK == sa_add_string("register", "Baidu", 5, properties));
// 关联注册用户与匿名用户
assert(SA_OK == sa_track_signup(login_id, cookie_id, properties, sa));
sa_free_properties(properties);
}
// 2.2 用户注册时,填充了一些个人信息,可以用Profile接口记录下来
{
properties = sa_init_properties();
if (NULL == properties) {
fprintf(stderr, "Failed to initialize the properties.");
return 1;
}
// 用户的注册渠道
assert(SA_OK == sa_add_string("register", "Baidu", 5, properties));
// 用户注册日期
assert(SA_OK == sa_add_date("$signup_time", time(NULL), 0, properties));
// 用户是否购买过商品
assert(SA_OK == sa_add_bool("is_vip", SA_FALSE, properties));
// 设置用户属性
assert(SA_OK == sa_profile_set(login_id, properties, sa));
sa_free_properties(properties);
}
// 3. 用户提交订单
// 3.1 记录用户提交订单事件
{
properties = sa_init_properties();
if (NULL == properties) {
fprintf(stderr, "Failed to initialize the properties.");
return 1;
}
// 通过请求中的UA,可以解析出用户使用设备的操作系统是 iOS 的
assert(SA_OK == sa_add_string("$os", "iOS", strlen("iOS"), properties));
// 操作系统的具体版本
assert(SA_OK == sa_add_string("$os_version", "10.0.0", strlen("10.0.0"), properties));
// 请求中能够拿到用户的IP,则把这个传递给SA,SA会自动根据这个解析省份、城市
assert(SA_OK == sa_add_string("$ip", "123.123.123.123", strlen("123.123.123.123"), properties));
// 商品名称
assert(SA_OK == sa_add_string("product_name", "XX手机", 8, properties));
// 商品价格
assert(SA_OK == sa_add_number("product_price", 5888, properties));
// 记录购买商品事件
assert(SA_OK == sa_track(cookie_id, "SubmitOrder", properties, sa));
sa_free_properties(properties);
}
// 3.2 在用户属性中记录用户支付金额
{
properties = sa_init_properties();
if (NULL == properties) {
fprintf(stderr, "Failed to initialize the properties.");
return 1;
}
// 累加用户支付金额
assert(SA_OK == sa_add_number("pay", 5888, properties));
// 用户获得头衔
assert(SA_OK == sa_append_list("title", "VIP", 3, properties));
// 记录搜索商品事件
assert(SA_OK == sa_profile_increment(login_id, properties, sa));
sa_free_properties(properties);
}
// 3.3 在用户属性中增加用户头衔
{
properties = sa_init_properties();
if (NULL == properties) {
fprintf(stderr, "Failed to initialize the properties.");
return 1;
}
// 用户获得头衔
assert(SA_OK == sa_append_list("title", "VIP", 3, properties));
// 记录搜索商品事件
assert(SA_OK == sa_profile_append(login_id, properties, sa));
sa_free_properties(properties);
}
// 4. 其他
// 4.1 删除用户某个属性
{
assert(SA_OK == sa_profile_unset(login_id, "title", sa));
}
// 4.2 删除某个用户的所有属性
{
assert(SA_OK == sa_profile_delete(login_id, sa));
}
// 4.3 不合法的事件名称
{
assert(SA_INVALID_PARAMETER_ERROR == sa_track(login_id, "time", NULL, sa));
assert(SA_INVALID_PARAMETER_ERROR == sa_track(login_id, "100vip", NULL, sa));
}
sa_flush(sa);
sa_free(sa);
return 0;
}