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

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

Установить геотаргетинг

Чтобы включить таргетинг на местоположение для кампании "Местные услуги", добавьте LocationInfo и задайте для него location CampaignCriterion , которое отправляется в API Google Рекламы, с помощью CampaignCriterionService.MutateCampaignCriteria . Дополнительную информацию см. в разделе Таргетинг на местоположение .

Таргетинг на конкретные типы услуг

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

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

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

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

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

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

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

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

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'

Начиная с версии 17 API Google Рекламы, вы можете использовать метод LocalServicesLeadService.AppendLeadConversation для добавления ресурсов LocalServicesLeadConversation к LocalServicesLead .

Ограничения

  • Чтобы получить доступ к 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.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 ресурсе под названием LocalServicesSetting .

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

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