Conceptos básicos sobre los informes de conversiones

En esta guía, se explica cómo usar la funcionalidad de registro 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 con diferentes modelos de atribución. Los informes de conversiones creados con la API de datos 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 del registro 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 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.

Informes de conversiones en comparación con 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. Usan dimensiones y métricas específicas (consulta el esquema de 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 trata como un informe de conversiones si consulta una o más métricas de conversión (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 que se incluirán 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 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 que usa el método runReport para generar un informe de conversiones que muestra las conversiones por nombre de campaña con el modelo de atribución basada en datos.

HTTP

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

Ejemplo: Vuelve a crear un informe de rendimiento de 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 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 método getMetadata para encontrar los IDs de acciones 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 de 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 acciones de conversión que encontraste 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, ya que muestra los clics en anuncios, el costo de los anuncios, el costo de los anuncios por clic, el costo de los anuncios por todas las conversiones, las impresiones de anuncios, el retorno de la inversión publicitaria, los ingresos totales y todas las conversiones por grupo de canales predeterminado.

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

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

Puedes verificar que la respuesta se haya tratado como un registro de conversiones comprobando 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 informes de conversiones.