Campagne di Servizi locali

Campagne di Servizi locali ti consentono di pubblicizzare la tua attività su Google e di ricevere lead direttamente potenziali clienti. Questa guida riassume le operazioni supportate e limitazioni previste 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 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 gli elementi status della campagna e budget della campagna associato amount_micros campi.

Impostare la strategia di offerta per le campagne di Servizi locali

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

Impostare una pianificazione annunci come criterio della campagna

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

Crea una AdScheduleInfo e impostala sul 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 una LocationInfo e impostarla sul location del CampaignCriterion, che viene inviato all'API Google Ads, utilizzando CampaignCriterionService.MutateCampaignCriteria Per ulteriori dettagli, consulta la sezione Posizione il targeting per località.

Scegli come target tipi di servizi specifici

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

Devi utilizzare un ID servizio che corrisponda al targeting della campagna location e category.

Operazioni non supportate

Le limitazioni elencate nella seguente tabella possono cambiare nelle versioni future di l'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 Gli annunci di Servizi locali vengono esposti direttamente Nell'API Google Ads tramite le seguenti risorse dei report di sola lettura:

Affinché queste risorse restituiscano dati, deve essere presente un campagna nell'account cliente che ha effettuato la richiesta. E poiché ci possono essere solo una campagna di Servizi locali per account cliente, queste risorse specificare 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 tramite per l'inserzionista.

I dati sulle richieste di Servizi locali possono essere recuperati dal local_services_lead. Ecco un 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 se lead_status è uguale a WIPED_OUT.
  • I dati dei lead in cui category_id fa parte di una categoria sanitaria sono non disponibile.

Conversazione di contatto di Servizi locali

LocalServicesLeadConversation mostra i dettagli di conversazioni che si sono verificate nell'ambito di un LocalServicesLead. Esiste una relazione one-to-many con LocalServicesLead, dove un lead può avere più conversazioni. La risorsa del lead correlato è disponibile nel campo lead.

I dati sulle conversazioni possono essere recuperati dalla local_services_lead_conversation risorsa. 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 LocalServicesLeadService.AppendLeadConversation per aggiungere LocalServicesLeadConversation in un LocalServicesLead.

Limitazioni

  • Per accedere all'URL per la registrazione della chiamata, devi accedere con un indirizzo email che disponga almeno dell'accesso di sola lettura all'account cliente Google Ads proprietario campagna a cui è associato il lead.
  • Richiedere tutte le conversazioni in una volta può essere una richiesta molto dispendiosa in termini di 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 gli inserzionisti aziendali. Tieni presente che questi a livello di attività e non includono verifiche di 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 viene creata l'istanza dell'elemento di verifica nell'API Google Ads e ogni artefatto di verifica rappresenta una singola richiesta di verifica. Ciascuna l'artefatto di verifica potrebbe contenere alcune delle seguenti informazioni, a seconda sul 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 la registrazione già inviata immagine (se applicabile)

I dati degli artefatti di verifica possono essere recuperati dal local_services_verification_artifact risorsa. Ecco una query di esempio che recupera i dati per tutti i 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 su licenze e assicurazioni geografiche e per categoria

Per determinare in modo programmatico lo stato delle richieste di verifica in base all'area geografica località, in particolare il codice del targeting geografico) e categoria servizi locali ID, puoi usare un nuovo nella risorsa customer, LocalServicesSetting

Questo campo mostra un riepilogo generale dello stato della licenza e dell'assicurazione richieste di verifica per località e categoria. Ecco un esempio di query 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 servizio locali che gli inserzionisti hanno caricato il loro annuncio profilo nei nostri sistemi.

Ecco una query di esempio che recupera i dati per 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