Кампании местных услуг

Кампании «Местные услуги» позволяют вам рекламировать свой бизнес в Google и получать лиды напрямую от потенциальных клиентов. В этом руководстве описаны поддерживаемые операции и ограничения в текущей версии API Google Рекламы.

Поддерживаемые операции

Поддерживаются следующие операции.

Получить данные о кампаниях и бюджетах местных служб

Информацию о кампаниях и бюджетах местных услуг можно получить с помощью метода GoogleAdsService.Search или GoogleAdsService.SearchStream для запроса ресурсов кампании , где advertising_channel_type = 'LOCAL_SERVICES' . Вот пример:

SELECT
  campaign.id,
  campaign.status,
  campaign_budget.id,
  campaign_budget.period,
  campaign_budget.amount_micros,
  campaign_budget.type
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

Редактировать кампании местных услуг

Вы можете обновить status кампании и связанные с ней поля amount_micros бюджета кампании.

Установите стратегию назначения ставок для кампаний местных услуг

Вы можете установить следующие стратегии назначения ставок в качестве стандартной стратегии назначения ставок для кампаний «Местные услуги»:

Установите расписание показов объявлений как критерий кампании

Вы можете установить расписание показов объявлений для кампании «Местные услуги» в качестве критерия кампании.

Создайте AdScheduleInfo и установите для него ad_schedule критерия CampaignCriterion , который отправляется в API Google Ads с помощью CampaignCriterionService.MutateCampaignCriteria .

Установить таргетинг на местоположение

Чтобы включить геотаргетинг для кампании «Местные услуги», добавьте LocationInfo и укажите location критерия CampaignCriterion , который отправляется в API Google Ads с помощью CampaignCriterionService.MutateCampaignCriteria . Подробнее см. в разделе «Геотаргетинг» .

Ориентируйтесь на конкретные типы услуг

Чтобы включить таргетинг на определенный тип службы, добавьте LocalServiceIdInfo и задайте для него тип службы .

Вам следует использовать идентификатор услуги, соответствующий целевому местоположению и категории вашей кампании.

Отправить отзыв о лиде

Используйте метод ProvideLeadFeedback() сервиса LocalServicesLeadService для отправки оценки и отзыва о лиде. Вы также можете проверить поле lead_feedback_submitted сервиса LocalServicesLead , чтобы определить, была ли лиду дана оценка и был ли отправлен отзыв.

Неподдерживаемые операции

Ограничения, перечисленные в следующей таблице, могут измениться в будущих версиях API Google Ads.

Неподдерживаемые операции
Создание и удаление кампаний API Google Ads блокирует создание новых кампаний «Местные услуги».
Операции над подобъектами в кампании API Google Ads не поддерживает создание, изменение, удаление или извлечение групп объявлений, объявлений или критериев в кампаниях местных услуг.

Ресурсы местных служб

Некоторые данные из рекламы местных услуг отображаются непосредственно в API Google Ads через следующие ресурсы отчетов , доступные только для чтения :

Чтобы эти ресурсы возвращали данные, в клиентской учётной записи, отправляющей запрос, должна быть кампания «Местные услуги». Поскольку на одну клиентскую учётную запись может быть только одна кампания «Местные услуги», эти ресурсы не указывают кампанию. Чтобы определить кампанию, с которой связаны эти ресурсы, используйте следующий запрос:

SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'

Руководитель отдела местных услуг

LocalServicesLead предоставляет подробную информацию о лиде, который генерируется, когда потребитель звонит, отправляет сообщение или заказывает услугу у рекламодателя.

Данные о лидах в сфере местных услуг можно получить из ресурса local_services_lead . Вот пример запроса:

SELECT
  local_services_lead.lead_type,
  local_services_lead.category_id,
  local_services_lead.service_id,
  local_services_lead.contact_details,
  local_services_lead.lead_status,
  local_services_lead.creation_date_time,
  local_services_lead.locale,
  local_services_lead.lead_charged,
  local_services_lead.credit_details.credit_state,
  local_services_lead.credit_details.credit_state_last_update_date_time
FROM local_services_lead

Ограничения

  • Поле contact_details имеет значение null, если lead_status равно WIPED_OUT .
  • Данные по лидам, где category_id является частью категории здравоохранения, недоступны.

Местные службы ведут беседу

LocalServicesLeadConversation предоставляет подробную информацию о диалогах, состоявшихся в рамках LocalServicesLead . С LocalServicesLead существует связь «один ко многим», при которой один лид может иметь несколько диалогов. Имя ресурса для связанного лида можно найти в поле lead .

Данные о разговорах можно получить из ресурса local_services_lead_conversation . Вот пример запроса, который фильтрует результаты по телефонным звонкам:

SELECT
  local_services_lead_conversation.id,
  local_services_lead_conversation.conversation_channel,
  local_services_lead_conversation.participant_type,
  local_services_lead_conversation.lead,
  local_services_lead_conversation.event_date_time,
  local_services_lead_conversation.phone_call_details.call_duration_millis,
  local_services_lead_conversation.phone_call_details.call_recording_url,
  local_services_lead_conversation.message_details.text,
  local_services_lead_conversation.message_details.attachment_urls
FROM local_services_lead_conversation
WHERE local_services_lead_conversation.conversation_channel = 'PHONE_CALL'

Метод LocalServicesLeadService.AppendLeadConversation можно использовать для добавления ресурсов LocalServicesLeadConversation к LocalServicesLead .

Ограничения

  • Чтобы получить доступ к URL-адресу записи разговора, необходимо войти в систему, используя адрес электронной почты, имеющий как минимум права доступа «только для чтения» к клиентской учетной записи Google Ads, которой принадлежит кампания, с которой связан лид.

  • Запрос всех разговоров одновременно может занять много времени, поэтому вам следует отфильтровать разговоры по лидам, например:

    SELECT
local_services_lead_conversation.id,
local_services_lead_conversation.event_date_time,
local_services_lead_conversation.message_details.text
FROM local_services_lead_conversation
WHERE local_services_lead.id = LEAD_ID

Артефакт проверки местных служб

LocalServicesVerificationArtifact предоставляет данные о верификации компаний рекламодателей. Обратите внимание, что эти верификации проводятся на уровне компании и не включают верификации сотрудников. Эти данные включают следующее:

  • Проверки лицензий
  • Страховые проверки
  • Проверка биографических данных
  • Проверки регистрации бизнеса

При каждой отправке запроса на проверку в сервис «Реклама местных услуг» для него в API Google Рекламы создаётся новый экземпляр артефакта проверки, и каждый артефакт проверки представляет собой отдельный запрос. Каждый артефакт проверки может содержать следующую информацию, в зависимости от типа запроса:

  • Статус каждого артефакта проверки
  • URL-адрес для проверки биографических данных, который будет использоваться для подтверждения биографических данных
  • Время вынесения решения по проверке биографических данных (если применимо)
  • URL-адрес страхового документа для просмотра уже отправленной информации о страховании
  • Причина отказа в страховании (если применимо)
  • Данные лицензии (тип, номер, имя, фамилия)
  • Причина отказа в выдаче лицензии (если применимо)
  • URL-адрес лицензионного документа для просмотра уже отправленного изображения лицензии (если применимо)
  • Регистрационные данные предприятия (проверьте идентификационный номер, регистрационный номер)
  • Причина отказа в регистрации бизнеса (если применимо)
  • URL-адрес регистрационного документа предприятия для просмотра уже отправленного регистрационного изображения (если применимо)

Данные артефактов верификации можно получить из ресурса local_services_verification_artifact . Вот пример запроса, который извлекает данные всех артефактов верификации, связанных с лицензией, для заданной учётной записи клиента:

SELECT
  local_services_verification_artifact.id,
  local_services_verification_artifact.creation_date_time,
  local_services_verification_artifact.status,
  local_services_verification_artifact.artifact_type,
  local_services_verification_artifact.license_verification_artifact.license_type,
  local_services_verification_artifact.license_verification_artifact.license_number,
  local_services_verification_artifact.license_verification_artifact.licensee_first_name,
  local_services_verification_artifact.license_verification_artifact.licensee_last_name,
  local_services_verification_artifact.license_verification_artifact.rejection_reason
FROM local_services_verification_artifact
WHERE local_services_verification_artifact.artifact_type = 'LICENSE'

Географические и категориальные данные о лицензиях и страховании

Для программного определения статуса запросов на проверку по географическому положению (в частности, коду геотаргета ) и идентификатору категории местных услуг можно использовать новое поле в ресурсе customer , называемое LocalServicesSettings .

Это поле содержит общую сводку о статусе запросов на проверку лицензий и страховок по местоположению и категории. Вот пример запроса, который извлекает все эти данные:

SELECT
  customer.local_services_settings.granular_license_statuses,
  customer.local_services_settings.granular_insurance_statuses
FROM customer

Местный сотрудник службы поддержки

LocalServicesEmployee раскрывает данные о сотрудниках местных служб, которые рекламодатели загрузили в свои рекламные профили в наши системы.

Вот пример запроса, который извлекает данные обо всех сотрудниках местной службы поддержки для заданной учетной записи клиента:

SELECT
  local_services_employee.status,
  local_services_employee.type,
  local_services_employee.university_degrees,
  local_services_employee.residencies,
  local_services_employee.fellowships,
  local_services_employee.job_title,
  local_services_employee.year_started_practicing,
  local_services_employee.languages_spoken,
  local_services_employee.first_name,
  local_services_employee.middle_name,
  local_services_employee.last_name
FROM local_services_employee