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

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

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

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

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

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

Настройте таргетинг по местоположению

Чтобы включить таргетинг по местоположению для кампании «Локальные услуги», добавьте LocationInfo и установите для него location , указанное в CampaignCriterion , который отправляется в Google Ads API, используя 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 можно получить из ресурса 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 предоставляет данные для проверки бизнеса рекламодателей. Обратите внимание, что эти проверки проводятся на уровне бизнеса и не включают проверки сотрудников. Данные включают следующее:

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

При каждой отправке запроса на подтверждение в Local Services Ads в API Google Ads создается новый экземпляр артефакта подтверждения, и каждый артефакт подтверждения представляет собой отдельный запрос на подтверждение. В зависимости от типа запроса на подтверждение каждый артефакт подтверждения может содержать следующую информацию:

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

Кампании Local Services Performance Max

Начиная с версии 24.2, кампании Performance Max поддерживают настройки, связанные с локальными службами. Эти настройки позволяют конфигурировать и идентифицировать кампанию Performance Max, которая показывает объявления локальных служб (GLS PMax).

Выявление кампаний Local Services Performance Max

Чтобы определить, является ли кампания Performance Max кампанией локальных служб, проверьте поле local_services_enabled доступное только для чтения, в pmax_campaign_settings этой кампании.

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

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

  • 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 : Номер телефона получателя, используемый для звонков из рекламного блока Local Services (по умолчанию).
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY : Номер телефона получателя, поддерживающий SMS.
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY : Номер телефона получателя для аккаунта WhatsApp оператора связи.