提取實驗的地理區域資料

如要自動或大規模擷取 GeoX 實驗資料，請務必使用 Google Ads API 擷取費用和支出資料。然後，將這項資料與來自內部顧客關係管理系統、銷售點 (POS) 或內部銷售資料庫的原始、未經過濾且未歸因的轉換或收益資料合併。

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

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

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

  • 要納入的欄位：

  • 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

後續處理和資料擷取

  • 地理區隔對應：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 能順利處理資料：
    • 每日時間序列：資料必須按天彙整。
    • 地理區域層級：每項轉換都必須對應至您測試的確切地理區域單位 (例如，將顧客的運送郵遞區號與設計中使用的指定行銷區域或郵遞區號群組相符)。
    • 總值：資料必須為非負數的絕對值，例如總收益或總轉換次數。如果客戶關係管理系統追蹤淨收益時，退款金額為負值，請務必在實驗中使用總收益，並在之後套用退款比率。
上一頁
報表
下一頁
非同步錯誤