В отчетеpaidAndOrganic показаны поисковые запросы, которые привели к показу вашей рекламы в Google, к тому, что Google отобразил бесплатные (обычные) результаты поиска для вашего сайта, или и то, и другое. Отчет возвращает результаты только в том случае, если вы уже настроили платный и органический отчет для учетной записи системы, по которой вы создаете отчет.
Этот отчет может быть возвращен только асинхронным запросом (то есть через метод Reports.request() ).
Запросить выдержку
Отправьте обычное тело запроса Reports.request() , но укажите "reportType": "paidAndOrganic" .
{
...
"reportType": "paidAndOrganic",
"columns": [
{
"columnName": string,
"headerText": string,
"startDate": string,
"endDate": string
}
],
"filters": [
{
"column": {
"columnName": string,
},
...
},
...
],
...
} Для каждого столбца, который вы хотите вернуть или отфильтровать в отчете, укажите columnName указанное в таблице ниже. Вы также можете дополнительно указать headerText , startDate и endDate . Обратите внимание, что некоторые столбцы нельзя фильтровать; см. «Фильтрация» в таблице ниже.
columnName | Описание | Поведение | Тип | Фильтруемый |
|---|---|---|---|---|
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 | Да |
searchQuery | Условия поиска, введенные пользователями Google. | атрибут | String | Да |
serpType | Тип результата поиска, на который нажимали пользователи Google. Возможные значения:
| атрибут | SERP type | Да |
paidClicks | Количество кликов по объявлению после ввода searchQuery. | метрика | Integer | Да |
organicClicks | Количество кликов по бесплатным результатам поиска для вашего сайта после того, как кто-то ввел поисковый запрос. | метрика | Integer | Да |
paidAndOrganicClicks | Количество кликов по одному из ваших рекламных объявлений или бесплатному результату поиска для вашего сайта после того, как кто-то ввел поисковый запрос. | метрика | Integer | Да |
paidImpressions | Сколько раз объявление появлялось на странице результатов поиска или на веб-сайте в сети Google после того, как кто-то ввел поисковый запрос. | метрика | Integer | Да |
organicQueries | Общее количество раз, когда пользователи вводили поисковый запрос и видели хотя бы один результат обычного поиска с вашего сайта. | метрика | Integer | Да |
paidAndOrganicQueries | Общее количество раз, когда пользователи вводили поисковый запрос и видели хотя бы одно ваше объявление или хотя бы один результат обычного поиска с вашего сайта. | метрика | Integer | Да |
paidCtr | Рейтинг кликов для объявления, то есть как часто люди, которые видят ваше объявление, нажимают на него после ввода поискового запроса. | метрика | Number | Да |
organicCtr | Скорость, с которой люди, которые видят бесплатные результаты поиска для вашего сайта, в конечном итоге нажимают на бесплатные результаты и переходят на ваш сайт. | метрика | Number | Да |
paidAndOrganicCtr | Скорость, с которой люди, которые видят одно из ваших объявлений или бесплатные результаты поиска для вашего сайта, в конечном итоге нажимают на любую из них и переходят на ваш сайт. | метрика | Number | Да |
paidAvgPos | Средняя позиция, на которой появляется объявление после того, как пользователь ввел поисковый запрос. | метрика | Number | Да |
organicAvgPos | Средняя верхняя позиция бесплатных результатов поиска для вашего сайта. | метрика | Number | Да |
paidCostPerClick | Средняя стоимость клика по объявлению. Это средняя сумма, которую вы платите каждый раз, когда кто-то нажимает на ваше объявление. | метрика | Money | Да |
date | Сегментирует отчет по дням; каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждый день. Этот столбец возвращает дату каждой строки. | сегмент | Date | Да |
monthStart | Сегментирует отчет по месяцам; каждая строка и ее сводные показатели разбиты на несколько строк, по одной на каждый месяц. Этот столбец возвращает первый день месяца каждой строки. | сегмент | Date | Да |
monthEnd | Сегментирует отчет по месяцам; каждая строка и ее сводные показатели разбиты на несколько строк, по одной на каждый месяц. Этот столбец возвращает последний день месяца каждой строки. | сегмент | Date | Да |
quarterStart | Сегментирует отчет по кварталам; каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждый квартал. Этот столбец возвращает первый день квартала каждой строки. | сегмент | Date | Да |
quarterEnd | Сегментирует отчет по кварталам; каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждый квартал. Этот столбец возвращает последний день квартала каждой строки. | сегмент | Date | Да |
weekStart | Сегментирует отчет по неделям (с воскресенья по субботу); каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждую неделю. Этот столбец возвращает первый день (воскресенье) каждой строки. | сегмент | Date | Да |
weekEnd | Сегментирует отчет по неделям (с воскресенья по субботу); каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждую неделю. Этот столбец возвращает последний день (субботу) каждой строки. | сегмент | Date | Да |
yearStart | Сегментирует отчет по годам; каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждый год. Этот столбец возвращает первый день года каждой строки. | сегмент | Date | Да |
yearEnd | Сегментирует отчет по годам; каждая строка и ее совокупные показатели разбиты на несколько строк, по одной на каждый год. Этот столбец возвращает последний день года для каждой строки. | сегмент | Date | Да |
campaign | Сегментирует отчет по кампаниям; каждая строка и ее совокупные показатели разделены на несколько строк, по одной для каждой кампании в области отчета. Этот столбец возвращает название кампании. | сегмент | String | Да |
campaignId | Сегментирует отчет по кампаниям; каждая строка и ее совокупные показатели разделены на несколько строк, по одной для каждой кампании в области отчета. Этот столбец возвращает идентификатор кампании DS. | сегмент | ID | Да |
adGroup | Сегментирует отчет по группам объявлений; каждая строка и ее совокупные показатели разделены на несколько строк, по одной для каждой группы объявлений в области отчета. Этот столбец возвращает название группы объявлений. | сегмент | String | Да |
adGroupId | Сегментирует отчет по группам объявлений; каждая строка и ее совокупные показатели разделены на несколько строк, по одной для каждой группы объявлений в области отчета. Этот столбец возвращает идентификатор группы объявлений DS. | сегмент | ID | Да |
keywordId | Сегментирует отчет по ключевому слову; каждая строка и ее совокупные показатели разбиты на несколько строк, по одной для каждого ключевого слова в области отчета. Этот столбец возвращает идентификатор ключевого слова DS. | сегмент | ID | Да |
keywordMatchType | Сегментирует отчет по ключевому слову; каждая строка и ее совокупные показатели разбиты на несколько строк, по одной для каждого ключевого слова в области отчета. Этот столбец возвращает тип соответствия ключевого слова. | сегмент | Match type | Да |
keywordText | Сегментирует отчет по ключевому слову; каждая строка и ее совокупные показатели разбиты на несколько строк, по одной для каждого ключевого слова в области отчета. Этот столбец возвращает текст ключевого слова. | сегмент | String | Да |