REST Resource: properties.recurringAudienceLists

Zasób: RecurringAudienceList

W przypadku cyklicznej listy odbiorców codziennie tworzone są nowe listy odbiorców. Listy odbiorców to użytkownicy znajdujący się na liście odbiorców w momencie jej utworzenia. Cykliczna lista odbiorców zapewnia, że lista odbiorców powstaje na podstawie najnowszych danych dostępnych do użycia z danego 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 cyklicznej listy odbiorców przypisana podczas tworzenia. Ta nazwa zasobu identyfikuje ten zasób (RecurringAudienceList).

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

audience

string

Wymagane. Nazwa zasobu listy odbiorców. Ta nazwa zasobu określa listę odbiorców i jest udostępniana przez interfejsy Analytics Data & Admin API.

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

audienceDisplayName

string

Tylko dane wyjściowe. Wyświetlana nazwa opisowa dla tej listy odbiorców. Na przykład „Kupujący”.

dimensions[]

object (AudienceDimension)

Wymagane. Wymiary, o które prosisz i wyświetlały się w odpowiedzi na żądanie listy odbiorców.

audienceLists[]

string

Tylko dane wyjściowe. Nazwy zasobów list odbiorców na potrzeby wystąpień list odbiorców utworzonych na potrzeby tej cyklicznej listy odbiorców. Każdego dnia tworzona jest jedna lista odbiorców, która znajduje się w tym miejscu.

Lista jest uporządkowana od najnowszych.

activeDaysRemaining

integer

Opcjonalnie. Liczba pozostałych dni, w ramach których cykliczny eksport listy odbiorców wygeneruje wystąpienie listy odbiorców. Licznik ten maleje codziennie o jeden, a gdy osiągnie zero, nie są tworzone żadne nowe listy odbiorców.

Cykliczna prośba o listę odbiorców w usługach w Analytics 360 domyślnie obejmuje 180 dni, a maksymalnie 365 dni. Żądania w standardowych usługach w Analytics mają domyślnie okres 14 dni, a maksymalnie 30 dni.

Minimalna dozwolona wartość podczas tworzenia to 1. Żądania powyżej ustalonej wartości maksymalnej będą traktowane jako maksymalna.

webhookNotification

object (WebhookNotification)

Opcjonalnie. Umożliwia skonfigurowanie wysyłania powiadomień webhook z interfejsu Google Analytics Data API na serwer webhooka. Korzystanie z webhooków jest opcjonalne. Jeśli cykliczna lista odbiorców nie jest używana, musisz przeprowadzić ankietę w tym interfejsie API, aby określić, kiedy cykliczna lista odbiorców ma tworzyć nowe listy odbiorców. Webhooki umożliwiają wysyłanie powiadomień do Twoich serwerów i pozwalają uniknąć konieczności odpytywania.

Za każdym razem, gdy cykliczna lista odbiorców utworzy listę odbiorców, zostaną wysłane 2 żądania POST. Dzieje się tak raz dziennie, aż cykliczna lista odbiorców osiągnie 0 pozostałych dni aktywności. W odpowiedzi zostanie wysłana pierwsza prośba z informacją, że nowo utworzona lista odbiorców jest w stanie TWORZENIA. Druga prośba zostanie wysłana po utworzeniu listy odbiorców (stan AKTYWNA lub NIEBŁĄD).

Metody

create

Tworzy cykliczną listę odbiorców.

get

Pobiera metadane konfiguracji dotyczące określonej cyklicznej listy odbiorców.

list

Zawiera wszystkie cykliczne listy odbiorców danej usługi.