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
}