Тип отчета: объявление

Показатели эффективности и атрибуты конфигурации для рекламы.

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

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

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

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

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

columnName Описание Поведение Тип Фильтруемый
status Статус объявления: Active , Paused или Removed . Обратите внимание, что кампании, группы объявлений, ключевые слова и объявления имеют свой собственный статус. Смотрите статус . атрибут Status Да
engineStatus Дополнительный статус объявления во внешнем аккаунте движка. Возможные статусы (в зависимости от типа внешней учетной записи): active , eligible , creative deleted , creative approved family safe и т. д. атрибут String Да
creationTimestamp Временная метка создания объявления в формате ISO 8601. атрибут Timestamp Да
lastModifiedTimestamp Временная метка последней модификации объявления в формате ISO 8601. атрибут Timestamp Да
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 Да
ad Название объявления. атрибут String Да
adId Идентификатор объявления DS. Значение 0 указывает, что у объявления нет атрибуции. атрибут ID Да
adEngineId Идентификатор объявления во внешнем аккаунте системы. атрибут ID Да
isUnattributedAd Указывает, связаны ли показатели в этой строке с конкретным объявлением. Например, объявление неподдерживаемого формата или ошибочный URL-адрес сервера кликов могут помешать DS присвоить метрики объявлению. атрибут Boolean Да
adHeadline Заголовок объявления. атрибут String Да
adHeadline2 Заголовок объявления 2; недоступно для некоторых двигателей. атрибут String Да
adHeadline3 Заголовок объявления 3; недоступно для некоторых двигателей. атрибут String Да
adDescription1 Строка описания объявления 1. атрибут String Да
adDescription2 Вторая строка описания объявления; недоступно для некоторых двигателей. атрибут String Да
adDisplayUrl URL-адрес отображения объявления. атрибут String Да
adLandingPage Целевая страница объявления. См. URL-адреса целевой страницы и сервера кликов . атрибут String Да
adType Тип объявления: Text , Product , Dynamic search , Mobile app install , Call-Only , Expanded text или Expanded dynamic search . атрибут Ad type Да
adPromotionLine Линия продвижения рекламы. Короткое рекламное сообщение для рекламы продукта. атрибут String Да
adLabels Названия ярлыков, непосредственно присвоенных этому объявлению; унаследованные метки не включаются. атрибут String list Да
adPathField1 Поле пути объявления 1. Поля пути 1 и 2 объединяются с adDisplayUrl для формирования URL-адреса, отображаемого в объявлении. атрибут String Да
adPathField2 Поле пути объявления 2. Поля пути 1 и 2 объединяются с adDisplayUrl для формирования URL-адреса, отображаемого в объявлении. атрибут String Да
effectiveLabels Названия всех ярлыков, унаследованных или напрямую назначенных этому объявлению. атрибут String list Да
dfaActions Общее количество действий Менеджера кампании. метрика Integer Да
dfaRevenue Совокупный доход, полученный от транзакций Менеджера кампаний. метрика Money Да
dfaTransactions Общее количество транзакций Менеджера кампаний. метрика Integer Да
dfaWeightedActions Взвешенная сумма действий Менеджера кампании. метрика Number Да
dfaActionsCrossEnv Общее количество действий Менеджера кампаний в разных средах. метрика Number Да
dfaRevenueCrossEnv Совокупный доход, полученный от межсредовых транзакций Менеджера кампаний. метрика Money Да
dfaTransactionsCrossEnv Общее количество транзакций Менеджера кампаний в разных средах. метрика Number Да
dfaWeightedActionsCrossEnv Взвешенная сумма действий менеджера кампании в разных средах. метрика Number Да
avgCpc Средняя стоимость клика. метрика Money Да
avgCpm Средняя стоимость за тысячу показов. метрика Money Да
avgPos Средняя позиция. метрика Number Да
clicks Совокупность кликов. метрика Integer Да
cost Совокупная стоимость, выплаченная на счет(а) системы. метрика Money Да
ctr Средний рейтинг кликов. метрика Number Да
impr Общее количество показов. метрика Integer Да
adWordsConversions Данные, которые рекламодатель настроил для отображения в столбце «Конверсии Google Рекламы». При создании действия-конверсии Google Рекламы рекламодатель может выбрать, следует ли учитывать эти конверсии в столбце отчета "Конверсии" . метрика Number Да
adWordsConversionValue Совокупная ценность конверсий Google Рекламы. метрика Number Да
adWordsViewThroughConversions Общее количество конверсий по показам Google Рекламы. метрика Integer Да
visits Общее количество посещений DS. метрика Integer Да
date Сегментирует отчет по дням; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый день. Этот столбец возвращает дату каждой строки. сегмент Date Да
monthStart Сегментирует отчет по месяцам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый месяц. Этот столбец возвращает первый день месяца каждой строки. сегмент Date Да
monthEnd Сегментирует отчет по месяцам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый месяц. Этот столбец возвращает последний день месяца каждой строки. сегмент Date Да
quarterStart Сегментирует отчет по кварталам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый квартал. Этот столбец возвращает первый день квартала каждой строки. сегмент Date Да
quarterEnd Сегментирует отчет по кварталам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый квартал. Этот столбец возвращает последний день квартала каждой строки. сегмент Date Да
weekStart Сегментирует отчет по неделям (с воскресенья по субботу); каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждую неделю. Этот столбец возвращает первый день (воскресенье) каждой строки. сегмент Date Да
weekEnd Сегментирует отчет по неделям (с воскресенья по субботу); каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждую неделю. Этот столбец возвращает последний день (суббота) каждой строки. сегмент Date Да
yearStart Сегментирует отчет по годам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый год. Этот столбец возвращает первый день года каждой строки. сегмент Date Да
yearEnd Сегментирует отчет по годам; каждая строка и ее совокупные показатели разбиваются на несколько строк, по одной на каждый год. Этот столбец возвращает последний день года каждой строки. сегмент Date Да
deviceSegment Сегментирует отчет по устройствам; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждого сегмента устройства. Этот столбец возвращает сегмент устройства каждой строки. сегмент Device segment Да
floodlightGroup Сегментирует отчет по группам Floodlight; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждой группы Floodlight. В этом столбце возвращается название группы Floodlight для каждой строки. Обратите внимание, что некоторые показатели не имеют сегментированных значений Floodlight, например клики и посещения. сегмент String Да
floodlightGroupId Сегментирует отчет по группам Floodlight; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждой группы Floodlight. В этом столбце возвращается идентификатор группы DS Floodlight для каждой строки. Обратите внимание, что некоторые показатели не имеют сегментированных значений Floodlight, например клики и посещения. сегмент ID Да
floodlightGroupTag Сегментирует отчет по группам Floodlight; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждой группы Floodlight. Этот столбец возвращает тег группы Floodlight для каждой строки. Обратите внимание, что некоторые показатели не имеют сегментированных значений Floodlight, например клики и посещения. сегмент String Да
floodlightActivity Сегментирует отчет по действиям Floodlight; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждого действия Floodlight. В этом столбце возвращается название действия Floodlight для каждой строки. Обратите внимание, что некоторые показатели не имеют сегментированных значений Floodlight, например клики и посещения. сегмент String Да
floodlightActivityId Сегментирует отчет по действиям Floodlight; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждого действия Floodlight. В этом столбце возвращается идентификатор действия DS Floodlight для каждой строки. Обратите внимание, что некоторые показатели не имеют сегментированных значений Floodlight, например клики и посещения. сегмент ID Да
floodlightActivityTag Сегментирует отчет по действиям Floodlight; каждая строка и ее совокупные показатели разбиваются на несколько строк, до одной для каждого действия Floodlight. В этом столбце возвращается тег активности Floodlight для каждой строки. Обратите внимание, что некоторые показатели не имеют сегментированных значений Floodlight, например клики и посещения. сегмент String Да