menu
Is this helpful?

# 巨量引擎广告创意数据

TIP

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

# 概要

# 接口简介

接口名 类型 粒度 归因 成本 收益 展示 点击 转化
广告创意数据 API 聚合数据

广告创意数据 (opens new window)是广告数据粒度最细的普通数据报表,相比多合一数据报表来说,分析维度较少,但是支持的指标会多一些。

# 集成流程

  1. 登录巨量引擎开放平台 (opens new window),创建开发者账号与应用
  2. 获取应用的 APP_ID、Secret 以及登录用户 ID
  3. 登录 TE 后台,进入三方集成模块,新增巨量引擎广告创意数据的集成方案
  4. 打开授权链接,并登录您需要拉取的广告账号所属的巨量账号,完成授权
  5. 查看 TE 系统否成功接收数据,并完成报表搭建

# 一、获取授权信息

# 1.1 创建开发者账号与应用

在接入巨量引擎数据前,您需要申请巨量引擎开发者账号,并创建一个应用

  1. 首先您需要登录或注册巨量账号,点击本链接进入登录注册页 (opens new window),如果您拥有巨量引擎账号,可选择左下角登陆,登陆对应账号;如果没有账号,则使用邮箱或手机号注册巨量引擎账号

  2. 完成登录后,您将跳转至巨量引擎开放平台 (opens new window),点击页面右上角「开发者管理后台」按钮,进入开发者后台

  3. 如果您没有创建开发者账号,则此时需要您完成开发者信息的录入与资质审核,由于一个公司信息仅能注册认证一个开发者账户,请务必使用公司邮箱进行申请,并妥善保管该账号。具体的申请流程,可以参考官方文档 (opens new window)

    1. 开发者类型,需要选择广告主/代理商,请按实际情况选择其一,两者的差异如下:
    • 广告主:只可申请与开发者账户同公司主体的纵横组织账户授权
    • 代理商:只可申请与开发者账户同公司主体的代理商账户授权
  4. 开发者账号认证通过后,请进入开发者官网并进入「APPID管理」页面,选择创建「广告管理」类型应用

    1. 应用名称、应用图表、应用描述可以按照实际需要进行编写,描述应用的作用是将巨量投放数据回传到自有平台
    2. 回调地址处,请填写「www.thinkingdata.cn」,该地址只是临时的地址,在方案配置完毕后还需要调整
    3. 申请权限出,至少需要选中「数据报表」权限
  5. 申请提交后,巨量将在一个工作日内审核完成您的应用创建(APPID)申请

# 1.2 获取 App ID、App Secret

完成应用申请后,请进入到开发者后台,从左边栏找到「应用管理」-「基础应用」,选择创建的应用,点击「编辑」进入「基本信息」页面,找到 APP_ID 和 Secret,并记录下来。

# 1.3 获取登录用户 ID

接下来,您需要获得登录用户的 ID。请进入到「巨量引擎开发平台」,点击右上角"六边形标识",点击「巨量纵横」进入后台,点击右上角「账户信息与安全」,找到登录用户 ID,并记录下来

# 1.4 总结

至此,您已经获得了所有需要的授权信息。此时您应该获得了以下信息:

  • App ID
  • App Secret
  • 登录用户 ID

# 二、方案配置

当您获得了所有授权信息后,您可以登录 TE 系统,在「三方集成」模块中完成新方案的配置。下图是巨量引擎广告创意数据的配置界面,请您按照本章节内容完成方案的创建:

# 2.1 授权信息配置

点击「授权信息」按钮,在弹出框内填写您在上一步中获得的信息:

其中:

  • APP ID:应用的 APP ID
  • APP Secret:应用的 APP Secret
  • Login ID:登录用户 ID
  • Account ID List:需要拉取数据的广告账号 ID,如果不填写则会拉取授权用户下的所有广告账号的数据

# 2.2 定时拉取

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

# 2.3 入库设置

您可以控制数据是否以事件的形式写入,如果关闭,则数据将不会写入事件表,因此请不要关闭该配置。

# 2.4 集成配置

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

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

模块 名称 含义
sink_event event_name 入库后的事件名,可以自定义,字符串类型。接收到的数据均将以该名称作为事件名。
source metrics 数据中的指标,列表类型,可以自定义
group_by 数据中的分组维度,列表类型,可以自定义
time_granularity 数据的时间聚合粒度,即拉取的数据以天还是小时进行聚合 可选值: day、hour

您可以按照需要,对集成配置进行修改

# 2.4.1 分组维度

以下表格是广告创意数据报表支持的分组维度,我们默认的分组条件是:

  • STAT_GROUP_BY_FIELD_STAT_TIME
  • STAT_GROUP_BY_FIELD_ID

除此之外,您还可以增加最多一个其他分组条件(比如下表中的 STAT_GROUP_BY_INVENTORY),也可不添加,即采用默认分组条件。如需进行调整,请将需要添加的分组条件名添加到 source.group_by 中

分组条件名 入库字段名 含义 是否默认
STAT_GROUP_BY_FIELD_STAT_TIME stat_datetime 数据起始时间,格式为:
  • yyyy-MM-dd HH:mm:ss
STAT_GROUP_BY_FIELD_ID advertiser_id 广告主 ID
campaign_name 广告组名称
campaign_id 广告组 ID
ad_name 广告计划名称
ad_id 广告计划 ID
creative_id 创意 ID
STAT_GROUP_BY_INVENTORY inventory 投放广告位
STAT_GROUP_BY_CREATIVE_MATERIAL_MODE creative_material_mode 创意类型,取值:
  • STATIC_ASSEMBLE(程序化创意)

  • INTERVENE(自定义创意)

STAT_GROUP_BY_LANDING_TYPE landing_type 推广目的类型
STAT_GROUP_BY_PRICING pricing 出价类型
STAT_GROUP_BY_IMAGE_MODE image_mode 素材类型
STAT_GROUP_BY_PROVINCE_NAME province_name 省份
STAT_GROUP_BY_CITY_NAME city_name 城市
STAT_GROUP_BY_GENDER gender 性别
STAT_GROUP_BY_AGE age 年龄
STAT_GROUP_BY_PLATFORM platform 平台
STAT_GROUP_BY_AC ac 类型

# 2.4.2 涵盖指标

以下表格展示的是广告创意数据报表支持的部分常用指标,由于全量指标过多,此处无法完全展示,如有需要,可以访问官网文档 (opens new window)获取全指标说明。如需添加其他指标,可以将指标名写入 source.metrics 中

指标名 中文名 是否默认
active 激活数
active_cost 激活成本
active_pay_cost 首次付费成本
active_pay_rate 首次付费率
active_rate 激活率
active_register_cost 注册成本
active_register_rate 注册率
attribution_active_pay_7d_per_count 7日人均付费次数
attribution_convert 转化数(计费时间)
attribution_convert_cost 转化成本(计费时间)
attribution_deep_convert 深度转化数(计费时间)
attribution_deep_convert_cost 深度转化成本(计费时间)
attribution_game_pay_7d_cost 7日付费成本
attribution_game_pay_7d_count 7日付费次数
attribution_next_day_open_cnt 次留数
attribution_next_day_open_cost 次留成本
attribution_next_day_open_rate 次留率
avg_click_cost 平均点击单价
avg_show_cost 平均千次展现费用
click 点击数
click_install 点击安装数
convert 转化数
convert_cost 转化成本
convert_rate 转化数据-转化率
cost 总消耗
ctr 点击率
deep_convert 深度转化数
deep_convert_cost 深度转化成本
deep_convert_rate 深度转化率
download 下载开始
game_addiction 关键行为数
game_addiction_cost 关键行为成本
game_addiction_rate 关键行为率
game_pay_cost 付费成本
game_pay_count 付费次数
next_day_open 次留回传数(未对回)
next_day_open_cost 次留成本(未对回)
next_day_open_rate 次留率(未对回)
pay_count 首次付费次数
play_100_feed_break 99%进度播放数
play_25_feed_break 25%进度播放数
play_50_feed_break 50%进度播放数
play_75_feed_break 75%进度播放数
play_duration_sum 播放时长,单位ms
total_play 播放数
valid_play 有效播放数
valid_play_cost 有效播放成本
valid_play_rate 有效播放率
play_over_rate 播完率
redirect 页面跳转
register 注册数
share 分享数
show 展示数
wifi_play WiFi播放量
wifi_play_rate WiFi播放占比

# 2.4.3 入库规则

  • 使用数据中的 stat_datetime 字段,即数据的日期,设置为聚合数据的 #event_time
  • 数据事件名为 -- oceanengine_creative_data
  • 其余字段都将会入库

# 2.5 完成授权

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

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

回到巨量引擎开发者后台,进入到之前创建的应用的基础信息页,将刚刚复制的地址填入回调地址处

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

此时将展示授权界面,选择「当前用户全量账户」,并确认「当前登录用户」拥有您需要拉取数据的广告账户。请确认红框中的登录用户 ID 是您在方案配置中输入的登录用户 ID。确认完毕后,点击同意授权,即可完成授权工作。

完成了授权之后,请在「授权信息」中点击左下角的「我已完成以上两步操作」后点击右下角的「完成授权」结束配置。至此,您完成巨量引擎广告创意数据的集成。

# 2.6 标准化字段

如果数据中存在以下事件属性,我们会自动进行标准化处理:

原始字段 标准化字段 含义
advertiser_id te_ads_object.ad_account_id 广告账号 ID
campaign_name te_ads_object.campaign_name 广告计划名
campaign_id te_ads_object.campaign_id 广告计划 ID
ad_name te_ads_object.ad_group_name 广告组名,变现广告的 Unit 名
ad_id te_ads_object.ad_group_id 广告组 ID,变现广告的 Unit ID
creative_name te_ads_object.ad_name 广告名
creative_id te_ads_object.ad_id 广告 ID
platform(默认不获取) te_ads_object.platform 平台,即 Android、iOS 等
【CNY】(定值) te_ads_object.currency 成本或收益的币种
show te_ads_object.impressions 曝光量
click te_ads_object.clicks 点击量
click_install te_ads_object.installs 转化量(安装)
cost te_ads_object.cost 买量成本