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 Anwendung anhand gemeinsamer Attribute gruppieren.
Mit der Data API können Sie Ihre Zielgruppen, einschließlich eines Snapshots ihrer Nutzer, exportieren.
Im Leitfaden Erwartungen an Daten in Zielgruppenexporten 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:
- Rufen Sie die Methode
audienceExports.createauf, um einen Zielgruppenexport zu erstellen. - Rufen Sie die Methode
audienceExports.queryauf, 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.
Berichtseinheit auswählen
Bei allen Data API-Methoden muss die ID der Google Analytics-Property in einem URL-Anfragepfad in Form von properties/GA_PROPERTY_ID angegeben werden. Beispiel:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports
Der Bericht wird anhand der Google Analytics-Ereignisdaten generiert, die in der angegebenen Google Analytics-Property erfasst wurden.
Wenn Sie eine der Data API-Clientbibliotheken verwenden, müssen Sie den Pfad der Anfrage-URL nicht ändern. Die meisten API-Clients bieten einen property-Parameter, für den ein String in Form von properties/GA_PROPERTY_ID erwartet wird. In der Kurzanleitung finden Sie Beispiele für die Verwendung der Clientbibliotheken.
Zielgruppenexport erstellen
Wenn Sie einen Zielgruppenexport erstellen möchten, rufen Sie die Methode audienceExports.create mit dem Objekt AudienceExport in Ihrer Anfrage auf. Folgende Parameter sind erforderlich:
- Ein gültiger Zielgruppenname im Feld
audience, formatiert alsproperties/{propertyId}/audiences/{audienceId}. Sie können diesen Wert mit der Methodeaudiences.listder Google Analytics Admin API v1 abrufen. Das FeldAudience.namederaudiences.list-Antwort enthält den Namen der Zielgruppe. - Eine gültige Liste von Dimensionen im Feld
dimensions. Eine Liste der von dieser Methode unterstützten Dimensionen finden Sie in der Dokumentation zum Exportschema für Zielgruppen. In einem Zielgruppenexport sind nur die Daten für die in diesem Feld genannten Dimensionen enthalten.
Hier ist 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"
}
]
}
Die 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"
}
}
Mit der name können Sie die Nutzer aus dem Zielgruppenexport abfragen.
Bereitschaftsstatus des Zielgruppenexports abfragen
Nach dem audienceExports.create-Aufruf kann es einige Minuten dauern, bis der Zielgruppenexport 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:
HTTP-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 die Zielgruppenexporte generiert wurden, ändert sich der Status von CREATING in 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
Rufen Sie nach dem Erstellen des Zielgruppenexports die Methode audienceExports.query auf und geben Sie in der Anfrage die name des Zielgruppenexports an.
Hier ein Beispiel für eine Anfrage:
HTTP-Anfrage
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.
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
}