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 App anhand gemeinsamer Attribute gruppieren.

Sie können Ihre Zielgruppen, einschließlich einer Momentaufnahme der Nutzer, über die Data API exportieren.

Im Leitfaden Erwartungen an Daten für Zielgruppenexporte finden Sie wichtige Informationen zu den Daten, die in Zielgruppenexporten angezeigt werden.

Ü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

Für alle Data API-Methoden muss die Google Analytics-Property-ID in einem URL-Anforderungspfad 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 werden.

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 Methode audienceExports.create mit dem Objekt AudienceExport in Ihrer Anfrage auf. Folgende Parameter sind erforderlich:

• Ein gültiger Zielgruppenname im Feld audience im Format properties/{propertyId}/audiences/{audienceId}. Sie können diesen Wert mit der Methode audiences.list der Google Analytics Admin API v1 abrufen. Das Feld Audience.name der audiences.list-Antwort enthält den Zielgruppennamen.
• 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 die in diesem Feld genannten Dimensionen werden in einen Zielgruppenexport aufgenommen.

Hier ist 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. Sie sehen 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

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

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

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:

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 der Zielgruppenexport generiert wurde, ändert sich sein Status von CREATING in ACTIVE.

Sie sehen 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 abrufen, indem Sie die Methode audienceExports.list aufrufen.

Nutzer aus einem Zielgruppenexport abrufen

Rufen Sie nach dem Generieren des Zielgruppenexports die Methode audienceExports.query auf und geben Sie die name des Zielgruppenexports in der Anfrage an.

Hier ein Beispiel für eine 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:

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