REST Resource: properties.recurringAudienceLists

Risorsa: RecurringAudienceList

Un elenco del segmento 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 assicura di disporre di 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 del segmento di pubblico ricorrente assegnato durante la creazione. Il nome di questa risorsa identifica questo RecurringAudienceList.

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

audience

string

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

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

audienceDisplayName

string

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

dimensions[]

object (AudienceDimension)

Obbligatoria. Le dimensioni richieste e visualizzate nella risposta dell'elenco del segmento di pubblico.

audienceLists[]

string

Solo output. Nomi delle risorse degli elenchi del segmento di pubblico per le istanze dell'elenco del segmento di pubblico create per questo elenco del segmento di pubblico ricorrente. Ogni giorno viene creato un elenco del segmento di pubblico, che sarà riportato qui.

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

activeDaysRemaining

integer

Campo facoltativo. Il numero di giorni restanti durante i quali un'esportazione di segmenti di pubblico ricorrente genererà un'istanza di elenco del segmento di pubblico. Questo contatore diminuisce di un'unità ogni giorno e, quando arriva a zero, non verranno creati nuovi elenchi di segmenti di pubblico.

Le richieste di elenchi dei segmenti di pubblico ricorrenti per le proprietà Analytics 360 hanno una durata predefinita di 180 giorni e un massimo di 365 giorni. Le richieste per le proprietà Analytics standard hanno una durata predefinita di 14 giorni e un massimo di 30 giorni.

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

webhookNotification

object (WebhookNotification)

Campo facoltativo. Configura le notifiche webhook da inviare dall'API di dati di Google Analytics al server webhook. L'utilizzo dei webhook è facoltativo. Se non lo utilizzi, dovrai eseguire un sondaggio in questa API per determinare quando un elenco del segmento di pubblico ricorrente crea nuovi elenchi dei segmenti di pubblico. I webhook consentono di inviare notifiche ai server ed evitano di dover eseguire il polling.

Verranno inviate due richieste POST ogni volta che un elenco del segmento di pubblico ricorrente crea un elenco. Questa operazione si verifica una volta al giorno fino a quando un elenco del segmento di pubblico ricorrente non raggiunge 0 giorni attivi rimanenti. La prima richiesta verrà inviata mostrando un elenco del segmento di pubblico appena creato nel suo stato IN CREAZIONE. La seconda richiesta verrà inviata al termine della creazione dell'elenco del segmento di pubblico (stato ATTIVO o NON RIUSCITO).

Metodi

create

Crea un elenco del segmento di pubblico ricorrente.

get

Recupera i metadati di configurazione relativi a uno specifico elenco del segmento di pubblico ricorrente.

list

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