Wiederkehrende Zielgruppenlisten

In diesem Dokument werden wiederkehrende Zielgruppenlisten beschrieben, die eine der Google Analytics Data API Version 1 verwenden. Eine Einführung in die Funktion zum Exportieren von Zielgruppenlisten Weitere Informationen finden Sie im Grundlagenleitfaden zum Zielgruppenexport.

Wiederkehrende Zielgruppenlisten werden täglich ändern sich die Zielgruppenzugehörigkeit, damit Sie mit den neuesten Daten arbeiten.

Normale (einmalige) Zielgruppenlisten sind statische Listen von Nutzern in der Zielgruppe zu dem Zeitpunkt, zu dem die Liste generiert wird.

Täglich eine neue Zielgruppenliste erstellen

Die Verarbeitung und Aktualisierung der Zielgruppendaten eines Tages ist unterschiedlich lang. Mitgliedschaft. Es kann nicht sichergestellt werden, dass die Daten der Zielgruppenliste 24 Stunden.

Auch wenn Sie eine Zielgruppenliste beispielsweise jeden Tag zur selben Zeit anfordern, An manchen Tagen ist die Zielgruppenliste wie vom Vortag. An anderen Tagen sieht die Zielgruppenliste anders aus und einen zusätzlichen Tag für Mitgliedschaftsänderungen enthalten.

Zielgruppenlisten basieren auf Ereignisdaten des letzten Tages vor dem Mitgliedschaftsänderungen. Wenn Sie vor der täglichen Mitgliedschaft eine Zielgruppenliste erstellen werden Daten der zwei Tage davor verwendet. Wenn Sie eine nach täglichen Aktualisierungen der Mitgliedschaft verwendet, werden Daten aus folgenden Zeiträumen verwendet: gestern.

Regelmäßig eine Umfrage in einer wiederkehrenden Zielgruppenliste durchführen

Wiederkehrende Zielgruppenlisten generieren nur dann Zielgruppenlisten, wenn für einen weiteren Tag Daten verfügbar sind. So müssen Sie nicht mehr raten, wann Sie Zielgruppenlisten. Stattdessen können Sie in der Liste mit wiederkehrenden Zielgruppen kostengünstig eine Umfrage durchführen. über den Tag verteilt, um zu sehen, ob zusätzliche Daten verfügbar sind.

Wiederkehrende Zielgruppenliste erstellen

Rufen Sie zum Erstellen einer wiederkehrenden Zielgruppenliste die Methode recurringAudienceLists.create mit der Methode RecurringAudienceList -Objekt in einer Anfrage. Folgende Parameter sind erforderlich:

• Ein gültiger Zielgruppenname in der audience im Format properties/{propertyId}/audiences/{audienceId}. Sie können die audiences.list der Google Analytics Admin API Version 1 verwenden, um diesen Wert zu erhalten. Die Audience.name der audiences.list-Antwort den Namen der Zielgruppe enthält.
• Eine gültige Liste von Dimensionen im dimensions ein. Die Liste der von dieser Methode unterstützten Dimensionen finden Sie in der Dokumentation zum Schema für Zielgruppenexport. Nur die Daten für Dimensionen, die in diesem Feld erwähnt werden, werden in eine Zielgruppenliste.

Hier sehen Sie ein Beispiel für eine wiederkehrende Anfrage zum Erstellen einer Zielgruppenliste:

HTTP-Anfrage

POST https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists
{
  "audience": "properties/1234567/audiences/12345",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ]
}

Eine Antwort der Methode recurringAudienceLists.create enthält den in das Feld name ein, z. B. properties/1234567/recurringAudienceLists/123), die in nachfolgende Abfragen, um die Konfigurationsmetadaten abzurufen für diese wiederkehrende Zielgruppenliste. Außerdem enthalten die Konfigurationsmetadaten Ressourcennamen für Zielgruppenlisteninstanzen die für diese wiederkehrende Zielgruppenliste erstellt wurde.

HTTP-Antwort

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

Metadaten der Umfragekonfiguration

Verwenden Sie die Methode recurringAudienceLists.get können Sie Konfigurationsmetadaten zu einer bestimmten wiederkehrende Zielgruppenliste. Die Konfigurationsmetadaten enthalten Ressourcennamen für Zielgruppenlisteninstanzen die für diese wiederkehrende Zielgruppenliste erstellt wurde.

Beispiel:

HTTP-Anfrage

GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists/123

Eine Instanz von RecurringAudienceList wird als Antwort zurückgegeben. Es enthält die Konfigurationsmetadaten, darunter: Ressourcennamen für Zielgruppenlisteninstanzen die für diese wiederkehrende Zielgruppenliste erstellt wurde.

HTTP-Antwort

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

Sie können recurringAudienceLists.list , um alle wiederkehrenden Zielgruppenlisten für eine Property aufzulisten.

Mit Webhooks asynchrone Benachrichtigungen zu neuen Zielgruppenlisten erhalten

Anstatt die Konfigurationsmetadaten zu einem bestimmten wiederkehrende Zielgruppenliste mithilfe des recurringAudienceLists.get können Sie asynchron Webhook-Benachrichtigungen erhalten, wenn eine Zielgruppe verfügbar ist.

Geben Sie zum Konfigurieren von Webhook-Benachrichtigungen die webhookNotification wenn Sie eine neue wiederkehrende Zielgruppenliste erstellen.

Folgen Sie der Anleitung zu Async audience lists with webhooks finden Sie weitere Informationen zur Verwendung von Webhooks in der Google Analytics Data API Version 1.

Nutzer in einem Zielgruppenexport abrufen

Um Nutzer in einem Zielgruppenexport abzurufen, rufen Sie die Methode audienceExports.query und geben Sie den Namen des Zielgruppenexports an, aus den Konfigurationsmetadaten abgerufen, recurringAudienceLists.get oder recurringAudienceLists.list.

HTTP-Anfrage

POST https://analyticsdata.googleapis.com/v1beta/properties/1234567/audienceExports/123:query

Ist der Zielgruppenexport fertig, wird eine Antwort mit der Liste für Nutzer in einer Zielgruppe:

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
}