campanhas do Serviços Locais

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 os restrições na versão atual da API Google Ads.

Operações 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 para consultar os recursos de 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 status e as do orçamento da campanha associada amount_micros.

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 de lances padrão de 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 uma campanha critério.

Crie um AdScheduleInfo e defina-o como o ad_schedule das CampaignCriterion que é enviado à API Google Ads usando o 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 defini-lo como location das CampaignCriterion que é enviado à API Google Ads usando o CampaignCriterionService.MutateCampaignCriteria. Para mais detalhes, consulte Localização segmentação.

Segmentar tipos de serviço específicos

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

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

Operações incompatíveis

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

Operações incompatíveis
Criar e remover campanhas A API Google Ads bloqueia a criação de novas campanhas do 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 para recuperar grupos de anúncios, anúncios ou critérios nas campanhas dos Serviços Locais.

Recursos dos Serviços Locais

A partir da API Google Ads v15, alguns dados de Os anúncios dos Serviços Locais são expostos diretamente na API Google Ads com os seguintes recursos de relatórios somente leitura:

Para que esses recursos retornem dados, é necessário ter um campanha na conta de cliente que fez a solicitação. E, como só pode haver uma campanha do Serviços Locais por conta de cliente, esses recursos não especificar uma campanha. Identificar a campanha a que esses recursos sã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 leads gerados quando um cliente liga, envia mensagens ou reserva um serviço o anunciante.

Os dados de lead dos Serviços Locais podem ser recuperados local_services_lead. Este é 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.
  • Dados de leads em que category_id faz parte de uma categoria de saúde: indisponível.

Conversas de leads dos Serviços Locais

LocalServicesLeadConversation expõe os detalhes das conversas que ocorreram como parte de uma LocalServicesLead. Existe uma relação de um para muitos LocalServicesLead, em que um lead pode ter várias conversas. O recurso o nome do lead relacionado pode ser encontrado no campo lead.

Os dados da conversa podem ser recuperados do local_services_lead_conversation recurso. 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'

A partir da versão 17 da API Google Ads, você pode usar o LocalServicesLeadService.AppendLeadConversation método para anexar LocalServicesLeadConversation recursos para um LocalServicesLead.

Limitações

  • Para acessar o URL de 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 proprietária da campanha à qual o lead está associado.

  • 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 os dados de verificação dos anunciantes negócios. Observe que esses 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 seguros
  • Verificações de histórico para contratação
  • Verificações de registro de empresa

Sempre que um pedido de verificação é enviado aos anúncios dos Serviços Locais, os novos instância de artefato de verificação for criada para ela na API Google Ads e cada artefato de verificação representa uma única solicitação de verificação. Cada o artefato de verificação pode conter algumas das seguintes informações, dependendo sobre o tipo de solicitação de verificação que ela representa:

  • Status de cada artefato de verificação
  • URL que será usado na investigação de histórico para contratação
  • Horário da adjudicação da investigação de histórico para contratação (se aplicável)
  • URL do documento de seguro para acessar as informações 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 de registro da empresa (verificação de identidade, número de registro)
  • Motivo da rejeição do registro da empresa (se aplicável)
  • URL do documento de registro da empresa para acessar o registro já enviado imagem (se aplicável)

Os dados de artefato de verificação podem ser recuperados local_services_verification_artifact recurso. Aqui está um exemplo de consulta que recupera dados para todos os artefatos de verificação relacionados à licença para 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

Determinar o status de solicitações de verificação por área geográfica de forma programática local, mais especificamente, código de segmentação por área geográfica) e categoria de serviços locais ID, é possível usar um novo no recurso customer, chamado LocalServicesSetting.

Esse campo expõe um resumo de alto nível do status da licença e do seguro solicitações de verificação por local e categoria. Aqui está 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 para os quais os anunciantes enviaram seus anúncios nos nossos sistemas.

Aqui está um exemplo de consulta que recupera dados para todos os funcionários de serviço local para 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