被滤除的行摘要

就一个查询而言，如果其结果中的某些行未充分汇总（汇总是为了保护最终用户的隐私），或者未通过广告数据中心的其他隐私权检查，系统将舍弃这些行。您可以在分析查询中配置被滤除的行摘要，这样就会返回一个包含常量和被舍弃行总和的行。这有助于防止数据合计值（例如总展示次数或总点击次数）出现不一致。对于使用界面创建的新分析查询，系统会默认启用“被滤除的行摘要”。“被滤除的行摘要”不适用于受众群体查询。默认情况下，使用 API 创建的查询不会启用“被滤除的行摘要”。

示例

在下面的示例中，包含广告系列 124 和 125 的行将被滤除，因为它们不满足 50 位用户的汇总要求。

广告系列 ID 用户数量
123 400
124 45
125 6

不过，您可以使用“被滤除的行摘要”，将被滤除的数据组合起来，以满足 50 位用户的汇总要求。下例使用求和运算来合计被滤除的数据，并使用一个常量来标记该行：

  • 求和运算用于汇总 Users 列中被滤除的数据。
  • 常量用于标记“被滤除的行摘要”，在 Campaign ID 列中设置为“被滤除的行摘要”。
广告系列 ID 用户数量
被滤除的行摘要 51
123 400

自动模式

我们建议使用自动模式。默认情况下，广告数据中心会自动为使用界面创建的新查询启用并配置“被滤除的行摘要”。在您修改查询时，广告数据中心会根据所选的列自动调整相应配置。

  • 如需在查看报告时查看自动配置的设置，请依次点击修改 修改。配置处于只读状态。
  • 如要停用自动模式，请点击自动切换开关，将其切换到关闭位置。系统会保留当前配置并停用自动模式。您必须保存查询才能保留更改。
  • 如需启用自动模式，请点击自动切换开关，将其切换到开启位置。您必须保存查询才能保留更改。
  • 如需使用此 API 开启/关闭自动模式，请使用 generateFilteredRowSummaryAutomatically。

我们建议使用自动模式。如需手动向已保存的查询中添加“被滤除的行摘要”，或者在停用自动模式后添加，请按以下步骤操作：

  1. 在广告数据中心内，打开“报告”页面。
  2. 点击要修改的报告的名称。
  3. 点击系统自动生成的被滤除的行摘要旁边的修改 修改。
  4. 点击自动切换开关，将其切换到关闭位置。注意：停用自动模式后，系统会保留当前配置。根据需要修改或删除这些规则。
  5. 使用求和对列进行汇总。请注意，如果总和低于汇总阈值，则“被滤除的行摘要”将被舍弃。
    1. 点击 Add rule。
    2. 在列名称字段中输入要汇总的列的名称。
    3. 从类型列表中选择 Sum（求和）。
  6. 使用常量为“被滤除的行摘要”添加标签。您所使用的常量必须是对所选列有效的数据类型。
    1. 点击添加。
    2. 确定您希望该标识符显示在过滤后行摘要的哪一列中，然后在列名称字段中输入该列的名称。
    3. 从 Type（类型）列表中选择 Constant（常量）。
    4. 在指定常量字段中为该行输入一个有用的标识符，例如“被滤除的行摘要”。
  7. 点击完成。
  8. 点击保存以提交更改。

我们建议使用自动模式。如果您使用导出多个表一文中介绍的 in-sql 语法来导出多个表，则可以通过列选项来添加“被滤除的行摘要”：

CREATE TABLE `myproject.mydataset.mytable` (
    campaign_id INT64 OPTIONS(merge_constant=0),
    ct INT64 OPTIONS(merge_type="SUM")
  )
OPTIONS(privacy_checked_export=true) AS
SELECT campaign_id, COUNT(*) AS ct GROUP BY campaign_id;

这将生成一个包含“被滤除的行摘要”的表格，其中 campaign_id 为 0，ct 为由于隐私权检查而从结果中滤除的行数总和。

可用于“被滤除的行摘要”的列选项包括：

  • merge_type="SUM"：用于在摘要行中输出被滤除的值的总和。
    • 仅对数字类型有效。
  • merge_constant=<value>：用于在摘要行中设置一个常量值。类型必须与相应的列相同。
  • 没有指定选项的列将在摘要行中显示 NULL。

只能指定 merge_type 或 merge_constant 中的一个。 针对“被滤除的行摘要”的所有规则在这里也适用（比如，如果总和低于汇总阈值，则“被滤除的行摘要”将被舍弃）。