Необработанные данные о событиях о конверсиях.
Этот отчет может быть возвращен только асинхронным запросом (то есть через метод Reports.request() ).
Поскольку события происходят в определенные даты, в запросе этого отчета должен быть указан timeRange . Вы можете указать одно из следующих значений:
- дата начала и дата окончания .
- ChangeMetricsSinceTimestamp ( changedAttributesSinceTimestamp недопустим для событий).
Запросить выдержку
Отправьте обычное тело запроса 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 | Да |