Wiederkehrende Zielgruppenlisten

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

Bei wiederkehrenden Zielgruppenlisten werden täglich Zielgruppenlisten erstellt, wenn sich die Mitgliedschaften ändern, damit Sie mit den neuesten Daten arbeiten.

Reguläre (nicht wiederkehrende) Zielgruppenlisten sind statische Listen von Nutzern, die sich in einer Zielgruppe befinden, wenn die Liste generiert wird.

Täglich eine neue Zielgruppenliste erstellen

Die Verarbeitung der Zielgruppendaten eines Tages und die Aktualisierung der Mitgliedschaft kann unterschiedlich lange dauern. Es kann nicht sicher sein, dass die Daten der Zielgruppenliste innerhalb von 24 Stunden aktualisiert werden.

Beispiel: Auch wenn Sie eine Zielgruppenliste jeden Tag zur gleichen Zeit anfordern, ist die Zielgruppenliste an manchen Tagen mit der des Vortags identisch. An anderen Tagen ändert sich die Zielgruppenliste um einen zusätzlichen Tag, an dem die Zielgruppenliste geändert wird.

Zielgruppenlisten basieren auf Ereignisdaten des letzten Tages vor den letzten Änderungen an der Mitgliedschaft. Wenn Sie eine Zielgruppenliste erstellen, bevor die Mitgliedschaft täglich aktualisiert wird, werden die Daten der beiden vorherigen Tage verwendet. Wenn Sie eine Zielgruppenliste erstellen, nachdem die Mitgliedschaft täglich aktualisiert wurde, werden die Daten des Vortages verwendet.

Regelmäßig Umfragen für eine wiederkehrende Zielgruppenliste durchführen

Mit wiederkehrenden Zielgruppenlisten werden nur dann Zielgruppenlisten erstellt, wenn die Daten für einen zusätzlichen Tag verfügbar sind. Sie müssen nicht mehr spekulieren, wann neue Zielgruppenlisten erstellt werden sollen. Stattdessen können Sie die wiederkehrende Zielgruppenliste den ganzen Tag über kostengünstig abfragen, um festzustellen, ob zusätzliche Daten verfügbar sind.

Wiederkehrende 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 im Format properties/{propertyId}/audiences/{audienceId}. Sie können die Methode audiences.list der Google Analytics Admin API Version 1 verwenden, um diesen Wert zu erhalten. 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 den Zielgruppenexport. Nur die Daten für Dimensionen, die in diesem Feld erwähnt werden, werden in eine Zielgruppenliste aufgenommen.

Beispiel für eine Anfrage zum wiederholten Erstellen einer Zielgruppenliste:

HTTP-Request

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), der in nachfolgenden Abfragen verwendet werden kann, um die Konfigurationsmetadaten für diese wiederkehrende Zielgruppenliste abzurufen. Außerdem enthalten die Konfigurationsmetadaten Ressourcennamen für Zielgruppenlisten-Instanzen, 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 für Umfragen

Verwenden Sie die Methode recurringAudienceLists.get, um Konfigurationsmetadaten für eine bestimmte wiederkehrende Zielgruppenliste abzurufen. Die Konfigurationsmetadaten enthalten Ressourcennamen für Zielgruppenlisten-Instanzen, die für diese wiederkehrende Zielgruppenliste erstellt wurden.

Beispiel:

HTTP-Request

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 Ressourcennamen für Zielgruppenlisten-Instanzen, 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 lassen sich alle wiederkehrenden Zielgruppenlisten für eine Property abrufen.

Webhooks verwenden, um asynchrone Benachrichtigungen zu neuen Zielgruppenlisten zu erhalten

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

Um Webhook-Benachrichtigungen zu konfigurieren, geben Sie beim Erstellen einer neuen wiederkehrenden Zielgruppenliste das Feld webhookNotification an.

Weitere Informationen zur Verwendung von Webhooks in der Google Analytics Data API Version 1 finden Sie in der Dokumentation zu WebhookNotification.

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 von recurringAudienceLists.get oder recurringAudienceLists.list bereitgestellten Konfigurationsmetadaten abgerufen wird.

HTTP-Request

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
}