REST Resource: properties.recurringAudienceLists

Recurso: RecurringAudienceList

Uma lista de público-alvo recorrente produz novas listas de público-alvo todos os dias. As listas de público-alvo são usuários em um público-alvo no momento da criação da lista. Uma lista de público-alvo recorrente garante que você tenha uma lista de público-alvo com base nos dados mais recentes disponíveis para uso a cada dia.

Representação JSON 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
Campos
name

string

Apenas saída. Identificador. O nome do recurso da lista de público-alvo recorrente atribuído durante a criação. Esse nome de recurso identifica o RecurringAudienceList.

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

string

Obrigatório. O nome do recurso de público-alvo. Esse nome de recurso identifica o público-alvo listado e é compartilhado entre as APIs Analytics Data e Admin.

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

string

Apenas saída. O nome de exibição descritivo desse público-alvo. Por exemplo, "Compradores".
dimensions[]

object (AudienceDimension)

Obrigatório. As dimensões solicitadas e exibidas na resposta da lista de público-alvo.
audienceLists[]

string

Apenas saída. Nomes de recursos de lista de público-alvo para instâncias de lista de público-alvo criadas para essa lista de público-alvo recorrente. Uma lista de público-alvo é criada para cada dia e é listada aqui.

A lista é ordenada com a lista de público-alvo mais recente em primeiro lugar.
activeDaysRemaining

integer

Opcional. É o número de dias restantes em que uma exportação recorrente de público-alvo vai produzir uma instância de lista de público-alvo. Esse contador diminui em um a cada dia, e quando chega a zero, nenhuma nova lista de público-alvo é criada.

A solicitação recorrente de lista de público-alvo para propriedades do Analytics 360 tem um período padrão de 180 dias e um máximo de 365 dias. As solicitações para propriedades padrão do Google Analytics têm um padrão de 14 dias e um máximo de 30 dias.

O valor mínimo permitido durante a criação é 1. As solicitações acima do limite máximo serão forçadas para o limite máximo.
webhookNotification

object (WebhookNotification)

Opcional. Configura as notificações de webhook para serem enviadas da API Data do Google Analytics para seu servidor de webhook. O uso de webhooks é opcional. Se não for usada, você vai precisar consultar essa API para determinar quando uma lista de público-alvo recorrente cria novas listas. Os webhooks permitem que uma notificação seja enviada aos seus servidores e evitam a necessidade de pesquisa.

Duas solicitações POST são enviadas sempre que uma lista de público-alvo recorrente cria uma lista de público-alvo. Isso acontece uma vez por dia até que uma lista de público-alvo recorrente atinja 0 dias ativos restantes. A primeira solicitação será enviada mostrando uma lista de público-alvo recém-criada no estado "CRIA-SE". A segunda solicitação será enviada depois que a criação da lista de público-alvo for concluída (no estado ATIVA ou FALHOU).

Métodos

create

 Cria uma lista de público-alvo recorrente.

get

 Recebe metadados de configuração sobre uma lista de público-alvo recorrente específica.

list

 Lista todas as listas de público-alvo recorrentes de uma propriedade.