Conceptos básicos sobre los informes de conversiones

En esta guía, se explica cómo usar la funcionalidad de informes de conversiones en la versión 1 de la API de Google Analytics Data. Esta función te permite generar informes enfocados en eventos de conversión con compatibilidad para diferentes modelos de atribución. Los informes de conversiones creados con la API de Data son similares a los informes de atribución que puedes encontrar en la sección Publicidad > Conversiones de la IU de Google Analytics. Para obtener más información, consulta el artículo del Centro de ayuda sobre el informe de rendimiento de las conversiones.

Propósito de los informes de conversiones

Los informes de conversiones proporcionan una forma de analizar la eficacia de tus esfuerzos de marketing atribuyendo las conversiones a campañas, fuentes y medios específicos. A diferencia de los informes estándar basados en eventos que solo cuentan eventos, los informes de conversiones aplican un modelo de atribución para distribuir el crédito entre los puntos de contacto que llevaron a una conversión.

Comparación entre los informes de conversiones y los informes basados en eventos

  • Informes basados en eventos: Proporcionan recuentos sin procesar de eventos (p.ej., eventCount) y son útiles para comprender la actividad general de tu propiedad.
  • Informes de conversiones: Se enfocan en los eventos que se marcaron como conversiones. Utilizan dimensiones y métricas específicas (consulta el esquema de los informes de conversiones) y te permiten ver datos atribuidos según modelos como Basado en datos o Último clic.

Cómo habilitar los informes de conversiones

Para ejecutar un informe de conversiones, usa el runReport método. Una solicitud se trata como un informe de conversiones si consulta una o más métricas de conversiones (por ejemplo, allConversionsByInteractionDate) o si el campo conversionSpec se completa en el cuerpo de la solicitud.

El conversionSpec objeto contiene los siguientes campos:

  • conversionActions: Es una lista de nombres de recursos de acciones de conversión para incluir en el informe (p.ej., ["conversionActions/12345"]). Si está vacío, se incluyen todas las conversiones. Los IDs de acciones de conversión válidos se pueden recuperar del campo conversion_action dentro de la lista conversions en la respuesta del método GetMetadata.
  • attributionModel: Es el modelo de atribución que se usará. Los valores admitidos son DATA_DRIVEN (predeterminado) y LAST_CLICK.

Cómo generar un informe de conversiones

A continuación, se muestra una solicitud de ejemplo en la que se usa el runReport método para generar un informe de conversiones que muestra las conversiones por nombre de campaña con el modelo de atribución Basado en datos.

HTTP

Abrir en el Explorador de API 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "campaignName"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByConversionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [],
        "attributionModel": "DATA_DRIVEN"
    }
}

Ejemplo: Cómo volver a crear un informe de rendimiento de las conversiones

En este ejemplo, se muestra cómo recuperar primero las acciones de conversión disponibles para una propiedad y, luego, usarlas para crear un informe similar al informe de rendimiento de las conversiones que se muestra en la IU de Google Analytics en Publicidad > Conversiones > Rendimiento de las conversiones.

Paso 1: Recupera las acciones de conversión

Llama al getMetadata método para encontrar los IDs de acciones de conversión válidos para tu propiedad. Asegúrate de especificar el ID de propiedad de GA (en lugar de usar 0 para obtener campos comunes para todas las propiedades) para ver las acciones de conversión creadas para tu propiedad.

La respuesta contiene una lista conversions con las acciones de conversión disponibles:

{
  ...

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

Paso 2: Ejecuta el informe

Llama al runReport método. Usa los IDs de acciones de conversión que se encontraron en el paso 1 para filtrar tu informe o deja conversionActions vacío para generar informes sobre todas las conversiones. Esta solicitud vuelve a crear un informe de la IU de rendimiento de las conversiones mostrando los clics en publicidad, el costo de publicidad, el costo de publicidad por clic, el costo de publicidad por todas las conversiones, las impresiones de publicidad, el retorno de la inversión publicitaria, los ingresos totales y todas las conversiones por grupo de canales predeterminado.

HTTP

Abrir en el Explorador de API 
{
    "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"
    }
}

A continuación, se muestra una respuesta de ejemplo para esta solicitud:

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

Para verificar que la respuesta se trató como un informe de conversiones, comprueba que el campo metadata.section de la respuesta esté configurado como SECTION_ADVERTISING.

Para obtener una lista completa de las dimensiones y métricas disponibles para los informes de conversiones, consulta el esquema de los informes de conversiones.