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 ( |
Felder | |
---|---|
name |
Nur Ausgabe. ID. Der wiederkehrende Ressourcenname der Zielgruppenliste, der bei der Erstellung zugewiesen wurde. Dieser Ressourcenname identifiziert diese Format: |
audience |
Erforderlich. Der Name der Zielgruppenressource. Dieser Ressourcenname kennzeichnet die aufgeführte Zielgruppe und wird von den Analytics Data & Admin APIs gemeinsam verwendet. Format: |
audienceDisplayName |
Nur Ausgabe. Der beschreibende Anzeigename für diese Zielgruppe. Beispiel: „Käufer“. |
dimensions[] |
Erforderlich. Die Dimensionen, die in der Antwort der Zielgruppenliste angefordert und angezeigt werden. |
audienceLists[] |
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 |
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 |
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 |
|
---|---|
|
Hiermit wird eine wiederkehrende Zielgruppenliste erstellt. |
|
Ruft Konfigurationsmetadaten zu einer bestimmten wiederkehrenden Zielgruppenliste ab. |
|
Listet alle wiederkehrenden Zielgruppenlisten für eine Property auf |