REST Resource: properties.recurringAudienceLists

Ressource: RecurringAudienceList

Bei einer wiederkehrenden Zielgruppenliste werden jeden Tag neue Zielgruppenlisten erstellt. Zielgruppenlisten umfassen Nutzer, die zum Zeitpunkt der Erstellung der Liste zu einer Zielgruppe gehörten. Mit einer wiederkehrenden Zielgruppenliste können Sie jeden Tag eine Zielgruppenliste mit den neuesten verfügbaren Daten verwenden.

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

string

Nur Ausgabe. Kennung. Der Name der wiederkehrenden Zielgruppenliste, der bei der Erstellung zugewiesen wurde. Dieser Ressourcenname identifiziert diese RecurringAudienceList.

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

string

Erforderlich. Der Name der Zielgruppenressource. Dieser Ressourcenname identifiziert die aufgeführte Zielgruppe und wird von der Analytics Data API und der Admin API gemeinsam verwendet.

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

string

Nur Ausgabe. Der aussagekräftige Anzeigename für diese Zielgruppe. Beispiel: „Käufer“.
dimensions[]

object (AudienceDimension)

Erforderlich. Die Dimensionen, die in der Antwort der Zielgruppenliste angefordert und angezeigt werden.
audienceLists[]

string

Nur Ausgabe. Ressourcennamen der Zielgruppenlisten für Zielgruppenlisteninstanzen, die für diese wiederkehrende Zielgruppenliste erstellt wurden. Für jeden Tag wird eine Zielgruppenliste erstellt, die hier aufgeführt wird.

Diese Liste ist nach der zuletzt erstellten Zielgruppenliste sortiert.
activeDaysRemaining

integer

Optional. Die Anzahl der verbleibenden Tage, an denen durch einen wiederkehrenden Zielgruppenexport eine Zielgruppenlisteninstanz erstellt wird. Dieser Zähler wird jeden Tag um eins verringert. Wenn er auf null fällt, werden keine neuen Zielgruppenlisten mehr erstellt.

Die Standarddauer für wiederkehrende Anfragen für Zielgruppenlisten in Analytics 360-Properties beträgt 180 Tage. Maximal sind 365 Tage möglich. Für Anfragen für Standard-Analytics-Properties gilt standardmäßig ein Zeitraum von 14 Tagen, maximal 30 Tage.

Der Mindestwert bei der Erstellung ist 1. Anfragen, die über dem jeweiligen Höchstwert liegen, werden auf den Höchstwert begrenzt.
webhookNotification

object (WebhookNotification)

Optional. Hiermit werden Webhook-Benachrichtigungen konfiguriert, die von der Google Analytics Data API an Ihren Webhook-Server gesendet werden. Die Verwendung von Webhooks ist optional. Wenn Sie diese Funktion nicht verwenden, müssen Sie diese API abfragen, um zu ermitteln, wann neue Zielgruppenlisten für eine wiederkehrende Zielgruppenliste erstellt werden. Mit Webhooks kann eine Benachrichtigung an Ihre Server gesendet werden, sodass keine Abfragen erforderlich sind.

Jedes Mal, wenn eine Zielgruppenliste mit wiederkehrenden Ereignissen eine Zielgruppenliste erstellt, werden zwei POST-Anfragen gesendet. Das geschieht einmal täglich, bis für eine wiederkehrende Zielgruppenliste keine aktiven Tage mehr verbleiben. Die erste Anfrage enthält eine neu erstellte Zielgruppenliste im Status „ERSTELLT“. Die zweite Anfrage wird gesendet, nachdem die Zielgruppenliste erstellt wurde (Status „AKTIV“ oder „FEHLER“).

Methoden

create

 Erstellt eine wiederkehrende Zielgruppenliste.

get

 Ruft Konfigurationsmetadaten zu einer bestimmten wiederkehrenden Zielgruppenliste ab.

list

 Listet alle wiederkehrenden Zielgruppenlisten für eine Property auf.