轉換報表基本知識

本指南說明如何使用 Google Analytics Data API 第 1 版的轉換報表功能。這項功能可讓您產生以轉換事件為主的報表，並支援不同的歸因模式。使用 Data API 建立的轉換報表，與 Google Analytics 使用者介面「廣告」>「轉換」部分中的歸因報表類似。詳情請參閱轉換成效報表說明中心文章。

轉換報表用途

轉換報表可將轉換歸因於特定廣告活動、來源和媒介，協助您分析行銷活動的成效。與只會計算事件的標準事件報表不同，轉換報表會套用歸因模式，在促成轉換的接觸點之間分配功勞。

轉換與以事件為準的報表

  • 以事件為準的報表：提供事件的原始計數 (例如 eventCount)，有助於瞭解資源的一般活動。
  • 轉換報表：著重於標示為轉換的事件。這類報表會使用特定維度和指標 (請參閱轉換報表結構定義)，並根據以數據為準或最終點擊等模式，顯示歸因資料。

啟用轉換報表

如要執行轉換報表，請使用 runReport 方法。如果要求查詢一或多個轉換指標 (例如 allConversionsByInteractionDate)，或要求主體中填入 conversionSpec 欄位，系統就會將要求視為轉換報表。

conversionSpec 物件包含下列欄位：

  • conversionActions：要納入報表的轉換動作資源名稱清單 (例如 ["conversionActions/12345"])。如果為空白，系統會納入所有轉換。您可以從 GetMetadata 方法回應的 conversions 清單中，擷取 conversion_action 欄位內的有效轉換動作 ID。
  • attributionModel：要使用的歸因模式。支援的值為 DATA_DRIVEN (預設值) 和 LAST_CLICK。

產生轉換報表

以下是使用 runReport 方法的範例要求，可產生轉換報表，並以以數據為準歸因模式顯示依廣告活動名稱劃分的轉換次數。

HTTP

在 API Explorer 中開啟 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "campaignName"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByConversionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [],
        "attributionModel": "DATA_DRIVEN"
    }
}

範例：重新建立轉換成效報表

這個範例說明如何先擷取資源的可用轉換動作，然後使用這些動作建立類似於「廣告」>「轉換」>「轉換成效」下方Google Analytics 使用者介面中顯示的「轉換成效」報表。

步驟 1：擷取轉換動作

呼叫 getMetadata 方法，找出資源的有效轉換動作 ID。請務必指定 Google Analytics 資源 ID (而非使用 0 取得所有資源通用的欄位)，才能查看為資源建立的轉換動作。

回應會包含 conversions 清單，列出可用的轉換動作：

{
  ...

  "conversions": [
    {
      "conversionAction": "conversionActions/12345",
      "displayName": "purchase"
    },
    {
      "conversionAction": "conversionActions/67890",
      "displayName": "sign_up"
    }
  ]
}

步驟 2：執行報表

呼叫 runReport 方法。 使用步驟 1 中找到的轉換動作 ID 篩選報表，或將 conversionActions 留空，以製作所有轉換的報表。這項要求會顯示廣告點擊次數、廣告費用、單次點擊廣告費用、單次全轉換廣告費用、廣告曝光次數、廣告投資報酬率、總收益和依預設管道群組劃分的所有轉換，藉此重新建立轉換成效使用者介面報表。

HTTP

在 API Explorer 中開啟 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "defaultChannelGroup"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByInteractionDate"
        },
        {
            "name": "advertiserAdCost"
        },
        {
            "name": "advertiserAdCostPerAllConversionsByInteractionDate"
        },
        {
            "name": "advertiserAdImpressions"
        },
        {
            "name": "advertiserAdClicks"
        },
        {
            "name": "advertiserAdCostPerClick"
        },
        {
            "name": "totalRevenueByInteractionDate"
        },
        {
            "name": "returnOnAdSpendByInteractionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [
            "conversionActions/12345"
        ],
        "attributionModel": "DATA_DRIVEN"
    }
}

以下是這項要求的回覆範例：

{
  "dimensionHeaders": [
    {
      "name": "defaultChannelGroup"
    }
  ],
  "metricHeaders": [
    {
      "name": "allConversionsByInteractionDate",
      "type": "TYPE_FLOAT"
    },
    {
      "name": "advertiserAdCost",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "advertiserAdCostPerAllConversionsByInteractionDate",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "advertiserAdImpressions",
      "type": "TYPE_INTEGER"
    },
    {
      "name": "advertiserAdClicks",
      "type": "TYPE_INTEGER"
    },
    {
      "name": "advertiserAdCostPerClick",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "totalRevenueByInteractionDate",
      "type": "TYPE_CURRENCY"
    },
    {
      "name": "returnOnAdSpendByInteractionDate",
      "type": "TYPE_FLOAT"
    }
  ],
  "rows": [
    {
      "dimensionValues": [
        {
          "value": "Paid Search"
        }
      ],
      "metricValues": [
        {
          "value": "75.2"
        },
        {
          "value": "500"
        },
        {
          "value": "6.65"
        },
        {
          "value": "10000"
        },
        {
          "value": "500"
        },
        {
          "value": "1"
        },
        {
          "value": "1500"
        },
        {
          "value": "3"
        }
      ]
    }
  ],
  "rowCount": 1,
  "metadata": {
    "schemaRestrictionResponse": {},
    "currencyCode": "USD",
    "timeZone": "America/Los_Angeles",
    "section": "SECTION_ADVERTISING"
  },
  "kind": "analyticsData#runReport"
}

如要確認回應是否視為轉換報表，請檢查回應中的 metadata.section 欄位是否設為 SECTION_ADVERTISING。

如需轉換報表可用的完整維度和指標清單，請參閱轉換報表結構定義。