資源:RecurringAudienceList
週期性目標對象名單每天都會產生新的目標對象名單。目標對象名單在建立名單時即屬於目標對像中的使用者。定期建立目標對象名單可確保目標對象名單採用的是每天可用的最新資料。
JSON 表示法 |
---|
{ "name": string, "audience": string, "audienceDisplayName": string, "dimensions": [ { object ( |
欄位 | |
---|---|
name |
僅供輸出。ID。在建立期間指派的週期性目標對象名單資源名稱。此資源名稱可識別這個 格式: |
audience |
必要欄位。目標對象資源名稱。這個名稱可用來識別列出的目標對象,且可在 Analytics 資料與Admin API 格式: |
audienceDisplayName |
僅供輸出。此目標對象的描述性顯示名稱。例如「購買者」。 |
dimensions[] |
必要欄位。要求的維度在目標對象名單回應中顯示。 |
audienceLists[] |
僅供輸出。為這份週期性目標對象名單建立目標對象名單執行個體的目標對象名單資源名稱。系統會每天建立一份目標對象名單,該名單也會列在這裡。 這份名單會優先顯示最新建立的目標對象名單。 |
activeDaysRemaining |
選用設定。週期性目標對象匯出作業將產生目標對象名單例項的剩餘天數。這個計數器每天會減少一個,如果達到零,系統就不會建立新的目標對象名單。 Analytics 360 資源的週期性目標對象名單要求,預設為 180 天,最長可達 365 天。標準 Analytics 資源的要求預設為 14 天,最長可達 30 天。 建立時允許的最小值為 1。系統會將超過相應上限的要求強制轉為上限。 |
webhookNotification |
選用設定。設定 Webhook 通知,從 Google Analytics Data API 傳送至 Webhook 伺服器。但不一定要使用 Webhook。如果沒有,您必須輪詢這個 API,才能判斷週期性目標對象名單何時建立新的目標對象名單。Webhook 允許傳送通知到您的伺服器,就不必進行輪詢 每次週期性目標對象名單建立目標對象名單時,系統都會傳送 2 個 POST 要求。這種情況會每天進行一次,直到週期性目標對象名單的有效天數達到 0 天為止。系統會傳送第一個要求,顯示新建立的目標對象名單處於「建立中」狀態。目標對象名單建立完成後 (處於「有效」或「失敗」狀態),第二個要求就會傳送。 |
方法 |
|
---|---|
|
建立週期性目標對象名單。 |
|
取得特定週期性目標對象名單的設定中繼資料。 |
|
列出特定資源的所有週期性目標對象名單。 |