Zielgruppenexport erstellen

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

Sie können Ihre Zielgruppen, einschließlich einer Momentaufnahme ihrer Nutzer, mithilfe der Data API exportieren.

Wichtige Informationen zu den Daten in Zielgruppenexporten finden Sie im Leitfaden zu Zielgruppenexporten.

Überblick

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. Mit der Methode audienceExports.query werden die Nutzer in der Zielgruppe abgerufen.

Sie können audienceExports.get aufrufen, um Konfigurationsmetadaten für einen 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 4-Property-ID in einem URL-Anfragepfad in Form von properties/GA4_PROPERTY_ID angegeben werden. Beispiel:

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

Der Bericht wird auf Grundlage der Google Analytics-Ereignisdaten erstellt, die in der angegebenen Google Analytics 4-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 in Form von properties/GA4_PROPERTY_ID erwartet. In der Kurzanleitung finden Sie Beispiele zur Verwendung der Clientbibliotheken.

Zielgruppenexport erstellen

Wenn Sie einen Zielgruppenexport erstellen möchten, rufen Sie die Methode audienceExports.create mit dem Objekt AudienceExport in der 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 abzurufen. Das Feld Audience.name der audiences.list-Antwort enthält den Namen der Zielgruppe.
• Eine gültige Liste von Dimensionen im Feld dimensions. Die Liste der von dieser Methode unterstützten Dimensionen finden Sie in der Dokumentation zum Schema für den Zielgruppenexport. In einem Zielgruppenexport werden nur die Daten der in diesem Feld genannten Dimensionen berücksichtigt.

Hier sehen Sie eine Beispielanfrage zum Erstellen eines Zielgruppenexports:

HTTP-Request

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

Sie können die name verwenden, um die Nutzer aus dem Zielgruppenexport abzufragen.

Bereitschaftsstatus des Zielgruppenexports abfragen

Nach dem audienceExports.create-Aufruf kann das Generieren des Zielgruppenexports einige Minuten dauern.

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 eine Beispielanfrage:

HTTP-Request

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 abgeschlossen ist, ändert sich sein Status von CREATING zu 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

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

Hier eine Beispielanfrage:

HTTP-Request

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

Wenn der Zielgruppenexport bereit ist, wird durch diesen 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
}