campanhas do Serviços Locais

Com as campanhas do 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 aceitas na versão atual da API Google Ads.

Operações compatíveis

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

Extrair 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 os recursos da campanha em que advertising_channel_type = 'LOCAL_SERVICES'. 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 e amount_micros do orçamento da campanha associada.

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

É possível definir as seguintes estratégias de lances como padrão nas campanhas de serviços locais:

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

Segmentar tipos de serviço específicos

Para ativar o direcionamento para 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 sua campanha.

Operações incompatíveis

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

Operações incompatíveis
Criar e remover campanhas A API do Google Ads bloqueia a criação de novas 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 do Serviços Locais

Alguns dados dos Anúncios de 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 de serviços locais na conta do cliente que está fazendo a solicitação. E como só pode haver uma campanha do Serviços Locais por conta de cliente, esses recursos não especificam uma campanha. Para identificar a campanha a que esses recursos estão associados, use a seguinte consulta:

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

Lead de Serviços Locais

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

Os dados de lead dos Serviços locais podem ser recuperados 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 vai ser 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 aconteceram 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 da conversa podem ser recuperados do recurso local_services_lead_conversation. Confira um exemplo de consulta que filtra resultados que são ligações:

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'

A partir da versão 17 da API Google Ads, é possível usar 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 de leitura à conta de cliente do Google Ads proprietária da campanha associada ao lead.

  • Solicitar todas as conversas de uma vez pode ser demorado, então 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 verificação para empresas de anunciantes. Observe que essas verificações são no nível da empresa e não incluem verificações para 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 a ser usado para a verificação
  • Horário da adjudicação da investigação de histórico para contratação (se aplicável)
  • URL do documento de seguro para conferir 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 sobrenomes)
  • Motivo da rejeição da licença (se aplicável)
  • URL do documento de licença para acessar a imagem da licença já enviada (se aplicável)
  • Detalhes do registro da empresa (verifique o ID e o número de registro)
  • Motivo da rejeição do registro da empresa (se aplicável)
  • URL do documento de registro comercial para visualizar a imagem de registro já enviada (se aplicável)

Os dados do artefato de verificação podem ser extraídos do recurso local_services_verification_artifact. Confira um exemplo de consulta que extrai 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 de forma programática o status das solicitações de verificação por localização geográfica, especificamente código de destino geográfico e ID da categoria de serviços locais, use um novo campo no recurso customer, chamado 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

LocalServicesEmployee expõe os dados sobre funcionários de serviços locais que os anunciantes enviaram o perfil de anúncios para nossos sistemas.

Confira um exemplo de consulta que extrai dados de todos os funcionários de serviço local 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