REST Resource: properties.recurringAudienceLists

Ressource: RecurringAudienceList

Bei wiederkehrenden Zielgruppenlisten werden jeden Tag neue Zielgruppenlisten erstellt. Zielgruppenlisten sind Nutzer, die zum Zeitpunkt der Erstellung einer Zielgruppe angehören. Mit einer wiederkehrenden Zielgruppenliste wird sichergestellt, dass die Zielgruppenliste auf Basis der neuesten Daten basiert, die täglich zur Verfügung stehen.

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 dieses RecurringAudienceList.

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

string

Erforderlich. Der Name der Zielgruppenressource. Dieser Ressourcenname kennzeichnet die aufgelistete Zielgruppe und wird zwischen den Analytics-Daten und Admin-APIs.

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 angefordert und in der Antwort der Zielgruppenliste 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 hier aufgeführt wird.

Diese Liste wird so geordnet, dass die zuletzt erstellte Zielgruppenliste an erster Stelle steht.
activeDaysRemaining

integer

Optional. Die Anzahl der verbleibenden Tage, an denen bei einem wiederkehrenden Zielgruppenexport eine Zielgruppenliste erstellt wird. Dieser Zähler verringert sich jeden Tag um eins. Wenn er null erreicht, werden keine neuen Zielgruppenlisten erstellt.

Wiederkehrende Zielgruppenlistenanfragen für Analytics 360-Properties dauern standardmäßig 180 Tage und sind maximal 365 Tage lang. Für Analytics-Standard-Properties sind Anfragen standardmäßig auf 14 Tage und maximal 30 Tage möglich.

Der Mindestwert, der während der Erstellung zulässig ist, ist 1. Anfragen, die über dem jeweiligen Maximum liegen, werden zum Erreichen des Maximums gezwungen.
webhookNotification

object (WebhookNotification)

Optional. Konfiguriert Webhook-Benachrichtigungen, die von der Google Analytics Data API an Ihren Webhook-Server gesendet werden. Die Verwendung von Webhooks ist optional. Wird sie nicht verwendet, müssen Sie diese API abfragen, um festzustellen, wann eine wiederkehrende Zielgruppenliste neue Zielgruppenlisten erstellt. Mit Webhooks können Benachrichtigungen an Ihre Server und ohne dass Abfragen erforderlich sind.

Jedes Mal, wenn eine wiederkehrende Zielgruppenliste erstellt wird, werden zwei POST-Anfragen gesendet. Das geschieht einmal täglich, bis eine wiederkehrende Zielgruppenliste 0 aktive Tage übrig hat. Die erste Anfrage wird gesendet. Eine neu erstellte Zielgruppenliste wird im Status WIRD ERSTELLT angezeigt. Die zweite Anfrage wird gesendet, nachdem die Zielgruppenliste erstellt wurde (AKTIV oder FEHLGESCHLAGEN).

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.