提取实验的地理位置数据

如需针对 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）。开发者可以直接查询 geo_target_constant 表：

    SELECT geo_target_constant.canonical_name
FROM geo_target_constant
WHERE geo_target_constant.resource_name = 'geoTargetConstants/{extracted_id}'

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

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

定位代码（DMA 和国家/地区）

执行定位突变时，广告客户必须查找并传递所选区域的确切 GeoTargetConstant ID。您无法传递原始 ISO 或 Nielsen 代码。

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

最佳实践和常见格式错误

  • 日期格式： segments.date 字段以 YYYY-MM-DD 格式返回数据。Excel 等电子表格应用通常会自动更改日期格式。请先将文件上传到 Google 表格，以确保系统以所需的 YYYY-MM-DD 格式准确读取日期范围。
  • 前导零： 确保邮政编码中的前导零（例如 01234）不会被舍弃。在 Google 表格中使用“自定义数字格式”强制使用 5 位数字符串。
  • 汇总： 如果要进行多单元格研究，您必须为每个实验组提供单独的支出指标。
  • 联接转化数据： 与来自内部 CRM 系统或内部销售数据库的转化数据联接时，请确保转化数据具有以下属性，以确保与 Google Ads API 数据和 GeoX 进行无缝数据处理：
    • 每日时间序列： 数据必须按天汇总。
    • 地理位置级别： 每次转化都必须映射到您正在测试的确切地理位置单元（例如，将客户的送货邮政编码与设计中使用的 DMA 或邮政编码集群进行匹配）。
    • 总值： 数据必须是非负的绝对值，例如总收入或总转化次数。如果您的 CRM 跟踪净收入，并使用负值表示退款，则必须使用实验的总值，并在稍后应用退款比率。