提取實驗的地理區域資料

如要自動或大規模擷取 GeoX 實驗資料，請務必使用 Google Ads API 擷取費用和支出資料。接著，您將這項資料與內部 CRM、銷售點 (POS) 或內部銷售資料庫中未經篩選和歸因的原始轉換或收益資料結合。

建議的 API 工作流程架構

如要依地理區隔準確擷取廣告活動和費用資料，請遵循下列架構：

• 服務：使用 GoogleAdsService，特別是 Search 或 SearchStream 方法。

• 資源：查詢 geographic_view，查看使用者實際所在或感興趣的地點，這通常是 GeoX 實驗的標準。或者，您也可以查詢 location_view，根據廣告活動指定的特定地區查看成效。

  注意： 請勿使用 campaign_location_target_report，因為這個舊版 AdWords API 報表已停用。

• 要納入的欄位：

  • campaign.id
  • segments.date
  • segments.geo_target_city (或區域或國家/地區，視 GeoX 精細程度而定)
  • metrics.cost_micros

• GAQL 查詢範例：對於 GeoX，廣告主會使用 Google Ads API 擷取費用指標，而不是已歸因轉換 (應來自內部客戶關係管理或第三方系統)。您可以使用下列查詢：

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

  注意： geographic_view 只會傳回在指定日期記錄曝光或支出的地理區隔資料列。如要在 GeoX 時間序列中納入零支出的日期和區域，請在資料管道中，對日期和目標區域的完整笛卡爾乘積執行左外部彙整。

注意： 如果您從 Google Ads 擷取轉換指標，則擷取的是已歸因轉換，也就是說，您只會看到 Google 演算法已歸功的銷售。強烈建議不要在 GeoX 中使用歸因資料，因為歸因邏輯會導致因果關係評估結果出現偏差。

後置處理和資料擷取

• 地理區隔對應：API 不會在報表資料檢視中傳回純文字名稱 (例如「紐約」) 或簡短代碼 (例如「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 或尼爾森代碼。

區域類型	必要 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)，而非整數，這樣開頭的零就不會遭到移除。
• 匯總：如果執行多組研究，則必須為每個實驗組提供個別的支出指標。
• 彙整轉換資料：彙整內部客戶關係管理系統或內部銷售資料庫的轉換資料時，請確保轉換資料具備下列屬性，以便與 Google Ads API 資料和 GeoX 順暢處理資料：
  • 每日時間序列：資料必須按日匯總。
  • 地理層級：每筆轉換都必須對應至您測試的確切地理單位 (例如，將客戶的運送郵遞區號與設計中使用的指定行銷區域或郵遞區號群組進行比對)。
  • 總值：資料必須是非負數的絕對值，例如總收益或總轉換次數。如果客戶關係管理系統追蹤淨收益時，退款金額為負值，則必須在實驗中使用總金額，並在之後套用退款比率。