В отчете payAndOrganic показаны поисковые запросы, которые либо привели к показу вашей рекламы в 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 | Идентификатор учетной записи во внешней учетной записи системы. | атрибут | 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 | Сколько раз кто-то нажимал на объявление после ввода поискового запроса. | метрика | 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 | Да |