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.

Recuperare le campagne e i budget di Servizi locali

Le campagne e i budget di Servizi locali possono essere recuperati utilizzando il GoogleAdsService.Search o GoogleAdsService.SearchStream metodo 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'
consulta la guida alle prestazioni a livello di campagna Performance Max e le campagne Performance Max di Servizi locali.

Modificare le campagne di Servizi locali

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

Impostare la strategia di offerta

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

Impostare 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 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 sul location campo del CampaignCriterion inviato all'API Google Ads utilizzando CampaignCriterionService.MutateCampaignCriteria. Per maggiori dettagli, consulta Targeting per località.

Scegliere 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 sul 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.

Inviare feedback sui lead

Utilizza il ProvideLeadFeedback metodo di LocalServicesLeadService per inviare valutazioni e feedback per un lead. Puoi anche controllare il lead_feedback_submitted campo di LocalServicesLead per determinare se un lead è stato valutato e se sono stati inviati feedback.

Operazioni non supportate

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

Operazioni non supportate
Creare e rimuovere campagne L'API Google Ads blocca la creazione e la rimozione di campagne di Servizi locali autonome (advertising_channel_type = 'LOCAL_SERVICES'). A partire dalla v26, puoi creare nuove campagne Performance Max di Servizi locali (advertising_channel_type = 'PERFORMANCE_MAX') impostando pmax_campaign_settings.local_services_enabled = true; consulta Creare campagne Performance Max di Servizi locali.
Operazioni sulle sottoentità in una campagna Per le campagne di Servizi locali autonome (advertising_channel_type = 'LOCAL_SERVICES'), l'API Google Ads non supporta la creazione, la modifica, la rimozione o il recupero di gruppi di annunci, annunci o criteri diversi dai criteri della campagna elencati in Operazioni supportate. Per le campagne Performance Max di Servizi locali, utilizza i gruppi di asset e i criteri della campagna.

Risorse di Servizi locali

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

Affinché queste risorse restituiscano i dati, nell'account cliente che effettua la richiesta deve essere presente una campagna 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 dell'inserzionista.

I dati dei lead di Servizi locali possono essere recuperati dalla local_services_lead risorsa. 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.
  • A partire da 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 sui lead di Servizi locali

LocalServicesLeadConversation espone 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 più conversazioni. Il nome della risorsa del lead correlato è disponibile nel campo lead.

I dati delle conversazioni possono essere recuperati dalla local_services_lead_conversation risorsa. 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 LocalServicesLeadService.AppendLeadConversation metodo per aggiungere LocalServicesLeadConversation risorse 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, pertanto 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 per le attività degli inserzionisti. Tieni presente che queste verifiche sono a livello di attività e non includono le verifiche per i dipendenti. I dati includono:

  • Verifiche delle licenze
  • Verifiche delle assicurazioni
  • 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 di artefatto di verifica nell'API Google Ads e ogni artefatto di verifica rappresenta una singola richiesta di verifica. Ogni artefatto di verifica può 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 del controllo dei precedenti
  • 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, 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 local_services_verification_artifact risorsa. 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_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 di verifica geografici e categoriali

Per determinare a livello di programmazione lo stato delle richieste di verifica in base alla località geografica (in particolare, al codice del target geografico) e all'ID categoria di Servizi locali, puoi utilizzare il local_services_settings campo `local_services_settings` nella risorsa customer `customer`, che ha il tipo LocalServicesSettings `LocalServicesSettings`.

Questo campo espone un riepilogo di alto livello 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 sui dipendenti di servizi locali che gli inserzionisti hanno caricato nel loro profilo pubblicitario nei nostri sistemi.

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

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

Creare campagne Performance Max di Servizi locali

A partire da v26, 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 in 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.

Nelle versioni v24 e v25, l'API supporta solo gli aggiornamenti per le campagne Performance Max di Servizi locali esistenti create nell'interfaccia utente dagli account nella lista consentita.

Identificare le campagne Performance Max di Servizi locali

Per verificare se una campagna Performance Max è una campagna di Servizi locali, controlla il campo local_services_enabled in pmax_campaign_settings della campagna.

Configurare impostazioni

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

  • listing_id: l'ID della scheda di Profilo dell'attività su Google collegato alla campagna. A partire da v26, questo campo è obbligatorio e immutabile durante la creazione della campagna Performance Max di Servizi locali. L'ID della scheda deve essere collegato all'account come asset LOCATION abilitato; in caso contrario, l' API restituisce un CampaignError.INVALID_LOCAL_SERVICES_PERFORMANCE_MAX_LISTING_ID errore. Poiché listing_id è contrassegnato come IMMUTABLE, il tentativo di aggiornare questo campo dopo la creazione della campagna non riesce e viene restituito l'errore RequestError.IMMUTABLE_FIELD. Gli sviluppatori possono scoprire o verificare gli ID delle schede collegate eseguendo una query sulla Asset risorsa per gli asset LOCATION abilitati (controllando location_asset.business_profile_locations). Per ulteriori informazioni, consulta Asset posizione.
  • navigational_query_leads_enabled: indica se utilizzare un filtro di query di navigazione.
  • founding_year: l'anno di fondazione dell'attività.
  • country_code: il codice paese dell'annuncio di Servizi locali. Questo campo è immutabile e viene impostato una sola volta durante la creazione dell'annuncio. È un codice paese di due lettere in maiuscolo, utilizzato per determinare i requisiti di verifica e convalidare la selezione dei criteri di località.
  • phone_numbers: un elenco di numeri di telefono associati a il fornitore, rappresentati da LocalServicesPhoneNumber messaggi.

Numeri di telefono

Ogni voce nel campo ripetuto phone_numbers utilizza il LocalServicesPhoneNumber tipo di messaggio 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 da GlsPhoneNumberTypeEnum.GlsPhoneNumberType. I tipi supportati includono:
    • DESTINATION_PHONE_NUMBER_FOR_ADS: numero di destinazione da utilizzare per le chiamate da un'unità pubblicitaria di annunci di Servizi locali (impostazione predefinita).
    • DESTINATION_PHONE_NUMBER_FOR_SMS_ONLY: numero di destinazione che supporta gli SMS.
    • DESTINATION_PHONE_NUMBER_FOR_WHATSAPP_ONLY: numero di destinazione per l'account WhatsApp di un fornitore.