特殊文件

广告数据见解

通过本章，您将了解营销API提供的广告数据见解。

广告insight接口在广告后为您提供数据报告和分析服务。我们的报告将涵盖多个级别的数据，例如促销帐户，广告，创造力，材料等，并通过每日和小时的时间维度来查询。所有报告数据涵盖了常见的基本指标，例如曝光，点击，费用，应用程序下载/转换/激活。如果您需要更多指标数据，例如平均点击单价（CPC），平均千印象价格（CPM），平均转换率，平均转换成本等，则可以根据我们提供的基本数据自己对其进行计算。

依靠广告数据见解的相关界面提供的数据，您可以了解不同时间段和不同人群中不同广告的性能，并且可以基于此进一步优化广告交付。您可以通过以下各章了解广告数据洞察服务的特定功能：

获取每日报告：在每个级别查询报告数据以及天数；

获取每小时报告：在每个级别上查询报告数据，并带有小时尺寸；

获取目标标签报告：根据目标人群的性别，年龄和地区查询报告数据。

创建一个异步任务：使完整的报告数据不同步。

除了了解营销API提供的数据报告维度和度量方面外，您还可能需要了解数据见解和返回数据条目中涉及的报告汇总规则。接下来，您将介绍这两个规则。

聚合规则

不同类型的报告可以选择聚合规则以略有差异。首先，我们将介绍可以为每日报告，小时报告和针对性标签报告选择的聚合条件。

1。默认情况下按日期（日）汇总每日报告，并且在不同级别支持的聚合条件如下：

2。默认情况下按小时汇总了小时报告，并且在不同级别支持的聚合条件如下：

3。在不同类型的目标标签报告下受支持的聚合条件如下：

聚合示例

聚合条件将影响最终输出。接下来，我们将使用几个示例来说明每个聚合条件的规则。

1。每日报告（Daily_reports/get）

假设一个帐户下有10个AD组，并且在2018/08/01-2018/08/11上有交货数据。如果查询该帐户广告组维度的报告数据，请访问2018/08/01-2018/08/11：

2。小时报告（hourly_reports/get）

假设一个帐户下有10个AD组，并且在2018/08/01的24小时内有送货数据，如果您查询2018/08/01 AD AD Group Dimension（Level = ADGroup）中的帐户的每小时数据：

3。目标标签报告（targeting_tag_reports/get）

假设一个帐户下有10个AD组，并且在2018/08/01-2018/08/11上有交货数据。如果查询在2018/08/01-2018/08/11期间帐户期间广告组的性别数据：

数据输入

返回的数据输入与汇总规则有关，也与数据有关。在所有报告接口中，返回的数据将仅包含至少有曝光的条目，也就是说，报告不会包含报告中具有0个指标的所有条目。

例如，通过每日报告界面，请查询从一个月的1个到第10个帐户级别的每日数据，然后按一天进行汇总。实际上，该帐户的第1，第二和第三只有广告，报告申报表中只有3个记录，这些记录将不包含从4日至10日开始的条目。

使用的局限性

除了受到通用接口呼叫频率限制外，广告性能报告接口还具有以下限制（异型任务下载报告不受此限制的约束）：

通过分页获得的数据总数限制为10,000，也就是说，Page*page_size不能超过10,000，并且在超过它之后将被拦截。

在10秒内匹配的数据总数限制为40,000。详细的逻辑是：每个每日报告的配额（daily_reports/get），hourly_reports/get和targeting_tag_reports/get。

配额基于10秒作为周期，并且基于查询周期中的命中总量的总量进行计算。

配额超过该期间，相应的请求访问将被冷冻。

冻结时间是根据此周期中当前的累积配额消耗来计算的。冻结时间=此周期中的剩余时间 +下降（当前的累积配额消耗/40000） * 10秒