Необработанные данные о посещениях. Посещение происходит каждый раз, когда потребитель нажимает на объявление и перенаправляется на целевую страницу.
Этот отчет может быть возвращен только асинхронным запросом (то есть через метод Reports.request() ).
Поскольку события происходят в определенные даты, в запросе этого отчета необходимо указать timeRange . Вы можете указать одно из следующего:
- Дата начала и Дата окончания .
- changeMetricsSinceTimestamp ( changedAttributesSinceTimestamp недействителен для событий).
Запросить выдержку
Отправьте обычное тело запроса Reports.request() , но укажите "reportType": "visit" .
{
...
"reportType": "visit",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
} Для каждого столбца, который вы хотите вернуть или отфильтровать в отчете, укажите columnName указанное в таблице ниже. Вы также можете дополнительно указать headerText , startDate и endDate . Обратите внимание, что некоторые столбцы нельзя фильтровать; см. «Фильтрация» в таблице ниже.
columnName | Описание | Поведение | Тип | Фильтруемый |
|---|---|---|---|---|
status | Статус визита. Посещения неизменяемы, поэтому это всегда Active . | атрибут | Status | Да |
deviceSegment | Сегмент устройств, к которому относится посещение: Desktop , Mobile , Tablet или Other . | атрибут | Device segment | Да |
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), установленный для фида Merchant Center, содержащего данные о товаре. | атрибут | String | Да |
productStoreId | Магазин в рекламе местного ассортимента, на который был сделан клик. Это должно совпадать с идентификаторами магазинов, используемыми в вашем фиде местных продуктов. | атрибут | String | Да |
productChannel | Канал продаж продукта, на который кликнули: Online или Local . | атрибут | Product channel | Да |
visitId | Идентификатор посещения DS. | атрибут | ID | Да |
visitSearchQuery | Поисковый запрос, вызвавший это посещение. | атрибут | String | Да |
visitDate | Дата в часовом поясе учетной записи Engine, когда произошло посещение. Эта дата используется для агрегации посещений. Например, когда DS объединяет посещения за 1 мая, она подсчитывает все посещения, visitDate которых равна 1 мая. | атрибут | Date | Да |
visitTimestamp | Отметка времени в формате UTC, когда произошло посещение. | атрибут | Timestamp | Да |
visitNetworkType | Рекламная сеть, вызвавшая это посещение: Content , Search или Other . | атрибут | Network type | Да |
visitReferrer | URL-адрес реферера посещения. | атрибут | String | Да |
visitExternalClickId | Уникальная строка для каждого посещения, которая передается на целевую страницу в качестве параметра URL-адреса gclid . Доступно только для рекламодателей с интеграцией API конверсии или интеграцией с Google Analytics. | атрибут | String | Да |
feedItemId | Идентификатор строки элемента ленты, связанной с этим посещением. | атрибут | ID | Да |
feedId | Идентификатор таблицы каналов, связанной с этим посещением. | атрибут | ID | Да |
feedType | Тип фида, связанный с этим посещением. | атрибут | Feed type | Да |