Com as campanhas dos 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
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'
. 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 os campos status
da campanha e amount_micros
do orçamento de campanha associado.
Definir a estratégia de lances das campanhas dos Serviços Locais
Você pode definir as seguintes estratégias de lances como padrão das campanhas dos Serviços Locais:
ManualCpa
definindo o campomanual_cpa
.Você pode definir os lances de
ManualCpa
aLocalServicesCampaignSettings.category_bids
. Você pode recuperar e definirLocalServicesCampaignSettings
de campanhas dos Serviços Locais usandoCampaign.local_services_campaign_settings
.MaximizeConversions
definindo o campomaximize_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
da CampaignCriterion
enviada à 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 o location
do CampaignCriterion
que é enviado para a 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, 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 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 permite a criação, modificação, remoção ou recuperação de grupos de anúncios, anúncios ou critérios em campanhas do 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 por meio dos 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 do Serviços Locais na conta de cliente que está fazendo a solicitação. Além disso, 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 à qual 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
lead gerado quando um consumidor liga, envia mensagens ou reserva um serviço do
anunciante.
Os dados de lead dos Serviços Locais podem ser recuperados no recurso local_services_lead
. Aqui está 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 selead_status
for igual aWIPED_OUT
. - Não estão disponíveis dados de leads em que
category_id
faz parte de uma categoria de saúde.
Conversas de leads dos Serviços Locais
LocalServicesLeadConversation
expõe os detalhes das conversas que ocorreram como parte de um
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 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, é possível usar o método LocalServicesLeadService.AppendLeadConversation
para anexar recursos LocalServicesLeadConversation
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 proprietária da campanha a que o lead está associado.
Solicitar todas as conversas de uma 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.id = LEAD_ID
Artefato de verificação dos Serviços Locais
LocalServicesVerificationArtifact
expõe os dados de verificação das empresas dos 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 histórico para contratação
- Verificações de registro de empresa
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 informações a seguir, dependendo do tipo de solicitação de verificação que 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 conferir a imagem de registro já enviada (se aplicável)
Os dados de 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 à 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
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 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 os funcionários de serviços locais que os anunciantes enviaram aos nossos
sistemas.
Este é 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