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 correspondem aos usuários de um público-alvo no momento da criação da lista. Com uma lista de público-alvo recorrente, você tem uma lista com base nos dados mais recentes disponíveis para uso diário.

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. Esse nome de recurso identifica o público-alvo listado e é compartilhado entre os dados do Google Analytics e APIs Admin.

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

audienceDisplayName

string

Apenas saída. O nome de exibição descritivo para este 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 da lista de público-alvo para instâncias de listas de público-alvo criadas para esta lista de público-alvo recorrente. Uma lista de público-alvo é criada para cada dia, e ela será listada aqui.

Essa lista é organizada com a lista de público-alvo criada mais recentemente primeiro.

activeDaysRemaining

integer

Opcional. O número de dias restantes que uma exportação de público-alvo recorrente vai produzir uma instância de lista de público-alvo. Esse contador diminui em um por dia e, quando ele chegar a zero, nenhuma lista de público-alvo será criada.

As solicitações recorrentes de lista de público-alvo para propriedades do Google Analytics 360 são padronizadas como 180 dias e, no máximo, 365 dias. As solicitações de propriedades padrão do Google Analytics são padronizadas como 14 dias e, no máximo, 30 dias.

O valor mínimo permitido durante a criação é 1. As solicitações acima do valor máximo determinado são forçadas a atingir o valor máximo.

webhookNotification

object (WebhookNotification)

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

Duas solicitações POST serão enviadas sempre que uma lista de público-alvo recorrente criar 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 "CRIANDO". A segunda solicitação será enviada depois que a lista de público-alvo concluir a criação (no estado ACTIVE ou FAILED).

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.