提取實驗的地理區域資料

如要自動或大規模提取 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 不會在報表檢視畫面中傳回純文字名稱 (例如「紐約」) 或簡短代碼 (例如「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，才能輸出上傳檔案中所需的標準貨幣值。

指定代碼 (指定行銷區域和國家/地區)

執行指定目標突變時，廣告主必須查詢並傳遞所選區域的確切 GeoTargetConstant ID。您無法傳遞原始 ISO 或 Nielsen 代碼。

區域類型 必要 API ID (GeoTargetConstant) 舊版格式 (請勿使用)
指定行銷區域 ID 200501 (紐約) 尼爾森代碼 (例如紐約為 501)
國家/地區 ID 2724 (適用於西班牙) ISO 代碼 (例如西班牙的 "ES")

最佳做法和常見格式錯誤

  • 日期格式：segments.date 欄位會以 YYYY-MM-DD 格式傳回資料。Excel 等試算表應用程式通常會自動變更日期格式。請先將檔案上傳至 Google 試算表，確保系統能以正確的YYYY-MM-DD格式讀取日期範圍。
  • 開頭的零：請確保郵遞區號開頭的零 (例如 01234) 不會遭到捨棄。在 Google 試算表中使用「自訂數字格式」，強制使用 5 位數的字串。
  • 匯總：如果執行多格研究，您必須為每個實驗組提供個別的支出指標。
  • 加入轉換資料：加入內部 CRM 系統或內部銷售資料庫的轉換資料時，請確保轉換資料具有下列屬性，以便順暢處理 Google Ads API 資料和 GeoX 資料：
    • 每日時間序列：資料必須按天匯總。
    • 地理區域層級：每項轉換都必須對應至您測試的確切地理區域單位 (例如，將顧客的運送郵遞區號與設計中使用的指定行銷區域或郵遞區號群組相符)。
    • 總值：資料必須為非負數的絕對值，例如總收益或總轉換次數。如果貴商家 CRM 追蹤的淨收益包含退款的負值，您必須在實驗中使用總收益，並在稍後套用退款比率。