Rapporti

I report ti consentono di recuperare informazioni sul rendimento degli annunci e sui lead dei tuoi account collegati.

Rapporti sull'account

I report sull'account mostrano il rendimento e le metriche associati agli account Servizi locali collegati di un account amministratore. Puoi visualizzare questi dati in un periodo di tempo specificato. I dati potrebbero essere obsoleti fino a 30 minuti.

Per acquisire il report, invia una richiesta HTTP GET a https://localservices.googleapis.com/v1/accountReports:search con i seguenti parametri URL configurabili:

Parametri URL
query	Obbligatorio Contiene uno o più valori ID, uno dei quali deve essere l'ID dell'account amministratore per la query. query può accettare più valori separati da punto e virgola: Obbligatorio: manager_customer_id:<manager_cid> (Facoltativo) customer_id:<linked_cid> Esempio: query=manager_customer_id:123;customer_id:456
startDate.day	Facoltativo Il giorno del mese in cui inizia il periodo del report. Può assumere valori compresi tra 1 e 31 inclusi. Il valore predefinito è 1.
startDate.month	Facoltativo Il mese di inizio del periodo del report. Può assumere valori compresi tra 1 e 12 inclusi. Per impostazione predefinita è il mese corrente.
startDate.year	Facoltativo L'anno di inizio del periodo di rendicontazione, nel formato YYYY. Il valore predefinito è l'anno corrente.
endDate.day	Facoltativo Il giorno del mese in cui termina il periodo del report. Può assumere valori compresi tra 1 e 31 inclusi. Il valore predefinito è il giorno corrente.
endDate.month	Facoltativo Il mese in cui termina il periodo del report. Può assumere valori compresi tra 1 e 12 inclusi. Per impostazione predefinita è il mese corrente.
endDate.year	Facoltativo L'anno in cui termina il periodo di rendicontazione, nel formato YYYY. Il valore predefinito è l'anno corrente.
pageSize	Facoltativo Un numero intero positivo che indica il numero di voci da restituire. Il valore predefinito è 1000 e il valore massimo è 10000.
pageToken	Facoltativo Una stringa. Inserisci il valore next_page_token della risposta precedente in questo campo.

I campi nella tabella precedente vengono utilizzati per creare un SearchAccountReportsRequest. Per ogni ID cliente nella richiesta, in SearchAccountReportsResponse è incluso un AccountReports corrispondente. Ogni report sull'account corrisponde a un account cliente collegato che mostra gli annunci di Servizi locali.

Nota :i proto per richiesta, risposta e strutture di dati sono disponibili e collegati dopo il lancio.

La seguente tabella mostra i campi in AccountReports:

Campi
accountId	ID cliente collegato a un account Servizi locali.
businessName	Nome dell'attività del cliente.
averageWeeklyBudget	Budget settimanale medio attuale del cliente.
averageFiveStarRating	Valutazione media a cinque stelle, calcolata in base a tutte le recensioni disponibili del cliente.
totalReview	Numero totale di recensioni disponibili per il cliente.
impressionsLastTwoDays	Il numero totale di impressioni generate dall'account negli ultimi due giorni.
phoneLeadResponsiveness	Reattività dei lead telefonici dell'account nei 90 giorni precedenti. Per calcolarlo, il numero totale di chiamate connesse dai lead telefonici a pagamento viene diviso per il numero totale di chiamate ricevute.
currentPeriodChargedLeads	Numero di lead addebitati nel periodo di intervallo di date specificato.
previousPeriodChargedLeads	Numero di lead addebitati nel periodo precedente. Ad esempio, se l'intervallo di date è impostato dal 21 al 30 gennaio, il periodo precedente sarà dall'11 al 20 gennaio.
currentPeriodTotalCost	Somma del costo dei lead addebitati nel periodo dell'intervallo di date specificato.
previousPeriodTotalCost	Somma del costo dei lead addebitati nel periodo precedente. Ad esempio, se l'intervallo di date è impostato dal 21 al 30 gennaio, il periodo precedente sarà dall'11 al 20 gennaio.
currencyCode	Codice valuta dell'account cliente.
currentPeriodPhoneCalls	Numero di chiamate nel periodo dell'intervallo di date specificato, sia connesse che non connesse.
previousPeriodPhoneCalls	Numero di chiamate nel periodo precedente, sia connesse che non connesse.
currentPeriodConnectedPhoneCalls	Numero di chiamate telefoniche connesse nel periodo di intervallo di date specificato con una durata superiore a 30 secondi.
previousPeriodConnectedPhoneCalls	Numero di chiamate telefoniche connesse nel periodo precedente con una durata superiore a 30 secondi.

Esempi

URL della richiesta HTTP

https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:{manager_customer_id}

Esempio di richiesta HTTP completa

GET /v1/accountReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]

Report dettagliati sui lead

Importante:i report dettagliati sui lead sono ritirati. Utilizza l'API Google Ads per recuperare lead e conversazioni associati ai tuoi account Servizi locali.

I report dettagliati sui lead mostrano una visualizzazione approfondita dei lead associati agli account di Servizi locali collegati di un account amministratore. Puoi visualizzare questi dati in un periodo di tempo specificato. Per un determinato intervallo di tempo, il report include i lead creati o i lead il cui stato di contestazione è stato aggiornato. I dati potrebbero essere obsoleti fino a 30 minuti.

Nota :i client API possono richiedere report dettagliati sulle richieste solo per un periodo di massimo 31 giorni. Ciò è dovuto al volume elevato di lead che possono essere restituiti dal report.

Per acquisire il report, invia una richiesta HTTP GET a https://localservices.googleapis.com/v1/detailedLeadReports:search con i seguenti parametri URL configurabili:

Parametri URL
query	Obbligatorio Contiene uno o più valori ID, uno dei quali deve essere l'ID dell'account amministratore per la query. query può accettare più valori separati da punto e virgola: Obbligatorio: manager_customer_id:<manager_cid> (Facoltativo) customer_id:<linked_cid> Esempio: query=manager_customer_id:123;customer_id:456
startDate.day	Facoltativo Il giorno del mese in cui inizia il periodo del report. Può assumere valori compresi tra 1 e 31 inclusi. Il valore predefinito è 1.
startDate.month	Facoltativo Il mese di inizio del periodo del report. Può assumere valori compresi tra 1 e 12 inclusi. Per impostazione predefinita è il mese corrente.
startDate.year	Facoltativo L'anno di inizio del periodo di rendicontazione, nel formato YYYY. Il valore predefinito è l'anno corrente.
endDate.day	Facoltativo Il giorno del mese in cui termina il periodo del report. Può assumere valori compresi tra 1 e 31 inclusi. Il valore predefinito è il giorno corrente.
endDate.month	Facoltativo Il mese in cui termina il periodo del report. Può assumere valori compresi tra 1 e 12 inclusi. Per impostazione predefinita è il mese corrente.
endDate.year	Facoltativo L'anno in cui termina il periodo di rendicontazione, nel formato YYYY. Il valore predefinito è l'anno corrente.
pageSize	Facoltativo Un numero intero positivo che indica il numero di voci da restituire. Il valore predefinito è 1000 e il valore massimo è 10000.
pageToken	Facoltativo Una stringa. Inserisci il valore next_page_token della risposta precedente in questo campo.

I campi precedenti vengono utilizzati per creare un SearchDetailedLeadReportsRequest. Per ogni ID cliente nella richiesta, in SearchDetailedLeadReportsResponse è incluso un DetailedLeadReports corrispondente. Ogni report dettagliato sui lead corrisponde uno a uno a un lead specifico associato a un account cliente collegato che mostra gli annunci di Servizi locali.

La seguente tabella mostra i campi in DetailedLeadReports:

Campi
leadId	Identificatore univoco di un lead.
accountId	Identifica l'account che ha ricevuto il lead.
businessName	Il nome dell'attività associato all'account.
leadCreationTimestamp	Timestamp della creazione del lead. Include la data nel formato M/D/YYYY e l'ora nel formato HH:MM:SS. Esempio: 11/1/2019 12:13:20
leadType	Tipo di lead: MESSAGE o PHONE_CALL.
leadCategory	Categoria di servizio associata al lead. Esempio: housecleaner
geo	Le località della città di residenza dell'account associato. Esempio: San Francisco, California, United States
messageLead	Informazioni associate solo ai lead di messaggistica: customerName, jobType, postalCode e consumerPhoneNumber.
phoneLead	Informazioni associate solo ai lead telefonici: chargedCallTimestamp, chargedConnectedCallDurationSeconds e consumerPhoneNumber.
bookingLead	Informazioni associate solo ai lead di prenotazione: customerName, consumerPhoneNumber, jobType, consumerEmail e bookingAppointmentTimestamp.
chargeStatus	Se il lead è stato addebitato. Può essere true o false.
currencyCode	Codice valuta dell'account per cui è stato creato il lead.
disputeStatus	Stato della contestazione del lead.
aggregatorInfo	Informazioni specifiche per i partner aggregatori di terze parti. Questo campo viene compilato solo per i client API associati a partner aggregatori di terze parti. Nota:questa opzione non è applicabile ai clienti standard di Centro clienti.
timezone	Il fuso orario dell'account associato al lead. Indicato nel formato IANA Time Zone Database.

Esempi

URL della richiesta HTTP

https://localservices.googleapis.com/v1/detailedLeadReports:search?query=manager_customer_id:{manager_customer_id}

Esempio di richiesta HTTP completa

GET /v1/detailedReports:search?query=manager_customer_id:{manager_customer_id} HTTP/1.1
Host: localservices.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]