新版 API 数据聚合规则-示例
聚合规则
不同类型的报表可选择聚合规则略有差异。首先,将分别介绍日报表、小时报表、定向标签报表可选择的聚合条件。
1、日报表默认按 date(天)聚合,且不同 level 下支持的聚合条件如下:
当 level 为 ADVERTISER 时,支持按 date 聚合。
当 level 为 ADGROUP 时,支持按 date、adgroup_id、site_set 聚合。
当 level 为DYNAMIC_CREATIVE时,支持按 date、adgroup_id、dynamic_creative_id、site_set 聚合。
当 level 为COMPONENT时,支持按 date、dynamic_creative_id、component_id、site_set聚合。
当 level 为 CHANNEL 时,支持按 date、channel_id、site_set 聚合。
当 level 为 MATERIAL_VIDEO 时,支持按 date、image_id、adgroup_id、site_set 聚合。
当 level 为 MATERIAL_IMAGE 时,支持按 date、video_id、adgroup_id、site_set 聚合。
当 level 为 BIDWORD 时,支持按 date、bidword_id、site_set 聚合。
2、小时报表默认按 hour(小时)聚合,且不同 level 下支持的聚合条件如下:
当 level 为 ADVERTISER 时,支持按 hour 聚合。
当 level 为 ADGROUP 时,支持按 hour、adgroup_id 聚合。
当 level 为DYNAMIC_CREATIVE时,支持按 hour、adgroup_id、dynamic_creative_id聚合。
当 level 为COMPONENT时,支持按 hour、dynamic_creative_id、component_id聚合。
当 level 为 CHANNEL 时,支持按 hour、channel_id 聚合。
当 level 为 MATERIAL_VIDEO 时,支持按 hour、image_id、adgroup_id 聚合。
当 level 为 MATERIAL_IMAGE 时,支持按 hour、video_id、adgroup_id 聚合。
当 level 为 BIDWORD 时,支持按 hour、bidword_id 聚合。
3、定向标签报表不同 type 下支持的聚合条件如下:
当 type 为 GENDER 时,支持按 gender 聚合
当 type 为 AGE 时,支持按 age 聚合
当 type 为 REGION 时,默认按 region_id 聚合
聚合示例
聚合条件会影响最终的输出结果,接下来将通过几个示例说明各聚合条件的规则
1、日报表(daily_reports/get)
假设某帐号下共有 10 个广告组,且在 2018/08/01-2018/08/11 均有投放数据,若查询该帐号在 2018/08/01-2018/08/11 广告组维度(level = ADGROUP)的报表数据:
选择按天聚合(GROUP BY date),则一共返回 11 条记录,各项指标为所有广告组在各天的综合指标,返回数据节点中的 adgroup_id 无意义;
选择按广告组聚合(GROUP BY adgroup_id),则一共返回 10 条数据,各项指标为各广告组 10 天的综合指标,返回的数据节点中的 date(天)无意义;
选择同时按天以及广告组聚合(GROUP BY date,adgroup_id),则一共返回 110 条数据,各项指标为各广告组在各天的效果指标,返回的数据节点中的 adgroup_id、date 均有意义。
2、小时报表(hourly_reports/get)
假设某帐号下共有 10 个广告组,且在 2018/08/01 的 24 小时内均有投放数据,若查询该帐号在 2018/08/01 广告组维度(level = ADGROUP)的小时数据:
选择按小时聚合(GROUP BY hour),则一共有 24 条数据,各项指标为所有广告组在每小时的综合指标,返回数据节点中的 adgroup_id 无意义;
选择按广告组聚合(GROUP BY adgroup_id),则一共返回 10 条数据,各项指标为各广告组当天的综合指标,返回的数据节点中的 hour(小时)无意义;
选择同时按小时以及广告组聚合(GROUP BY hour,adgroup_id),则一共返回 240 条数据,各项指标为各广告组在各小时的效果指标,返回的数据节点中的 adgroup_id、hour 均有意义。
3、定向标签报表(targeting_tag_reports/get)
假设某帐号下共有 10 个广告组,且在 2018/08/01-2018/08/11 均有投放数据,若查询该帐号在 2018/08/01-2018/08/11 期间某广告组的性别数据:
选择按天聚合(GROUP BY date),则一共返回 11 条记录,各项指标为该广告组在各天的综合指标,返回数据节点中的 gender 无意义;
选择按性别聚合(GROUP BY gender),则一共返回 2 条数据,各项指标为该广告组 11 天分性别的综合指标,返回的数据节点中的 date(天)无意义;
选择同时按天以及性别聚合(GROUP BY date,gender),则一共返回 22 条数据,各项指标为该广告组分性别在这 11 天内的明细数据,返回的数据节点中的 date、gender 均有意义。