# 快手广告主数据
TIP
请注意，第三方数据集成产生的数据会被纳入集群的消耗数据量
# 概要
# 接口简介
| 接口名 | 类型 | 粒度 | 归因 | 成本 | 收益 | 展示 | 点击 | 转化 |
|---|---|---|---|---|---|---|---|---|
| 广告主数据 | API | 聚合指标 | ✅ | ✅ | ✅ | ✅ |
广告主数据 (opens new window)提供了广告主粒度的各类指标，包括广告的展示、点击、转化、买量成本以及大量其他指标。
# 集成流程
- 注册快手开发者账号，并创建应用
- 登录 TE 后台，进入三方集成模块，新增快手广告主数据方案，并完成相关配置
- 从 TE 后台获取授权回调地址，登录快手开放平台，在之前创建的应用填入该回调地址
- 在 TE 后台处打开授权地址完成授权
- 查看 TE 系统否成功接收数据，并完成报表搭建
# 一、获取授权所需信息
# 1.1 注册快手开发者账号
在调用快手 Marketing API 前，您需要准备一个快手开发者账号，首先您需要登录磁力引擎开放平台 (opens new window) 
接下来，点击「注册为开发者」：
填写联系人姓名等信息，完善联系人信息：
接着，您需要完善开发者资质，可以由公司法人 or 代理人注册申请，但是均需要申请人进行实名身份认证
您需要在开发者角色处选择「广告主」
# 1.2 创建应用
在完成快手开发者账号的注册后，接下来您需要在「应用管理」创建一个新应用
创建应用需要提供：
- 应用名称、应用图标、应用描述：可以自定义
- 回调地址：目前先使用 www.thinkingdata.cn，完成应用创建且 TE 平台方案创建完毕后需要再次调整
接下来您需要获取下图绿框与绿箭头标出的 APP ID 与 Secret
# 1.3 获取您需要授权账号的快手 ID
最后，您需要获取您需要拉取广告数据的快手账号的快手 ID，一般您可以在快手后台的右上角获取到：
# 二、方案配置
创建完应用后，接下来需要您登录 TE 系统后台，在「三方集成」模块中完成快手广告主数据方案的配置。下图是快手广告数据的配置界面：
# 2.1 授权信息配置
点击「授权信息」按钮，在弹出框内填写您在授权工作中获取到的信息
其中 APP ID、Secret、User ID 分别填入创建应用时获得的 APP ID、Secret 以及您需要授权账号的快手 ID
Advertiser ID List 则需要填写您想要拉取的广告账号 ID 的列表，您可以用 "," 号分割多个。如果不填写，TE 系统将获取您授权的所有广告账号的数据。如果填写，则 TE 系统只会获取您填写的广告账号的数据
# 2.2 定时拉取
您可以在「定时拉取」模块设置 TE 系统定时拉取快手广告主数据的策略，可以选择在每天的某时或者每小时拉取一段时间的数据。由于拉取的数据也会计算再数据量中，建议您在不要定时拉取太长时间的数据
# 2.3 事件表入库设置
打开「事件表入库设置」开关后，回传的数据都将写入到事件表中，我们建议您开启事件数据入库。 
# 2.4 集成配置
最后，您可以在集成配置模块对数据拉取的细节配置进行控制。包括数据的时间聚合粒度，以及入库后的事件名等。
集成配置中的内容是一个 JSON，您可以按照以下内容进行自定义配置：
| 模块 | 名称 | 含义 |
|---|---|---|
| sink_event | event_name | 入库后的事件名，可以自定义，字符串类型。接收到的数据均将以该名称作为事件名。 |
| source | time_granularity | 数据的时间聚合粒度，即拉取的数据以天还是小时进行聚合 可选值: DAILY ／ HOURLY |
| transfer | double_columns | 指标字段，请不要修改 |
广告主数据的指标包含了多种业态（比如网店、直播带货等）的指标数据，以下展示的是部分常用指标，如需了解完整的指标列表，可以查看【广告主数据】 (opens new window)文档。默认情况下，我们会入库所有数据
- 指标字段
| 指标 | 描述 |
|---|---|
| charge | 花费（元） |
| show | 封面曝光数 |
| photo_click | 封面点击数 |
| aclick | 素材曝光数 |
| bclick | 行为数 |
| photo_click_ratio | 封面点击率 |
| impression_1k_cost | 平均千次曝光花费（元） |
| photo_click_cost | 平均点击单价（元） |
| action_cost | 平均行为单价（元） |
| share | 分享数 |
| comment | 评论数 |
| like | 点赞数 |
| follow | 新增关注数 |
| cancel_follow | 取消关注数 |
| report | 举报数 |
| block | 拉黑数 |
| negative | 减少此类作品数 |
| download_started | 应用下载数据-安卓下载开始数 |
| download_completed | 应用下载数据-安卓下载完成数 |
| activation | 应用下载数据-激活数 |
| event_pay_first_day | 应用下载数据-首日付费次数 |
| event_pay_purchase_amount_first_day | 应用下载数据-首日付费金额 |
| event_pay_first_day_roi | 应用下载数据-首日 ROI |
| event_pay | 应用下载数据-付费次数 |
| event_pay_purchase_amount | 应用下载数据-付费金额 |
| event_pay_roi | 应用下载数据-ROI |
| event_register | 应用下载数据-注册数 |
| event_register_cost | 应用下载数据-注册成本 |
| event_register_ratio | 应用下载数据-注册率 |
| event_order_paid | 应用下载数据-付款成功数 |
| event_order_paid_purchase_amount | 应用下载数据-付款成功金额 |
| event_order_paid_cost | 应用下载数据-单次付款成本 |
| played_end | 播放完成 |
| played_three_seconds | 有效播放数 |
| click_1k_cost | 平均千次素材曝光花费(元) |
| event_button_click | 按钮点击数 |
| event_button_click_cost | 按钮点击成本：当日消耗 / 按钮点击数 |
| event_button_click_ratio | 按钮点击率：按钮点击数 / 行为数 |
| play_end_ratio | 完播率：按钮点击数 / 行为数 |
| event_watch_app_ad | 广告观看 |
| event_ad_watch_times | 广告观看次数 |
| event_ad_watch_times_ratio | 广告观看次数转化率 |
| event_ad_watch_times_cost | 广告观看次数成本 |
| ad_show | 广告曝光 |
| click_conversion_ratio | 点击激活成本 |
| conversion_cost | 激活单价 |
| download_completed_cost | 安卓下载完成单价（元） |
| download_completed_ratio | 安卓下载完成率 |
| download_conversion_ratio | 下载完成激活率 |
| download_started_cost | 安卓下载开始单价（元） |
| download_started_ratio | 安卓下载开始率 |
| conversion_num | 转化数（回传时间归因） |
| conversion_num_cost | 转化成本（回传时间归因） |
| conversion_ratio | 转化率（回传时间归因） |
| 维度 | 描述 |
|---|---|
| advertiser_id | 广告账号 ID |
# 2.5 事件入库规则
- 使用数据中的 stat_date 与 stat_hour 字段，即日期与小时的拼接值，作为数据的 #event_time
- 数据事件名为 -- kuaishou_ads_account_report
- 其余字段都将会入库
# 2.6 完成授权
完成配置后，您可以点击右上角的「保存并授权」将方案配置保存下来。接下来，您需要完成最后的授权工作：
首先，请在弹出的「授权信息」页面中，将第一步中的地址复制下来
其次，登录到磁力引擎开放平台，进入到之前创建的应用，将授权回调地址填入下图的回调地址处
再回到 TE 界面，点击「前往授权」，此时将打开磁力引擎的授权页面
此时将展示授权界面，选择「基于用户授权」，并确认授权页面中展示的快手 ID 与之前在 TE 系统配置的方案里的 User ID 一致。接着勾选「同意使用协议」后，点击「确认授权」完成授权工作
# 2.7 标准化字段
快手广告主数据中的部分字段，TE 系统会进行标准化处理：
| 字段名 | 标准化字段 | 含义 |
|---|---|---|
| advertiser_id | te_ads_object.ad_account_id | 广告主 ID |
| campaign_name | te_ads_object.campaign_name | 广告组名称 |
| campaign_id | te_ads_object.campaign_id | 广告组 ID |
| unit_name | te_ads_object.ad_group_name | 广告计划名称 |
| unit_id | te_ads_object.ad_group_id | 广告计划 ID |
| creative_name | te_ads_object.ad_name | 创意名 |
| creative_id | te_ads_object.ad_id | 创意 ID |
| 【CNY】（定值） | te_ads_object.currency | 成本或收益的币种 |
| show | te_ads_object.impressions | 展示数 |
| photo_click | te_ads_object.clicks | 点击数 |
| conversion_num | te_ads_object.installs | 点击安装数 |
| charge | te_ads_object.cost | 总消耗 |