Conceptos básicos sobre los informes de conversiones

En esta guía, se explica cómo usar la función de informes de conversiones en la API de Google Analytics Data v1. Esta función te permite generar informes enfocados en los 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 te permiten analizar la efectividad de tus iniciativas de marketing, ya que atribuyen las conversiones a campañas, fuentes y medios específicos. A diferencia de los informes estándar basados en eventos, que solo registran eventos, los informes de conversiones aplican un modelo de atribución para distribuir el crédito entre los puntos de contacto que generaron 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 en 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 los datos atribuidos según modelos como el basado en datos o el de último clic.

Habilita los informes de conversiones

Para ejecutar un informe de conversiones, usa el método runReport. Una solicitud se considera 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 objeto conversionSpec 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ía, 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.

Genera un informe de conversiones

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

HTTP

Abrir en el Explorador de APIs 
{
    "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 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 método getMetadata para encontrar los IDs de acción de conversión válidos para tu propiedad. Asegúrate de especificar el ID de la propiedad de GA (en lugar de usar 0 para obtener los campos comunes a 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 método runReport. Usa los IDs de acción de conversión que se encuentran en el paso 1 para filtrar tu informe o deja conversionActions vacío para generar informes sobre todas las conversiones. Esta solicitud recrea un informe de la IU de Rendimiento de las conversiones mostrando los clics en anuncios, el costo del anuncio, el costo por clic del anuncio, el costo del anuncio por todas las conversiones, las impresiones del anuncio, 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 APIs 
{
    "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 haya tratado como un informe de conversiones, comprueba que el campo metadata.section de la respuesta esté establecido en 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.