编写和运行报告

关键术语：查询现在名为报告 在向报告这一名称过渡期间，您可能会在界面上及文档中看到这两个术语互换使用的情况。

创建报告

注意：并非所有用户都能创建并修改报告。详细了解广告数据中心的访问权限控制。

1. 前往广告数据中心内的查询标签页。
2. 点击 + 创建查询。此时系统会打开创建新报告页面。
3. 可选：通过搜索、选择图标和选择以下下拉菜单选项的方式过滤模板：
   • 数据源
   • 用例
   • 广告资源
   • MRC 认证
4. 可选：点击 expand_content 展开，预览模板详细信息和 SQL。
5. 点击使用模板，选择想要使用的模板；或点击 add_circle 添加，从头开始创建报告。
6. 为报告输入一个名称。
7. 使用与 BigQuery 兼容的 SQL 编写或修改报告。您可以从 Google 表格标签页中查找可用的表和字段，然后将其插入您的 SQL。
8. 可选：配置参数。
9. 可选：配置被滤除的行摘要。
10. 点击保存。

参数

参数可以使报告更加灵活。例如，您可能希望针对不同的广告系列运行同一报告。您可以配置一个参数，以接受您生成报告时从“生成”卡片输入的一个或多个广告系列 ID，而不是生成重复的报告或在每次运行前对广告系列 ID 进行硬编码。使用参数可让代码保持简洁，减少编辑时引入错误的可能性，并让您的报告无需编辑即可重复使用。您在哪个报告中创建参数，参数的作用范围就限定为哪个报告。因此您可以在其他报告中重复使用参数名称。

参数类型

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

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

创建参数

1. 打开已保存的报告，或创建新的报告。
2. 依次点击属性 > 参数 > 添加参数。
3. 在名称字段中输入一个名称。您将使用此名称在报告文本中引用参数。
4. 使用下拉菜单选择参数类型。
   • 如果您选择“array”，系统随即会显示一个额外的下拉菜单。从该下拉菜单中选择数组类型。
5. 可选：重复第 2-4 步，直到添加完所需的所有参数。
6. 点击“保存”

使用参数

在报告文本中，应使用标准 SQL 参数格式，即在参数名称前面加上 @。在以下示例中，报告包含一个名为 @campaign_ids 的参数：

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

  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

运行查询时，新建作业对话框将包含参数字段。为您定义的每个参数输入值。

移除参数

1. 打开具有您要删除的参数的报告。
2. 打开属性标签页。
3. 在参数卡片中，点击您要删除的参数旁边的删除。
4. 点击“保存”。

预留的参数

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

start_date	date 报告作业的开始日期（含此日期）。系统会忽略用户以此名称定义的参数，并替换为新建作业对话框中设置的值。
end_date	date 报告作业的结束日期（含此日期）。系统会忽略用户以此名称定义的参数，并替换为新建作业对话框中设置的值。
time_zone	string 报告作业的时区。系统会忽略用户以此名称定义的参数，并替换为新建作业对话框中设置的值。 提示：为防止在报告中使用时区（例如在 WHERE 子句中）时出现差异，您可以使用 time_zone 来使时区与新建作业对话框中设置的时区一致。此外，使用与数据源相同的时区也很重要。

被滤除的行摘要

被滤除的行摘要会统计因隐私权检查而被滤除的数据。系统会对被滤除的行中的数据求和，并将结果添加到一个汇总行中。虽然无法对被滤除的数据进行进一步分析，但可以大致了解从结果中滤除了多少数据。

注意：汇总要求适用于被滤除的行摘要本身。如果生成的被滤除的行摘要不符合汇总要求，被滤除的行摘要本身将被滤除。

修改报告

1. 前往广告数据中心内的查询标签页。
2. 点击要修改的报告的名称。
3. 修改报告。
4. 点击保存。

生成报告

要点：编写好 {queries} 后，您应该先使用沙盒进行测试，然后再针对真实数据运行这些报告。详细了解在广告数据中心内编写报告的最佳实践

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

1. 前往广告数据中心内的查询标签页。
2. 点击要运行的报告的名称。
3. 点击运行图标 。
   • 页面顶部会显示报告预计会使用的字节数。
4. 从广告数据来源下拉菜单中选择一个 ID。这应该是与您要查询的广告数据相关联的广告数据来源 ID。（如果您想查询沙盒数据，请选择广告数据中心沙盒客户。）
5. 如果使用的是匹配表，请从匹配表来源下拉菜单中选择匹配表。
6. 在目标表字段中指定应将报告结果保存到哪个表中。
7. 输入开始日期和结束日期，以确定报告的日期范围。
8. 输入时区。时区应与购买渠道的时区一致。
9. 可选：输入任何参数的值。
10. 点击运行。

查看结果

报告运行完毕后，您可以在“任务”页面上预览结果。您还可以在 BigQuery、Google 表格或数据洞察中浏览数据。

预览

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

BigQuery

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

Google 表格和数据洞察

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