Questo documento descrive gli elenchi dei segmenti di pubblico ricorrenti, una funzionalità avanzata dell'API di dati di Google Analytics v1. Per un'introduzione alla funzionalità di esportazione degli elenchi dei segmenti di pubblico, consulta la guida sui concetti fondamentali dell'esportazione di segmenti di pubblico.
Gli elenchi dei segmenti di pubblico ricorrenti producono elenchi dei segmenti di pubblico giornalieri le iscrizioni ai segmenti di pubblico cambiano, per assicurarti di lavorare con i dati più recenti.
Gli elenchi dei segmenti di pubblico regolari (non ricorrenti) sono elenchi statici di utenti inclusi nel segmento di pubblico. nel momento in cui viene generato l'elenco.
Creare un nuovo elenco del segmento di pubblico ogni giorno
L'elaborazione dei dati sul pubblico di un giorno e l'aggiornamento richiedono un periodo di tempo variabile . Non è possibile in alcun modo assicurarsi che i dati degli elenchi dei segmenti di pubblico siano aggiornati 24 ore su 24.
Ad esempio, anche se richiedi un elenco del segmento di pubblico alla stessa ora ogni giorno, in alcuni giorni l'elenco del segmento di pubblico sarà lo stesso rispetto al giorno precedente, mentre negli altri giorni l'elenco del segmento di pubblico sarà diverso contengono un altro giorno di modifiche all'abbonamento.
Gli elenchi dei segmenti di pubblico si basano sui dati sugli eventi del giorno precedente a quello più recente modifiche alle iscrizioni. Se crei un elenco del segmento di pubblico prima dell'appartenenza giornaliera verranno eseguiti tutti gli aggiornamenti, utilizzerà i dati dei due giorni precedenti. Se crei un dell'elenco del segmento di pubblico dopo gli aggiornamenti giornalieri dell'appartenenza, utilizzerà i dati provenienti da ieri.
Eseguire periodicamente un polling di un elenco del segmento di pubblico ricorrente
Gli elenchi dei segmenti di pubblico ricorrenti generano elenchi dei segmenti di pubblico solo quando la disponibilità dei dati. In questo modo, è più semplice decidere quando creare nuovi Elenchi dei segmenti di pubblico. Invece, puoi proporre sondaggi sull'elenco del segmento di pubblico ricorrente nel corso della giornata per vedere se sono disponibili dati aggiuntivi.
Crea un elenco del segmento di pubblico ricorrente
Per creare un elenco del segmento di pubblico ricorrente, chiama la
recurringAudienceLists.create
utilizzando il metodo
RecurringAudienceList
in una richiesta. I seguenti parametri sono obbligatori:
- Un nome del segmento di pubblico valido nel campo
audiencenel formatoproperties/{propertyId}/audiences/{audienceId}. Puoi utilizzare loaudiences.listdell'API Admin Google Analytics v1 per ottenere questo valore. LaAudience.namedella rispostaaudiences.listcontiene il nome del segmento di pubblico. - Un elenco valido di dimensioni nel
dimensions. L'elenco delle dimensioni supportate da questo metodo è disponibile nella sezione documentazione relativa allo schema di esportazione dei segmenti di pubblico. In questo campo sono inclusi solo i dati relativi alle dimensioni menzionate in questo campo un elenco del segmento di pubblico.
Di seguito è riportato un esempio di richiesta di creazione di un elenco del segmento di pubblico ricorrente:
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists
{
"audience": "properties/1234567/audiences/12345",
"dimensions": [
{
"dimensionName": "deviceId"
}
]
}
Una risposta del metodo recurringAudienceLists.create contiene il parametro
nome nel campo name (ad esempio
properties/1234567/recurringAudienceLists/123), che può essere utilizzato in
per recuperare i metadati di configurazione
per questo elenco del segmento di pubblico ricorrente. Inoltre, i metadati di configurazione contengono
nomi delle risorse per istanze degli elenchi dei segmenti di pubblico
creato per questo elenco del segmento di pubblico ricorrente.
Risposta HTTP
{
"name": "properties/1234567/recurringAudienceLists/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"activeDaysRemaining": 180,
"audienceLists": [
"properties/1234567/audienceLists/45678"
]
}
Metadati della configurazione del sondaggio
Utilizza la
recurringAudienceLists.get
per recuperare i metadati di configurazione relativi a uno
elenco del segmento di pubblico ricorrente. I metadati di configurazione contengono
nomi delle risorse per istanze degli elenchi dei segmenti di pubblico
creato per questo elenco del segmento di pubblico ricorrente.
Ecco un esempio:
Richiesta HTTP
GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists/123
Un'istanza di RecurringAudienceList
viene restituito. Contiene i metadati di configurazione, che includono
nomi delle risorse per istanze degli elenchi dei segmenti di pubblico
creato per questo elenco del segmento di pubblico ricorrente.
Risposta HTTP
{
"name": "properties/1234567/recurringAudienceLists/123",
"audience": "properties/1234567/audiences/12345",
"audienceDisplayName": "Purchasers",
"dimensions": [
{
"dimensionName": "deviceId"
}
],
"activeDaysRemaining": 180,
"audienceLists": [
"properties/1234567/audienceLists/45678"
]
}
Puoi utilizzare
recurringAudienceLists.list
per elencare tutti gli elenchi dei segmenti di pubblico ricorrenti per una proprietà.
Utilizza webhook per ricevere notifiche asincrone sui nuovi elenchi dei segmenti di pubblico.
Anziché eseguire periodicamente il polling dei metadati di configurazione su una specifica
dell'elenco del segmento di pubblico ricorrente,
recurringAudienceLists.get
, puoi ricevere in modo asincrono notifiche webhook quando un segmento di pubblico
un elenco di indirizzi IP.
Per configurare le notifiche webhook, specifica
webhookNotification
quando crei un nuovo elenco del segmento di pubblico ricorrente.
Segui la guida di Async audience lists with webhooks
per saperne di più sull'utilizzo dei webhook nella versione 1 dell'API di dati di Google Analytics.
Recuperare gli utenti in un'esportazione dei segmenti di pubblico
Per recuperare gli utenti in un'esportazione dei segmenti di pubblico, chiama il metodo
audienceExports.query
e specifica il nome dell'esportazione dei segmenti di pubblico
recuperata dai metadati di configurazione forniti
recurringAudienceLists.get
o recurringAudienceLists.list.
Richiesta HTTP
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query
Se l'esportazione dei segmenti di pubblico è pronta, viene visualizzata una risposta contenente l'elenco di vengono restituiti gli utenti di un segmento di pubblico:
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
}