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

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

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

Google Ads API поддерживает следующие операции для кампаний Местных услуг.

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

Чтобы получить кампании и бюджеты Местных услуг, используйте метод GoogleAdsService.Search или GoogleAdsService.SearchStream для запроса ресурсов Campaign, где 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, который отправляется в Google Ads API, с помощью метода CampaignCriterionService.MutateCampaignCriteria.

Как настроить геотаргетинг

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

Как настроить таргетинг на определенные типы услуг

Чтобы включить таргетинг на определенный тип услуг, создайте объект LocalServiceIdInfo с одним из идентификаторов категорий местных услуг, задайте его в поле local_service_id объекта CampaignCriterion и отправьте его с помощью CampaignCriterionService.MutateCampaignCriteria.

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

Как отправить отзыв о лидах

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

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

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

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

Ресурсы Местных услуг

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

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

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.
  • Начиная с версии v25, поле ContactDetails.email удалено, а поле ContactDetails.phone_number_extension доступно в сообщении ContactDetails, возвращаемом методом local_services_lead.contact_details.
  • Данные о лидах, у которых 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'

Чтобы добавить ресурсы LocalServicesLeadConversation в LocalServicesLead, используйте метод LocalServicesLeadService.AppendLeadConversation.

Ограничения

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

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

    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_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'

Объекты проверки

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

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

Каждый раз, когда в Рекламу местных услуг отправляется запрос на проверку, в Google Ads API создается новый экземпляр объекта проверки. Каждый объект проверки представляет собой отдельный запрос на проверку. Каждый артефакт проверки может содержать часть указанной ниже информации в зависимости от типа запроса на проверку:

  • Статус каждого артефакта проверки.
  • 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'

Географические и категорийные данные для проверки

Чтобы программно определить статус запросов на проверку по географическому местоположению (в частности, коду области геотаргетинга) и идентификатору категории местных услуг, вы можете использовать поле local_services_settings ресурса 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

Кампании с максимальной эффективностью для местных услуг

Кампании с максимальной эффективностью поддерживают настройки, связанные с местными услугами, начиная с v24. Эти настройки позволяют настроить и идентифицировать кампанию с максимальной эффективностью, в которой показывается Реклама местных услуг (GLS PMax).

С v26 вы можете создавать новые кампании Местных услуг с максимальной эффективностью через API, установив значение local_services_enabled = true для параметра pmax_campaign_settings (нельзя изменить после создания). При создании кампании с максимальной эффективностью для местных услуг в local_services_pmax_campaign_settings должны быть указаны country_code и listing_id. В версии v25 и более ранних API поддерживал только обновление существующих кампаний, созданных в интерфейсе пользователями из белого списка.

Как найти кампании с максимальной эффективностью для местных услуг

Чтобы определить, является ли кампания с максимальной эффективностью кампанией местных услуг, проверьте поле local_services_enabled в pmax_campaign_settings кампании.

Настройка параметров

Для кампаний, в которых local_services_enabled – это true, задайте настройки в поле local_services_pmax_campaign_settings:

  • listing_id – идентификатор профиля компании в Google, связанного с кампанией. С v26 это поле является обязательным и его нельзя изменить при создании кампании с максимальной эффективностью для местных услуг. Идентификатор предложения должен быть связан с аккаунтом как активный объект LOCATION. В противном случае API возвращает ошибку CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID. Поскольку поле listing_id отмечено как IMMUTABLE, попытка изменить его после создания кампании приведет к ошибке RequestError.IMMUTABLE_FIELD. Разработчики могут найти или проверить идентификаторы связанных страниц, запросив ресурс Asset для включенных объектов LOCATION (проверив location_asset.business_profile_locations). Подробнее об объектах адресов…
  • navigational_query_leads_enabled: использовать ли фильтр навигационных запросов.
  • founding_year – год основания компании.
  • country_code – код страны, в которой показывается реклама местных услуг. Это поле неизменяемое и задается один раз при создании объявления. Это двухбуквенный код страны, написанный заглавными буквами. Он используется для определения требований к подтверждению и проверки выбранного критерия местоположения.
  • phone_numbers – список номеров телефонов, связанных с поставщиком, представленный сообщениями LocalServicesPhoneNumber.

Номера телефонов

Каждая запись в повторяющемся поле phone_numbers использует тип сообщения LocalServicesPhoneNumber со следующими полями:

  • phone_number – номер телефона.
  • country_code – двухбуквенный код страны в верхнем регистре.
  • phone_number_type – тип номера телефона, определяемый атрибутом GlsPhoneNumberTypeEnum.GlsPhoneNumberType. Поддерживаются следующие типы:
    • DESTINATION_PHONE_NUMBER_FOR_ADS – номер телефона, который будет использоваться для звонков из рекламного блока местных услуг (по умолчанию).
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY – номер получателя, поддерживающий SMS.
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY – номер телефона, связанный с аккаунтом WhatsApp поставщика.