週期性目標對象名單

本文件說明瞭週期性目標對象名單，也就是 Google Analytics Data API v1 的進階功能 目標對象名單匯出功能簡介： 請參閱目標對象匯出基本概念指南。

週期性目標對象名單每天產生的目標對象名單，是 目標對象成員資格有所變更，確保你能使用最新資料。

一般 (非週期性) 目標對象名單是目標對像中的靜態使用者清單 系統就會在清單產生時立刻顯示

每天建立新的目標對象名單

處理某天的目標對象資料並更新資料需要花費的時間並不固定 會員。您無法確認目標對象名單資料已在 24 小時。

舉例來說，即使您每天在同一時間要求目標對象名單 目標對象名單的某些時段 與前一天相同的目標對象名單不同 包含額外的 1 天會員變更。

每天建立新的目標對象名單

目標對象名單是根據最近 1 天的事件資料建立 成員身分變更在每日會員資格前建立目標對象名單 更新時，系統會使用前兩天的資料。如果建立 每日成員資格更新後，目標對象名單就會使用以下來源的資料： 昨天。

定期輪詢週期性目標對象名單

週期性目標對象名單只會在至少一天內產生目標對象名單 資料。如此一來，您就不需要再憑空臆測， 目標對象名單。但可以負擔低廉的費用研究週期性目標對象名單 ，觀察是否還有其他資料可用。

在白天定期輪詢週期性目標對象名單

建立週期性目標對象名單

如要建立週期性目標對象名單，請呼叫 recurringAudienceLists.create敬上 方法，使用 RecurringAudienceList。 物件中一樣。以下是必要參數：

  • 已在文件中找到有效的目標對象名稱： audience敬上 欄位，格式為 properties/{propertyId}/audiences/{audienceId}。 您可以使用 audiences.list敬上 Google Analytics Admin API v1 方法來取得這個值。 Audience.name敬上 audiences.list回應中的 欄位包含目標對象名稱。
  • 有幾個有效的維度清單 dimensions敬上 ] 欄位。如需此方法支援的維度清單，請前往 目標對象匯出結構定義說明文件。 只有這個欄位提到的維度資料才會納入 目標對象名單。

以下是週期性目標對象名單建立要求的範例：

HTTP 要求

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

recurringAudienceLists.create 方法的回應會包含 name欄位中的名稱 (例如 properties/1234567/recurringAudienceLists/123)，您可以在 後續查詢來擷取設定中繼資料 將預測套用至這份週期性目標對象名單設定中繼資料也包含 目標對象名單執行個體的資源名稱 為這份週期性目標對象名單建立

HTTP 回應

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

意見調查設定中繼資料

使用 recurringAudienceLists.get敬上 擷取特定 Deployment 設定中繼資料的 週期性目標對象名單。設定中繼資料包含 目標對象名單執行個體的資源名稱 為這份週期性目標對象名單建立

範例如下：

HTTP 要求

GET https://analyticsdata.googleapis.com/v1alpha/properties/1234567/recurringAudienceLists/123

RecurringAudienceList 的執行個體 則會在回應中傳回其中包含設定中繼資料，包括 目標對象名單執行個體的資源名稱 為這份週期性目標對象名單建立

HTTP 回應

{
  "name": "properties/1234567/recurringAudienceLists/123",
  "audience": "properties/1234567/audiences/12345",
  "audienceDisplayName": "Purchasers",
  "dimensions": [
    {
      "dimensionName": "deviceId"
    }
  ],
  "activeDaysRemaining": 180,
  "audienceLists": [
    "properties/1234567/audienceLists/45678"
  ]
}

別擔心！您可以使用 recurringAudienceLists.list敬上 列出某資源的所有週期性目標對象名單。

使用 Webhook 接收新目標對象名單的非同步通知

與其定期輪詢特定工作負載的設定中繼資料 反覆建立目標對象名單 recurringAudienceLists.get敬上 方法，您就能在目標對象時以非同步方式接收 Webhook 通知 清單可供使用。

如要設定 Webhook 通知，請指定 webhookNotification敬上 ] 欄位。

遵循《Async audience lists with webhooks》指南 ，進一步瞭解如何在 Google Analytics Data API v1 中使用 Webhook。

在目標對象匯出檔案中擷取使用者

如要在目標對象匯出檔案中擷取使用者，請呼叫 audienceExports.query敬上 方法，並指定目標對象匯出名稱 擷取自 recurringAudienceLists.get。 或 recurringAudienceLists.list。

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
}