Wiederkehrende Zielgruppenlisten

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

In diesem Dokument werden wiederkehrende Zielgruppenlisten beschrieben, eine erweiterte Funktion der Google Analytics Data API v1. Eine Einführung in die Funktion zum Exportieren von Zielgruppenlisten finden Sie im Leitfaden zu den Grundlagen des Zielgruppenexports.

Bei wiederkehrenden Zielgruppenlisten werden Zielgruppenlisten täglich erstellt, wenn sich die Zugehörigkeit zu Zielgruppen ändert, damit Sie immer mit den neuesten Daten arbeiten.

Regelmäßige (nicht wiederkehrende) Zielgruppenlisten sind statische Listen der Nutzer in der Zielgruppe zum Zeitpunkt der Erstellung der Liste.

Täglich eine neue Zielgruppenliste erstellen

Es dauert unterschiedlich lang, bis die Zielgruppendaten eines Tages verarbeitet und die Mitgliedschaft aktualisiert werden. Es kann nicht garantiert werden, dass die Daten der Zielgruppenliste innerhalb von 24 Stunden aktualisiert werden.

Auch wenn Sie beispielsweise jeden Tag zur selben Zeit eine Zielgruppenliste anfordern, ist diese Liste an manchen Tagen mit der des Vortags identisch. An anderen Tagen enthält sie möglicherweise Änderungen der Zugehörigkeit, die sich am Vortag ereignet haben.

Zielgruppenlisten basieren auf Ereignisdaten vom Vortag der letzten Änderungen an der Mitgliedschaft. Wenn Sie eine Zielgruppenliste erstellen, bevor tägliche Aktualisierungen der Mitgliedschaften erfolgen, werden die Daten der beiden Tage davor verwendet. Wenn Sie eine Zielgruppenliste erstellen, nachdem die täglichen Aktualisierungen der Mitgliedschaft erfolgt sind, werden die Daten vom Vortag verwendet.

Regelmäßig eine wiederkehrende Zielgruppenliste abfragen

Bei wiederkehrenden Zielgruppenlisten werden nur dann Zielgruppenlisten erstellt, wenn Daten für einen zusätzlichen Tag verfügbar sind. So müssen Sie nicht mehr selbst entscheiden, wann Sie neue Zielgruppenlisten erstellen. Stattdessen können Sie die Liste der wiederkehrenden Zielgruppen mehrmals täglich abfragen, um zu sehen, ob zusätzliche Daten verfügbar sind.

Regelmäßige Zielgruppenliste erstellen

Wenn Sie eine wiederkehrende Zielgruppenliste erstellen möchten, rufen Sie die Methode recurringAudienceLists.create mit dem Objekt RecurringAudienceList in einer Anfrage auf. Folgende Parameter sind erforderlich:

• Ein gültiger Zielgruppenname im Feld audience, formatiert als properties/{propertyId}/audiences/{audienceId}. Sie können die Methode audiences.list der Google Analytics Admin API v1 verwenden, um diesen Wert abzurufen. Das Feld Audience.name der audiences.list-Antwort enthält den Namen der Zielgruppe.
• Eine gültige Liste von Dimensionen im Feld dimensions. Eine Liste der von dieser Methode unterstützten Dimensionen finden Sie in der Dokumentation zum Schema für Zielgruppenexporte. In einer Zielgruppenliste sind nur die Daten für die in diesem Feld genannten Dimensionen enthalten.

Hier ist ein Beispiel für eine Anfrage zum Erstellen einer wiederkehrenden Zielgruppenliste:

POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists
{
  "audience": "properties/1234567/audiences/12345",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ]
}

Eine Antwort der recurringAudienceLists.create-Methode enthält den Namen im Feld name (z. B. properties/1234567/recurringAudienceLists/123). Dieser kann in nachfolgenden Abfragen verwendet werden, um die Konfigurationsmetadaten für diese wiederkehrende Zielgruppenliste abzurufen. Außerdem enthalten die Konfigurationsmetadaten Ressourcennamen für Zielgruppenlisteninstanzen, die für diese wiederkehrende Zielgruppenliste erstellt wurden.

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

Metadaten der Abfragekonfiguration

Verwenden Sie die Methode recurringAudienceLists.get, um Konfigurationsmetadaten zu einer bestimmten wiederkehrenden Zielgruppenliste abzurufen. Die Konfigurationsmetadaten enthalten Ressourcennamen für Zielgruppenlisteninstanzen, die für diese wiederkehrende Zielgruppenliste erstellt wurden.

Beispiel:

GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists/123

Es wird eine Instanz von RecurringAudienceList zurückgegeben. Er enthält die Konfigurationsmetadaten, darunter Ressourcennamen für Zielgruppenlisteninstanzen, die für diese wiederkehrende Zielgruppenliste erstellt wurden.

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

Mit recurringAudienceLists.list können Sie alle wiederkehrenden Zielgruppenlisten für eine Property auflisten.

Mit Webhooks asynchrone Benachrichtigungen zu neuen Zielgruppenlisten erhalten

Anstatt die Konfigurationsmetadaten für eine bestimmte wiederkehrende Zielgruppenliste mit der Methode recurringAudienceLists.get regelmäßig abzufragen, können Sie asynchron Webhook-Benachrichtigungen erhalten, wenn eine Zielgruppenliste verfügbar ist.

Wenn Sie Webhook-Benachrichtigungen konfigurieren möchten, geben Sie beim Erstellen einer neuen wiederkehrenden Zielgruppenliste das Feld webhookNotification an.

Weitere Informationen zur Verwendung von Webhooks in der Google Analytics Data API v1 finden Sie im Leitfaden Async audience lists with webhooks.

Nutzer in einem Zielgruppenexport abrufen

Wenn Sie Nutzer in einem Zielgruppenexport abrufen möchten, rufen Sie die Methode audienceExports.query auf und geben Sie den Namen des Zielgruppenexports an, der aus den Konfigurationsmetadaten von recurringAudienceLists.get oder recurringAudienceLists.list abgerufen wurde.

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

Wenn der Zielgruppenexport bereit ist, wird eine Antwort mit der Liste der Nutzer in einer Zielgruppe zurückgegeben:

{
  "audienceExport": {
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "ACTIVE",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  },
  "audienceRows": [
    {
      "dimensionValues": [
        {
          "value": "1000276123.1681742376"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000374452.1668627377"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000391956.1652750758"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000410539.1682018694"
        }
      ]
    },
    {
      "dimensionValues": [
        {
          "value": "1000703969.1666725875"
        }
      ]
    }
  ],
  "rowCount": 5
}