Campanhas dos Serviços Locais

Com as campanhas de Serviços Locais, você divulga sua empresa no Google e gera leads diretamente de clientes em potencial. Este guia resume as operações e restrições aceitas na API Google Ads.

Operações compatíveis

A API Google Ads é compatível com as seguintes operações para campanhas de Serviços Locais.

Recuperar campanhas e orçamentos de Serviços Locais

As campanhas e os orçamentos de 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 de Serviços Locais

É possível atualizar os campos status da campanha e amount_micros do orçamento da campanha associado.

Definir a estratégia de lances

É possível definir as seguintes estratégias de lances como padrão das campanhas de Serviços Locais:

• ManualCpa definindo o campo manual_cpa

  É possível definir os lances de ManualCpa usando LocalServicesCampaignSettings.category_bids. É possível recuperar e definir LocalServicesCampaignSettings de campanhas de 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

É 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 que é enviado à API Google Ads usando CampaignCriterionService.MutateCampaignCriteria.

Configurar 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 que é enviado à API Google Ads usando CampaignCriterionService.MutateCampaignCriteria. Para mais detalhes, consulte Segmentação por local.

Segmentar tipos de serviço específicos

Para ativar a segmentação para um tipo de serviço específico, crie um LocalServiceIdInfo com um dos IDs de categoria de 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 sua campanha.

Enviar feedback sobre leads

Use o método ProvideLeadFeedback do LocalServicesLeadService para enviar uma classificação e um feedback sobre um lead. Também é possível inspecionar o campo lead_feedback_submitted do LocalServicesLead para ajudar a determinar se um lead foi avaliado e se o feedback foi enviado.

Operações incompatíveis

A tabela a seguir lista as operações não compatíveis com campanhas de 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 de Serviços Locais ou uma campanha Performance Max de Serviços Locais na conta de cliente que faz a solicitação. O campo local_services_lead.campaign vincula os registros de lead à campanha associada, incluindo as campanhas Performance Max para metas de pagamento por lead em que campaign.advertising_channel_type = 'PERFORMANCE_MAX' e campaign.pmax_campaign_settings.local_services_enabled = true. Para identificar a campanha associada a esses recursos, use a seguinte consulta:

SELECT
  campaign.id,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

Lead dos Serviços Locais

LocalServicesLead expõe os detalhes de um lead que são gerados quando um consumidor liga, envia uma mensagem, agenda um serviço ou usa um cupom do anunciante.

O tipo de lead é definido por LocalServicesLeadType. A partir de v26, o COUPON será compatível para ativar tipos de lead de cupom em campanhas de Serviços Locais e campanhas Performance Max para Serviços Locais.

O campo campaign vincula o registro do lead à campanha associada. Além de selecionar campos campaign atribuídos (como campaign.id e campaign.name), é possível filtrar consultas de lead por nome do recurso da campanha (WHERE local_services_lead.campaign = ...) ou por tipo de canal de publicidade (WHERE campaign.advertising_channel_type = ...) para segmentar leads por tipo de campanha.

Os dados de lead dos Serviços Locais podem ser recuperados do recurso local_services_lead. Veja 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,
  local_services_lead.campaign
FROM local_services_lead

Limitações

• O campo contact_details será nulo se lead_status for igual a WIPED_OUT.
• A partir do v25, o ContactDetails.email foi removido e o ContactDetails.phone_number_extension está 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 com 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 várias conversas. O nome do recurso para o lead relacionado pode ser encontrado no campo lead.

Os dados da conversa podem ser recuperados do recurso local_services_lead_conversation. Veja um exemplo de consulta que filtra resultados que são 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'

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 que possui a campanha associada ao lead.

• Solicitar todas as conversas de uma só vez pode ser uma solicitação demorada. Portanto, 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 das empresas dos anunciantes. Essas verificações são feitas no nível da empresa e não incluem os funcionários. Os dados incluem o seguinte:

• Verificações de licença
• Verificações de seguro
• Verificações 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 da investigação de histórico para contratação a ser usado na verificação
• Tempo de adjudicação da investigação de histórico para contratação (se aplicável)
• URL do documento de seguro para ver 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 (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 visualizar a imagem do registro já enviado (se aplicável)

Os dados do artefato de verificação podem ser recuperados do recurso local_services_verification_artifact. Veja 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_override_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 de forma programática 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 da categoria de Serviços Locais, use o campo local_services_settings no recurso customer, que tem o tipo LocalServicesSettings.

Esse campo mostra um resumo geral do status das solicitações de verificação de licença e seguro por local e categoria. Veja 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 os funcionários de serviços locais que os anunciantes enviaram para o perfil de anúncio nos nossos sistemas.

Veja 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 de Serviços Locais

As campanhas Performance Max são compatíveis com as configurações relacionadas aos Serviços Locais a partir de v24. Com essas configurações, é possível configurar e identificar uma campanha Performance Max que veicula anúncios dos Serviços Locais (PMax do GLS).

Criar campanhas Performance Max para Serviços Locais

A partir de v26, a API Google Ads vai permitir criar e atualizar campanhas Performance Max de Serviços Locais. Para criar novas campanhas Performance Max de Serviços Locais pela API, crie uma campanha Performance Max (advertising_channel_type = 'PERFORMANCE_MAX') e defina local_services_enabled = true em pmax_campaign_settings (imutável após a criação). Ao criar uma campanha Performance Max de Serviços Locais, country_code e listing_id são obrigatórios em local_services_pmax_campaign_settings. No v24 e no v25, a API aceita apenas atualizações para campanhas Performance Max de Serviços Locais criadas na interface por contas na lista de permissões. Para instruções completas sobre como configurar pré-requisitos e criar campanhas de forma atômica, consulte o guia de campanhas Performance Max para metas de pagamento por lead.

Identificar campanhas Performance Max para Serviços Locais

Para identificar se uma campanha Performance Max é de Serviços Locais, verifique o campo local_services_enabled no pmax_campaign_settings da campanha. Esse campo é um booleano imutável (CREATE ONLY) definido como true na criação da campanha.

Definir configurações

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

• 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 de campanhas Performance Max para Serviços Locais. O ID da ficha precisa estar vinculado à conta como um recurso LOCATION ativado. Caso contrário, a API vai retornar um erro CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID. Como listing_id está marcado como IMMUTABLE, as tentativas de atualizar esse campo após a criação da campanha falham com RequestError.IMMUTABLE_FIELD. Os desenvolvedores podem descobrir ou verificar IDs de fichas de empresas vinculadas consultando o recurso Asset para recursos LOCATION ativados (inspecionando location_asset.business_profile_locations). Para mais informações, consulte Recursos de local.
• navigational_query_leads_enabled: 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. A partir de v26, esse campo é obrigatório e imutável, definido uma vez durante a criação da campanha. É um código de país de duas letras maiúsculas (atualmente, apenas US é aceito para campanhas Performance Max para Serviços Locais), 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 ao provedor, representados por mensagens LocalServicesPhoneNumber. Se omitido, o número de chamada será, por padrão, o número de telefone na ficha do Perfil da Empresa no Google vinculada. Ele será obrigatório se a ficha do Perfil da Empresa não tiver um número de telefone.

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 com 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 chamadas de um bloco de anúncios dos Serviços Locais (para leads de chamada, padrão).
  • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: número de destino que aceita SMS (opcional, para notificações por SMS de lead de mensagem).
  • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: número de destino da conta do WhatsApp de um provedor.