Campanhas dos Serviços Locais

As campanhas dos Serviços Locais permitem que você anuncie sua empresa no Google e receba 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

As seguintes operações são compatíveis.

Recuperar campanhas e orçamentos dos Serviços Locais

As campanhas e os orçamentos dos Serviços Locais podem ser recuperados usando o GoogleAdsService.Search ou GoogleAdsService.SearchStream método para consultar os recursos da campanha 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

É possível 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 estratégia padrão das campanhas dos Serviços Locais:

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

É possível definir uma programação de anúncios para uma campanha dos 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 dos Serviços Locais, adicione um LocationInfo e defina-o como o location do CampaignCriterion que é enviado à API Google Ads usando CampaignCriterionService.MutateCampaignCriteria. Para mais detalhes, consulte Segmentação geográfica.

Segmentar tipos de serviço específicos

Para ativar a segmentação de um tipo de serviço específico, adicione um LocalServiceIdInfo e defina-o como o tipo de serviço.

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

Enviar feedback de leads

Use o ProvideLeadFeedback() método do LocalServicesLeadService para enviar classificação e feedback de um lead. Você também pode inspecionar o lead_feedback_submitted campo do LocalServicesLead para determinar se um lead foi classificado e o 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 novas campanhas dos Serviços Locais.
Operações em subentidades em 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 dos Serviços Locais.

Recursos dos Serviços Locais

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

Para que esses recursos retornem dados, é necessário que haja uma campanha dos Serviços Locais na conta de cliente que está fazendo a solicitação. Como só pode haver uma campanha dos 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

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

Os dados de leads dos Serviços Locais podem ser recuperados do local_services_lead recurso. 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 é nulo se lead_status for igual a WIPED_OUT.
  • 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. Há uma relação de um para muitos com LocalServicesLead, em que um lead pode ter muitas conversas. O nome do recurso do lead relacionado pode ser encontrado no campo lead.

Os dados de conversas podem ser recuperados do local_services_lead_conversation recurso. Confira um exemplo de consulta que filtra resultados de chamadas 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'

Você pode usar o LocalServicesLeadService.AppendLeadConversation método para adicionar ao final LocalServicesLeadConversation recursos a um LocalServicesLead.

Limitações

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

  • Solicitar todas as conversas de uma vez pode ser uma solicitação demorada. 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.id = LEAD_ID

Artefato de verificação dos Serviços Locais

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

  • Verificações de licença
  • Verificações de seguro
  • 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 de verificação representa uma única solicitação de verificaçã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 de investigação de histórico para contratação a ser usado para verificação
  • Tempo de julgamento da investigação de histórico para contratação (se aplicável)
  • URL do documento de seguro para visualizar as informações de seguro 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 visualizar a imagem da licença já enviada (se aplicável)
  • Detalhes do registro comercial (ID de verificação, número de registro)
  • Motivo da rejeição do registro comercial (se aplicável)
  • URL do documento de registro comercial para visualizar a imagem de registro já enviada (se aplicável)

Os dados de artefatos de verificação podem ser recuperados do local_services_verification_artifact recurso. Confira um exemplo de consulta que recupera dados de todos os artefatos de verificação relacionados à licença 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 de serviços locais, você pode usar um novo campo no recurso customer, chamado LocalServicesSettings.

Esse campo expõe 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

LocalServicesEmployee expõe os dados sobre funcionários de serviços locais que os anunciantes fizeram upload do perfil de anúncio nos 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 oferecem suporte a configurações relacionadas aos Serviços Locais a partir da versão 24.2. Essas configurações permitem configurar e identificar uma campanha Performance Max que veicula anúncios dos Serviços Locais (GLS PMax).

Identificar campanhas Performance Max dos Serviços Locais

Para identificar se uma campanha Performance Max é uma campanha dos Serviços Locais, verifique o campo local_services_enabled somente leitura nas pmax_campaign_settings da campanha.

Definir configurações

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

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

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: código do país de duas letras maiúsculas .
  • phone_number_type: o tipo de número de telefone, definido por GlsPhoneNumberTypeEnum.GlsPhoneNumberType. Os tipos com suporte incluem:
    • DESTINATION_PHONE_NUMBER_FOR_ADS: número de destino a ser usado para chamadas de um bloco de anúncios dos Serviços Locais (padrão).
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: número de destino que oferece suporte a SMS.
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: número de destino da conta do WhatsApp de um provedor.