После настройки клиентского приложения, как описано в разделе «Мое первое приложение» , вы можете использовать API Search Ads 360 для запроса и скачивания отчетов. Вы можете сделать любой из следующих типов запросов:
- Синхронный
Требуется только один запрос и возвращает отчет в формате JSON. Синхронные запросы:
- Может возвращать только отчеты по рекламодателям и учетным записям системы.
- Заблокируйте своего клиента, пока Поисковая реклама 360 не создаст отчет
Если вы запрашиваете отчеты по крупным рекламодателям или учетным записям систем, мы рекомендуем асинхронный подход.
- Асинхронный
Требуется отправить первоначальный запрос, указывающий данные, которые вы хотите включить в отчет. Затем вы отправляете дополнительные запросы для опроса Поисковой рекламы 360. Когда Поисковая реклама 360 завершает создание отчета, вы отправляете запросы на загрузку отчета в виде одного или нескольких файлов. Асинхронные запросы:
- Может возвращать любой тип отчета
- Разделяет очень большие отчеты на несколько файлов
- Форматирует отчеты как CSV или TSV
Модель данных: строки и столбцы
Поисковая реклама 360 упорядочивает данные в отчете по строкам и столбцам. Тип запрашиваемого отчета определяет возвращаемые строки . Например, если вы запрашиваете отчет по ключевым словам, каждая строка будет содержать данные об одном ключевом слове. Список всех типов отчетов см. в справочнике по типам отчетов. Вы указываете, какие столбцы вы хотите включить в отчет, называя каждый столбец в запросе отчета. См. справочник по типам отчетов для получения списка столбцов, которые могут быть возвращены для каждого типа отчета.
Поведение столбцов
Поведение столбца зависит от типа данных, содержащихся в столбце (справочник по типам отчетов отображает поведение каждого столбца):
Столбцы атрибутов . Столбец атрибутов содержит данные, которые настраивают или идентифицируют объект в кампании, например название кампании или ставку ключевого слова. Search Ads 360 API всегда возвращает текущее значение столбца атрибута независимо от даты или диапазона дат, указанных в запросе. Например, если вчера вы изменили ставку ключевого слова с 2,00 на 1,50, а затем запросили отчет с данными за последний месяц, в отчете будет возвращено значение 1,50 для ставки ключевого слова.
Метрические столбцы . Столбец показателей содержит данные об эффективности вашей кампании, например количество кликов по объявлению, количество посещений, зарегистрированных тегом Floodlight, или доход. Если вы не укажете диапазон времени, равный одному дню, API возвращает совокупное значение для столбцов метрик. Например, если вы запросите отчет по данным за последний месяц, API вернет общее количество кликов за последний месяц.
Сегментные столбцы . Столбец сегмента разбивает данные на отдельные строки. Например,
date— это столбец сегмента, который можно указать для многих типов отчетов. Если вы укажете столбецdateв отчете по ключевым словам с диапазоном дат от 01.01.2013 до 07.01.2013, API вернет семь строк для каждого ключевого слова, каждая из которых соответствует одному дню и отображает показатели для этого дня. См. Сегментированные отчеты .
Валюты
В запросе отчета необходимо указать валюту денежных данных (как атрибутов, таких как dailyBudget , так и показателей, таких как cost ). Вы можете указать одно из следующего:
- Валюта агентства, если область отчета относится к агентству, рекламодателю или учетной записи системы.
- Валюта рекламодателя, если отчет привязан к аккаунту рекламодателя или системы.
- Валюта системного аккаунта, если отчет относится к системному аккаунту.
- доллар США
Используйте свойство запроса Reports.request.statisticsCurrency , чтобы указать валюту.
В самом отчете валюта будет указана в свойстве Reports.statisticsCurrencyCode .
Часовой пояс
Показатели Поисковой рекламы 360 хранятся в датах без часовых поясов. Эти даты соответствуют часовому поясу системной учетной записи для показателей системы (например, кликов, показов и посещений) и часовому поясу сети Менеджера кампаний для показателей конверсий (таких как действия, транзакции и доход). Когда все показатели в отчете относятся к одному и тому же часовому поясу, этот часовой пояс будет возвращен в запросе. В противном случае часовой пояс не будет возвращен. В ваших запросах можно установить Reports.request.verifySingleTimeZone : true , чтобы не отображать отчеты, представляющие метрику из более чем одного часового пояса.
Если все метрики, представленные в отчете, относятся к одному часовому поясу, этот часовой пояс возвращается в Reports.statisticsTimeZoneReports .