- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- Ambiti di autorizzazione
- Utente
- UserIdType
- ActivityType
- UserActivitySession
- Attività
- CustomDimension
- PageviewData
- ScreenviewData
- EcommerceData
- ECommerceAction
- TransactionData
- ProductData
- EcommerceType
- GoalSetData
- GoalData
- EventData
- Prova!
Restituisce i dati sull'attività utente.
Richiesta HTTP
POST https://analyticsreporting.googleapis.com/v4/userActivity:search
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON | |
---|---|
{ "dateRange": { object( |
Campi | |
---|---|
dateRange |
Intervallo di date per il quale recuperare l'attività utente. Se non viene specificato un intervallo di date, l'intervallo di date predefinito è (startDate: data corrente - 7 giorni, data di fine: data corrente - 1 giorno). |
viewId |
Obbligatoria. L'ID vista di Analytics da cui recuperare i dati. Ogni elemento SearchUserActivityRequest deve contenere il parametro |
user |
Obbligatoria. ID utente univoco per il quale eseguire la query. Ogni elemento SearchUserActivityRequest deve contenere questo campo. |
activityTypes[] |
Insieme di tutti i tipi di attività richiesti. Nella risposta verranno restituite solo le attività che corrispondono a questi tipi. Se il campo è vuoto, verranno restituite tutte le attività. |
pageSize |
La dimensione della pagina serve al paging e specifica il numero massimo di righe restituite. La dimensione della pagina deve essere maggiore di 0. Se il valore è 0 o se il campo non è specificato, la richiesta restituisce 1000 righe per pagina, per impostazione predefinita. |
pageToken |
Un token di continuazione per visualizzare la pagina successiva dei risultati. Se lo aggiungi alla richiesta, verranno restituite le righe che seguono il token pageToken. pageToken deve essere il valore restituito nel parametro nextPageToken nella risposta alla richiesta SearchUserActivityRequest. |
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
La risposta dalla chiamata userActivity:get
.
Rappresentazione JSON | |
---|---|
{
"sessions": [
{
object( |
Campi | |
---|---|
sessions[] |
Ogni record rappresenta una sessione (dettagli del dispositivo, durata e così via). |
totalRows |
Righe totali restituite da questa query (in pagine diverse). |
nextPageToken |
Questo token deve essere trasmesso a SearchUserActivityRequest per recuperare la pagina successiva. |
sampleRate |
Questo campo rappresenta la frequenza di campionamento per la richiesta specificata ed è un numero compreso tra 0,0 e 1,0. Per maggiori dettagli, consulta la guida per gli sviluppatori. |
Ambiti di autorizzazione
Richiede uno dei seguenti ambiti OAuth:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
Utente
Contiene informazioni che consentono di identificare in modo univoco un particolare utente.
Rappresentazione JSON | |
---|---|
{
"type": enum( |
Campi | |
---|---|
type |
Tipo di utente nella richiesta. Il campo |
userId |
ID univoco dell'utente per il quale vengono richiesti i dati. |
UserIdType
Rappresenta i vari tipi di identificazione degli utenti disponibili.
Enum | |
---|---|
USER_ID_TYPE_UNSPECIFIED |
Quando non viene specificato il tipo di ID utente, il tipo predefinito utilizzato sarà CLIENT_ID. |
USER_ID |
Un utente singolo, come un account utente a cui è stato eseguito l'accesso, che può interagire con contenuti su uno o più dispositivi e/o una o più istanze di browser. |
CLIENT_ID |
ClientId assegnato ad Analytics. |
ActivityType
Enum | |
---|---|
ACTIVITY_TYPE_UNSPECIFIED |
ActivityType non avrà mai questo valore nella risposta. L'uso di questo tipo nella richiesta comporterà un errore. |
PAGEVIEW |
Utilizzata quando l'attività è risultata dalla visualizzazione di una pagina da parte di un visitatore. |
SCREENVIEW |
Utilizzato quando l'attività è risultata da un visitatore che utilizza un'applicazione su un dispositivo mobile. |
GOAL |
Utilizzato per indicare che un'attività di tipo obiettivo. |
ECOMMERCE |
Il visitatore della pagina ha eseguito una transazione di e-commerce. |
EVENT |
Utilizzata quando l'attività è un evento. |
UserActivitySession
Rappresenta una sessione utente eseguita su un dispositivo specifico in un determinato momento in un determinato periodo di tempo.
Rappresentazione JSON | |
---|---|
{
"sessionId": string,
"deviceCategory": string,
"platform": string,
"dataSource": string,
"activities": [
{
object( |
Campi | |
---|---|
sessionId |
ID univoco della sessione. |
deviceCategory |
Il tipo di dispositivo utilizzato: "mobile", "tablet" e così via. |
platform |
Piattaforma su cui si è verificata l'attività: "android", "ios" e così via. |
dataSource |
La sorgente di dati di un hit. Per impostazione predefinita, gli hit inviati da analytics.js vengono registrati come "web" e gli hit inviati da SDK mobile vengono registrati come "app". L'override di questi valori può essere eseguito in Measurement Protocol. |
activities[] |
Rappresenta una vista dettagliata di ogni attività di questa sessione. |
sessionDate |
Data di questa sessione in formato ISO-8601. |
Attività
Un'attività rappresenta i dati relativi a un'attività di un utente. Tieni presente che un'attività è diversa da un hit. Un hit può comportare più attività. Ad esempio, se un hit include una transazione e un completamento obiettivo, per questo hit saranno presenti due protocolli attività, uno per ECOMMERCE e uno per OBIETTIVO. Al contrario, più hit possono creare un'unica attività. Nell'e-commerce classico, i dati di una transazione potrebbero essere inviati attraverso più hit. Questi hit verranno uniti in un'unica attività ECOMMERCE.
Rappresentazione JSON | |
---|---|
{ "activityTime": string, "source": string, "medium": string, "channelGrouping": string, "campaign": string, "keyword": string, "hostname": string, "landingPagePath": string, "activityType": enum( |
Campi | ||
---|---|---|
activityTime |
Timestamp dell'attività. Un timestamp in formato "Zulu" UTC RFC3339, preciso al nanosecondo. Esempio: |
|
source |
La sorgente dei referral. Per il monitoraggio manuale delle campagne, è il valore del parametro di monitoraggio della campagna utm_source. Per la codifica automatica di AdWords, è Google. Se non utilizzi nessuno dei due, si tratta del dominio della sorgente (ad es. document.referrer) che fa riferimento agli utenti. Potrebbe anche contenere un indirizzo di porta. Se gli utenti sono arrivati senza un referrer, il suo valore è (direct). |
|
medium |
Il tipo di referral. Per il monitoraggio manuale delle campagne, è il valore del parametro di monitoraggio della campagna utm_medium. Per la codifica automatica di AdWords, si tratta di cpc. Se gli utenti provengono da un motore di ricerca rilevato da Google Analytics, si tratta di risultati organici. Se il referrer non è un motore di ricerca, si tratta di referral. Se gli utenti hanno raggiunto direttamente la proprietà e document.referrer è vuoto, il valore è (nessuno). |
|
channelGrouping |
Il gruppo di canali associato alla sessione di un utente finale per questa vista (definito dai raggruppamenti dei canali della vista). |
|
campaign |
Per il monitoraggio manuale delle campagne, è il valore del parametro di monitoraggio della campagna utm_campaign. Per la codifica automatica di AdWords, si tratta dei nomi delle campagne pubblicitarie online che utilizzi per la proprietà. Se non utilizzi nessuno dei due valori, il valore è (not set). |
|
keyword |
Per il monitoraggio manuale delle campagne, è il valore del parametro di monitoraggio della campagna utm_term. Per il traffico AdWords, contiene i migliori criteri di targeting corrispondenti. Per la Rete Display, dove più criteri di targeting avrebbero potuto determinare la visualizzazione dell'annuncio, restituisce i migliori criteri di targeting corrispondenti selezionati da Google Ads. Può essere display_keyword, site posizionamento, boomuserlist, user_interest, età o genere. In caso contrario, il valore è (not set). |
|
hostname |
Il nome host da cui è stata effettuata la richiesta di monitoraggio. |
|
landingPagePath |
La prima pagina della pagina delle sessioni degli utenti o la pagina di destinazione. |
|
activityType |
Tipo di attività. |
|
customDimension[] |
Un elenco di tutte le dimensioni personalizzate associate a questa attività. |
|
Campo di unione activity_details . A seconda dell'activity_type , verrà impostato esattamente uno dei seguenti campi. activity_details può essere solo uno dei seguenti: |
||
pageview |
Verrà impostato se |
|
appview |
Verrà impostato se |
|
ecommerce |
Verrà impostato se |
|
goals |
Questo campo contiene un elenco di tutti gli obiettivi raggiunti in questa attività quando |
|
event |
Questo campo contiene tutti i dettagli relativi a un evento e verrà impostato se |
CustomDimension
Dimensione personalizzata.
Rappresentazione JSON | |
---|---|
{ "index": number, "value": string } |
Campi | |
---|---|
index |
Numero area annuncio della dimensione personalizzata. |
value |
Valore della dimensione personalizzata. Il valore predefinito (ovvero una stringa vuota) indica la cancellazione del valore della dimensione personalizzata a livello di sessione/visitatore. |
PageviewData
Rappresenta i dettagli raccolti quando il visitatore visualizza una pagina.
Rappresentazione JSON | |
---|---|
{ "pagePath": string, "pageTitle": string } |
Campi | |
---|---|
pagePath |
L'URL della pagina che il visitatore ha visualizzato. |
pageTitle |
Il titolo della pagina che il visitatore ha visualizzato. |
ScreenviewData
Rappresentazione JSON | |
---|---|
{ "screenName": string, "mobileDeviceBranding": string, "mobileDeviceModel": string, "appName": string } |
Campi | |
---|---|
screenName |
Il nome dello schermo. |
mobileDeviceBranding |
Produttore di dispositivi mobili o nome del brand. Esempio: "Google", "Mela" ecc. |
mobileDeviceModel |
Modello del dispositivo mobile. Ad esempio: "Pixel", "iPhone" ecc. |
appName |
Nome dell'applicazione. |
EcommerceData
Dettagli di e-commerce associati all'attività dell'utente.
Rappresentazione JSON | |
---|---|
{ "actionType": enum( |
Campi | |
---|---|
actionType |
Azione associata a questa azione di e-commerce. |
transaction |
Dettagli transazione di questa azione di e-commerce. |
products[] |
Dettagli dei prodotti inclusi in questa transazione. |
ecommerceType |
Il tipo di attività di e-commerce. |
ECommerceAction
Insieme di tutte le azioni associate a un'azione di e-commerce.
Enum | |
---|---|
UNKNOWN |
Tipo di azione sconosciuto. |
CLICK |
Clic sugli elenchi di prodotti. |
DETAILS_VIEW |
Viste dei dettagli dei prodotti |
ADD_TO_CART |
Aggiungi prodotto/i al carrello. |
REMOVE_FROM_CART |
Rimuovi i prodotti dal carrello. |
CHECKOUT |
Paga. |
PAYMENT |
Acquisto completato. |
REFUND |
Rimborso dell'acquisto. |
CHECKOUT_OPTION |
Opzioni di pagamento. |
TransactionData
Rappresenta i dettagli raccolti quando il visitatore esegue una transazione sulla pagina.
Rappresentazione JSON | |
---|---|
{ "transactionId": string, "transactionRevenue": number, "transactionTax": number, "transactionShipping": number } |
Campi | |
---|---|
transactionId |
L'ID transazione, fornito dal metodo di monitoraggio e-commerce, per l'acquisto nel carrello degli acquisti. |
transactionRevenue |
Le entrate totali delle vendite (escluse spese di spedizione e tasse) della transazione. |
transactionTax |
Imposte totali per la transazione. |
transactionShipping |
Costo totale della spedizione. |
ProductData
Dettagli dei prodotti in una transazione e-commerce.
Rappresentazione JSON | |
---|---|
{ "productSku": string, "productName": string, "itemRevenue": number, "productQuantity": string } |
Campi | |
---|---|
productSku |
Codice univoco che rappresenta il prodotto. |
productName |
Il nome del prodotto, fornito dall'applicazione di monitoraggio e-commerce, per gli articoli acquistati. |
itemRevenue |
Le entrate totali generate dagli articoli acquistati. |
productQuantity |
Numero totale di queste unità di prodotto nella transazione. |
EcommerceType
Rappresenta il tipo di dati e-commerce che viene restituito.
Enum | |
---|---|
ECOMMERCE_TYPE_UNSPECIFIED |
Utilizzato quando il tipo di attività e-commerce non è specificato. |
CLASSIC |
Utilizzata quando l'attività contiene informazioni di e-commerce classiche (non ottimizzate). |
ENHANCED |
Utilizzata quando l'attività ha migliorato le informazioni di e-commerce. |
GoalSetData
Rappresenta un insieme di obiettivi che sono stati raggiunti in un'attività.
Rappresentazione JSON | |
---|---|
{
"goals": [
{
object( |
Campi | |
---|---|
goals[] |
Tutti gli obiettivi che sono stati raggiunti nell'attività corrente. |
GoalData
Rappresenta tutti i dettagli relativi a un obiettivo.
Rappresentazione JSON | |
---|---|
{ "goalIndex": number, "goalCompletions": string, "goalValue": number, "goalCompletionLocation": string, "goalPreviousStep1": string, "goalPreviousStep2": string, "goalPreviousStep3": string, "goalName": string } |
Campi | |
---|---|
goalIndex |
Questo identifica l'obiettivo come configurato per il profilo. |
goalCompletions |
Numero totale di completamenti obiettivo in questa attività. |
goalValue |
Valore in questo obiettivo. |
goalCompletionLocation |
URL della pagina in cui è stato completato l'obiettivo. |
goalPreviousStep1 |
URL della pagina un passaggio prima del completamento dell'obiettivo. |
goalPreviousStep2 |
URL della pagina due passaggi prima del completamento dell'obiettivo. |
goalPreviousStep3 |
URL della pagina tre passaggi prima del completamento dell'obiettivo. |
goalName |
Nome dell'obiettivo. |
EventData
Rappresenta tutti i dettagli relativi a un evento.
Rappresentazione JSON | |
---|---|
{ "eventCategory": string, "eventAction": string, "eventLabel": string, "eventValue": string, "eventCount": string } |
Campi | |
---|---|
eventCategory |
L'oggetto sulla pagina con cui è stata eseguita l'interazione. Esempio: "Video". |
eventAction |
Tipo di interazione con l'oggetto. Esempio: "riproduci". |
eventLabel |
Etichetta allegata all'evento. |
eventValue |
Valore numerico associato all'evento. |
eventCount |
Numero di eventi di questo tipo in questa attività. |