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

В этом руководстве рассказывается, как использовать функции регистрации конверсий в 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, чтобы найти действительные идентификаторы действий-конверсий для вашего ресурса. Чтобы увидеть действия-конверсии, созданные для вашего ресурса Google Аналитики, укажите его идентификатор (не используйте 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.

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