REST Resource: properties.audienceExports

Risorsa: AudienceExport

Un'esportazione dei segmenti di pubblico è un elenco di utenti presenti in un segmento di pubblico al momento della creazione dell'elenco. Per un segmento di pubblico possono essere create più esportazioni di segmenti di pubblico per giorni diversi.

Rappresentazione JSON 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "creationQuotaTokensCharged": integer,
  "state": enum (State),
  "beginCreatingTime": string,
  "rowCount": integer,
  "errorMessage": string,
  "percentageCompleted": number
}
Campi
name

string

Solo output. Identificatore. Il nome della risorsa di esportazione dei segmenti di pubblico assegnato durante la creazione. Questo nome risorsa identifica questo AudienceExport.

Formato: properties/{property}/audienceExports/{audienceExport}
audience

string

Obbligatorio. Il nome della risorsa pubblico. Questo nome risorsa identifica il segmento di pubblico elencato e viene condiviso tra i dati di Analytics e API amministrative.

Formato: properties/{property}/audiences/{audience}
audienceDisplayName

string

Solo output. Il nome visualizzato descrittivo di questo segmento di pubblico. Ad esempio, "Acquirenti".
dimensions[]

object (AudienceDimension)

Obbligatorio. Le dimensioni richieste e visualizzate nella risposta alla query.
creationQuotaTokensCharged

integer

Solo output. I token di quota totali addebitati durante la creazione di AudienceExport. Poiché il conteggio di questo token si basa sull'attività nello stato CREATING, questi token addebitati verranno corretti quando un AudienceExport entrerà nello stato ACTIVE o FAILED.
state

enum (State)

Solo output. Lo stato attuale di questa AudienceExport.
beginCreatingTime

string (Timestamp format)

Solo output. L'ora in cui audienceExports.create è stato chiamato e AudienceExport ha iniziato lo stato CREATING.

Un timestamp nel formato RFC3339 UTC "Zulu" con risoluzione in nanosecondi e fino a nove cifre frazionarie. Esempi: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
rowCount

integer

Solo output. Il numero totale di righe nel risultato AudienceExport.
errorMessage

string

Solo output. Un messaggio di errore viene compilato quando l'esportazione dei segmenti di pubblico non va a buon fine durante la creazione. Un motivo comune di questo errore è l'esaurimento della quota.
percentageCompleted

number

Solo output. La percentuale di completamento per questa esportazione dei segmenti di pubblico compresa tra 0 e 100.

AudienceDimension

Una dimensione per il pubblico è un attributo utente. Vengono richiesti i dati attribuiti all'utente specifico che verranno poi restituiti nell'elemento QueryAudienceExportResponse.

Rappresentazione JSON 
{
  "dimensionName": string
}
Campi
dimensionName

string

(Facoltativo) Il nome API della dimensione. Consulta la pagina Dimensioni API per l'elenco dei nomi delle dimensioni.

Stato

Al momento AudienceExport esiste in questo stato.

Enum
STATE_UNSPECIFIED Non verrà mai utilizzato lo stato non specificato.
CREATING AudienceExport è attualmente in fase di creazione e sarà disponibile in futuro. La creazione avviene immediatamente dopo la chiamata audienceExports.create.
ACTIVE AudienceExport è stato completamente creato ed è pronto per l'esecuzione di query. Un AudienceExport viene aggiornato in modo da essere attivo in modo asincrono da una richiesta. Questo avviene un po' di tempo (ad esempio 15 minuti) dopo la chiamata iniziale di creazione.
FAILED Impossibile creare AudienceExport. È possibile che la nuova richiesta di esportazione dei segmenti di pubblico vada a buon fine.

Metodi

create

 Crea un'esportazione dei segmenti di pubblico per il recupero in un secondo momento.

get

 Recupera i metadati di configurazione relativi a un'esportazione di segmenti di pubblico specifica.

list

 Elenca tutte le esportazioni dei segmenti di pubblico per una proprietà.

query

 Recupera un'esportazione dei segmenti di pubblico degli utenti.