此页面由 Cloud Translation API 翻译。

创建受众群体导出

Google Analytics 中的受众群体您可以根据自身业务需求对用户进行细分。包含您可以根据共享、属性。

您可以使用 Data API。

请参阅受众群体导出数据预期有关您在受众群体导出功能中看到的数据的重要信息指南。

概览

发出以下 Data API 请求以创建和查询受众群体导出内容：

调用 audienceExports.create 方法来创建受众群体导出。
调用 audienceExports.query 方法用于检索受众群体中的用户。

如需了解更多信息，您可以致电 audienceExports.get至检索有关导出的特定受众群体的配置元数据，以及 audienceExports.list至列出针对特定媒体资源导出的所有受众群体。

选择举报实体

所有 Data API 方法都需要 Google Analytics 媒体资源 identifier，在网址请求路径内指定，即在 properties/GA_PROPERTY_ID 格式。示例如下：

  POST  https://analyticsdata.googleapis.com/v1beta/properties/GA_PROPERTY_ID/audienceExports

报告是根据在 Google Analytics 中收集的 Google Analytics 事件数据生成的，指定 Google Analytics 媒体资源。

如果您使用的是某个 Data API 客户端库，请执行以下操作：因此无需更改请求网址路径。大多数 API 客户端都提供 property 参数，需要 properties/GA_PROPERTY_ID 形式的字符串。请参阅快速入门指南，提供了有关如何使用客户端库。

创建受众群体导出

如需创建受众群体导出，请使用 audienceExports.create 方法调用 AudienceExport 对象。以下是必填参数：

audience 中的有效受众群体名称字段，格式为 properties/{propertyId}/audiences/{audienceId}。您可以使用 audiences.list 方法获取此值。通过 Audience.name audiences.list响应的字段包含受众群体名称。
dimensions 中的有效维度列表字段。此方法支持的维度列表可在受众群体导出架构文档。只有某个受众群体中包含此字段中提及的维度对应的数据导出。

以下是创建受众群体导出的示例请求：

HTTP 请求

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

audienceExports.create 方法的响应包含受众群体导出 name 字段中的名称，例如 properties/1234567/audienceExports/123。以下是示例响应：

HTTP 响应

{
  "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"
  }
}

您可以使用 name 从受众群体导出内容中查询用户。

查询受众群体导出功能的就绪状态

待导出完毕后，系统可能需要几分钟时间才能生成受众群体导出内容。 audienceExports.create 调用。

您可以调用 audienceExports.get 方法。

使用 audienceExports.create 响应中的受众群体导出名称，请在请求中指定受众群体导出功能

下面是一个示例请求：

HTTP 请求

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

受众群体导出的就绪状态会在 state 字段中返回。受众群体导出生成完成后，其状态从 CREATING 更改为 ACTIVE。

以下是示例响应：

HTTP 响应

{
  "name": "properties/1234567/audienceExports/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "state": "CREATING",
  "beginCreatingTime": "2023-06-22T23:35:28.787910949Z"
}

要获取所有受众群体导出的状态，可以调用 audienceExports.list 方法。

从受众群体导出文件中检索用户

生成受众群体导出文件后，请调用 audienceExports.query 方法，并指定受众群体导出的 name。

下面是一个示例请求：

HTTP 请求

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

如果受众群体导出已准备就绪，此调用会返回受众群体。

以下是示例响应：

HTTP 响应

{
  "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
}