Основы отчетов о конверсиях

В этом руководстве рассказывается, как использовать функции регистрации конверсий в Google Analytics Data API (версия 1). Эта функция позволяет создавать отчеты, ориентированные на события-конверсии, с поддержкой разных моделей атрибуции. Отчеты о конверсиях, созданные с помощью Data API, похожи на отчеты об атрибуции, которые можно найти в разделе Реклама > Конверсии интерфейса Google Аналитики. Подробнее об отчете "Эффективность конверсий"…

Зачем нужны отчеты о конверсиях

Отчеты о конверсиях позволяют анализировать эффективность маркетинговых усилий, относя конверсии к определенным кампаниям, источникам и каналам. В отличие от стандартных отчетов на основе событий, в которых учитываются только события, в отчетах о конверсиях применяется модель атрибуции, чтобы распределить ценность между точками взаимодействия, которые привели к конверсии.

Отчеты о конверсиях и отчеты на основе событий

  • Отчеты на основе событий содержат необработанные данные о количестве событий (например, eventCount) и помогают понять общую активность в ресурсе.
  • Отчеты о конверсиях содержат данные о событиях, отмеченных как конверсии. В них используются определенные параметры и показатели (см. схему отчетов о конверсиях) и можно просматривать данные атрибуции на основе таких моделей, как "На основе данных" или "Последний клик".

Как включить отчеты о конверсиях

Чтобы создать отчет о конверсиях, используйте метод runReport. Запрос считается отчетом о конверсиях, если он содержит запрос на один или несколько показателей конверсий (например, allConversionsByInteractionDate) или если в теле запроса заполнено поле conversionSpec.

Объект conversionSpec содержит следующие поля:

  • conversionActions – список названий ресурсов действий-конверсий, которые нужно включить в отчет (например, ["conversionActions/12345"]). Если список пуст, в отчет будут включены все конверсии. Действительные идентификаторы действий-конверсий можно получить из поля conversion_action в списке conversions в ответе метода GetMetadata.
  • attributionModel – модель атрибуции, которую нужно использовать. Допустимые значения: DATA_DRIVEN (по умолчанию) и LAST_CLICK.

Как создать отчет о конверсиях

Ниже приведен пример запроса с использованием метода runReport для создания отчета о конверсиях, в котором конверсии сгруппированы по названию кампании с помощью модели атрибуции на основе данных.

HTTP

Открыть в API Explorer 
{
    "dateRanges": [
        {
            "startDate": "2026-04-01",
            "endDate": "2026-04-30"
        }
    ],
    "dimensions": [
        {
            "name": "campaignName"
        }
    ],
    "metrics": [
        {
            "name": "allConversionsByConversionDate"
        }
    ],
    "conversionSpec": {
        "conversionActions": [],
        "attributionModel": "DATA_DRIVEN"
    }
}

Пример: как воссоздать отчет об эффективности конверсий

В этом примере показано, как сначала получить доступные действия-конверсии для ресурса, а затем использовать их для создания отчета, похожего на отчет "Эффективность конверсий", который можно найти в интерфейсе Google Аналитики в разделе Реклама > Конверсии > Эффективность конверсий.

Шаг 1. Получите действия-конверсии

Вызовите метод getMetadata, чтобы найти действительные идентификаторы действий-конверсий для вашего ресурса. Чтобы посмотреть действия-конверсии, созданные для вашего ресурса, укажите идентификатор ресурса GA (вместо того чтобы использовать 0 для получения полей, общих для всех ресурсов).

Ответ содержит список conversions с доступными действиями-конверсиями:

{
  ...

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

Шаг 2. Запустите отчет

Вызовите метод runReport. Используйте идентификаторы действий-конверсий, полученные на шаге 1, чтобы отфильтровать отчет, или оставьте поле conversionActions пустым, чтобы получить отчет обо всех конверсиях. Этот запрос позволяет воссоздать отчет "Эффективность конверсий" в интерфейсе, показывая клики по объявлениям, стоимость рекламы, цену за клик, цену за все конверсии, показы объявлений, рентабельность инвестиций в рекламу, общую выручку и все конверсии по группе каналов по умолчанию.

HTTP

Открыть в 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"
    }
}

Вот пример ответа на этот запрос:

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

Чтобы убедиться, что ответ был обработан как отчет о конверсиях, проверьте, что в поле metadata.section ответа задано значение SECTION_ADVERTISING.

Полный список параметров и показателей, доступных в отчетах о конверсиях, приведен в схеме отчетов о конверсиях.