I segmenti di pubblico in Google Analytics 4 ti consentono di segmentare gli utenti nei modi più importanti per la tua attività. Con i segmenti di pubblico, puoi raggruppare gli utenti del tuo sito o della tua applicazione in base ad attributi condivisi.
Puoi esportare i segmenti di pubblico, inclusa un'istantanea dei loro utenti, utilizzando l'API di dati.
Per informazioni importanti sui dati visualizzati nelle esportazioni dei segmenti di pubblico, consulta la guida Aspettative dei dati per l'esportazione dei segmenti di pubblico.
Panoramica
Effettua le seguenti richieste di API di dati per creare ed eseguire query su un'esportazione dei segmenti di pubblico:
- Chiama il metodo
audienceExports.create
per creare un'esportazione dei segmenti di pubblico. - Viene utilizzato il metodo
audienceExports.query
per recuperare gli utenti nel segmento di pubblico.
Per saperne di più, puoi chiamare audienceExports.get
per recuperare i metadati di configurazione su una specifica esportazione di segmenti di pubblico e audienceExports.list
per elencare tutte le esportazioni dei segmenti di pubblico per una proprietà specifica.
Seleziona un'entità report
Tutti i metodi dell'API di dati richiedono che l'identificatore proprietà Google Analytics 4 sia specificato all'interno di un percorso di richiesta dell'URL, nel formato properties/GA4_PROPERTY_ID
. Esempio:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/audienceExports
Il report viene generato in base ai dati sugli eventi di Google Analytics raccolti nella proprietà Google Analytics 4 specificata.
Se utilizzi una delle librerie client dell'API di dati,
non è necessario modificare il percorso dell'URL di richiesta.
La maggior parte dei client API fornisce un parametro property
che prevede una
stringa nel formato properties/GA4_PROPERTY_ID
.
Consulta la Guida rapida per esempi di utilizzo delle librerie client.
Creare un'esportazione dei segmenti di pubblico
Per creare un'esportazione dei segmenti di pubblico, chiama il metodo audienceExports.create
utilizzando l'oggetto AudienceExport
nella richiesta. I seguenti parametri sono obbligatori:
- Un nome di segmento di pubblico valido nel campo
audience
, con formatoproperties/{propertyId}/audiences/{audienceId}
. Per ottenere questo valore, puoi utilizzare il metodoaudiences.list
dell'API Google Analytics Admin v1. Il campoAudience.name
della rispostaaudiences.list
contiene il nome del segmento di pubblico. - Un elenco valido di dimensioni nel campo
dimensions
. L'elenco delle dimensioni supportate da questo metodo è disponibile nella documentazione relativa allo schema di esportazione dei segmenti di pubblico. In un'esportazione dei segmenti di pubblico sono inclusi solo i dati relativi alle dimensioni menzionate in questo campo.
Ecco un esempio di richiesta per creare un'esportazione dei segmenti di pubblico:
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports
{
"audience": "properties/1234567/audiences/12345",
"dimensions": [
{
"dimensionName": "deviceId"
}
]
}
Una risposta del metodo audienceExports.create
contiene il nome dell'esportazione dei segmenti di pubblico
nel campo name
, ad esempio properties/1234567/audienceExports/123
.
Ecco un esempio di risposta:
Risposta HTTP
{
"response": {
"@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "CREATING",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}
}
Puoi utilizzare name
per eseguire query sugli utenti dall'esportazione dei segmenti di pubblico.
Esegui una query sullo stato di idoneità dell'esportazione dei segmenti di pubblico
Potrebbero essere necessari diversi minuti per generare l'esportazione dei segmenti di pubblico dopo la chiamata di audienceExports.create
.
Puoi controllare lo stato di idoneità di un'esportazione dei segmenti di pubblico chiamando il metodo audienceExports.get
.
Utilizza il nome dell'esportazione dei segmenti di pubblico di una risposta audienceExports.create
per
specificare l'esportazione dei segmenti di pubblico nella richiesta.
Ecco una richiesta di esempio:
Richiesta HTTP
GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123
Lo stato di idoneità per un'esportazione dei segmenti di pubblico viene restituito nel campo state
della risposta. Una volta completata la generazione dell'esportazione dei segmenti di pubblico,
il suo stato cambia da CREATING
a ACTIVE
.
Ecco un esempio di risposta:
Risposta HTTP
{
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "CREATING",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}
Puoi ottenere lo stato di tutte le esportazioni dei segmenti di pubblico chiamando il metodo
audienceExports.list
.
Recuperare gli utenti da un'esportazione dei segmenti di pubblico
Una volta generata l'esportazione dei segmenti di pubblico, chiama il metodo audienceExports.query
e specifica il name
dell'esportazione dei segmenti di pubblico nella richiesta.
Ecco una richiesta di esempio:
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query
Se l'esportazione dei segmenti di pubblico è pronta, questa chiamata restituisce l'elenco di utenti nel segmento di pubblico.
Ecco un esempio di risposta:
Risposta HTTP
{
"audienceExport": {
"name": "properties/1234567/audienceExports/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"state": "ACTIVE",
"beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
},
"audienceRows": [
{
"dimensionValues": [
{
"value": "1000276123.1681742376"
}
]
},
{
"dimensionValues": [
{
"value": "1000374452.1668627377"
}
]
},
{
"dimensionValues": [
{
"value": "1000391956.1652750758"
}
]
},
{
"dimensionValues": [
{
"value": "1000410539.1682018694"
}
]
},
{
"dimensionValues": [
{
"value": "1000703969.1666725875"
}
]
}
],
"rowCount": 5
}