campanhas do Serviços Locais

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

Operações compatíveis

Recuperar campanhas e orçamentos dos Serviços Locais

É possível recuperar campanhas e orçamentos dos Serviços Locais usando os métodos GoogleAdsService.Search ou GoogleAdsService.SearchStream para consultar os recursos de 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 o campo status da campanha e os campos amount_micros do orçamento associado à campanha.

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

Você pode definir as seguintes estratégias como a estratégia de lances padrão das campanhas dos 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 dos Serviços Locais como um critério de campanha.

Crie uma AdScheduleInfo e a defina como a ad_schedule do CampaignCriterion que é 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 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

Se quiser ativar a segmentação 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 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 permite a 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

A partir da API Google Ads v15, 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, é preciso ter uma campanha do 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 à qual esses recursos estão afiliados, use a seguinte consulta:

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

Líder dos Serviços Locais

LocalServicesLead expõe os detalhes de um lead gerados quando um consumidor chama, envia mensagens ou reserva 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 será nulo se lead_status for igual a WIPED_OUT.
  • Os dados de leads em que category_id faz parte de uma categoria de assistência médica não estão disponíveis.

Conversa de leads dos Serviços Locais

LocalServicesLeadConversation expõe os detalhes de conversas que ocorreram como parte de uma LocalServicesLead. Existe 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. Veja um exemplo de consulta que filtra por 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'

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 proprietária da campanha associada ao lead.

  • Solicitar todas as conversas de uma vez pode ser uma solicitação demorada, então você precisa filtrar 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 das empresas dos anunciantes. Essas verificações estã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 seguro
  • Investigações de histórico para contratação
  • Verificações de registro comercial

Sempre que uma solicitação de verificação é enviada aos anúncios do Serviços Locais, uma nova instância de artefato de verificação é criada na API Google Ads, e cada artefato de verificação representa uma única solicitação. Cada artefato de verificação pode conter algumas das informações a seguir, 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
  • Tempo de adjudicação da investigação de histórico para contratação (se aplicável)
  • URL do documento de seguro para visualizar as informações do 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 visualizar a imagem de licença já enviada (se aplicável)
  • Detalhes do registro da empresa (verificação de identificação e número de registro)
  • Motivo da rejeição do registro da empresa (se aplicável)
  • URL do documento de registro da empresa para visualizar 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ças e seguros

Para determinar programaticamente o status das solicitações de verificação por localização geográfica (mais especificamente, código de segmentação geográfica) e ID da categoria de serviços locais, use um novo campo no recurso customer, chamado LocalServicesSetting.

Esse campo exibe um resumo de alto nível do status das solicitações de verificação de licenças e seguros 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ço local

O LocalServicesEmployee expõe os dados sobre os funcionários do serviço local que foram enviados aos nossos sistemas pelos anunciantes.

Veja um exemplo de consulta que recupera dados de todos os funcionários do 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