Zielgruppenexport erstellen

Zielgruppen in Google Analytics können Sie Nutzer so segmentieren, wie es für Ihr Unternehmen wichtig ist. Mit Zielgruppen können Sie Nutzer Ihrer Website oder App 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 in Zielgruppenexporten angezeigt werden, finden Sie im Leitfaden zu den Erwartungen an Zielgruppenexportdaten.

Übersicht

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

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

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

Berichtseinheit auswählen

Für alle Data API-Methoden muss die Google Analytics-Property ID in einem URL-Anfragepfad im Format properties/GA_PROPERTY_ID angegeben werden. Hier ein Beispiel:

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

Der Bericht wird anhand 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 Anfrage-URL-Pfad nicht ändern. Die meisten API-Clients bieten einen property-Parameter, der einen String im Format properties/GA_PROPERTY_ID erwartet. Beispiele für die Verwendung der Clientbibliotheken finden Sie in der Kurzanleitung.

Zielgruppenexport erstellen

Rufen Sie zum Erstellen eines Zielgruppenexports die audienceExports.create Methode auf und verwenden Sie in der Anfrage das AudienceExport Objekt. 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 Zielgruppenexporte. In einem Zielgruppenexport sind nur die Daten für Dimensionen enthalten, die in diesem Feld angegeben sind.

Hier eine Beispielanfrage zum Erstellen eines Zielgruppenexports:

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. Hier ein Beispiel:

{
  "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 name können Sie die Nutzer aus dem Zielgruppenexport abfragen.

Bereitschaftsstatus des Zielgruppenexports abfragen

Nach dem Aufruf von audienceExports.create kann es einige Minuten dauern, bis der Zielgruppenexport generiert wird.

Sie können den Bereitschaftsstatus eines Zielgruppenexports mit der audienceExports.get Methode prüfen.

Geben Sie den Namen des Zielgruppenexports aus einer audienceExports.create-Antwort an, um den Zielgruppenexport in der Anfrage anzugeben.

Hier eine Beispielanfrage:

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

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

Hier ein Beispiel:

{
  "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 mit der audienceExports.list Methode abrufen.

Nutzer aus einem Zielgruppenexport abrufen

Rufen Sie nach der Generierung des Zielgruppenexports die audienceExports.query-Methode auf und geben Sie in der Anfrage den Zielgruppenexport's name an.

Hier eine Beispielanfrage:

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

Wenn der Zielgruppenexport bereit ist, gibt dieser Aufruf die Liste der Nutzer in der Zielgruppe zurück.

Hier ein Beispiel:

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