轉換報表基本知識

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

轉換報表用途

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

轉換與事件報表

  • 事件報表：提供事件的原始計數 (例如 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 UI 中「廣告」>「轉換」>「轉換成效」下方的「轉換成效」報表。

步驟 1：擷取轉換動作

呼叫 getMetadata 方法，找出資源的有效轉換動作 ID。請務必指定 GA 資源 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，確認回應是否視為轉換報表。

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