Тип отчета: посетить

Необработанные данные о посещениях. Посещение происходит каждый раз, когда потребитель нажимает на объявление и перенаправляется на целевую страницу.

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

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

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

Отправьте обычное тело запроса 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 Идентификатор учетной записи во внешней учетной записи системы. атрибут 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), установленный для фида Merchant Center, содержащего данные о товаре. атрибут String Да
productStoreId Магазин в рекламе местного ассортимента, на который был сделан клик. Он должен совпадать с идентификаторами магазинов, которые используются в фиде местных товаров. атрибут String Да
productChannel Канал продаж продукта, по которому был сделан клик: Online или Local . атрибут Product channel Да
visitId Идентификатор посещения DS. атрибут ID Да
visitSearchQuery Поисковый запрос, который привел к этому посещению. атрибут String Да
visitDate Дата в часовом поясе системного аккаунта, когда произошло посещение. Эта дата используется для агрегирования посещений. Например, когда 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 Да