Campagne Servizi locali

Le campagne di Servizi locali ti consentono di pubblicizzare la tua attività su Google e ricevere richieste direttamente dai potenziali clienti. Questa guida riassume le operazioni e le limitazioni supportate nell'API Google Ads.

Operazioni supportate

L'API Google Ads supporta le seguenti operazioni per le campagne di Servizi locali.

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 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'

Modifica le campagne di Servizi locali

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

Imposta la strategia di offerta

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

• ManualCpa impostando il campo manual_cpa

  Puoi impostare le offerte di ManualCpa tramite LocalServicesCampaignSettings.category_bids. Puoi recuperare e impostare LocalServicesCampaignSettings delle campagne di Servizi locali tramite Campaign.local_services_campaign_settings.

• MaximizeConversions impostando il campo maximize_conversions

Imposta una pianificazione degli annunci come criterio della campagna

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

Crea un AdScheduleInfo e impostalo su ad_schedule di CampaignCriterion che viene inviato all'API Google Ads utilizzando CampaignCriterionService.MutateCampaignCriteria.

Imposta il targeting per località

Per attivare il targeting per località per una campagna di Servizi locali, aggiungi un LocationInfo e impostalo nel campo location della CampaignCriterion inviata all'API Google Ads, utilizzando CampaignCriterionService.MutateCampaignCriteria. Per maggiori dettagli, consulta Targeting per località.

Scegli come target tipi di servizi specifici

Per attivare il targeting per un tipo di servizio specifico, crea un LocalServiceIdInfo con uno degli ID categoria di Servizi locali, impostalo nel campo local_service_id di un CampaignCriterion e invialo utilizzando CampaignCriterionService.MutateCampaignCriteria.

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

Invia feedback sui lead

Utilizza il metodo ProvideLeadFeedback di LocalServicesLeadService per inviare la valutazione e il 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

La tabella seguente elenca le operazioni non supportate per le campagne di Servizi locali autonome (advertising_channel_type = 'LOCAL_SERVICES').

Risorse di Servizi locali

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 che effettua la richiesta deve essere presente una campagna Servizi locali o una campagna Performance Max per Servizi locali. Il campo local_services_lead.campaign collega i record dei lead alla campagna associata (incluse le campagne Performance Max per gli obiettivi pay-per-lead in cui campaign.advertising_channel_type = 'PERFORMANCE_MAX' e campaign.pmax_campaign_settings.local_services_enabled = true). Per identificare la campagna a cui sono affiliate queste risorse, utilizza la seguente query:

SELECT
  campaign.id,
  campaign.advertising_channel_type,
  campaign.pmax_campaign_settings.local_services_enabled
FROM campaign
WHERE campaign.advertising_channel_type IN ('LOCAL_SERVICES', 'PERFORMANCE_MAX')

Lead di Servizi locali

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

Il tipo di lead è definito da LocalServicesLeadType. A partire dal giorno v26, COUPON è supportato per attivare i tipi di lead con coupon nelle campagne di Servizi locali e Performance Max per Servizi locali.

Il campo campaign collega il record del lead alla campagna associata. Oltre a selezionare i campi campaign attribuiti (come campaign.id e campaign.name), puoi filtrare le query sui lead in base al nome della risorsa della campagna (WHERE local_services_lead.campaign = ...) o al tipo di canale pubblicitario (WHERE campaign.advertising_channel_type = ...) per segmentare i lead in base al tipo di campagna.

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,
  local_services_lead.campaign
FROM local_services_lead

Limitazioni

• Il campo contact_details è null se lead_status è uguale a WIPED_OUT.
• A partire dalla versione v25, ContactDetails.email viene rimosso e ContactDetails.phone_number_extension è disponibile nel messaggio ContactDetails restituito da local_services_lead.contact_details.
• 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 hanno avuto luogo nell'ambito di una LocalServicesLead. Esiste una relazione one-to-many con LocalServicesLead, in cui un lead può avere più conversazioni. Il nome della risorsa per il lead correlato è disponibile nel campo lead.

I dati della conversazione possono essere recuperati dalla risorsa local_services_lead_conversation. Ecco una query di esempio che filtra i risultati per le chiamate:

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 della registrazione della chiamata, 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_conversation.lead = 'customers/CUSTOMER_ID/localServicesLeads/LEAD_ID'
  

Artefatti di verifica

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

• Verifiche delle licenze
• Verifiche dell'assicurazione
• 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 elemento di verifica
• URL del controllo dei precedenti da utilizzare per la verifica del controllo dei precedenti
• Tempo di valutazione 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, 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à (controlla l'ID, il 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 elementi 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 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_override_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 di verifica geografici e categoriali

Per determinare in modo programmatico lo stato delle richieste di verifica in base alla posizione geografica (nello specifico, il codice di targeting geografico) e all'ID categoria di Servizi locali, puoi utilizzare il campo local_services_settings nella risorsa customer, che ha il tipo LocalServicesSettings.

Questo campo mostra un riepilogo generale dello stato delle richieste di verifica della licenza e dell'assicurazione 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 nel profilo dell'annuncio nei nostri sistemi.

Ecco una query di esempio che recupera i dati di tutti i dipendenti dei servizi locali 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

Campagne Performance Max per Servizi locali

Le campagne Performance Max supportano le impostazioni relative ai Servizi locali a partire dalla versione v24. Queste impostazioni ti consentono di configurare e identificare una campagna Performance Max che pubblica annunci di Servizi locali (PMax GLS).

Crea campagne Performance Max per Servizi locali

A partire dal giorno v26, l'API Google Ads supporta sia la creazione che l'aggiornamento delle campagne Performance Max di Servizi locali. Puoi creare nuove campagne Performance Max di Servizi locali tramite l'API creando una campagna Performance Max (advertising_channel_type = 'PERFORMANCE_MAX') e impostando local_services_enabled = true su pmax_campaign_settings (immutabile dopo la creazione). Quando crei una campagna Performance Max di Servizi locali, sia country_code sia listing_id sono obbligatori in local_services_pmax_campaign_settings. In v24 e v25, l'API supporta solo gli aggiornamenti per le campagne Performance Max locali esistenti create nell'interfaccia utente dagli account inclusi nella lista consentita. Per istruzioni end-to-end sulla configurazione dei prerequisiti e sulla creazione di campagne in modo atomico, consulta la guida a Performance Max per gli obiettivi pay-per-lead.

Identifica le campagne Performance Max di Servizi locali

Per identificare se una campagna Performance Max è una campagna di Servizi locali, controlla il campo local_services_enabled nel pmax_campaign_settings della campagna. Questo campo è un valore booleano immutabile (CREATE ONLY) impostato su true al momento della creazione della campagna.

Configura impostazioni

Per le campagne in cui local_services_enabled è true, configura le impostazioni nel campo local_services_pmax_campaign_settings:

• listing_id: l'ID della scheda Profilo dell'attività su Google collegata alla campagna. A partire dal v26, questo campo è obbligatorio e immutabile durante la creazione della campagna Performance Max di Servizi locali. L'ID scheda deve essere collegato all'account come asset LOCATION attivato; in caso contrario, l'API restituisce un errore CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID. Poiché listing_id è contrassegnato come IMMUTABLE, il tentativo di aggiornare questo campo dopo la creazione della campagna non va a buon fine e viene visualizzato l'errore RequestError.IMMUTABLE_FIELD. Gli sviluppatori possono scoprire o verificare gli ID scheda collegati eseguendo una query sulla risorsa Asset per gli asset LOCATION attivati (ispezionando location_asset.business_profile_locations). Per saperne di più, consulta Asset posizione.
• navigational_query_leads_enabled: indica se utilizzare un filtro per le query di navigazione.
• founding_year: l'anno di fondazione dell'attività.
• country_code: il codice paese dell'annuncio di Servizi locali. A partire dal giorno v26, questo campo è obbligatorio e immutabile e viene impostato una sola volta durante la creazione della campagna. Si tratta di un codice paese di due lettere maiuscole (al momento, per le campagne Performance Max per Servizi locali è supportato solo US), utilizzato per determinare i requisiti di verifica e convalidare la selezione dei criteri di località.
• phone_numbers: un elenco di numeri di telefono associati al fornitore, rappresentati dai messaggi LocalServicesPhoneNumber. Se omesso, il numero di chiamata corrisponde per impostazione predefinita al numero di telefono indicato nella scheda del profilo dell'attività su Google collegata ed è obbligatorio se la scheda del profilo dell'attività non contiene un numero di telefono.

Numeri di telefono

Ogni voce nel campo ripetuto phone_numbers utilizza il tipo di messaggio LocalServicesPhoneNumber con i seguenti campi:

• phone_number: il numero di telefono.
• country_code: codice paese di due lettere in maiuscolo.
• phone_number_type: Il tipo di numero di telefono, definito daGlsPhoneNumberTypeEnum.GlsPhoneNumberType. I tipi supportati includono:
  • DESTINATION_PHONE_NUMBER_FOR_ADS: numero di destinazione da utilizzare per le chiamate da un'unità annuncio di Servizi locali (per i lead di chiamata, predefinito).
  • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: numero di destinazione che supporta gli SMS (facoltativo, per le notifiche SMS dei lead di messaggi).
  • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: numero di destinazione per l'account WhatsApp di un fornitore.