REST Resource: properties.recurringAudienceLists

Zasób: RecurringAudienceList

Cykliczna lista odbiorców generuje nowe listy odbiorców każdego dnia. Listy odbiorców to użytkownicy znajdujący się na liście odbiorców w momencie jej tworzenia. Cykliczna lista odbiorców gwarantuje, że Twoja lista odbiorców powstała na podstawie najnowszych danych dostępnych dla 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 cyklicznej listy odbiorców przypisana podczas tworzenia. Ta nazwa zasobu identyfikuje zasób RecurringAudienceList.

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

audience

string

Wymagane. Nazwa zasobu związanego z odbiorcami. Ta nazwa zasobu identyfikuje wymienioną listę odbiorców i jest współdzielona przez dane Analytics i API dla administratorów.

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

audienceDisplayName

string

Tylko dane wyjściowe. Opisowa wyświetlana nazwa grupy odbiorców. np. „Kupujący”.

dimensions[]

object (AudienceDimension)

Wymagane. Żądane wymiary i wyświetlane w odpowiedzi z listą odbiorców.

audienceLists[]

string

Tylko dane wyjściowe. Nazwy zasobów listy odbiorców na potrzeby instancji list odbiorców utworzonych na potrzeby tej cyklicznej listy odbiorców. Dla każdego dnia tworzona jest jedna lista odbiorców. Tutaj będzie widoczna lista odbiorców.

Lista jest uporządkowana od najnowszych.

activeDaysRemaining

integer

Opcjonalnie: Liczba pozostałych dni, w których cykliczny eksport odbiorców spowoduje utworzenie instancji listy odbiorców. Ten licznik zmniejsza się o 1 dziennie. Gdy osiągnie wartość zero, nie są tworzone żadne nowe listy odbiorców.

Cykliczne żądanie listy odbiorców w usługach w Analytics 360 domyślnie wynosi 180 dni, a maksymalnie 365 dni. Żądania dotyczące standardowych usług w Analytics domyślnie wynoszą 14 dni, a maksymalnie 30 dni.

Minimalna wartość dozwolona podczas tworzenia to 1. Żądania powyżej poziomu maksymalnego będą wymuszane na maksymalnym poziomie.

webhookNotification

object (WebhookNotification)

Opcjonalnie: Konfiguruje wysyłanie powiadomień webhooka do serwera webhooka z interfejsu Google Analytics Data API. Korzystanie z webhooków jest opcjonalne. Jeśli nie używasz tego interfejsu, musisz przeprowadzić sondowanie tego interfejsu API, aby określić, kiedy cykliczna lista odbiorców tworzy nowe listy odbiorców. Webhooki umożliwiają wysyłanie powiadomień do serwerów aby uniknąć konieczności przeprowadzania ankiet.

Za każdym razem, gdy cykliczna lista odbiorców utworzy listę odbiorców, zostaną wysłane 2 żądania POST. Dzieje się tak raz dziennie, dopóki liczba aktywnych dni na liście odbiorców cyklicznej nie spadnie przez 0. W pierwszym żądaniu pojawi się stan TWORZENIA nowo utworzonej listy odbiorców. Druga prośba zostanie wysłana po zakończeniu tworzenia listy odbiorców (ze stanem AKTYWNY lub NIEPRAWIDŁOWY).

Metody

create

Tworzy cykliczną listę odbiorców.

get

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

list

Zawiera listę wszystkich cyklicznych list odbiorców w danej usłudze.