> [!NOTE]
> **Note:** This functionality is only available in the [v1alpha version of the Data API](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1alpha/properties/runReport).

> [!CAUTION]
> **Caution:** This feature may not be available to your Google Analytics property. The Google Analytics team is actively working to expand this feature to more properties. Reach out to your [support team](https://support.google.com/analytics/gethelp) if you have questions about the eligibility of your property.

This guide explains how to use the conversion reporting functionality in the
Google Analytics Data API v1. This feature lets you generate reports
focused on conversion events with support for different attribution models.
Conversion reports created with the Data API are similar to the attribution
reports you can find in the **Advertising \> Conversions** section of the
[Google Analytics UI](https://analytics.google.com/analytics/web/). For more
information, see the [Conversion performance report](https://support.google.com/analytics/answer/14715749)
help center article.

## Purpose of conversion reporting

Conversion reporting provides a way to analyze the effectiveness of your
marketing efforts by attributing conversions to specific campaigns, sources, and
mediums. Unlike standard event-based reports that only count events,
conversion reporting applies an attribution model to distribute credit among
the touchpoints that led to a conversion.

## Conversions versus event-based reports

- **Event-based reports** : Provide raw counts of events (e.g., `eventCount`) and are useful for understanding general activity on your property.
- **Conversions reports** : Focus on events that have been marked as conversions. They use specific dimensions and metrics (see the [Conversion Reports Schema](https://developers.google.com/analytics/devguides/reporting/data/v1/conversions-api-schema)) and allow you to see attributed data based on models like Data-driven or Last click.

## Enable conversion reports

To run a conversion report, use the
[`runReport`](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1alpha/properties/runReport)
method. A request is treated as a conversion report if it queries one or more
[conversion metrics](https://developers.google.com/analytics/devguides/reporting/data/v1/conversions-api-schema#metrics) (for example,
`allConversionsByInteractionDate`), or if the
`conversionSpec` field is populated in the request body.

The [`conversionSpec`](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1alpha/properties/runReport#ConversionSpec)
object contains the following fields:

- `conversionActions`: A list of conversion action resource names to include in the report (e.g., `["conversionActions/12345"]`). If empty, all conversions are included. Valid conversion action IDs can be retrieved from the `conversion_action` field within the `conversions` list in the response of the `GetMetadata` method.
- `attributionModel`: The attribution model to use. Supported values are `DATA_DRIVEN` (default) and `LAST_CLICK`.

## Generate a conversion report

Here's a sample request using the [`runReport`](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1alpha/properties/runReport)
method to generate a conversion report showing conversions by
campaign name using the Data-driven attribution model.

### HTTP


[Open in API Explorer](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1alpha/properties/runReport?apix=true&apix_params=%0A%7B%22resource%22:%7B%22dateRanges%22:+%5B%7B%22startDate%22:+%222026-04-01%22,+%22endDate%22:+%222026-04-30%22%7D%5D,+%22dimensions%22:+%5B%7B%22name%22:+%22campaignName%22%7D%5D,+%22metrics%22:+%5B%7B%22name%22:+%22allConversionsByConversionDate%22%7D%5D,+%22conversionSpec%22:+%7B%22conversionActions%22:+%5B%5D,+%22attributionModel%22:+%22DATA_DRIVEN%22%7D%7D%7D "Open this sample in API Explorer")

```json
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "campaignName"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByConversionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [],
        "attributionModel": "DATA_DRIVEN"
    }
}
```

<br />

## Example: Re-create a conversion performance report

This example demonstrates how to first retrieve the available conversion actions
for a property and then use them to create a report similar to the Conversion
Performance report shown in the [Google Analytics UI](https://analytics.google.com/analytics/web/)
under **Advertising \> Conversions \> Conversion performance**.

### Step 1: Retrieve conversion actions

Call the
[`getMetadata`](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1alpha/properties/getMetadata?apix_params=%7B%22name%22:%22properties/YOUR_GA_PROPERTY_ID/metadata%22%7D)
method to find the valid conversion action IDs for your property. Make sure
to specify the GA property ID (instead of using `0` to get fields common for
all properties) in order to see conversion actions created for your property.

The response contains a `conversions` list with the available conversion
actions:

    {
      ...

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

### Step 2: Run the report

Call the [`runReport`](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1alpha/properties/runReport) method.
Use the conversion action IDs found in Step 1 to filter your report, or leave
`conversionActions` empty to report on all conversions. This request recreates a
Conversion Performance UI report by showing advertising clicks, ad cost, ad cost
per click, ad cost per all conversions, ad impressions, return on ad spend,
total revenue, and all conversions by default channel group.

### HTTP


[Open in API Explorer](https://developers.google.com/analytics/devguides/reporting/data/v1/rest/v1alpha/properties/runReport?apix=true&apix_params=%0A%7B%22resource%22:%7B%22dateRanges%22:+%5B%7B%22startDate%22:+%222026-04-01%22,+%22endDate%22:+%222026-04-30%22%7D%5D,+%22dimensions%22:+%5B%7B%22name%22:+%22defaultChannelGroup%22%7D%5D,+%22metrics%22:+%5B%7B%22name%22:+%22allConversionsByInteractionDate%22%7D,+%7B%22name%22:+%22advertiserAdCost%22%7D,+%7B%22name%22:+%22advertiserAdCostPerAllConversionsByInteractionDate%22%7D,+%7B%22name%22:+%22advertiserAdImpressions%22%7D,+%7B%22name%22:+%22advertiserAdClicks%22%7D,+%7B%22name%22:+%22advertiserAdCostPerClick%22%7D,+%7B%22name%22:+%22totalRevenueByInteractionDate%22%7D,+%7B%22name%22:+%22returnOnAdSpendByInteractionDate%22%7D%5D,+%22conversionSpec%22:+%7B%22conversionActions%22:+%5B%22conversionActions/12345%22%5D,+%22attributionModel%22:+%22DATA_DRIVEN%22%7D%7D%7D "Open this sample in API Explorer")

```json
{
    "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"
    }
}
```

<br />

Here is a sample response for this request:

    {
      "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"
    }

You can verify that the response was treated as a conversion report by
checking that `metadata.section` field in the response is set to
`SECTION_ADVERTISING`.

For a full list of available dimensions and metrics for conversion reports,
refer to the [Conversion Reports Schema](https://developers.google.com/analytics/devguides/reporting/data/v1/conversions-api-schema).