REST Resource: properties.recurringAudienceLists

Ressource: RecurringAudienceList

Bei wiederkehrenden Zielgruppenlisten werden jeden Tag neue Zielgruppenlisten erstellt. Zielgruppenlisten sind Nutzer, die zum Zeitpunkt der Erstellung in einer Zielgruppe enthalten sind. Mit einer wiederkehrenden Zielgruppenliste wird sichergestellt, dass die Zielgruppenliste auf den neuesten Daten basiert, die täglich verwendet werden können.

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

string

Nur Ausgabe. ID. Der wiederkehrende Ressourcenname der 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 kennzeichnet die aufgeführte Zielgruppe und wird von den Analytics Data & Admin APIs gemeinsam verwendet.

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

string

Nur Ausgabe. Der beschreibende 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 von Zielgruppenlisten für Zielgruppenlisteninstanzen, die für diese wiederkehrende Zielgruppenliste erstellt wurden. Für jeden Tag wird eine Zielgruppenliste erstellt. Die Zielgruppenliste wird hier aufgeführt.

Die Liste wird nach der zuletzt erstellten Zielgruppenliste sortiert.
activeDaysRemaining

integer

Optional. Die Anzahl der verbleibenden Tage, an denen ein wiederkehrender Zielgruppenexport zu einer Zielgruppenlisteninstanz führt. Dieser Zähler verringert sich jeden Tag um eins. Wenn er null erreicht, werden keine neuen Zielgruppenlisten erstellt.

Wiederkehrende Zielgruppenlisten für Analytics 360-Properties werden standardmäßig auf 180 Tage und maximal 365 Tage lang angefordert. Anfragen für Analytics-Standard-Properties werden standardmäßig auf 14 Tage, die maximale Dauer von 30 Tagen, festgelegt.

Der Mindestwert während der Erstellung ist 1. Anfragen, die das jeweilige Maximum überschreiten, werden auf ihr Maximum gezwungen.
webhookNotification

object (WebhookNotification)

Optional. Mit dieser Richtlinie 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 nicht verwendet wird, müssen Sie diese API abfragen, um festzustellen, wann mit einer wiederkehrenden Zielgruppenliste neue Zielgruppenlisten erstellt werden. Mit Webhooks kann eine Benachrichtigung an Ihre Server gesendet werden, sodass keine Abfragen erforderlich sind.

Jedes Mal, wenn für eine wiederkehrende Zielgruppenliste eine Zielgruppenliste erstellt wird, werden zwei POST-Anfragen gesendet. Dies geschieht einmal täglich, bis eine wiederkehrende Zielgruppenliste keine verbleibenden aktiven Tage erreicht. Die erste Anfrage wird mit einer neu erstellten Zielgruppenliste im Status CREATING gesendet. Die zweite Anfrage wird gesendet, nachdem die Zielgruppenliste erstellt wurde (mit dem Status AKTIV oder FEHLGESCHLAGEN).

Methoden

create

 Hiermit wird eine wiederkehrende Zielgruppenliste erstellt.

get

 Ruft Konfigurationsmetadaten zu einer bestimmten wiederkehrenden Zielgruppenliste ab.

list

 Listet alle wiederkehrenden Zielgruppenlisten für eine Property auf