建立目標對象匯出作業

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

您可以使用 Data API

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

總覽

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

  1. 呼叫 audienceExports.create 方法,用於建立目標對象匯出檔案。
  2. 呼叫 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
}