Noções básicas sobre relatórios de conversão

Este guia explica como usar a funcionalidade de relatórios de conversão na API Google Analytics Data v1. Esse recurso permite gerar relatórios focados em eventos de conversão com suporte a diferentes modelos de atribuição. Os relatórios de conversão criados com a API Data são semelhantes aos relatórios de atribuição que podem ser encontrados na seção Publicidade > Conversões da interface do Google Analytics. Para mais informações, consulte o artigo da Central de Ajuda sobre o relatório de performance de conversões.

Objetivo dos relatórios de conversão

Os relatórios de conversão oferecem uma maneira de analisar a eficácia dos seus esforços de marketing, atribuindo conversões a campanhas, origens e mídias específicas. Ao contrário dos relatórios padrão baseados em eventos que apenas contam eventos, os relatórios de conversão aplicam um modelo de atribuição para distribuir o crédito entre os pontos de contato que levaram a uma conversão.

Conversões x relatórios baseados em eventos

  • Relatórios baseados em eventos: fornecem contagens brutas de eventos (por exemplo, eventCount) e são úteis para entender a atividade geral na sua propriedade.
  • Relatórios de conversões: focam em eventos que foram marcados como conversões. Eles usam dimensões e métricas específicas (consulte o esquema de relatórios de conversão) e permitem que você veja dados atribuídos com base em modelos como o baseado em dados ou o de último clique.

Ativar relatórios de conversão

Para gerar um relatório de conversão, use o runReport método. Uma solicitação é tratada como um relatório de conversão se consultar uma ou mais métricas de conversão (por exemplo, allConversionsByInteractionDate) ou se o campo conversionSpec for preenchido no corpo da solicitação.

O conversionSpec objeto contém os seguintes campos:

  • conversionActions: uma lista de nomes de recursos de ações de conversão a serem incluídos no relatório (por exemplo, ["conversionActions/12345"]). Se estiver vazio, todas as conversões serão incluídas. Os IDs de ações de conversão válidos podem ser extraídos do campo conversion_action na lista conversions na resposta do método GetMetadata.
  • attributionModel: o modelo de atribuição a ser usado. Os valores aceitos são DATA_DRIVEN (padrão) e LAST_CLICK.

Gerar um relatório de conversão

Confira um exemplo de solicitação usando o runReport método para gerar um relatório de conversão que mostra as conversões por nome da campanha usando o modelo de atribuição baseado em dados.

HTTP

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

Exemplo: recriar um relatório de performance de conversões

Este exemplo demonstra como extrair as ações de conversão disponíveis para uma propriedade e usá-las para criar um relatório semelhante ao de performance de conversões mostrado na interface do Google Analytics em Publicidade > Conversões > Performance de conversões.

Etapa 1: extrair ações de conversão

Chame o getMetadata método para encontrar os IDs de ações de conversão válidos para sua propriedade. Especifique o ID da propriedade do GA (em vez de usar 0 para receber campos comuns a todas as propriedades) para conferir as ações de conversão criadas para sua propriedade.

A resposta contém uma lista conversions com as ações de conversão disponíveis:

{
  ...

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

Etapa 2: gerar o relatório

Chame o runReport método. Use os IDs de ações de conversão encontrados na etapa 1 para filtrar o relatório ou deixe conversionActions vazio para gerar relatórios sobre todas as conversões. Essa solicitação recria um relatório de performance de conversões da interface mostrando cliques em anúncios, custo do anúncio, custo do anúncio por clique, custo do anúncio por todas as conversões, impressões de anúncios, retorno do investimento em publicidade, receita total e todas as conversões por grupo de canais padrão.

HTTP

Abrir no APIs Explorer 
{
    "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"
    }
}

Confira um exemplo de resposta para essa solicitação:

{
  "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 se a resposta foi tratada como um relatório de conversão, confira se o campo metadata.section na resposta está definido como SECTION_ADVERTISING.

Para uma lista completa de dimensões e métricas disponíveis para relatórios de conversão, consulte o esquema de relatórios de conversão.