入门与指南专题介绍帐号管理营销资产广告管理数据洞察人群管理数据接入接口清单附录

获取广告的点击数据

当您投放的广告产生点击时,您可以获取点击中所包含的信息,包括:点击发生的时间、点击id、发生点击的广告所属的账户id、广告推广的应用id、发生点击的用户设备id。

您可以按照以下步骤获取如上数据:

1、在投放端填写应用信息和feedbackURL

登录 腾讯社交广告官网 → 投放管理平台 → 左侧工具箱 → 转化跟踪  → 移动应用转化跟踪页面

点击:“获取点击数据”

如您需要获取账户内某个APP对应的广告产生的点击数据,则选择对应的移动平台,并填写应用ID和feedbackURL。

2、接收点击接口( Feedback URL )介绍

  • 接收点击接口用于腾讯社交广告将用户的点击行为信息发送给广告主,主要由广告主自定义的 Feedback URL 和 腾讯社交广告拼接的参数 共同构成。
  • 实现此接口需要广告主提供广告主自定义的feedback url,腾讯社交广告按照规则拼接参数后调用接收点击接口
  • 广告主利用Feedback URL接收点击数据,并返回正确的返回值后,腾讯社交广告即认为此次点击转发成功。
  • 腾讯社交广告在转发点击时,不会对点击的有效性进行进行过滤,因此一般情况下,腾讯社交广告投放端显示的点击(有效点击)可能低于实际转发的点击数。

 3、Feedback URL 介绍

Feedback URL 是由广告主自定义的用于腾讯社交广告将点击数据传输给广告主的实现连接。
广告主在腾讯社交广告投放端(e.qq.com)创建转化时,需要输入Feedback URL。

Feedback URL 要求:

    • 可以有参数,但不能包含符号:#
    • 不要占用如下参数:muid, click_time, click_id, app_type, appid,advertiser_id
    • 可以用https
    • 不能直接用ip,必须是正式的域名

示例如下:

http://www.example.com/gdt.cgi

        备注:正确(√)

http://www.example.com/gdt.cgi?source=gdt

        备注:可以添加参数(√)

https://www.example.com/gdt.cgi?muid=xxxxx&click_time=1406276499&appid=00000&click_id=00000&app_type=android&advertiser_id=0000

      备注:不能用特定的参数名称(×)

4、接收点击接口格式( Feedback URL )介绍

  • 请求方:腾讯社交广告点击后台
  • 处理方:广告主后台
  • 请求协议:http
  • 请求方式:GET
feedback URL:
http://www.example.com/gdt.cgi
接收点击接口示例:
 http://www.example.com/gdt.cgi?muid={muid}&click_time={click_time}&appid={appid}&click_id={click_id}&app_type={app_type}&advertiser_id={advertiser_id} 
实例如下:
Android应用:
http://www.example.com/gdt.cgi?muid=40c7084b4845eebce9d07b8a18a055fc&click_time=1406276499&appid=000000&click_id=007210548a030059ccdfd1d4&app_type=android&advertiser_id=20000
iOS应用:
http://www.example.com/gdt.cgi?muid=40c7084b4845eebce9d07b8a18a055fc&click_time=1406276499&appid=000000&click_id=007210548a030059ccdfd1d4&app_type=ios&advertiser_id=20000

5、接受点击接口参数介绍

名称 类型 描述
muid string 设备id,由IMEI(Android应用)md5生成,或是由IDFA(iOS应用)md5生成;
具体加密方案见表格下详细说明
click_time string 点击发生的时间,由腾讯社交广告系统生成,取值为标准时间戳,秒级别
click_id string 腾讯社交广告后台生成的点击id,腾讯社交广告系统中标识用户每次点击生成的唯一标识
appid int Android应用为应用宝移动应用的id,或者iOS应用在Apple App Store的id;创建转化时,需填入此appid
advertiser_id int 广告主在腾讯社交广告(e.qq.com)的账户id
app_type string app类型;取值为 android或ios(联盟Android为unionandroid);注意是小写;根据广告主在腾讯社交广告(e.qq.com)创建转化时提交的基本信息关联;
android_id string 由android_idmd5生成,当设备id获取不到或匹配不上时,可以用于作为归因补充;
mac string 由mac地址去掉":" 大写后MD5生成,当设备id获取不到或匹配不上时,可以用于作为归因补充;
ip string IP地址,不加密,当设备号获取不到或匹配不上时,可以用于作为归因补充;
user_agent string urlencode,当设备号获取不到或匹配不上时,可以用于作为归因补充;
muid加密方案:muid:设备id,由 IMEI(Android 应用)、IDFA(iOS 应用)md5生成。 具体加密方案如下:
  • Android 设备-muid 加密规则:IMEI 号需转小写,进行 md5 以后得到的 32位全小写md5 表现字符串。
  • iOS 设备-muid 加密规则:IDFA 码需转大写,进行 md5 以后得到的 32位全小写md5 表现字符串。
muid加密代码示例(C++):

bool GenerateMuid(const std::string& uni_id, const int32_t app_type, std::string* muid) 
{ 
    if (muid == NULL || uni_id.empty()) { 
        return false; 
    } 
    muid->clear(); 
    std::string tmp;  
    if (app_type == kAppTypeAndoirdImei) {
        LatinToLower(uni_id, &tmp); 
    }  
    else if (app_type == kAppTypeiOSIfa) { 
        LatinToUpper(uni_id, &tmp); 
    }  
    else { 
        return false; 
    }
    md5sum32l(tmp, muid);    // 32bit lower 
    return true; 
}

Android 设备号加密测试用例:

    • 原始 IMEI 号:354649050046412
    • 加密之后:b496ec1169770ea274a2b4f42ca4fb71

iOS 设备号加密测试用例:

    • 原始 IDFA 码:1E2DFA89-496A-47FD-9941-DF1FC4E6484A
    • 加密之后:40c7084b4845eebce9d07b8a18a055fc

6、接收点击接口响应信息

响应格式:Json数据格式

响应内容:{"ret": 返回码, "msg": "错误提示"}

返回码:返回码为0标识正常接收,其他返回码标识错误

注意:返回值必须有『ret』,且参数值必须为0;否则视为不成功;返回值不能包含『302』

返回值中的『错误信息』如果是中文,必须使用UTF-8字符集,不能使用GBK等其他字符集