API Search Ads 360 возвращает только агрегированные данные, если вы не запросите более подробные и сегментированные данные. Например, в столбце «Клики» в отчете по ключевым словам указано общее количество кликов по ключевому слову за указанный вами временной диапазон.
ключевое словоТекст | Ключевое словоLandingPage | щелчки |
---|---|---|
виджеты | http://www.example.com | 6000 |
Но если вы запросите отчет по ключевым словам с сегментацией по кварталам, для каждого ключевого слова вы увидите одну строку для каждого квартала, а в столбце «Клики» будут указаны итоговые показатели за квартал.
ключевое словоТекст | Ключевое словоLandingPage | кварталНачало | кварталКонец | щелчки |
---|---|---|---|---|
виджеты | http://www.example.com | 01.01.2012 | 2012-03-31 | 1000 |
виджеты | http://www.example.com | 01.04.2012 | 2012-06-30 | 1000 |
виджеты | http://www.example.com | 01.07.2012 | 30 сентября 2012 г. | 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 }
Запрос нескольких сегментов
В запрос можно включить более одного столбца сегмента. Обратите внимание на следующее:
Если вы сегментируете данные по неделям, месяцам или кварталам, мы рекомендуем включать в запрос как начальный, так и конечный столбцы. Например, в квартальный отчет включите столбцы
quarterStart
иquarterEnd
. Если включить оба этих столбца, будут выведены даты начала и окончания периода, что поможет подтвердить, что вы включили данные за каждый полный период.В один запрос нельзя включать разные типы сегментов, связанных со временем. Например, в одном запросе нельзя выполнить сегментацию по кварталам и месяцам.
Количество строк может увеличиваться экспоненциально с каждым дополнительным сегментом.