Сегментированные отчеты

Новый API отчетов Search Ads 360 теперь доступен. Новый API обеспечивает повышенную гибкость для создания пользовательских отчетов и интеграции данных в ваши приложения и процессы отчетности. Узнайте больше о переходе и использовании нового API отчетов Search Ads 360 .

API Search Ads 360 возвращает только агрегированные данные, если вы не запросите более подробные и сегментированные данные. Например, в столбце «Клики» в отчете по ключевым словам указано общее количество кликов по ключевому слову за указанный вами временной диапазон.

ключевое словоТекст Ключевое словоLandingPage щелчки
виджеты http://www.example.com 6000

Но если вы запросите отчет по ключевым словам с сегментацией по кварталам, для каждого ключевого слова вы увидите одну строку для каждого квартала, а в столбце «Клики» будут указаны итоговые показатели за квартал.

ключевое словоТекст Ключевое словоLandingPage кварталНачало кварталКонец щелчки
виджеты http://www.example.com 01.01.2012 31 марта 2012 г. 1000
виджеты http://www.example.com 01.04.2012 2012-06-30 1000
виджеты http://www.example.com 01.07.2012 2012-09-30 1000
виджеты http://www.example.com 01.10.2012 2012-12-31 3000

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

Некоторые сегменты несовместимы с определенными столбцами.

Некоторые сегменты могут привести к тому, что определенные столбцы будут возвращать недопустимые данные. Например, сегментирование по floodlightActivity имеет смысл, только если вы включаете столбцы, сообщающие данные Floodlight, такие как dfaActions , dfaRevenue , dfaTransactions и dfaWeightedActions . Другие типы столбцов конверсий (например, adWordsConversions ) или столбцы, в которых сообщаются показатели системы (например, клики и показы), не содержат данных, сообщаемых Floodlight, поэтому они возвращают недопустимые значения, если вы сегментируете отчет по floodlightActivity .

Как запросить сегментированный отчет

Чтобы запросить сегментированный отчет, включите столбец, в котором указан segment в качестве его поведения, в справочнике по типам отчетов .

Следующий асинхронный запрос предназначен для отчета по ключевым словам, сегментированного по кварталам. В столбце «Клики» в каждой строке будет указано общее количество кликов за квартал:

{
  "reportScope": {
    "agencyId": "20700000000000123", // Replace with your IDs
    "advertiserId": "2170000012345" // Replace with your IDs
  },
  "reportType": "keyword",

  "columns": [
     { "columnName": "campaignId" },
     { "columnName": "keywordText" },
     { "columnName": "keywordLandingPage" },

     { "columnName": "quarterStart" },
     { "columnName": "quarterEnd" },
     { "columnName": "clicks" },
  ]
  "timeRange" : {
    "startDate" : "2012-01-01",
    "endDate" : "2012-12-31"
  },
  "downloadFormat": "csv",
  "maxRowsPerFile": 5000000,
  "statisticsCurrency": "agency",
  "verifySingleTimeZone": false,
  "includeRemovedEntities": false
}
  
Примечание : будьте осторожны с датами. Если вы запрашиваете квартальный отчет, убедитесь, что timeRange отчета включает весь квартал. В противном случае вы получите лишь частичные результаты, что может заставить людей подумать, что произошло резкое снижение количества кликов, доходов и т. д.

Запрос нескольких сегментов

В запрос можно включить более одного столбца сегмента. Обратите внимание на следующее:

  • Если вы сегментируете данные по неделям, месяцам или кварталам, мы рекомендуем включать в запрос как начальный, так и конечный столбцы. Например, в квартальный отчет включите столбцы quarterStart и quarterEnd . Если включить оба этих столбца, будут выведены даты начала и окончания периода, что поможет подтвердить, что вы включили данные за каждый полный период.

  • В один запрос нельзя включать разные типы сегментов, связанных со временем. Например, в одном запросе нельзя выполнить сегментацию по кварталам и месяцам.

  • Количество строк может увеличиваться экспоненциально с каждым дополнительным сегментом.