REST Resource: properties.recurringAudienceLists

Zasób: RecurringAudienceList

Lista odbiorców z powtarzającymi się adresami e-mail generuje nowe listy odbiorców każdego dnia. Listy odbiorców to użytkownicy, którzy należą do listy w momencie jej utworzenia. Powtarzająca się lista odbiorców zapewnia, że masz listę odbiorców opartą na najnowszych danych dostępnych każdego dnia.

Zapis JSON 
{
  "name": string,
  "audience": string,
  "audienceDisplayName": string,
  "dimensions": [
    {
      object (AudienceDimension)
    }
  ],
  "audienceLists": [
    string
  ],
  "activeDaysRemaining": integer,
  "webhookNotification": {
    object (WebhookNotification)
  }
}
Pola
name

string

Tylko dane wyjściowe. Identyfikator. Nazwa zasobu listy odbiorców powtarzających się, przypisanej podczas tworzenia. Ta nazwa zasobu identyfikuje ten element RecurringAudienceList.

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

string

Wymagane. Nazwa zasobu listy odbiorców. Ta nazwa zasobu identyfikuje listę odbiorców i jest udostępniana między interfejsami API Analytics Data i Admin.

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

string

Tylko dane wyjściowe. Opisowa wyświetlana nazwa tej listy odbiorców. Na przykład „Kupujący”.
dimensions[]

object (AudienceDimension)

Wymagane. Wymiary żądane i wyświetlane w odpowiedzi na żądanie listy odbiorców.
audienceLists[]

string

Tylko dane wyjściowe. Nazwy zasobów listy odbiorców dla instancji listy odbiorców utworzonych dla tej powtarzającej się listy odbiorców. Na każdy dzień tworzona jest jedna lista odbiorców, która jest tutaj wyświetlana.

Ta lista jest uporządkowana według kolejności od najnowszej do najstarszej listy odbiorców.
activeDaysRemaining

integer

Opcjonalnie: Liczba pozostałych dni, w których cykliczny eksport listy odbiorców będzie generował instancję listy odbiorców. Ten licznik zmniejsza się o 1 codziennie, a gdy osiągnie wartość 0, nie będzie już tworzonych nowych list odbiorców.

W przypadku usług w Analytics 360 domyślny okres ważności żądania listy odbiorców cyklicznych wynosi 180 dni, a maksymalnie może wynosić 365 dni. Żądania dotyczące standardowych usług w Analytics mają domyślny okres ważności 14 dni, a maksymalnie 30 dni.

Minimalna wartość dozwolona podczas tworzenia to 1. Żądania przekraczające maksymalną wartość zostaną dopasowane do tej wartości.
webhookNotification

object (WebhookNotification)

Opcjonalnie: Konfiguruje powiadomienia webhooka, które mają być wysyłane z interfejsu Google Analytics Data API na serwer webhooka. Korzystanie z webhooków jest opcjonalne. Jeśli nie jest używana, musisz zapytać ten interfejs API, aby określić, kiedy cykliczna lista odbiorców tworzy nowe listy odbiorców. Webhooki umożliwiają wysyłanie powiadomień na serwery i unikanie konieczności przeprowadzania ankiet.

Za każdym razem, gdy lista odbiorców o powtarzającym się składzie tworzy listę odbiorców, wysyłane są 2 żądania POST. Dzieje się tak raz dziennie, dopóki liczba aktywnych dni na liście odbiorców z powtarzającymi się danymi nie spadnie do 0. Pierwsze żądanie będzie wysyłane, gdy nowo utworzona lista odbiorców będzie w stanie „Tworzenie”. Drugie żądanie zostanie wysłane po zakończeniu tworzenia listy odbiorców (stan AKTYWNA lub NIEPOWODZENIE).

Metody

create

 Tworzy listę odbiorców o okresowym działaniu.

get

 Pobiera metadane konfiguracji dotyczące konkretnej listy odbiorców okresowych.

list

 Wyświetla wszystkie cykliczne listy odbiorców w usłudze.