提取实验的地理位置数据

如需自动或大规模拉取 GeoX 实验的数据，您必须使用 Google Ads API 拉取费用和支出数据。然后，您将这些数据与来自内部 CRM、销售终端 (POS) 或内部销售数据库的原始、未经过滤且未归因的转化或收入数据相结合。

如需按地理细分准确提取广告系列和费用数据，请遵循以下架构：

  • 服务：使用 GoogleAdsService，特别是 Search 或 SearchStream 方法。

  • 资源：查询 geographic_view，了解用户实际所处的位置或感兴趣的位置，这通常是 GeoX 实验的标准。或者，查询 location_view，根据广告系列定位到的特定地理位置查看效果。

  • 要包含的字段：

  • GAQL 查询示例：对于 GeoX，广告客户使用 Google Ads API 提取费用指标，而不是已归因的转化（应来自内部 CRM 或第三方系统）。您可以使用以下查询：

    SELECT
  campaign.id,
  segments.date,
  segments.geo_target_city,
  metrics.cost_micros
FROM geographic_view
WHERE segments.date DURING LAST_30_DAYS

后处理和数据提取

  • 地理位置细分映射：该 API 不会在报告数据视图中返回纯文本名称（例如“New York”）或短代码（例如“501”或“ES”）。segments.geo_target_city 或 segments.geo_target_country 等字段会返回指向 GeoTargetConstant 的资源名称字符串（例如 geoTargetConstants/1023191）。提取数字 ID (1023191) 并查询 geo_target_constant 资源：

    SELECT
  geo_target_constant.id,
  geo_target_constant.name,
  geo_target_constant.canonical_name
FROM geo_target_constant
WHERE geo_target_constant.id = 1023191

    或者，如需在代码中本地执行联接，请在地理位置定位目标中下载静态地理位置定位目标 CSV 文件。

  • 费用换算：API 会以微单位返回费用值。您必须将 metrics.cost_micros 除以 1,000,000，才能输出上传文件中所需的标准币种值。

用于定位变更的地理位置 ID

在执行广告系列或广告组地理位置定位更改时，广告客户必须查找并传递所选区域的确切 GeoTargetConstant ID (geoTargetConstants/ID)。您无法传递原始 ISO 或 Nielsen 代码。

区域类型 所需的 API ID (GeoTargetConstant) 旧版格式（请勿使用）
DMA 区域 ID 200501（纽约） Nielsen 代码（例如，501 表示纽约）
国家/地区 ID 2724（西班牙） ISO 代码（例如，西班牙为 "ES"）

最佳实践和常见格式错误

  • 日期格式：segments.date 字段会返回采用 YYYY-MM-DD 格式的 ISO-8601 日期字符串。在 ETL 流水线中，将日期字段显式序列化为 YYYY-MM-DD 字符串，并避免在自动重新设置日期列格式的电子表格应用中打开导出的 CSV 文件。
  • 邮政编码中的前导零：在整个数据流水线中，将邮政编码（例如 01234）视为字符串类型（VARCHAR 或 STRING）而不是整数，这样前导零就不会被去除。
  • 汇总：如果开展多实验组研究，您必须为每个处理组提供单独的支出指标。
  • 联接转化数据：与内部 CRM 系统或内部销售数据库中的转化数据联接时，请确保转化数据具有以下属性，以确保与 Google Ads API 数据和 GeoX 进行无缝数据处理：
    • 每日时间序列：数据必须按天汇总。
    • 地理位置级别：每项转化都必须映射到您正在测试的确切地理位置单位（例如，将客户的送货邮政编码与设计中使用的特定媒体市场区域或邮政编码集群进行匹配）。
    • 总值：数据必须是非负绝对值，例如总收入或总转化次数。如果您的 CRM 系统使用负值来跟踪退款，您必须在实验中使用总收入，并在之后应用退款率。
上一页
报告
下一页
异步错误