Zielgruppenexport erstellen

Mit Zielgruppen in Google Analytics können Sie Ihre Nutzer so segmentieren, wie es für Ihr Unternehmen wichtig ist. Mit Zielgruppen können Sie Nutzer Ihrer Website oder Anwendung anhand gemeinsamer Attribute gruppieren.

Sie können Ihre Zielgruppen, einschließlich eines Snapshots ihrer Nutzer, mit der Data API exportieren.

Wichtige Informationen zu den Daten, die Sie in Zielgruppenexporten sehen, finden Sie im Leitfaden Erwartungen an Zielgruppenexportdaten.

Übersicht

Stellen Sie die folgenden Data API-Anfragen, um einen Zielgruppenexport zu erstellen und abzufragen:

  1. Rufen Sie die Methode audienceExports.create auf, um einen Zielgruppenexport zu erstellen.
  2. Rufen Sie die Methode audienceExports.query auf, um die Nutzer in der Zielgruppe abzurufen.

Weitere Informationen finden Sie unter audienceExports.get, um Konfigurationsmetadaten zu einem bestimmten Zielgruppenexport abzurufen, und unter audienceExports.list, um alle Zielgruppenexporte für eine bestimmte Property aufzulisten.

Berichtsentität auswählen

Bei allen Data API-Methoden muss die Google Analytics-Property-ID in einem URL-Anfragepfad im Format properties/GA_PROPERTY_ID angegeben werden. Beispiel:

  POST  https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports

Der Bericht wird auf Grundlage der Google Analytics-Ereignisdaten erstellt, die in der angegebenen Google Analytics-Property erfasst wurden.

Wenn Sie eine der Data API-Clientbibliotheken verwenden, müssen Sie den URL-Pfad der Anfrage nicht ändern. Die meisten API-Clients stellen einen property-Parameter bereit, der einen String im Format properties/GA_PROPERTY_ID erwartet. Beispiele für die Verwendung der Clientbibliotheken finden Sie in der Kurzanleitung.

Zielgruppenexport erstellen

Wenn Sie einen Zielgruppenexport erstellen möchten, rufen Sie die Methode audienceExports.create mit dem Objekt AudienceExport in Ihrer Anfrage auf. Folgende Parameter sind erforderlich:

  • Einen gültigen Zielgruppennamen 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 den Zielgruppenexport. In einen Zielgruppenexport werden nur die Daten für die in diesem Feld genannten Dimensionen aufgenommen.

Hier ein Beispiel für eine Anfrage zum Erstellen eines Zielgruppenexports:

HTTP-Anfrage

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

Eine Antwort der Methode audienceExports.create enthält den Namen des Zielgruppenexports im Feld name, z. B. properties/1234567/audienceExports/123. Sie sehen hier ein Beispiel:

HTTP-Antwort

{
  "response": {
    "@type": "type.googleapis.com/google.analytics.data.v1alpha.AudienceExport",
    "name": "properties/1234567/audienceExports/123",
    "audience": "properties/1234567/audiences/12345",
    "audienceDisplayName": "Purchasers",
    "dimensions": [
      {
        "dimensionName": "deviceId"
      }
    ],
    "state": "CREATING",
    "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
  }
}

Mit der name können Sie die Nutzer aus dem Zielgruppenexport abfragen.

Bereitschaftsstatus des Zielgruppenexports abfragen

Es kann einige Minuten dauern, bis der Zielgruppenexport nach dem audienceExports.create-Aufruf generiert wird.

Sie können den Bereitschaftsstatus eines Zielgruppenexports prüfen, indem Sie die Methode audienceExports.get aufrufen.

Verwenden Sie den Namen des Zielgruppenexports aus einer audienceExports.create-Antwort, um den Zielgruppenexport in Ihrer Anfrage anzugeben.

Hier ein Beispiel für eine Anfrage:

HTTP-Anfrage

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

Der Bereitschaftsstatus für einen Zielgruppenexport wird im Feld state der Antwort zurückgegeben. Sobald die Generierung des Zielgruppenexports abgeschlossen ist, ändert sich der Status von CREATING in ACTIVE.

Sie sehen hier ein Beispiel:

HTTP-Antwort

{
  "name": "properties/1234567/audienceExports/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "state": "CREATING",
  "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}

Sie können den Status aller Zielgruppenexporte abrufen, indem Sie die Methode audienceExports.list aufrufen.

Nutzer aus einem Zielgruppenexport abrufen

Sobald der Zielgruppenexport generiert wurde, rufen Sie die Methode audienceExports.query auf und geben Sie in der Anfrage den name des Zielgruppenexports an.

Hier ein Beispiel für eine Anfrage:

HTTP-Anfrage

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

Wenn der Zielgruppenexport bereit ist, wird mit diesem Aufruf die Liste der Nutzer in der Zielgruppe zurückgegeben.

Sie sehen hier ein Beispiel:

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
}