Diese Seite wurde von der Cloud Translation API übersetzt.

Zielgruppenexport – Grundlagen

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 Format properties/{propertyId}/audiences/{audienceId}. Sie können die Methode audiences.list der Google Analytics Admin API Version 1 verwenden, um diesen Wert zu erhalten. Das Feld Audience.name der audiences.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.