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 API Google Ads.

Operações compatíveis

A API Google Ads oferece suporte às seguintes operações para campanhas dos 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 GoogleAdsService.Search ou GoogleAdsService.SearchStream método 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 da campanha associado.

Definir a estratégia de lances

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

• ManualCpa definindo o campo manual_cpa

  É possível definir os lances de ManualCpa usando LocalServicesCampaignSettings.category_bids. Você pode recuperar e definir LocalServicesCampaignSettings de campanhas dos Serviços Locais usando Campaign.local_services_campaign_settings.

• MaximizeConversions definindo o campo maximize_conversions

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

Você pode 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 de uma campanha dos Serviços Locais, adicione um LocationInfo e defina-o como o location field of the CampaignCriterion that is sent to the API Google Ads, using 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, 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-o usando CampaignCriterionService.MutateCampaignCriteria.

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 se o feedback foi enviado.

Operações incompatíveis

A tabela a seguir lista as operações incompatíveis para campanhas dos Serviços Locais independentes (advertising_channel_type = 'LOCAL_SERVICES').

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:

• local_services_lead
• local_services_lead_conversation
• local_services_verification_artifact
• local_services_employee

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.
• A partir de v25, ContactDetails.email é removido e ContactDetails.phone_number_extension fica 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. 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 que são 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'

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

Artefatos de verificação

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 na verificação
• Tempo de decisão 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 de confirmação de identidade geográfica e categórica

Para determinar programaticamente o status das solicitações de verificação por localização geográfica (especificamente, código de segmentação por área geográfica) e ID de categoria dos Serviços Locais, você pode usar o campo local_services_settings no recurso customer, que tem o tipo 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ço local

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 de v24. Essas configurações permitem configurar e identificar uma campanha Performance Max que veicula anúncios dos Serviços Locais (GLS PMax).

Criar campanhas Performance Max dos Serviços Locais

A partir de v26, você pode criar novas campanhas Performance Max dos Serviços Locais pela API criando uma campanha Performance Max (advertising_channel_type = 'PERFORMANCE_MAX') e definindo local_services_enabled = true em pmax_campaign_settings (imutável após a criação). Ao criar uma campanha Performance Max dos Serviços Locais, ambos country_code e listing_id são obrigatórios em local_services_pmax_campaign_settings.

Nas versões v24 e v25, a API oferece suporte apenas a atualizações para campanhas Performance Max dos Serviços Locais criadas na interface por contas na lista de permissões.

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 nas pmax_campaign_settings da campanha.

Definir configurações

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

• listing_id: o ID da ficha do Perfil da Empresa no Google vinculado à campanha. A partir de v26, esse campo é obrigatório e imutável durante a criação da campanha Performance Max dos Serviços Locais. O ID da ficha precisa estar vinculado à conta como um recurso LOCATION ativado. Caso contrário, a API retorna um CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID erro. Como listing_id está marcado como IMMUTABLE, tentar atualizar este campo após a criação da campanha falha com RequestError.IMMUTABLE_FIELD. Os desenvolvedores podem descobrir ou verificar os IDs de ficha vinculados consultando o Asset recurso para recursos LOCATION ativados (inspecionando location_asset.business_profile_locations). Para mais informações, consulte Recursos de local.
• 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 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 oferece suporte a SMS.
  • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: número de destino da conta do WhatsApp de um provedor.