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. Com esse recurso, você pode gerar relatórios focados em eventos de conversão com suporte para 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 você encontra 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.

Finalidade dos relatórios de conversão

Com os relatórios de conversão, é possível analisar a eficácia das suas iniciativas de marketing atribuindo conversões a campanhas, fontes 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 com base 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: priorizam eventos marcados como conversões. Eles usam dimensões e métricas específicas (consulte o esquema de relatórios de conversão) e permitem ver dados atribuídos com base em modelos como atribuição baseada em dados ou último clique.

Ativar relatórios de conversão

Para gerar um relatório de conversão, use o método runReport. 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 objeto conversionSpec contém os seguintes campos:

  • conversionActions: uma lista de nomes de recursos de ação de conversão a serem incluídos no relatório (por exemplo, ["conversionActions/12345"]). Se estiver vazia, todas as conversões serão incluídas. Os IDs de ação de conversão válidos podem ser extraídos do campo conversion_action na lista conversions da 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 método runReport para gerar um relatório de conversão que mostra as conversões por nome da campanha usando o modelo de atribuição baseada em dados.

HTTP

Abrir no API 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 primeiro recuperar as ações de conversão disponíveis para uma propriedade e depois 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: recuperar ações de conversão

Chame o método getMetadata para encontrar os IDs de ação de conversão válidos da sua propriedade. Especifique o ID da propriedade do GA (em vez de usar 0 para receber campos comuns a todas as propriedades) para ver 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 método runReport. Use os IDs de ação de conversão encontrados na etapa 1 para filtrar seu relatório ou deixe conversionActions vazio para gerar um relatório de todas as conversões. Essa solicitação recria um relatório da interface de conversão e performance mostrando cliques e custo de publicidade, custo de publicidade por clique, custo de publicidade por todas as conversões, impressões de anúncio, retorno do investimento em publicidade, receita total e todas as conversões por grupo de canais padrão.

HTTP

Abrir no API 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.