Тип отчета: конверсия

Необработанные данные о событиях о конверсиях.

Этот отчет может быть возвращен только асинхронным запросом (то есть через метод Reports.request() ).

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

Запросить выдержку

Отправьте обычное тело запроса Reports.request() , но укажите "reportType": "conversion" .

{
...
  "reportType": "conversion",
  "columns": [
    {
      "columnName": string,
      "headerText": string,
      "startDate": string,
      "endDate": string
    }
  ],
  "filters": [
    {
      "column": {
        "columnName": string,
      },
      ...
    },
    ...
  ],
...
}

Для каждого столбца, который вы хотите вернуть или отфильтровать в отчете, укажите columnName , указанное в таблице ниже. Вы также можете дополнительно указать headerText , startDate и endDate . Обратите внимание, что некоторые столбцы нельзя фильтровать; см. раздел «Фильтрируемый» в таблице ниже.

columnName Описание Поведение Тип Фильтруемый
status Статус конверсии: Active или Removed . атрибут Status Да
deviceSegment Сегмент устройства, к которому относится конверсия: Desktop , Mobile , Tablet или Other . атрибут Device segment Да
floodlightGroup Название группы Floodlight. атрибут String Да
floodlightGroupConversionType Тип конверсий, генерируемых действиями Floodlight в этой группе: Action или Transaction . атрибут Conversion type Да
floodlightGroupId Идентификатор группы DS Floodlight. атрибут ID Да
floodlightGroupTag Тег группы Floodlight. атрибут String Да
floodlightActivity Название действия Floodlight. атрибут String Да
floodlightActivityId Идентификатор действия DS Floodlight. атрибут ID Да
floodlightActivityTag Тег активности Floodlight. атрибут String Да
agency Название агентства. атрибут String Да
agencyId Идентификатор агентства DS. атрибут ID Да
advertiser Имя рекламодателя. атрибут String Да
advertiserId Идентификатор рекламодателя DS. атрибут ID Да
account Имя учетной записи системы. атрибут String Да
accountId Идентификатор учетной записи ядра DS. атрибут ID Да
accountEngineId Идентификатор учетной записи во внешней учетной записи системы. атрибут String Да
accountType Тип учетной записи системы: Google AdWords , Bing Ads , Yahoo Japan Listing Ads , Yahoo Search Marketing , Yahoo Gemini , Baidu или Comparison Shopping . атрибут Engine type Да
campaign Название кампании. атрибут String Да
campaignId Идентификатор кампании DS. атрибут ID Да
campaignStatus Статус кампании, содержащей этот элемент. атрибут Status Да
adGroup Название группы объявлений. атрибут String Да
adGroupId Идентификатор группы объявлений DS. атрибут ID Да
adGroupStatus Статус группы объявлений, содержащей этот элемент. атрибут Status Да
keywordId Идентификатор ключевого слова DS. Значение 0 указывает, что ключевое слово не имеет атрибута. атрибут ID Да
keywordMatchType Тип соответствия ключевого слова: Broad , Exact , Phrase или Content . атрибут Match type Да
keywordText Текст ключевого слова. атрибут String Да
productTargetId Идентификатор цели продукта DS. атрибут ID Да
productGroupId Идентификатор группы продуктов, связанный с этой конверсией. Идентификаторы групп товаров есть только у конверсий из торговых кампаний. Идентификаторы групп продуктов не следует использовать для присоединения. атрибут ID Да
ad Название объявления. атрибут String Да
adId Идентификатор объявления DS. Значение 0 указывает, что у объявления нет атрибуции. атрибут ID Да
isUnattributedAd Указывает, связаны ли показатели в этой строке с конкретным объявлением. Например, объявление неподдерживаемого формата или ошибочный URL-адрес сервера кликов могут помешать DS присвоить метрики объявлению. атрибут Boolean Да
inventoryAccountId Идентификатор учетной записи запасов DS, содержащий продукт, связанный с конверсией. DS генерирует этот идентификатор, когда вы связываете учетную запись запасов в DS. атрибут ID Да
productId Идентификатор продукта, связанного с этой конверсией. атрибут String Да
productCountry Страна (формат ISO 3166), зарегистрированная для фида ассортимента, содержащего продукт, связанный с этой конверсией. атрибут String Да
productLanguage Язык (ISO 639-1) продукта, связанного с этим преобразованием. атрибут String Да
productStoreId Магазин в рекламе местного ассортимента, связанный с конверсией. Он должен совпадать с идентификаторами магазинов, которые используются в фиде местных товаров. атрибут String Да
productChannel Канал продаж продукта, связанный с конверсией: Online или Local . атрибут Product channel Да
conversionId Идентификатор, который Search Ads 360 генерирует для каждой конверсии. атрибут ID Да
advertiserConversionId Для офлайн-конверсий это идентификатор, предоставленный рекламодателями. Если рекламодатель не указывает такой идентификатор, Search Ads 360 сгенерирует его. Для онлайн-конверсий это значение равно столбцу «conversionId» или столбцу «floodlightOrderId» в зависимости от инструкций Floodlight рекламодателя. атрибут String Да
conversionType Тип конверсии: Action или Transaction . атрибут Conversion type Да
conversionRevenue Общая сумма в долларах США от конвертации. атрибут Money Да
conversionQuantity Количество товаров, зарегистрированных при преобразовании, определенное параметром qty . Рекламодатель несет ответственность за динамическое заполнение параметра (например, количества товаров, проданных в результате конверсии), в противном случае он по умолчанию равен 1. атрибут Number Да
conversionDate Дата (в часовом поясе сети Менеджера кампании), когда произошла конверсия. Эта дата используется для агрегирования показателей конверсий. Например, когда DS агрегирует действия за 1 мая, он учитывает все конверсии-действия, у которых conversionDate — 1 мая. атрибут Date Да
conversionTimestamp Метка времени в формате UTC, когда произошло преобразование. атрибут Timestamp Да
conversionLastModifiedTimestamp Временная метка в формате UTC последней модификации преобразования. атрибут Timestamp Да
conversionAttributionType С чем связана конверсия: Visit или Keyword+Ad . атрибут Conversion attribution type Да
conversionVisitId Идентификатор посещения DS, которому приписывается конверсия. атрибут ID Да
conversionVisitTimestamp Временная метка посещения в формате UTC, с которым связана конверсия. атрибут Timestamp Да
conversionVisitExternalClickId Уникальная строка для посещения, к которому относится конверсия, которая передается на целевую страницу в качестве параметра URL-адреса gclid . Доступно только для рекламодателей с интеграцией API конверсий или интеграцией Google Analytics. атрибут String Да
conversionSearchTerm Поисковый запрос, который привел к конверсии. атрибут String Да
floodlightOriginalRevenue Исходный неизмененный доход, связанный с событием Floodlight (в валюте текущего отчета), до изменения инструкций по валюте Floodlight. атрибут Money Да
floodlightEventRequestString Строка запроса Floodlight конверсии. атрибут String Да
floodlightReferrer Веб-сайт перехода Floodlight, на котором произошла конверсия. атрибут String Да
floodlightOrderId Идентификатор заказа Floodlight, предоставленный рекламодателем для конверсии. атрибут String Да
feedItemId Идентификатор строки элемента фида, связанной с этой конверсией. атрибут ID Да
feedId Идентификатор таблицы каналов, связанной с этим преобразованием. атрибут ID Да
feedType Тип фида, связанного с этой конверсией. атрибут Feed type Да