Отчеты

Отчетность позволяет вам получать информацию об эффективности рекламы связанных аккаунтов, а также данные о потенциальных клиентах.

Отчеты по счетам

Отчёты по учётным записям отображают эффективность и показатели, связанные с учётными записями «Местных услуг» в учётной записи менеджера. Вы можете просматривать эти данные за определённый период времени. Данные могут быть устаревшими до 30 минут.

Чтобы получить отчет, отправьте HTTP-запрос GET на адрес https://localservices.googleapis.com/v1/accountReports:search со следующими настраиваемыми параметрами URL:

Параметры URL
query	Необходимый Содержит одно или несколько значений идентификатора, одно из которых должно быть идентификатором учетной записи менеджера для запроса. query может принимать несколько значений, разделенных точкой с запятой: Обязательно: manager_customer_id: <manager_cid> Необязательно: customer_id: <linked_cid> Пример: query=manager_customer_id:123;customer_id:456
startDate.day	Необязательный День месяца, с которого начинается отчётный период. Может принимать значения от 1 до 31 включительно. По умолчанию — 1 .
startDate.month	Необязательный Начальный месяц отчётного периода. Может принимать значения от 1 до 12 включительно. По умолчанию — текущий месяц.
startDate.year	Необязательный Год начала отчётного периода в формате YYYY . По умолчанию — текущий год.
endDate.day	Необязательный День месяца, в котором заканчивается отчётный период. Может принимать значения от 1 до 31 включительно. По умолчанию — текущий день.
endDate.month	Необязательный Месяц окончания отчётного периода. Может принимать значения от 1 до 12 включительно. По умолчанию — текущий месяц.
endDate.year	Необязательный Год окончания отчётного периода в формате YYYY . По умолчанию — текущий год.
pageSize	Необязательный Положительное целое число, указывающее количество возвращаемых записей. Значение по умолчанию — 1000 , максимальное — 10000 .
pageToken	Необязательный Строка. Введите в это поле next_page_token из предыдущего ответа.

Поля в предыдущей таблице используются для создания запроса SearchAccountReportsRequest . Для каждого идентификатора клиента в запросе соответствующий AccountReports включается в SearchAccountReportsResponse . Каждый отчёт Account сопоставляется один к одному со связанным аккаунтом клиента, для которого отображается реклама местных услуг.

Примечание: прототипы запросов, ответов и структур данных будут доступны и на них будут ссылки после запуска.

В следующей таблице показаны поля в AccountReports :

Поля
accountId	Связанный идентификатор клиента с учетной записью местных услуг.
businessName	Название компании-заказчика.
averageWeeklyBudget	Текущий средний недельный бюджет клиента.
averageFiveStarRating	Средний пятизвездочный рейтинг, который рассчитывается на основе всех имеющихся отзывов клиента.
totalReview	Общее количество отзывов, доступных для клиента.
impressionsLastTwoDays	Общее количество показов аккаунта за последние два дня.
phoneLeadResponsiveness	Отзывчивость лидов по телефону за последние 90 дней. Для расчета этого показателя общее количество подключенных звонков от платных лидов делится на общее количество полученных звонков.
currentPeriodChargedLeads	Количество оплаченных лидов за указанный период времени.
previousPeriodChargedLeads	Количество лидов, по которым были оплачены счета за предыдущий период. Например, если задан диапазон дат с 21 по 30 января, то предыдущий период будет с 11 по 20 января.
currentPeriodTotalCost	Сумма расходов по оплаченным лидам за указанный период времени.
previousPeriodTotalCost	Сумма расходов по лидам, с которых взималась плата, за предыдущий период. Например, если задан диапазон дат с 21 по 30 января, то предыдущий период будет с 11 по 20 января.
currencyCode	Код валюты счета клиента.
currentPeriodPhoneCalls	Количество телефонных звонков за указанный период времени, как подключенных, так и неподключенных.
previousPeriodPhoneCalls	Количество телефонных звонков за предыдущий период, как подключенных, так и неподключенных.
currentPeriodConnectedPhoneCalls	Количество подключенных телефонных звонков за указанный период времени длительностью более 30 секунд.
previousPeriodConnectedPhoneCalls	Количество соединенных телефонных звонков за предыдущий период длительностью более 30 секунд.

Примеры

URL-адрес HTTP-запроса

https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:{manager_customer_id}

Полный пример HTTP-запроса

GET /v1/accountReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]

Подробные отчеты о лидах

Важно: Подробные отчёты о лидах устарели. Используйте API Google Ads для получения лидов и разговоров, связанных с вашими аккаунтами в сервисе «Местные услуги».

Подробные отчёты по лидам содержат подробную информацию о лидах, связанных с аккаунтами Local Services, привязанными к аккаунту менеджера. Вы можете просматривать эти данные за указанный период времени. За указанный период отчёт включает в себя как созданные лиды, так и лиды, статус спора которых был обновлён. Данные могут быть устаревшими до 30 минут.

Примечание: Клиенты API могут запрашивать подробные отчёты по лидам только за период не более 31 дня. Это связано с большим объёмом лидов, которые могут быть возвращены в отчёте.

Чтобы получить отчет, отправьте HTTP-запрос GET на адрес https://localservices.googleapis.com/v1/detailedLeadReports:search со следующими настраиваемыми параметрами URL:

Параметры URL
query	Необходимый Содержит одно или несколько значений идентификатора, одно из которых должно быть идентификатором учетной записи менеджера для запроса. query может принимать несколько значений, разделенных точкой с запятой: Обязательно: manager_customer_id: <manager_cid> Необязательно: customer_id: <linked_cid> Пример: query=manager_customer_id:123;customer_id:456
startDate.day	Необязательный День месяца, с которого начинается отчётный период. Может принимать значения от 1 до 31 включительно. По умолчанию — 1 .
startDate.month	Необязательный Начальный месяц отчётного периода. Может принимать значения от 1 до 12 включительно. По умолчанию — текущий месяц.
startDate.year	Необязательный Год начала отчётного периода в формате YYYY . По умолчанию — текущий год.
endDate.day	Необязательный День месяца, в котором заканчивается отчётный период. Может принимать значения от 1 до 31 включительно. По умолчанию — текущий день.
endDate.month	Необязательный Месяц окончания отчётного периода. Может принимать значения от 1 до 12 включительно. По умолчанию — текущий месяц.
endDate.year	Необязательный Год окончания отчётного периода в формате YYYY . По умолчанию — текущий год.
pageSize	Необязательный Положительное целое число, указывающее количество возвращаемых записей. Значение по умолчанию — 1000 , максимальное — 10000 .
pageToken	Необязательный Строка. Введите в это поле next_page_token из предыдущего ответа.

Предыдущие поля используются для создания запроса SearchDetailedLeadReportsRequest . Для каждого идентификатора клиента в запросе соответствующий DetailedLeadReports добавляется в SearchDetailedLeadReportsResponse . Каждый подробный отчёт о лидах сопоставляется один к одному с конкретным лидом, связанным со связанной учётной записью клиента, которая показывает рекламу местных услуг.

В следующей таблице показаны поля в DetailedLeadReports :

Поля
leadId	Уникальный идентификатор лида.
accountId	Идентифицирует учетную запись, которая получила лид.
businessName	Название компании, связанной с учетной записью.
leadCreationTimestamp	Временная метка создания лида. Включает дату в формате M/D/YYYY и время в формате HH:MM:SS . Пример: 11/1/2019 12:13:20
leadType	Тип лида: MESSAGE или PHONE_CALL .
leadCategory	Категория услуг, связанная с лидом. Пример: housecleaner
geo	Местоположение города, в котором находится соответствующая учетная запись. Пример: San Francisco, California, United States
messageLead	Информация, связанная только с лидами в сообщениях: customerName , jobType , postalCode и consumerPhoneNumber .
phoneLead	Информация, связанная только с телефонными лидами: chargedCallTimestamp , chargedConnectedCallDurationSeconds и consumerPhoneNumber .
bookingLead	Информация, связанная только с лидами по бронированию: customerName , consumerPhoneNumber , jobType , consumerEmail и bookingAppointmentTimestamp .
chargeStatus	Была ли произведена оплата за лид. Может быть true или false .
currencyCode	Код валюты счета, для которого был создан лид.
disputeStatus	Оспаривание статуса лида.
aggregatorInfo	Информация, относящаяся к сторонним партнерам-агрегаторам. Это поле заполняется только для клиентов API, связанных со сторонними партнерами-агрегаторами. Примечание: это не применимо к стандартным клиентам Центра клиентов (MCC).
timezone	Часовой пояс учётной записи, связанной с лидом. Указан в формате базы данных часовых поясов IANA .

Примеры

URL-адрес HTTP-запроса

https://localservices.googleapis.com/v1/detailedLeadReports:search?query=manager_customer_id:{manager_customer_id}

Полный пример HTTP-запроса

GET /v1/detailedReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]