创建和生成报告

本指南介绍了如何创建和运行报告，以及如何查看结果。

创建报告

分析师和超级用户可以创建和修改报告。详细了解广告数据中心的访问权限控制。

  1. 在广告数据中心内，打开报告页面。
  2. 点击 + 创建报告。系统随即会打开创建新报告页面。
    • 您可以通过搜索、选择产品图标和选择下拉菜单选项的方式过滤模板。
  3. 选择一个模板，然后点击使用模板；或点击 SQL，从头开始创建报告。
    • 点击 expand_content 展开，预览模板详细信息和 SQL。
  4. 如需修改报告，请点击修改查询。您可以使用查询编辑器执行以下操作：
    • 使用与 BigQuery 兼容的 SQL 自定义报告。
    • 在属性标签页中配置参数。
    • 在 Google 表格标签页中查看可用表和字段的列表。
    • 在“第一方表”标签页中查看已导入的第一方表及其架构的列表。
    • 点击运行以运行 SQL 查询。请注意，从 SQL 查询编辑器发起的执行不会计入报告的执行历史记录，也不会显示在首页的近期活动部分中。
    • 点击完成以确认对查询所做的更改，然后返回“报告设置”页面。
  5. 为报告输入一个名称。
  6. 在“设置”卡片中设置参数值（如果适用）。
  7. 为在此报告上运行的作业配置输入和输出：
    • 在广告数据来源字段中选择一个数据源。这应该是与您要查询的广告数据相关联的广告数据中心账号 ID。（如果您想查询沙盒数据，请选择“广告数据中心沙盒客户”。）
    • 如果使用的是匹配表，请在匹配表账号字段中选择匹配表。
    • 为报告选择日期范围和时区。报告时区应与关联的广告账号（例如 Google Ads 账号）的时区一致。注意：只有从 SQL 编辑器界面运行查询时，才支持用于查询测试的自定义日期范围。
    • 可选：更改隐私设置并配置被滤除的行摘要。
    • 选择应将报告结果保存到的 BigQuery 项目、数据集和表。
  8. 可选：将报告设置为按时间表生成。
  9. 点击保存。

参数

借助参数，您可以指定应如何运行给定报告。使用 SQL 创建报告（或修改报告模板中的 SQL）时，借助参数，您可以在报告中重复使用相同的 SQL 代码，并为报告的每个副本设置不同的参数值。例如，您可以针对不同的广告系列 ID 运行两个共用相同 SQL 查询或模板的报告，只需在报告详情页面的“设置”部分配置参数并设置其值即可。使用参数可让 SQL 代码保持简洁，减少编辑时引入错误的可能性，并让您能够在报告中重复使用相同的 SQL 查询，而无需修改 SQL 本身中的值。

在以下示例中，报告包含一个名为 campaign_ids 的参数，该参数接受 int64 广告系列 ID 的 array：

  /* Parameters:
   *   @campaign_ids (ARRAY of INT64):
   *   A list of campaign IDs to analyze
   */

  WITH user_reach AS (
  SELECT
    user_id,
    count(*) AS num_views
  FROM
    adh.google_ads_impressions
  WHERE
    campaign_id in UNNEST(@campaign_ids)
  GROUP BY
    user_id
  )
  SELECT
  COUNT(*) AS unique_users,
  COUNTIF(num_views = 1) AS one_view,
  COUNTIF(num_views > 1 AND num_views <= 5) AS less_or_equal_five_views,
  COUNTIF(num_views > 5) AS more_than_five_views
  FROM
    user_reach

参数类型

允许使用以下类型的参数：

  • int64
  • float64
  • bool
  • string
  • date
  • timestamp
  • array（所允许的上述任何类型）

向报告添加参数

  1. 打开已保存的报告，或创建新的报告。
  2. 点击修改查询。
  3. 在属性下，点击添加参数。
  4. 在名称字段中输入一个名称。您将使用此名称在报告文本中引用参数。
  5. 使用下拉菜单选择参数类型。
    • 如果您选择数组类型，系统随即会显示一个额外的下拉菜单。从此下拉菜单中选择数组类型。
  6. 在 SQL 查询中，使用标准 SQL 参数格式添加参数：@PARAMETER_NAME。请参阅以下步骤的示例。
  7. 点击完成，然后点击保存。

使用参数

  1. 打开已配置参数的报告。
  2. 在设置窗格中，为您定义的每个参数输入值
  3. 点击保存以保留参数值。

移除参数

  1. 打开已配置参数的报告。
  2. 点击修改查询以打开 SQL 编辑器。
  3. 在属性下，点击要删除的参数旁边的“删除”图标 Delete。
  4. 点击完成，然后点击保存。

预留的参数

下表列出了广告数据中心预留的参数。您可以在报告中使用这些参数，但不能创建与预留参数同名的参数。

start_date date

报告作业的开始日期（含此日期）。系统会忽略用户以此名称定义的参数，并替换为新建作业对话框中设置的值。
end_date date

报告作业的结束日期（含此日期）。系统会忽略用户以此名称定义的参数，并替换为新建作业对话框中设置的值。
time_zone string

报告作业的时区。系统会忽略用户以此名称定义的参数，并替换为新建作业对话框中设置的值。

被滤除的行摘要

被滤除的行摘要会统计因差异检查而被滤除的数据。系统会对被滤除的行中的数据求和，并将结果添加到一个汇总行中。虽然无法对被滤除的数据进行进一步分析，但可以大致了解从结果中滤除了多少数据。对于使用差异检查隐私模式的查询，广告数据中心会自动启用并配置“被滤除的行摘要”。在您修改查询时，广告数据中心会根据所选的列自动调整相应配置。如需详细了解被滤除的行摘要或手动配置被滤除的行摘要，请参阅被滤除的行摘要。

修改报告

  1. 在广告数据中心内，打开报告页面。
  2. 点击要修改的报告的名称。
  3. 对报告进行更改。例如，修改 SQL、管理参数值或设置时间表。
  4. 点击保存。

运行报告

在生成报告之前，请确保您已向服务账号授予将包含联接输出的数据集的 dataEditor 权限。详细了解 BigQuery 中的访问权限控制。

  1. 在广告数据中心内，打开报告页面。
  2. 点击要运行的报告的名称。
  3. 点击运行。

按计划生成报告

  1. 在广告数据中心内，打开报告页面。
  2. 点击您要为其设置时间表的报告的名称。
    • 如需为新报告设置时间安排，请创建报告，然后点击保存。
  3. 点击 + 设置时间表。
  4. 在时间安排窗格中，点击根据以下详细信息安排生成此报告的时间切换开关，将其切换到开启状态。
  5. 在频率下，选择间隔和时间，然后输入时区。
    • 如需改用 Cron 表达式，请将使用 Cron 表达式设置时间表切换开关切换到开启状态，然后在相应框中输入表达式。
  6. 点击完成。
  7. 点击保存，将对报告所做的更改提交。

如需在首页上显示已安排的作业，请从所有者过滤条件列表中选择任何人。

查看结果

报告运行完毕后，您可以在报告详情页面中预览结果。如需日后查看结果，请从首页打开报告。您还可以在 BigQuery、Google 表格或数据洞察中浏览数据。

预览

在已完成的作业中，点击预览。前 20 项结果将显示在作业下方。

BigQuery

默认情况下，您的结果会导出到 BigQuery。点击查看表格可在新窗口中打开 BigQuery。

Google 表格和数据洞察

打开探索下拉菜单，然后从选项中选择使用表格或使用数据洞察。系统随即会在新窗口显示数据。