Campagne di Servizi locali

Le campagne di Servizi locali ti consentono di pubblicizzare la tua attività su Google e ricevere lead direttamente dai potenziali clienti. Questa guida riepiloga le operazioni e le limitazioni supportate nella versione attuale dell'API Google Ads.

Operazioni supportate

Sono supportate le seguenti operazioni.

Recuperare campagne e 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 campaign 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'

Modificare le campagne Servizi locali

Puoi aggiornare i campi status della campagna e amount_micros del budget della campagna associato.

Impostare la strategia di offerta delle campagne di Servizi locali

Puoi impostare le seguenti strategie di offerta come strategia di offerta standard delle campagne di Servizi locali:

Impostare una pianificazione annunci come criterio della campagna

Puoi impostare una pianificazione annunci per una campagna Servizi locali come criterio della campagna.

Crea un AdScheduleInfo e impostalo su ad_schedule del CampaignCriterion 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 LocationInfo e impostalo su location di CampaignCriterion inviato all'API Google Ads utilizzando CampaignCriterionService.MutateCampaignCriteria. Per maggiori dettagli, vedi Targeting per località.

Scegliere come target tipi di servizio specifici

Per attivare il targeting per un tipo di servizio specifico, aggiungi un LocalServiceIdInfo e impostalo sul tipo di servizio.

Devi utilizzare un ID servizio che corrisponda alla località e alla categoria del targeting della campagna.

Inviare feedback sui lead

Utilizza il metodo ProvideLeadFeedback() di LocalServicesLeadService per inviare valutazioni e feedback per un lead. Puoi anche esaminare il campo lead_feedback_submitted di LocalServicesLead per determinare se un lead è stato valutato e se è stato inviato un feedback.

Operazioni non supportate

Le limitazioni elencate nella tabella seguente potrebbero 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 sulle 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

Alcuni dati degli annunci di Servizi locali sono esposti direttamente nell'API Google Ads tramite le seguenti risorse di report di sola lettura:

Affinché queste risorse restituiscano dati, nell'account cliente che effettua la richiesta deve essere presente una campagna di annunci di Servizi locali. Poiché può esistere una sola campagna di Servizi locali per account cliente, queste risorse non specificano una campagna. Per identificare la campagna a cui sono affiliate queste risorse, utilizza la seguente query:

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

Lead di Servizi locali

LocalServicesLead espone i dettagli di un lead generato quando un consumatore chiama, invia un messaggio o prenota un servizio dall'inserzionista.

I dati dei lead 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 è null se lead_status è uguale a WIPED_OUT.
  • I dati dei lead in cui category_id fa parte di una categoria sanitaria non sono disponibili.

Conversazione con un lead di Servizi locali

LocalServicesLeadConversation mostra i dettagli delle conversazioni che si sono svolte nell'ambito di un 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 si trova nel campo lead.

I dati delle conversazioni possono essere recuperati dalla risorsa local_services_lead_conversation. Ecco una query di esempio che filtra i risultati che sono chiamate telefoniche:

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'

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.

  • La richiesta di 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 di verifica di Servizi locali

LocalServicesVerificationArtifact espone i dati di verifica per le attività degli inserzionisti. Tieni presente che queste verifiche vengono eseguite a livello aziendale e non includono verifiche per i dipendenti. I dati includono quanto segue:

  • Verifiche delle licenze
  • Verifiche assicurative
  • Verifiche del controllo 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'artefatto di verifica nell'API Google Ads e ogni artefatto di verifica rappresenta una singola richiesta di verifica. Ogni artefatto di verifica potrebbe contenere alcune delle seguenti informazioni, a seconda del tipo di richiesta di verifica che rappresenta:

  • Stato di ogni artefatto di verifica
  • URL del controllo dei precedenti da utilizzare per la verifica
  • Tempo di aggiudicazione del 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 e 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 della 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 di tutti gli artefatti di verifica correlati 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 geografici e categoriali di licenze e assicurazioni

Per determinare in modo programmatico lo stato delle richieste di verifica in base alla posizione geografica, in particolare il codice di targeting geografico e l'ID categoria di servizi locali, puoi utilizzare un nuovo campo nella risorsa customer, denominato LocalServicesSettings.

Questo campo mostra un riepilogo di alto livello dello stato delle richieste di verifica di licenze e assicurazioni 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 sui dipendenti del servizio locale che gli inserzionisti hanno caricato il loro profilo annuncio nei nostri sistemi.

Ecco una query di esempio che recupera i dati di tutti i dipendenti del servizio locale per un determinato account 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