I segmenti di pubblico in Google Analytics ti permettono di suddividere gli utenti in base agli obiettivi più importanti per la tua attività. Con i segmenti di pubblico, puoi raggruppare gli utenti del tuo sito o della tua applicazione in base agli attributi condivisi.
Puoi esportare i tuoi segmenti di pubblico, incluso uno snapshot dei relativi utenti, utilizzando l'API Data.
Consulta la guida Aspetti da considerare per i dati delle esportazioni dei segmenti di pubblico per informazioni importanti sui dati visualizzati nelle esportazioni dei segmenti di pubblico.
Panoramica
Effettua le seguenti richieste all'API Data per creare ed eseguire query su un'esportazione dei segmenti di pubblico:
- Chiama il metodo
audienceExports.createper creare un'esportazione dei segmenti di pubblico. - Per recuperare gli utenti nel segmento di pubblico, viene utilizzato il metodo
audienceExports.query.
Per ulteriori informazioni, puoi chiamare
audienceExports.get per recuperare i metadati di configurazione relativi a un'esportazione del segmento di pubblico specifico 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 Data richiedono che l'identificatore della proprietà Google Analytics venga specificato all'interno di un percorso della richiesta dell'URL, nella forma properties/GA_PROPERTY_ID. Ecco un esempio:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports
Il report viene generato in base ai dati sugli eventi di Google Analytics raccolti nella proprietà Google Analytics specificata.
Se utilizzi una delle librerie client dell'API Data, non devi modificare il percorso dell'URL della richiesta. La maggior parte dei client API fornisce un parametro property
che si aspetta una stringa nel formato properties/GA_PROPERTY_ID. Consulta la guida rapida per esempi di utilizzo delle librerie client.
Creare un'esportazione dei segmenti di pubblico
Per creare un'esportazione del segmento di pubblico, chiama il metodo audienceExports.create utilizzando l'oggetto
AudienceExport
nella richiesta. I seguenti parametri sono obbligatori:
- Un nome segmento di pubblico valido nel campo
audience, formato comeproperties/{propertyId}/audiences/{audienceId}. Per ottenere questo valore, puoi utilizzare il metodoaudiences.listdella versione 1 dell'API Google Analytics Admin. Il campoAudience.namedella rispostaaudiences.listcontiene 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. Solo i dati relativi alle dimensioni menzionate in questo campo sono inclusi in un'esportazione del segmento di pubblico.
Di seguito è riportata una richiesta di esempio per creare un'esportazione del segmento 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 del segmento di pubblico nel campo name, ad esempio properties/1234567/audienceExports/123.
Ecco una risposta di esempio:
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 del segmento di pubblico.
Esegui una query sullo stato di idoneità dell'esportazione dei segmenti di pubblico
Potrebbero essere necessari diversi minuti per generare l'esportazione del segmento di pubblico dopo la chiamata
audienceExports.create.
Puoi controllare lo stato di idoneità di un'esportazione del segmento di pubblico chiamando il metodo
audienceExports.get.
Utilizza il nome dell'esportazione del segmento di pubblico da una risposta audienceExports.create per
specificare l'esportazione del segmento 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 del segmento di pubblico, lo stato cambia da CREATING a ACTIVE.
Ecco una risposta di esempio:
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 del segmento di pubblico
Una volta generata l'esportazione del segmento di pubblico, chiama il metodo audienceExports.query e specifica il valore name dell'esportazione del segmento 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 del segmento di pubblico è pronta, questa chiamata restituisce l'elenco degli utenti nel segmento di pubblico.
Ecco una risposta di esempio:
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
}