编写和运行查询

创建查询

  1. 前往广告数据中心内的查询标签页。
  2. 点击 + 创建查询。此时系统会打开分析查询模板页面。
  3. 可选:点击 展开,预览模板 SQL。
  4. 点击使用模板,选择想要使用的模板;或点击空白,从头开始创建报告。
  5. 为报告输入一个名称。
  6. 使用与 BigQuery 兼容的 SQL 编写或修改查询。您可以从 Google 表格标签页中查找可用的表和字段,然后将其插入您的 SQL。
  7. 可选:配置参数
  8. 可选:配置被滤除的行摘要
  9. 点击保存

参数

参数可让查询更加灵活。例如,您可能希望针对不同的广告系列运行同一查询。您可以配置一个参数,以接受您运行查询时从“运行”卡片输入的一个或多个广告系列 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

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

被滤除的行摘要

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

修改查询

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

运行查询

在运行查询之前,请确保您已针对将包含联接输出的数据集向服务账号授予了 dataEditor 权限。详细了解 BigQuery 中的访问权限控制

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

查看结果

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

预览

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

BigQuery

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

Google 表格和数据洞察

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