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

Neste guia, explicamos 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 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.

Objetivo dos relatórios de conversão

Os relatórios de conversão oferecem uma maneira de analisar a eficácia das suas iniciativas 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: se concentram 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 "Baseado 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 estiver preenchido no corpo da solicitação.

O objeto conversionSpec 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ção de conversão válidos podem ser recuperados no campo conversion_action na lista conversions na resposta do método GetMetadata.
  • attributionModel: o modelo de atribuição a ser usado. Os valores compatíveis são DATA_DRIVEN (padrão) e LAST_CLICK.

Gerar um relatório de conversão

Veja um exemplo de solicitação que usa o método runReport para gerar um relatório de conversão que mostra as conversões por nome de campanha usando o modelo de atribuição baseada 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 recuperar as ações de conversão disponíveis para uma propriedade e usá-las para criar um relatório semelhante ao Relatório de performance de conversão mostrado na interface do Google Analytics em Publicidade > Conversões > Performance de conversão.

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

Chame o método getMetadata para encontrar os IDs da ação 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 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 das ações de conversão encontrados na Etapa 1 para filtrar seu relatório ou deixe conversionActions vazio para gerar um relatório sobre todas as conversões. Essa solicitação recria um relatório de UI de performance de conversão mostrando cliques em publicidade, custo de publicidade, custo de publicidade por clique, custo de publicidade 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"
    }
}

Veja 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 ver uma lista completa das dimensões e métricas disponíveis para relatórios de conversão, consulte o esquema de relatórios de conversão.