Необработанные данные о конверсиях.
Этот отчет может быть возвращен только асинхронным запросом (то есть через метод 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 | ID аккаунта во внешнем движке аккаунта. | атрибут | 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 | Идентификатор объявления ДС. Значение 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 | Идентификатор, который Поисковая реклама 360 создает для каждой конверсии. | атрибут | ID | Да |
advertiserConversionId | Для офлайн-конверсий это идентификатор, предоставленный рекламодателями. Если рекламодатель не указывает такой идентификатор, Поисковая реклама 360 создает его. Для онлайн-конверсий это значение равно столбцу convertId или флудлайтордерид, в зависимости от инструкций рекламодателя 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 | Да |