Zielgruppen in Google Analytics können Sie Nutzer so segmentieren, wie es für Ihr Unternehmen wichtig ist. Mit können Sie die Nutzer Ihrer Website oder App anhand von freigegebenen Attribute.
Sie können Ihre Zielgruppen, einschließlich einer Übersicht über die Nutzer, exportieren. Verwenden Sie dazu die Data API:
Weitere Informationen finden Sie im Hilfeartikel Erwartungen an Zielgruppenexportdaten. finden Sie wichtige Informationen zu den Daten in Zielgruppenexporten.
Übersicht
Stellen Sie die folgenden Data API-Anfragen, um einen Zielgruppenexport zu erstellen und abzufragen:
- Rufen Sie die
audienceExports.createauf. Methode zum Erstellen eines Zielgruppenexports. - Rufen Sie die
audienceExports.queryauf. wird verwendet, um die Nutzer in der Zielgruppe abzurufen.
Weitere Informationen erhalten Sie unter
audienceExports.get bis
Konfigurationsmetadaten zu einem bestimmten Zielgruppenexport abrufen und
audienceExports.list bis
alle Zielgruppenexporte für eine bestimmte Property auflisten.
Berichtseinheit auswählen
Für alle Data API-Methoden ist die Google Analytics-Property erforderlich.
ID in einem URL-Anfragepfad im Feld
Form von properties/GA_PROPERTY_ID. Beispiel:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports
Der Bericht wird auf Grundlage der Google Analytics-Ereignisdaten erstellt, die in die angegebene Google Analytics-Property aus.
Wenn Sie eine der Data API-Clientbibliotheken verwenden, müssen Sie
den Anfrage-URL-Pfad nicht ändern. Die meisten API-Clients stellen ein property bereit.
-Parameter, der einen String im Format properties/GA_PROPERTY_ID erwartet. Weitere Informationen finden Sie unter
Kurzanleitung mit Beispielen für die Verwendung des
Clientbibliotheken.
Zielgruppenexport erstellen
Wenn Sie einen Zielgruppenexport erstellen möchten, rufen Sie die Methode audienceExports.create mit der Methode
AudienceExport
Objekt in Ihrer Anfrage. Folgende Parameter sind erforderlich:
- Ein gültiger Zielgruppenname in der
audienceim Formatproperties/{propertyId}/audiences/{audienceId}. Sie können verwenden Sie dieaudiences.listder Google Analytics Admin API Version 1 verwenden, um diesen Wert zu erhalten. DieAudience.namederaudiences.list-Antwort den Namen der Zielgruppe enthält. - Eine gültige Liste von Dimensionen in
dimensionsein. Die Liste der von dieser Methode unterstützten Dimensionen finden Sie in der Dokumentation zum Schema für den Zielgruppenexport. Nur die Daten für Dimensionen, die in diesem Feld erwähnt werden, sind in einer Zielgruppe enthalten. exportieren.
Hier sehen Sie eine Beispielanfrage 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 die Werte des Zielgruppenexports
Name 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 der Erstellung des Zielgruppenexports kann es einige Minuten dauern,
audienceExports.create
aufrufen.
Sie können den Bereitschaftsstatus eines Zielgruppenexports prüfen, indem Sie die Methode
audienceExports.get-Methode.
Verwenden Sie den Namen des Zielgruppenexports aus einer audienceExports.create-Antwort für
den Zielgruppenexport in der Anfrage anzugeben.
Hier eine Beispielanfrage:
HTTP-Anfrage
GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123
Der Bereitschaftsstatus für einen Zielgruppenexport wird im Feld state zurückgegeben.
der Antwort. Sobald der Zielgruppenexport abgeschlossen ist,
ändert sich 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
.
Nutzer aus einem Zielgruppenexport abrufen
Nachdem der Zielgruppenexport generiert wurde, rufen Sie die Methode audienceExports.query auf und geben Sie die Methode
name des Zielgruppenexports in der Anfrage.
Hier eine Beispielanfrage:
HTTP-Anfrage
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query
Wenn der Zielgruppenexport bereit ist, wird bei diesem Aufruf die Liste der Nutzer im Zielgruppe.
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
}