Campanhas dos Serviços Locais

Com as campanhas dos Serviços Locais, você anuncia sua empresa no Google e recebe leads diretamente de clientes em potencial. Este guia resume as operações e restrições compatíveis na versão atual da API Google Ads.

Operações compatíveis

A API Google Ads oferece suporte às seguintes operações para campanhas de Serviços locais.

Recuperar campanhas e orçamentos dos Serviços Locais

As campanhas e os orçamentos dos Serviços locais podem ser recuperados usando o método GoogleAdsService.Search ou GoogleAdsService.SearchStream para consultar recursos Campaign em que advertising_channel_type = 'LOCAL_SERVICES'. Confira um exemplo:

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'

Editar campanhas dos Serviços Locais

Você pode atualizar os campos status da campanha e amount_micros do orçamento associado.

Definir a estratégia de lances das campanhas dos Serviços Locais

Você pode definir as seguintes estratégias de lances como a padrão das campanhas de Serviços locais:

Definir uma programação de anúncios como critério de campanha

É possível definir uma programação de anúncios para uma campanha de Serviços Locais como um critério de campanha.

Crie um AdScheduleInfo e defina-o como o ad_schedule do CampaignCriterion enviado à API Google Ads usando CampaignCriterionService.MutateCampaignCriteria.

Definir a segmentação por local

Para ativar a segmentação por local em uma campanha de Serviços locais, adicione um LocationInfo e defina-o como o campo location do CampaignCriterion enviado à API Google Ads usando CampaignCriterionService.MutateCampaignCriteria. Para mais detalhes, consulte Segmentação por local.

Segmentar tipos de serviços específicos

Para ativar a segmentação de um tipo de serviço específico, crie um LocalServiceIdInfo com um dos IDs de categoria dos Serviços locais, defina-o no campo local_service_id de um CampaignCriterion e envie usando CampaignCriterionService.MutateCampaignCriteria.

Use um ID de serviço que corresponda ao local e à categoria da segmentação da sua campanha.

Enviar feedback sobre leads

Use o método ProvideLeadFeedback da LocalServicesLeadService para enviar avaliações e feedback de um lead. Também é possível inspecionar o campo lead_feedback_submitted do LocalServicesLead para ajudar a determinar se um lead foi classificado e se um feedback foi enviado.

Operações incompatíveis

As restrições listadas na tabela a seguir podem mudar em versões futuras da API Google Ads.

Operações incompatíveis
Criar e remover campanhas A API Google Ads bloqueia a criação de campanhas de Serviços Locais.
Operações em subentidades de uma campanha A API Google Ads não oferece suporte à criação, modificação, remoção ou recuperação de grupos de anúncios, anúncios ou critérios em campanhas de serviços locais.

Recursos dos Serviços Locais

Alguns dados dos anúncios de Serviços Locais são expostos diretamente na API Google Ads usando os seguintes recursos de relatório somente leitura:

Para que esses recursos retornem dados, é necessário haver uma campanha de Serviços Locais na conta de cliente que está fazendo a solicitação. Como só pode haver uma campanha de Serviços locais por conta de cliente, esses recursos não especificam uma campanha. Para identificar a campanha a que esses recursos estão afiliados, use a seguinte consulta:

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

Lead dos Serviços Locais

O LocalServicesLead expõe os detalhes de um lead gerado quando um consumidor liga, envia mensagens ou agenda um serviço do anunciante.

Os dados de leads dos Serviços locais podem ser extraídos do recurso local_services_lead. Confira um exemplo de consulta:

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

Limitações

  • O campo contact_details será nulo se lead_status for igual a WIPED_OUT.
  • A partir de v25, ContactDetails.email será removido e ContactDetails.phone_number_extension estará disponível na mensagem ContactDetails retornada por local_services_lead.contact_details.
  • Os dados de leads em que o category_id faz parte de uma categoria de saúde não estão disponíveis.

Conversa de lead dos Serviços Locais

LocalServicesLeadConversation expõe os detalhes das conversas que ocorreram como parte de um LocalServicesLead. Existe uma relação de um para muitos com LocalServicesLead, em que um lead pode ter várias conversas. O nome do recurso para o lead relacionado pode ser encontrado no campo lead.

Os dados de conversa podem ser recuperados do recurso local_services_lead_conversation. Confira um exemplo de consulta que filtra resultados de ligações telefônicas:

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'

Use o método LocalServicesLeadService.AppendLeadConversation para anexar recursos LocalServicesLeadConversation a um LocalServicesLead.

Limitações

  • Para acessar o URL da gravação de chamada, faça login com um endereço de e-mail que tenha pelo menos acesso somente leitura à conta de cliente do Google Ads proprietária da campanha associada ao lead.

  • Solicitar todas as conversas de uma só vez pode ser demorado. Por isso, filtre as conversas por lead, por exemplo:

    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'

Artefato de verificação dos Serviços Locais

LocalServicesVerificationArtifact expõe dados de confirmação de identidade das empresas dos anunciantes. Essas verificações são feitas no nível da empresa e não incluem as dos funcionários. Os dados incluem o seguinte:

  • Verificações de licença
  • Verificações de seguros
  • Verificações de investigação de histórico para contratação
  • Verificações de registro comercial

Sempre que uma solicitação de verificação é enviada aos anúncios dos Serviços Locais, uma nova instância de artefato de verificação é criada para ela na API Google Ads, e cada artefato representa uma única solicitação. Cada artefato de verificação pode conter algumas das seguintes informações, dependendo do tipo de solicitação de verificação que ele representa:

  • Status de cada artefato de verificação
  • URL da investigação de histórico para ser usado na verificação
  • Tempo de análise da investigação de histórico para contratação (se aplicável)
  • URL do documento do seguro para conferir as informações já enviadas
  • Motivo da rejeição do seguro (se aplicável)
  • Detalhes da licença (tipo, número, nome e sobrenome)
  • Motivo da rejeição da licença (se aplicável)
  • URL do documento de licença para ver a imagem de licença já enviada (se aplicável)
  • Detalhes do registro comercial (verifique o ID e o número de registro)
  • Motivo da rejeição do registro comercial (se aplicável)
  • URL do documento de registro comercial para ver a imagem de registro já enviada (se aplicável)

Os dados do artefato de verificação podem ser recuperados do recurso local_services_verification_artifact. Confira um exemplo de consulta que recupera dados de todos os artefatos de verificação relacionados a licenças de uma determinada conta de cliente:

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'

Dados geográficos e categóricos de licença e seguro

Para determinar programaticamente o status das solicitações de verificação por local geográfico (especificamente, código de segmentação geográfica) e ID da categoria dos Serviços locais, use o campo local_services_settings no recurso customer, que tem o tipo LocalServicesSettings.

Esse campo mostra um resumo de alto nível do status das solicitações de verificação de licença e seguro por local e categoria. Confira um exemplo de consulta que recupera todos esses dados:

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

Funcionário de serviços locais

O LocalServicesEmployee expõe os dados sobre funcionários de serviços locais que os anunciantes enviaram para nossos sistemas.

Confira um exemplo de consulta que recupera dados de todos os funcionários de serviços locais de uma determinada conta de cliente:

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

Campanhas Performance Max dos Serviços Locais

As campanhas Performance Max vão oferecer suporte às configurações relacionadas aos Serviços locais a partir de v24. Com essas configurações, você pode configurar e identificar uma campanha Performance Max que veicula anúncios dos Serviços locais (PMax para ASL).

Identificar campanhas Performance Max de Serviços locais

Para identificar se uma campanha Performance Max é uma campanha de serviços locais, verifique o campo somente leitura local_services_enabled na pmax_campaign_settings da campanha.

Definir configurações

Para campanhas em que local_services_enabled é true, configure as definições no campo local_services_pmax_campaign_settings:

  • navigational_query_leads_enabled: especifica se um filtro de consulta de navegação será usado.
  • founding_year: o ano de fundação da empresa.
  • country_code: o código do país do anúncio de serviços locais. Esse campo é imutável e definido apenas uma vez durante a criação do anúncio. É um código do país de duas letras em maiúsculas, usado para determinar os requisitos de verificação e validar a seleção do critério de local.
  • phone_numbers: uma lista de números de telefone associados ao provedor, representados por mensagens LocalServicesPhoneNumber.

Números de telefone

Cada entrada no campo repetido phone_numbers usa o tipo de mensagem LocalServicesPhoneNumber com os seguintes campos:

  • phone_number: o número de telefone.
  • country_code: maiúsculo, com duas letras do código do país.
  • phone_number_type: o tipo de número de telefone, definido por GlsPhoneNumberTypeEnum.GlsPhoneNumberType. Os tipos compatíveis incluem:
    • DESTINATION_PHONE_NUMBER_FOR_ADS: número de destino a ser usado para ligações de um bloco de anúncios dos Serviços locais (padrão).
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: número de destino que aceita SMS.
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: número de destino de uma conta do WhatsApp de um provedor.