Le campagne di Servizi locali ti consentono di pubblicizzare la tua attività su Google e ricevere lead direttamente dai potenziali clienti. Questa guida riassume le operazioni e le restrizioni supportate nella versione corrente dell'API Google Ads.
Operazioni supportate
Recupera le campagne e i budget di Servizi locali
Le campagne e i budget di Servizi locali possono essere recuperati utilizzando il metodo
GoogleAdsService.Search
o
GoogleAdsService.SearchStream
per eseguire query sulle risorse della campagna in cui
advertising_channel_type = 'LOCAL_SERVICES'
. Ecco un esempio:
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'
Modifica le campagne di Servizi locali
Puoi aggiornare i campi status
della campagna e i campi amount_micros
del budget della campagna associato.
Impostare la strategia di offerta per le campagne di Servizi locali
Puoi impostare le seguenti strategie di offerta come strategia di offerta standard delle campagne di Servizi locali:
ManualCpa
impostando il campomanual_cpa
Puoi impostare le offerte di
ManualCpa
tramiteLocalServicesCampaignSettings.category_bids
. Puoi recuperare e impostareLocalServicesCampaignSettings
campagne di Servizi locali tramiteCampaign.local_services_campaign_settings
.MaximizeConversions
impostando il campomaximize_conversions
Impostare una pianificazione annunci come criterio della campagna
Puoi impostare una pianificazione degli annunci per una campagna di Servizi locali come criterio della campagna.
Crea un elemento AdScheduleInfo
e impostalo sul valore
ad_schedule
del
CampaignCriterion
che viene inviato all'API Google Ads utilizzando
CampaignCriterionService.MutateCampaignCriteria
.
Impostare il targeting per località
Per attivare il targeting per località per una campagna di Servizi locali, aggiungi un elemento LocationInfo
e impostalo sul valore location
del CampaignCriterion
che viene inviato all'API Google Ads utilizzando CampaignCriterionService.MutateCampaignCriteria
.
Per ulteriori dettagli, consulta la sezione Targeting per località.
Scegli come target tipi di servizi specifici
Per abilitare il targeting per un tipo di servizio specifico, aggiungi un elemento LocalServiceIdInfo
e impostalo sul tipo di servizio.
Devi utilizzare un ID servizio che corrisponda alla località e alla categoria di targeting della campagna.
Operazioni non supportate
Le limitazioni elencate nella seguente tabella possono cambiare nelle versioni future dell'API Google Ads.
Operazioni non supportate | |
---|---|
Creare e rimuovere campagne | L'API Google Ads blocca la creazione di nuove campagne di Servizi locali. |
Operazioni su entità secondarie in una campagna | L'API Google Ads non supporta la creazione, la modifica, la rimozione o il recupero di gruppi di annunci, annunci o criteri nelle campagne di Servizi locali. |
Risorse di Servizi locali
A partire dalla versione 15 dell'API Google Ads, alcuni dati degli annunci di Servizi locali vengono esposti direttamente nell'API Google Ads tramite le seguenti risorse dei report di sola lettura:
local_services_lead
local_services_lead_conversation
local_services_verification_artifact
local_services_employee
Affinché queste risorse restituiscano dati, nell'account cliente deve essere presente una campagna di Servizi locali che effettua la richiesta. Poiché può esistere una sola campagna di Servizi locali per account cliente, queste risorse non specificano una campagna. Per identificare la campagna a cui queste risorse sono affiliate, utilizza questa query:
SELECT campaign.id
FROM campaign
WHERE campaign.advertising_channel_type = 'LOCAL_SERVICES'
Lead di Servizi locali
LocalServicesLead
mostra i dettagli di un lead generati quando un consumatore chiama, invia messaggi o prenota un servizio presso l'inserzionista.
I dati sulle richieste di Servizi locali possono essere recuperati dalla risorsa local_services_lead
. Ecco una
query di esempio:
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
Limitazioni
- Il campo
contact_details
è nullo selead_status
è uguale aWIPED_OUT
. - I dati dei lead in cui
category_id
fa parte di una categoria sanitaria non sono disponibili.
Conversazione di contatto di Servizi locali
LocalServicesLeadConversation
mostra i dettagli delle conversazioni che si sono verificate nell'ambito di
LocalServicesLead
. Esiste una relazione one-to-many con
LocalServicesLead
in cui un lead può avere molte conversazioni. Il nome
della risorsa per il lead correlato è disponibile nel campo lead
.
I dati sulle conversazioni possono essere recuperati dalla risorsa local_services_lead_conversation
. Di seguito è riportato un esempio di query che filtra i risultati relativi alle telefonate:
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 partire dalla versione 17 dell'API Google Ads, puoi utilizzare il metodo LocalServicesLeadService.AppendLeadConversation
per aggiungere risorse LocalServicesLeadConversation
a un LocalServicesLead
.
Limitazioni
- Per accedere all'URL di registrazione delle chiamate, devi accedere con un indirizzo email che disponga almeno dell'accesso di sola lettura all'account cliente Google Ads proprietario della campagna a cui è associato il lead.
Richiedere tutte le conversazioni contemporaneamente può richiedere molto tempo, quindi devi filtrare le conversazioni per lead, ad esempio:
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
Artefatto della verifica di Servizi locali
LocalServicesVerificationArtifact
espone i dati di verifica per le attività degli inserzionisti. Tieni presente che queste verifiche sono a livello di attività e non includono verifiche per i dipendenti. I dati includono:
- Verifiche delle licenze
- Verifiche assicurative
- Verifiche dei controlli dei precedenti
- Verifiche della registrazione dell'attività
Ogni volta che viene inviata una richiesta di verifica agli annunci di Servizi locali, viene creata una nuova istanza dell'elemento di verifica nell'API Google Ads e ciascun elemento di verifica rappresenta una singola richiesta di verifica. Ogni elemento di verifica potrebbe contenere alcune delle seguenti informazioni, a seconda del tipo di richiesta di verifica che rappresenta:
- Stato di ogni artefatto della verifica
- URL per il controllo dei precedenti da utilizzare per la verifica del controllo dei precedenti
- Data/ora di aggiudicazione per il controllo dei precedenti (se applicabile)
- URL del documento assicurativo per visualizzare le informazioni sull'assicurazione già inviate
- Motivo del rifiuto dell'assicurazione (se applicabile)
- Dettagli della licenza (tipo, numero, nome, cognome)
- Motivo del rifiuto della licenza (se applicabile)
- URL del documento di licenza per visualizzare l'immagine della licenza già inviata (se applicabile)
- Dettagli di registrazione dell'attività (ID controllo, numero di registrazione)
- Motivo del rifiuto della registrazione dell'attività (se applicabile)
- URL del documento di registrazione dell'attività per visualizzare l'immagine di registrazione già inviata (se applicabile)
I dati degli artefatti di verifica possono essere recuperati dalla risorsa local_services_verification_artifact
. Ecco una query di esempio che recupera i dati per tutti gli artefatti di verifica relativi alla licenza per un determinato account 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'
Dati su licenze e assicurazioni geografiche e per categoria
Per determinare in modo programmatico lo stato delle richieste di verifica in base alla posizione geografica, in particolare al codice del targeting geografico) e all'ID categoria di servizi locali, puoi utilizzare un nuovo campo nella risorsa customer
denominato LocalServicesSetting
.
Questo campo mostra un riepilogo generale dello stato delle richieste di verifica delle licenze e delle assicurazioni suddivise per località e categoria. Ecco una query di esempio che recupera tutti questi dati:
SELECT
customer.local_services_settings.granular_license_statuses,
customer.local_services_settings.granular_insurance_statuses
FROM customer
Dipendente di Servizi locali
LocalServicesEmployee
espone i dati relativi ai dipendenti dei servizi locali che gli inserzionisti hanno caricato nei nostri sistemi con il loro profilo degli annunci.
Ecco una query di esempio che recupera i dati per tutti i dipendenti del servizio locale per un determinato account client:
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