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

В этом руководстве объясняется, как использовать функциональность отчетов о конверсиях в Google Analytics Data API версии 1. Эта функция позволяет создавать отчеты, ориентированные на события конверсии, с поддержкой различных моделей атрибуции. Отчеты о конверсиях, созданные с помощью Data API, аналогичны отчетам по атрибуции, которые можно найти в разделе «Реклама > Конверсии» пользовательского интерфейса Google Analytics . Для получения дополнительной информации см. статью в справочном центре « Отчеты о производительности конверсий» .

Цель составления отчетов о конверсиях

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

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

  • Отчеты по событиям : предоставляют необработанные данные о количестве событий (например, 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 Analytics в разделе «Реклама» > «Конверсии» > «Эффективность конверсий» .

Шаг 1: Получение данных о конверсиях

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

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