menu
Is this helpful?

# 快手程序化创意 2.0 数据

TIP

请注意,第三方数据集成产生的数据会被纳入集群的消耗数据量

# 概要

# 接口简介

接口名 类型 粒度 归因 成本 收益 展示 点击 转化
程序化创意 2.0 数据 API 聚合指标

程序化创意 2.0 数据 (opens new window)适合获取「创意制作方式」为「程序化创意」的广告的数据

# 集成流程

  1. 注册快手开发者账号,并创建应用
  2. 登录 TE 后台,进入三方集成模块,新增快手程序化创意 2.0 数据方案,并完成相关配置
  3. 从 TE 后台获取授权回调地址,登录快手开放平台,在之前创建的应用填入该回调地址
  4. 在 TE 后台处打开授权地址完成授权
  5. 查看 TE 系统否成功接收数据,并完成报表搭建

# 一、获取授权所需信息

# 1.1 注册快手开发者账号

在调用快手 Marketing API 前,您需要准备一个快手开发者账号,首先您需要登录磁力引擎开放平台 (opens new window)

接下来,点击「注册为开发者」:

填写联系人姓名等信息,完善联系人信息:

接着,您需要完善开发者资质,可以由公司法人 or 代理人注册申请,但是均需要申请人进行实名身份认证

您需要在开发者角色处选择「广告主」

# 1.2 创建应用

在完成快手开发者账号的注册后,接下来您需要在「应用管理」创建一个新应用

创建应用需要提供:

  • 应用名称、应用图标、应用描述:可以自定义
  • 回调地址:目前先使用 www.thinkingdata.cn,完成应用创建且 TE 平台方案创建完毕后需要再次调整

接下来您需要获取下图绿框与绿箭头标出的 APP ID 与 Secret

# 1.3 获取您需要授权账号的快手 ID

最后,您需要获取您需要拉取广告数据的快手账号的快手 ID,一般您可以在快手后台的右上角获取到:

# 二、方案配置

创建完应用后,接下来需要您登录 TE 系统后台,在「三方集成」模块中完成快手程序化创意 2.0 数据的配置。下图是快手程序化创意 2.0 数据的配置界面:

# 2.1 授权信息配置

点击「授权信息」按钮,在弹出框内填写您在授权工作中获取到的信息

其中 APP ID、Secret、User ID 分别填入创建应用时获得的 APP ID、Secret 以及您需要授权账号的快手 ID

Advertiser ID List 则需要填写您想要拉取的广告账号 ID 的列表,您可以用 "," 号分割多个。如果不填写,TE 系统将获取您授权的所有广告账号的数据。如果填写,则 TE 系统只会获取您填写的广告账号的数据

# 2.2 定时拉取

您可以在「定时拉取」模块设置 TE 系统定时拉取快手广告程序化创意 2.0 数据的策略,可以选择在每天的某时或者每小时拉取一段时间的数据。由于拉取的数据也会计算再数据量中,建议您在不要定时拉取太长时间的数据

# 2.3 事件表入库设置

打开「事件表入库设置」开关后,回传的数据都将写入到事件表中,我们建议您开启事件数据入库。

# 2.4 集成配置

最后,您可以在集成配置模块对数据拉取的细节配置进行控制。包括数据的时间聚合粒度,以及入库后的事件名等。

集成配置中的内容是一个 JSON,您可以按照以下内容进行自定义配置:

模块 名称 含义
sink_event event_name 入库后的事件名,可以自定义,字符串类型。接收到的数据均将以该名称作为事件名。
source time_granularity 数据的时间聚合粒度,即拉取的数据以天还是小时进行聚合 可选值: DAILY / HOURLY
transfer double_columns 指标字段,请不要修改

程序化创意数据的指标包含了多种业态(比如网店、直播带货等)的指标数据,以下展示的是部分常用指标,如需了解完整的指标列表,可以查看【程序化创意 2.0 数据】 (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 转化率(回传时间归因)
- 维度字段
维度 描述
campaign_id 计划 ID
campaign_name 计划名称
unit_id 组 ID
unit_name 组名称
creative_id 创意 ID
photo_url 视频链接
photo_id 视频 ID
image_token 封面 ID
cover_url 封面链接
description 作品广告语
pic_id 图片库图片ID
pic_list 联盟图片(横版/竖版)
pic_url_list 联盟图片 URL(横版/竖版)

# 2.5 事件入库规则

  • 使用数据中的 stat_date 与 stat_hour 字段,即日期与小时的拼接值,作为数据的 #event_time
  • 数据事件名为 -- kuaishou_ads_program_creative_report
  • 其余字段都将会入库

# 2.6 完成授权

完成配置后,您可以点击右上角的「保存并授权」将方案配置保存下来。接下来,您需要完成最后的授权工作:

首先,请在弹出的「授权信息」页面中,将第一步中的地址复制下来

其次,登录到磁力引擎开放平台,进入到之前创建的应用,将授权回调地址填入下图的回调地址处

再回到 TE 界面,点击「前往授权」,此时将打开磁力引擎的授权页面

此时将展示授权界面,选择「基于用户授权」,并确认授权页面中展示的快手 ID 与之前在 TE 系统配置的方案里的 User ID 一致。接着勾选「同意使用协议」后,点击「确认授权」完成授权工作

# 2.7 标准化字段

快手程序化创意 2.0 数据中的部分字段,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 总消耗