本頁面由 Cloud Translation API 翻譯而成。

建立目標對象匯出作業

Google Analytics 目標對象可讓你根據自家業務的需求區隔使用者取代為您可以運用「目標對象」功能，根據共用的屬性。

您可以使用 Data API：

請參閱「目標對象匯出資料預期」一文本指南，瞭解有關目標對象匯出功能資料的重要資訊。

總覽

提出下列 Data API 要求，以建立及查詢目標對象匯出作業：

呼叫 audienceExports.create 方法，用於建立目標對象匯出檔案。
呼叫 audienceExports.query 方法擷取目標對像中的使用者。

如需詳情，請撥打 audienceExports.get 到擷取特定目標對象匯出作業的設定中繼資料 audienceExports.list 變更為列出特定資源的所有目標對象匯出作業

選取報表實體

所有 Data API 方法都需要 Google Analytics 資源識別碼並指定在網址要求路徑內， properties/GA_PROPERTY_ID 形式。範例如下：

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

系統會根據在以下位置收集到的 Google Analytics 事件資料產生報表：指定的 Google Analytics 資源

如果您使用其中一個 Data API 用戶端程式庫，無需變更要求網址路徑大部分的 API 用戶端都提供 property 參數，其格式為 properties/GA_PROPERTY_ID。詳情請見快速入門指南中的範例用戶端程式庫

建立目標對象匯出作業

如要建立目標對象匯出功能，請使用以下指令呼叫 audienceExports.create 方法： AudienceExport。物件中一樣。以下是必要參數：

「audience」中的有效目標對象名稱欄位，格式為 properties/{propertyId}/audiences/{audienceId}。你可以請使用 audiences.list敬上 Google Analytics Admin API v1 方法來取得這個值。 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
}