Mit Zielgruppen in Google Analytics 4 können Sie Ihre Nutzer so segmentieren, wie es für Sie sinnvoll ist. Mit Zielgruppen können Sie Nutzer Ihrer Website oder App anhand von gemeinsamen Attributen gruppieren.
Mit der Google Analytics Data API Version 1 können Sie Zielgruppenexporte generieren, die eine Übersicht der Nutzer in der Zielgruppe enthalten.
Zielgruppenexport erstellen
Die Google Analytics Data API Version 1 verwendet einen asynchronen Ansatz zum Erstellen von Zielgruppenexporten. Zuerst ist eine Anfrage an die Methode audienceExports.create
erforderlich, um einen Zielgruppenexport der Nutzer zu erstellen. Anschließend werden mit der Methode audienceExports.query
die Nutzer in der Zielgruppe abgerufen.
Darüber hinaus können Sie mit audienceExports.get
Konfigurationsmetadaten zu einem bestimmten Zielgruppenexport abrufen und mit audienceExports.list
alle Zielgruppenexporte für eine Property auflisten.
Meldeentität auswählen
Bei allen Methoden der Data API Version 1 muss die Google Analytics 4-Property-ID in einem URL-Anfragepfad im Format properties/GA4_PROPERTY_ID
angegeben werden. Beispiel:
POST https://analyticsdata.googleapis.com/v1beta/properties/GA4_PROPERTY_ID/audienceExports
Der Bericht wird anhand 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 manuell bearbeiten.
Die meisten API-Clients bieten einen property
-Parameter, der einen String in Form von properties/GA4_PROPERTY_ID
erwartet.
Beispiele zur Verwendung der Clientbibliotheken finden Sie in der Kurzanleitung.
Erstellen eines Zielgruppenexports beantragen
Wenn Sie einen Zielgruppenexport erstellen möchten, rufen Sie die Methode audienceExports.create
mit dem Objekt AudienceExport
in einer 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 zu erhalten. Das FeldAudience.name
deraudiences.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 Schema für den Zielgruppenexport. Nur die Daten für Dimensionen, die in diesem Feld erwähnt werden, werden in einen Zielgruppenexport aufgenommen.
Beispiel für eine Anfrage 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
), der in nachfolgenden Abfragen verwendet werden kann, um die Nutzer aus dem Zielgruppenexport abzurufen.
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"
}
}
Bereitschaftsstatus des Zielgruppenexports abfragen
Nach dem Aufruf von audienceExports.create
kann es einige Minuten dauern, bis der Zielgruppenexport generiert wird. Sie können den Bereitschaftsstatus für einen Zielgruppenexport abrufen, indem Sie die Methode audienceExports.get
aufrufen.
Verwenden Sie den Namen des Zielgruppenexports (z. B. properties/1234567/audienceExports/123
), den Sie aus einer audienceExports.create
-Antwort erhalten haben, um den Zielgruppenexport anzugeben.
Beispiel:
HTTP-Request
GET https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123
Der Bereitschaftsstatus für einen Zielgruppenexport wird im Feld state
einer Antwort zurückgegeben. Sobald der Zielgruppenexport abgeschlossen ist, ändert sich der Status von CREATING
in ACTIVE
.
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 mit einem Zielgruppenexport abrufen
Nachdem der mit der Methode audienceExports.create
erstellte Zielgruppenexport generiert wurde, rufen Sie die Methode audienceExports.query
auf und geben Sie den Namen des Zielgruppenexports an (z. B. properties/1234567/audienceExports/123
).
HTTP-Request
POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query
Wenn der Zielgruppenexport bereit ist, wird eine Antwort mit der Liste der Nutzer in einer Zielgruppe zurückgegeben:
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
}
Erwartungen an Zielgruppenexportdaten
Im folgenden Abschnitt werden die Daten für Nutzermitgliedschaften in Zielgruppenexporten festgelegt.
Datenaktualität
Die Aktualität der Zielgruppenexportdaten gibt an, wie lange es in Google Analytics dauert, um Ereignisse zu erfassen, Ereignisse zu verarbeiten und dann die Nutzerzugehörigkeit in Zielgruppen zu aktualisieren. Wenn der gesamte Vorgang 24 Stunden dauert, beträgt die Aktualität der Zielgruppenexportdaten 24 Stunden. Weitere Informationen finden Sie unter Datenaktualität.
Wenn ein Nutzer beispielsweise seinen ersten Kauf abschließt und dann 7 Stunden später einen Zielgruppenexport für die Zielgruppe „Käufer“ erstellt, ist der Nutzer höchstwahrscheinlich noch nicht im Zielgruppenexport „Käufer“ enthalten. In 14 bis 38 Stunden nach dem ersten Kauf ist der Nutzer wahrscheinlich in den neuen Zielgruppenexporten enthalten.
Zielgruppenexporte sind Momentaufnahmen
Zielgruppenexporte sind Listen von Nutzern in einer Zielgruppe, die jeweils auf einen Blick erfasst werden. Für das Google Ads-Remarketing werden Nutzer in Zielgruppen von Google Analytics automatisch und kontinuierlich nach Google Ads exportiert. Bei Zielgruppenexporten, die mit Version 1 der Data API erstellt wurden, müssen Sie einen neuen Zielgruppenexport erstellen, um die neuesten Nutzer in dieser Zielgruppe zu sehen.
Zielgruppenexporte werden basierend auf den neuesten verfügbaren Nutzermitgliedschaften erstellt. Zielgruppenexporte können jedoch eine Datenaktualität von beispielsweise 20 Stunden haben. Das bedeutet, dass der Zielgruppenexport auf allen Ereignissen der letzten 20 Stunden basiert.
Die neuesten Mitgliedschaftsdaten werden einmal täglich aktualisiert, in der Regel tagsüber in der Zeitzone der Property. Das bedeutet, dass bei einem Zielgruppenexport für dieselbe Zielgruppe um 9:00 Uhr und um 11:00 Uhr wahrscheinlich dieselben Daten zurückgegeben werden. Ein Zielgruppenexport um etwa 15:00 Uhr kann sich jedoch unterscheiden, wenn die Daten eines weiteren Tages einbezogen werden.
Ende der Zielgruppenexporte
Zielgruppenexporte laufen nach 72 Stunden ab. Täglich können neue Nutzende eine Zielgruppe betreten und wieder verlassen. Wenn Sie die aktuelle Nutzerübersicht abrufen möchten, müssen Sie für jeden Tag neue Zielgruppenexporte erstellen.
Nutzerlimits für den Zielgruppenexport
Wenn die Größe einer Zielgruppe oder Property ein Nutzerlimit überschreitet, werden mit Zielgruppenexporten repräsentative Stichproben der Zielgruppe zurückgegeben. Diese Limits hängen vom Property-Typ ab (Standard- oder 360-Property) und werden für jeden Zielgruppenexport einzeln erzwungen. Zurückkehrte Nutzer sind Nutzer in der angeforderten Zielgruppe. Als Nutzer gelten Nutzer, die Mitglied der Zielgruppe sein können oder nicht.
Art des Limits | Limits für Standard-Properties | Limits für Analytics 360-Properties |
---|---|---|
Maximale Anzahl zurückgegebener Nutzer | 2 Millionen | 200 Millionen |
Max. berücksichtigte Nutzer | 10 Millionen | 1 Milliarde |
Konsistenz der Identität für die Berichterstellung
Mit der Identität für die Berichterstellung wird festgelegt, wie Nutzer in Berichten dedupliziert werden. Zielgruppenexporte ändern sich NICHT aufgrund der Einstellung für die Identität für die Berichterstellung. Bei Zielgruppenexporten werden Nutzer immer anhand der User-ID und dann anhand der Geräte-ID identifiziert.
Das bedeutet, dass Berichte zu einer Zielgruppe mehr Nutzer enthalten können, als der Zielgruppenexport zurückgibt. Wenn die Identität für die Berichterstellung beispielsweise „Gerätebasiert“ ist und Nutzer-ID erfasst wird, werden in Berichten keine Nutzer anhand der User-ID dedupliziert. Bei Zielgruppenexporten werden hingegen Nutzer auf Grundlage der User-ID dedupliziert.
Backfill-Konsistenz
Wenn Sie eine Zielgruppe in Google Analytics erstellen und Google Ads-Remarketing aktivieren, wird in Google Analytics ein Backfill mit kürzlich hinzugefügten Mitgliedern für diese Zielgruppe durchgeführt. Google Analytics-Berichte und Zielgruppenexporte enthalten jedoch KEINE Zielgruppenmitgliedschaften, die auf einem Backfill beruhen. Ein Nutzer muss ein Ereignis protokollieren, nachdem die Zielgruppe erstellt wurde, damit der Nutzer in Berichten und Zielgruppenexporten angezeigt wird.
Wenn ein Nutzer beispielsweise am 20. Juni ein Kaufereignis protokolliert und Sie am 21. Juni die Zielgruppe „Käufer“ erstellen, müssen Sie wahrscheinlich bis zum 22. Juni warten, bis dieser Nutzer möglicherweise in neuen Zielgruppenexporten angezeigt wird. Er wird jedoch nur dann im Zielgruppenexport berücksichtigt, wenn er am 21. Juni ein Ereignis protokolliert hat.