转化报告基本信息

本指南介绍了如何使用 Google Analytics Data API v1 中的转化报告功能。借助此功能，您可以生成专注于转化事件的报告，并支持不同的归因模型。 使用 Data API 创建的转化报告与您在 广告 > 转化 部分找到的归因 报告类似。如需了解详情，请参阅转化效果报告 帮助中心文章。

转化报告的用途

转化报告提供了一种分析营销工作效果的方法，即将转化归因于特定的广告系列、来源和媒介。与仅统计事件的标准事件型报告不同，转化报告会应用归因模型，在促成转化的各个接触点之间分配功劳。

转化报告与事件型报告

  • 事件型报告：提供事件的原始计数（例如 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。请务必指定 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 来验证响应是否被视为转化报告。

如需查看转化报告的可用维度和指标的完整列表， 请参阅转化报告架构。