REST Resource: properties.recurringAudienceLists

Recurso: RecurringAudienceList

Una lista de público recurrente genera listas de público nuevas todos los días. Las listas de público son los usuarios de un público en el momento de la creación de la lista. Una lista de público recurrente garantiza que tengas una lista de público basada en los datos más recientes disponibles para usar todos los días.

Representación JSON 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
Campos
name

string

Solo salida. Identificador. Es el nombre del recurso de la lista de público recurrente asignado durante la creación. Este nombre de recurso identifica este RecurringAudienceList.

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

string

Obligatorio. Es el nombre del recurso del público. Este nombre de recurso identifica el público que se incluye en la lista y se comparte entre las APIs de Analytics Data y Admin.

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

string

Solo salida. Es el nombre visible descriptivo de este público. Por ejemplo, “Compradores”.
dimensions[]

object (AudienceDimension)

Obligatorio. Son las dimensiones solicitadas y que se muestran en la respuesta de la lista de público.
audienceLists[]

string

Solo salida. Son los nombres de los recursos de la lista de público para las instancias de la lista de público creadas para esta lista de público recurrente. Se crea una lista de público para cada día, y esta se mostrará aquí.

Esta lista se ordena de modo que la lista de público creada más recientemente aparezca primero.
activeDaysRemaining

integer

Opcional. Es la cantidad de días restantes que una exportación de público recurrente producirá una instancia de lista de público. Este contador disminuye en uno cada día y, cuando llegue a cero, no se crearán listas de público nuevas.

La solicitud de lista de público recurrente para las propiedades de Analytics 360 tiene un valor predeterminado de 180 días y un máximo de 365 días. Las solicitudes de propiedades estándares de Analytics tienen un período predeterminado de 14 días y un máximo de 30 días.

El valor mínimo permitido durante la creación es 1. Las solicitudes superiores a su máximo respectivo se aplicarán al máximo.
webhookNotification

object (WebhookNotification)

Opcional. Configura las notificaciones de webhook que se enviarán desde la API de datos de Google Analytics a tu servidor de webhook. El uso de webhooks es opcional. Si no se usa, deberás sondear esta API para determinar cuándo una lista de público recurrente crea listas de público nuevas. Los webhooks permiten que se envíe una notificación a tus servidores y evitan la necesidad de sondeos.

Se enviarán dos solicitudes POST cada vez que una lista de público recurrente cree una lista de público. Esto sucede una vez al día hasta que una lista de público recurrente alcance 0 días activos restantes. La primera solicitud se enviará para mostrar una lista de público recién creada en el estado CREATING. La segunda solicitud se enviará después de que se complete la creación de la lista de público (en el estado ACTIVE o FAILED).

Métodos

create

 Crea una lista de público recurrente.

get

 Obtiene metadatos de configuración sobre una lista de público recurrente específica.

list

 Muestra todas las listas de público recurrentes de una propiedad.