REST Resource: properties.recurringAudienceLists

Recurso: RecurringAudienceList

Una lista de público recurrente genera nuevas listas de público cada día. 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 cada día.

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. El nombre del recurso de la lista de público recurrente que se asignó durante la creación. El nombre del recurso identifica a este RecurringAudienceList.

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

string

Obligatorio. El nombre del recurso de público. El nombre de este recurso identifica el público que se muestra y se comparte entre los datos de Analytics. Admin.

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

string

Solo salida. El nombre visible descriptivo para este público. Por ejemplo, "Compradores".
dimensions[]

object (AudienceDimension)

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

string

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

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

integer

Opcional. 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 se establece de forma predeterminada en 180 días y tiene un máximo de 365 días. Las solicitudes de propiedades estándares de Analytics se establecen de forma predeterminada en 14 días y tienen un máximo de 30 días.

El valor mínimo permitido durante la creación es 1. Las solicitudes que superen su máximo respectivo se expondrán a su máximo.
webhookNotification

object (WebhookNotification)

Opcional. Configura las notificaciones de webhook para que se envíen desde la API de datos de Google Analytics a tu servidor de webhook. El uso de webhooks es opcional. Si no se utiliza, deberás consultar 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 evitar 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 alcanza los 0 días activos restantes. La primera solicitud se enviará y mostrará una lista de público recién creada en su estado CREATING. La segunda solicitud se enviará después de que se complete la creación de la lista de público (ya sea en el estado ACTIVA o CON ERRORES).

Métodos

create

 Crea una lista de público recurrente.

get

 Obtiene los 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.