创建查询
- 前往广告数据中心内的查询标签页。
- 点击 + 创建查询。此时系统会打开分析查询模板页面。
- 可选:点击 展开,预览模板 SQL。
- 点击使用模板,选择想要使用的模板;或点击空白,从头开始创建报告。
- 为报告输入一个名称。
- 使用与 BigQuery 兼容的 SQL 编写或修改查询。您可以从 Google 表格标签页中查找可用的表和字段,然后将其插入您的 SQL。
- 可选:配置参数。
- 可选:配置被滤除的行摘要。
- 点击保存。
参数
参数可让查询更加灵活。例如,您可能希望针对不同的广告系列运行同一查询。您可以配置一个参数,以接受您运行查询时从“运行”卡片输入的一个或多个广告系列 ID,而不是进行重复查询或在每次执行前对广告系列 ID 进行硬编码。使用参数可让代码保持简洁,减少编辑时引入错误的可能性,并让您的查询无需编辑即可重复使用。参数的范围限定为创建参数的查询,因此您可以在其他查询中重复使用参数名称。
参数类型
允许使用以下类型的参数:
int64
float64
bool
string
date
timestamp
- 所允许的上述任何类型的
array
创建参数
- 打开已保存的查询,或创建新的查询。
- 依次点击属性 > 参数 > 添加参数。
- 在名称字段中输入一个名称。您将使用此名称在查询文本中引用参数。
- 使用下拉菜单选择参数类型。
- 如果您选择“array”,系统随即会显示一个额外的下拉菜单。从该下拉菜单中选择数组类型。
- 可选:重复第 2-4 步,直到添加完所需的所有参数。
- 点击“保存”
使用参数
在查询文本中,使用标准 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
运行查询时,新建作业对话框将包含参数字段。为您定义的每个参数输入值。
移除参数
- 打开具有您要删除的参数的查询。
- 打开属性标签页。
- 在参数卡片中,点击您要删除的参数旁边的删除。
- 点击“保存”。
预留的参数
下表列出了广告数据中心预留的参数。您可以在查询中使用这些参数,但不能创建与预留参数同名的参数。
start_date
|
date
查询作业的开始日期(含此日期)。系统会忽略用户以此名称定义的参数,并替换为新建作业对话框中设置的值。 |
end_date
|
date
查询作业的结束日期(含此日期)。系统会忽略用户以此名称定义的参数,并替换为新建作业对话框中设置的值。 |
time_zone
|
string
查询作业的时区。系统会忽略用户以此名称定义的参数,并替换为新建作业对话框中设置的值。 |
被滤除的行摘要
被滤除的行摘要会统计因隐私权检查而被滤除的数据。系统会对被滤除的行中的数据求和,并将结果添加到一个汇总行中。虽然无法对被滤除的数据进行进一步分析,但可以大致了解从结果中滤除了多少数据。
修改查询
- 前往广告数据中心内的查询标签页。
- 点击要修改的查询的名称。
- 修改查询。
- 点击保存。
运行查询
在运行查询之前,请确保您已针对将包含联接输出的数据集向服务账号授予了 dataEditor
权限。详细了解 BigQuery 中的访问权限控制。
- 前往广告数据中心内的查询标签页。
- 点击要运行的查询的名称。
- 点击运行图标
- 页面顶部会显示查询预计会使用的字节数。
。
- 从广告数据来源下拉菜单中选择一个 ID。这应该是与您要查询的广告数据相关联的广告数据来源 ID。(如果您想查询沙盒数据,请选择广告数据中心沙盒客户。)
- 如果使用的是匹配表,请从匹配表来源下拉菜单中选择匹配表。
- 在目标表字段中指定应将查询结果保存到哪个表中。
- 输入开始日期和结束日期,以确定查询的日期范围。
- 输入时区。时区应与购买渠道的时区一致。
- 可选:输入任何参数的值。
- 点击运行。
查看结果
查询运行完毕后,您可以在“任务”页面上预览结果。您还可以在 BigQuery、Google 表格或数据洞察中浏览数据。
预览
在已完成的作业中,点击预览。前 20 项结果将显示在作业下方。
BigQuery
默认情况下,您的结果会导出到 BigQuery。点击查看表格可在新窗口中打开 BigQuery。
Google 表格和数据洞察
打开探索下拉菜单,然后从选项中选择使用表格或使用数据洞察。系统随即会在新窗口显示数据。