教育行业一方深度数据合作

目前，腾讯广告与一些客户实现了深度数据合作。客户将自己的深度用户行为/属性数据提供给腾讯广告，腾讯广告利用客户提供的一方深度数据，结合腾讯的二方数据能力和策略算法能力，为客户点对点，进行私有化优化召回、粗排、精排、出价等模型，实现业务更深层目标优化，提升ROI。如果您有丰富的深度用户转化/属性数据，期望与腾讯广告进行合作来持续优化广告深层效果和ROI，可联系您的接口运营进行咨询。

一、 数据上传相关介绍文档

DMP官网中给出了数据回传相关概念、步骤、功能的详细介绍，您可以查看此文档来了解相关能力：
https://dmp.tencent.com/helpcenter/detail?catalogId=739&postId=2997

二、深度合作数据上传介绍

1、 数据字段含义

不管您选择API、SDK还是JS方式上传深度合作数据。有一些基础字段都是我们期望您尽可能全面提供的：

• 用户ID（user_id）：如手机号、设备号、微信openID等。这些字段用来标识一个用户。如果您在一条行为/属性里，同时拿到了用户的多个ID，可以多个ID均回传给腾讯广告，以减少ID映射带来的折损。
• 行为类型（action_type）：如激活、下单等。这个字段用来定义一条行为数据的具体行为。腾讯广告有定义一些全行业通用的行为作为标准行为类型。同时也提供了为自定义行为（action_type=CUSTOM）的选项，可以提供给各行业深度数据上传时使用。使用自定义行为时，需要依照行业上传规范，来填写custom_action。否则无法被识别。
• 行为时间（action_time）：结合行为类型和用户id。行为时间是用来标识该条行为发生的时间。对于策略来说十分重要。如果需要传的是属性而不是行为（如custom_action为“家长人群”）。则action_time填为1。
• 渠道信息（channel）：渠道指行为（转化）发生渠道。通俗来讲，是指该条转化是由用户自然转化的，还是通过在腾讯、字节跳动、阿里巴巴等渠道中买量获得的。渠道信息可以给策略团队提供重要的特征支持。对于腾讯渠道转化，腾讯广告可以根据用户的全链路转化做关联；对于非腾讯渠道转化，腾讯广告中可能对该部分用户的探索不足够，可以做曝光的扶持。
• 行为参数（action_param）：行为参数是一个十分自由的字段，可以支持非常自由的回传各类字段。各行业规范的特殊字段基本都在行为参数中定义。
  

  2、字段回传格式

  注意：
  1）激活和有效线索不回传在custom_action内，直接根据现有字段回传，具体为：
  — 确认有效线索：action_type = CONFIRM_EFFECTIVE_LEADS
  — 激活应用：action_type = ACTIVATE_APP
  2）广告主可通过离线/API两种方式回传，推荐API持续回传的方式，便于数据连续性使用和人群包更新；
  3）可接受的最小数据量级：正价课10W+，正价课之上的链路按比例递增。推荐回传腾讯渠道正价课全量数据，并包含clickID，以便于准确评估低价课转正价课的比例。（如数据量不足，可联系运营对接人，进行沟通协调评估）
  4）回传数据中的商品类目，和创建的商品广告类目一致，详情可咨询对运营对接人。
  5）API接口文档请见：https://developers.e.qq.com/docs/api/user_data/user_action/user_actions_add?version=1.1

若查阅不便，请直接阅读：https://docs.qq.com/doc/DV2JNR2pEeXJhZE9F

三、数据上报代码示例

以"低价课转化（含扩科）"为例，数据上报示例如下。
教育行业深度数据合作-代码示例

curl 'https://api.e.qq.com/v1.3/user_actions/add?access_token=<ACCESS_TOKEN>&timestamp=<TIMESTAMP>&nonce=<NONCE>' \
-H 'Content-Type: application/json' \
-d '{
    "account_id": "<ACCOUNT_ID>",
    "user_action_set_id": 1111111111,
    "actions": [
        {
            "external_action_id": "external_action_identity",
            "action_time": 1606099210,
            "user_id": {
                "hash_imei": "f9efca36a3c30e1cf28170d86ecbf5e9"
            },
            "action_type": "CUSTOM",
            "custom_action": "low_price_conversion", 
            "action_param": {
                "industry":"EDUCATION",
                "nick_name":"tencent",
                "course_1":"course1",
                "course_2":"course2",
                "price_1":"10",
                "price_2":"20",
                "age":20
            },
            "channel":"TENCENT"
        }
    ]
}'

四、常见Q&A

1、回传数据时，用mkt api是做实时回传还是可以攒一波数据回传？
A：回传数据时需要带时间戳，实时或攒一波都可以。但建议尽量天更，最晚周更。

2、更新数据的话，每次更新全量数据，还是有变化的数据？
A：有变化的即可。

3、回传腾讯系数据时，是否可只回传clickid，userid就不传了？
A：建议clickid和userid都回传。因为只做clickid回传，无法验证腾讯系内对用户信息匹配是否正确。
同时注意：userid选1个就行。如只回传imei或只回传手机号。无需同1人多个设备号。（建议对同一类型的userid做去重）

4、回传数据后，上报通路如何验证已通？
A：数据回传完成后，腾讯系会有技术入群人工做确认沟通。

5、当一个用户买了2个课程。是要在1个clickid下写2个course还是写成2个clickid？
A：1个clickid下写2个course。

6、用户信息在md5加密后 是不是要加盐处理下？
A：不需要

7、如何判断当前接口的调用频次是否够用？
A：1次上报，50个行为。假设接口频次为1000次/分钟，则每分钟可以上报1000*50 = 50000 个行为。假设每天有100w条行为数据需要批量回传，则1000次/分钟的接口频次即可保证在20分钟内全部传输完毕。

8、timestamp与action time的区别？
A：timestamp是接口的全局参数，可以参考接口文档，指的是当前时间戳，单位为秒；
action time是用户发生行为的时间，unix时间，单位为秒（这个是我们关注的，需要回传 准确的行为发生时间，到天维度即可）