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:
- Rufen Sie die Methode
audienceExports.create
auf, um einen Zielgruppenexport zu erstellen. - 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 Formatproperties/{propertyId}/audiences/{audienceId}
. Sie können die Methodeaudiences.list
der Google Analytics Admin API Version 1 verwenden, um diesen Wert abzurufen. Das FeldAudience.name
deraudiences.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
}