Wiederkehrende Zielgruppenlisten

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 Grundlagen des Zielgruppenexports.

Bei wiederkehrenden Zielgruppenlisten werden täglich Zielgruppenlisten erstellt, wenn sich die Zielgruppenmitgliedschaften ändern. So haben Sie immer die neuesten Daten.

Normale (nicht wiederkehrende) Zielgruppenlisten sind statische Listen von Nutzern in der Zielgruppe zum Zeitpunkt der Listengenerierung.

Täglich eine neue Zielgruppenliste erstellen

Die Verarbeitung der Zielgruppendaten eines Tages und die Aktualisierung der Mitgliedschaft dauert unterschiedlich lange. Es gibt keine Garantie, dass die Daten der Zielgruppenliste innerhalb von 24 Stunden aktualisiert werden.

Auch wenn Sie beispielsweise jeden Tag zur gleichen Zeit eine Zielgruppenliste anfordern, ist sie an manchen Tagen mit der vom Vortag identisch. An anderen Tagen ist sie anders und enthält zusätzliche Änderungen an den Mitgliedschaften vom Vortag.

Täglich eine neue Zielgruppenliste erstellen

Zielgruppenlisten basieren auf Ereignisdaten vom Tag vor den letzten Änderungen an den Mitgliedschaften. Wenn Sie eine Zielgruppenliste erstellen, bevor die täglichen Mitgliedschaftsaktualisierungen erfolgen, werden Daten von zwei Tagen zuvor verwendet. Wenn Sie eine Zielgruppenliste erstellen, nachdem die täglichen Mitgliedschaftsaktualisierungen erfolgt sind, werden Daten vom Vortag verwendet.

Wiederkehrende Zielgruppenliste regelmäßig abfragen

Bei wiederkehrenden Zielgruppenlisten werden nur dann Zielgruppenlisten erstellt, wenn Daten für einen weiteren Tag verfügbar sind. So müssen Sie nicht mehr raten, wann Sie neue Zielgruppenlisten erstellen sollten. Stattdessen können Sie die wiederkehrende Zielgruppenliste den ganzen Tag über kostengünstig abfragen, um zu prüfen, ob zusätzliche Daten verfügbar sind.

Regelmäßiges Abrufen einer wiederkehrenden Zielgruppenliste im Laufe des Tages

Wiederkehrende Zielgruppenliste erstellen

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

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

Hier ist eine Beispielanfrage zum Erstellen einer wiederkehrenden Zielgruppenliste:

HTTP-Anfrage

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

Eine Antwort der Methode recurringAudienceLists.create 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.

HTTP-Antwort

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

Konfigurationsmetadaten abfragen

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

Beispiel:

HTTP-Anfrage

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

Als Antwort wird eine Instanz von RecurringAudienceList zurückgegeben. Sie enthält die Konfigurationsmetadaten, einschließlich der Ressourcennamen für Zielgruppenlisteninstanzen , die für diese wiederkehrende Zielgruppenliste erstellt wurden.

HTTP-Antwort

{
  "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.

Webhooks verwenden, um asynchrone Benachrichtigungen über neue Zielgruppenlisten zu erhalten

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

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

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

Nutzer in einem Zielgruppenexport abrufen

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

HTTP-Anfrage

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:

HTTP-Antwort

{
  "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
}