REST Resource: properties.recurringAudienceLists

Risorsa: RecurringAudienceList

Un elenco dei segmenti di pubblico ricorrente genera nuovi elenchi ogni giorno. Gli elenchi dei segmenti di pubblico sono gli utenti di un segmento di pubblico al momento della creazione dell'elenco. Un elenco del segmento di pubblico ricorrente ti garantisce di avere un elenco del segmento di pubblico basato sui dati più recenti disponibili per l'utilizzo ogni giorno.

Rappresentazione JSON 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
Campi
name

string

Solo output. Identificatore. Il nome della risorsa dell'elenco dei segmenti di pubblico ricorrenti assegnato durante la creazione. Questo nome della risorsa identifica questo RecurringAudienceList.

Formato: properties/{property}/recurringAudienceLists/{recurringAudienceList}
audience

string

Obbligatorio. Il nome della risorsa pubblico. Questo nome della risorsa identifica il segmento di pubblico elencato ed è condiviso tra le API Analytics Data e Admin.

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

string

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

object (AudienceDimension)

Obbligatorio. Le dimensioni richieste e visualizzate nella risposta dell'elenco del segmento di pubblico.
audienceLists[]

string

Solo output. Nomi delle risorse degli elenchi dei segmenti di pubblico per le istanze degli elenchi dei segmenti di pubblico create per questo elenco dei segmenti di pubblico ricorrente. Viene creato un elenco dei segmenti di pubblico per ogni giorno, che verrà elencato qui.

Questo elenco è ordinato in base all'elenco del segmento di pubblico creato più di recente.
activeDaysRemaining

integer

Facoltativo. Il numero di giorni rimanenti in cui un'esportazione ricorrente dei segmenti di pubblico produrrà un'istanza dell'elenco dei segmenti di pubblico. Questo contatore diminuisce di uno ogni giorno e, quando raggiunge lo zero, non vengono creati nuovi elenchi dei segmenti di pubblico.

La richiesta di elenchi dei segmenti di pubblico ricorrenti per le proprietà Analytics 360 ha un valore predefinito di 180 giorni e un massimo di 365 giorni. Per impostazione predefinita, le richieste per le proprietà Analytics standard hanno una durata massima di 30 giorni.

Il valore minimo consentito durante la creazione è 1. Le richieste superiori al rispettivo valore massimo verranno forzate al valore massimo.
webhookNotification

object (WebhookNotification)

Facoltativo. Configura le notifiche webhook da inviare dall'API di dati di Google Analytics al tuo server webhook. L'utilizzo dei webhook è facoltativo. Se non viene utilizzata, dovrai eseguire il polling di questa API per determinare quando un elenco dei segmenti di pubblico ricorrente crea nuovi elenchi dei segmenti di pubblico. Gli webhook consentono di inviare una notifica ai tuoi server ed evitano la necessità di eseguire polling.

Ogni volta che un elenco dei segmenti di pubblico ricorrenti crea un elenco dei segmenti di pubblico, vengono inviate due richieste POST. Questo accade una volta al giorno finché un elenco dei segmenti di pubblico ricorrente non raggiunge 0 giorni di attività rimanenti. La prima richiesta verrà inviata mostrando un elenco dei segmenti di pubblico appena creato nello stato CREATING. La seconda richiesta verrà inviata al termine della creazione dell'elenco del segmento di pubblico (stato ACTIVE o FAILED).

Metodi

create

 Crea un elenco del segmento di pubblico ricorrente.

get

 Recupera i metadati di configurazione di un elenco del segmento di pubblico ricorrente specifico.

list

 Elenca tutti gli elenchi dei segmenti di pubblico ricorrenti per una proprietà.