巨量引擎广告创意数据

您所在的位置：网站首页 › 巨量引擎广告管理平台 › 巨量引擎广告创意数据

巨量引擎广告创意数据

2024-07-12 06:07| 来源: 网络整理| 查看: 265

# 巨量引擎广告创意数据

TIP

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

# 概要

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

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

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

# 一、获取授权信息

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

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

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

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

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

开发者类型，需要选择广告主/代理商，请按实际情况选择其一，两者的差异如下：广告主：只可申请与开发者账户同公司主体的纵横组织账户授权代理商：只可申请与开发者账户同公司主体的代理商账户授权

开发者账号认证通过后，请进入开发者官网并进入「APPID管理」页面，选择创建「广告管理」类型应用

应用名称、应用图表、应用描述可以按照实际需要进行编写，描述应用的作用是将巨量投放数据回传到自有平台回调地址处，请填写「www.thinkingdata.cn」，该地址只是临时的地址，在方案配置完毕后还需要调整申请权限出，至少需要选中「数据报表」权限

申请提交后，巨量将在一个工作日内审核完成您的应用创建（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 买量成本

← 巨量引擎多合一报表巨量引擎广告升级版数据报表 →

【本文地址】

巨量引擎广告创意数据

巨量引擎广告创意数据

今日新闻

推荐新闻