REST Resource: properties.recurringAudienceLists

Risorsa: RecurringAudienceList

Un elenco del segmento di pubblico ricorrente genera ogni giorno nuovi elenchi dei segmenti di pubblico. 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 assicura di avere un elenco del segmento di pubblico basato sui dati più recenti disponibili da utilizzare 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. Questo nome risorsa identifica questo RecurringAudienceList.

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

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 dell'elenco del segmento di pubblico.

audienceLists[]

string

Solo output. Nomi delle risorse dell'elenco del segmento di pubblico per le istanze dell'elenco del segmento di pubblico create per questo elenco del segmento di pubblico ricorrente. Viene creato un elenco del segmento di pubblico al giorno e l'elenco del segmento di pubblico viene riportato qui.

Questo elenco è ordinato a partire dall'elenco del segmento di pubblico creato più di recente.

activeDaysRemaining

integer

(Facoltativo) Il numero di giorni rimanenti in cui un'esportazione dei segmenti di pubblico ricorrente produrrà un'istanza di un elenco del segmento di pubblico. Questo contatore diminuisce di un'unità ogni giorno e, quando raggiunge lo zero, non verranno creati nuovi elenchi dei segmenti di pubblico.

La richiesta di elenco del segmento di pubblico ricorrente per le proprietà Analytics 360 è impostata su un valore predefinito di 180 giorni e una durata massima di 365 giorni. Le richieste per le proprietà Analytics standard hanno una durata predefinita di 14 giorni e una durata massima di 30 giorni.

Il valore minimo consentito durante la creazione è 1. Le richieste che superano il 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 server webhook. L'uso dei webhook è facoltativo. Se non viene utilizzata, dovrai eseguire il polling di questa API per determinare quando un elenco del segmento di pubblico ricorrente crea nuovi elenchi dei segmenti di pubblico. I webhook consentono l'invio di notifiche ai tuoi server e evitando di ricorrere ai sondaggi.

Verranno inviate due richieste POST ogni volta che un elenco del segmento di pubblico ricorrente crea un elenco del segmento di pubblico. Questo accade 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 FASE DI CREAZIONE. La seconda richiesta verrà inviata al termine della creazione dell'elenco del segmento di pubblico (lo stato ATTIVO o NON RIUSCITA).

Metodi

create

Crea un elenco del segmento di pubblico ricorrente.

get

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

list

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