本指南介绍了如何使用 Google Analytics Data API v1 中的转化报告功能。借助此功能，您可以生成侧重于转化事件的报告，并支持不同的归因模型。使用 Data API 创建的转化报告与您在 Google Analytics 界面的广告 > 转化部分中找到的归因报告类似。如需了解详情，请参阅“转化效果”报告帮助中心文章。
转化报告的用途
通过转化报告，您可以将转化归因于特定广告系列、来源和媒介，从而分析营销工作的成效。与仅统计事件的标准事件报告不同，转化报告会应用归因模型，在促成转化的各个接触点之间分配功劳。
转化报告与基于事件的报告
- 基于事件的报告：提供事件的原始计数（例如
eventCount），有助于了解媒体资源上的总体活动情况。 - “转化”报告：侧重于已标记为转化的事件。它们使用特定的维度和指标（请参阅转化报告架构），并允许您根据以数据为依据的归因模型或最终点击归因模型等查看归因数据。
启用转化报告
如需运行转化报告，请使用 runReport 方法。如果请求查询一个或多个转化指标（例如 allConversionsByInteractionDate），或者请求正文中填充了 conversionSpec 字段，则该请求会被视为转化报告。
conversionSpec 对象包含以下字段：
conversionActions：要纳入报告中的转化操作资源名称的列表（例如["conversionActions/12345"]）。如果为空，则纳入所有转化。有效的转化操作 ID 可从GetMetadata方法的响应中conversions列表内的conversion_action字段检索。attributionModel：要使用的归因模型。支持的值为DATA_DRIVEN（默认值）和LAST_CLICK。
生成转化报告
以下是一个示例请求，该请求使用 runReport 方法生成转化报告，其中显示了按广告系列名称划分的转化次数（使用以数据为依据的归因模型）。
HTTP
{ "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
{ "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，以验证相应响应是否被视为转化报告。
如需查看转化报告的可用维度和指标的完整列表，请参阅转化报告架构。