查詢 Amazon Pinpoint 分析資料 - Amazon Pinpoint
查詢 Amazon Pinpoint 中的指標

支援結束通知：2026 年 10 月 30 日， AWS 將結束對 Amazon Pinpoint 的支援。2026 年 10 月 30 日之後，您將無法再存取 Amazon Pinpoint 主控台或 Amazon Pinpoint 資源 （端點、客群、行銷活動、旅程和分析）。如需詳細資訊，請參閱 Amazon Pinpoint 終止支援。注意：與 SMS、語音、行動推播、OTP 和電話號碼驗證相關的 APIs 不受此變更影響，並受 AWS 最終使用者傳訊支援。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

查詢 Amazon Pinpoint 分析資料

除了使用 Amazon Pinpoint 主控台的分析頁面，也可以使用 Amazon Pinpoint Analytics API 查詢標準指標子集的分析資料，深入了解與使用者互動、行銷活動推廣等相關的趨勢。這些指標也稱為「關鍵績效指標 (KPI)」，是可測量的值，可協助您監控與評估專案、行銷活動和行程的績效。

若使用 API 查詢分析資料，可以使用自選的報告工具分析資料，不須登入 Amazon Pinpoint 主控台或分析 Amazon Kinesis 串流等來源的原始事件資料。例如，您可以建置自訂儀表板，顯示每週的行銷活動結果，或是提供您行銷活動交付率的深入分析。

您可以使用 Amazon Pinpoint REST API、 AWS Command Line Interface (AWS CLI) 或 SDK 來 AWS 查詢資料。若要查詢資料，可以將請求傳送到 Amazon Pinpoint API，並使用支援的參數，指定所需的資料，以及任何您要套用的篩選條件。您提交查詢後，Amazon Pinpoint 會以 JSON 回應傳回查詢結果。然後，您可以將結果傳送到另一個服務或應用程式進行更深入的分析、儲存或報告。

Amazon Pinpoint 會針對您所有專案、行銷活動和旅程的所有支援指標，自動收集並彙整相關資料。此外，此資料會持續更新，產生上限約兩個小時的資料延遲時間範圍。但請注意，某些指標可能會有額外的資料延遲。這是因為某些指標的資料是以我們從收件者電子郵件提供者收到的資訊為基礎。有些提供者會立即傳送這些資訊給我們，有些提供者的傳送次數則較不頻繁。

Amazon Pinpoint 會存放資料 90 天。若要存放資料超過 90 天或即時存取原始分析資料，您可以設定 Amazon Pinpoint 專案，將事件資料串流至 Amazon Kinesis Data Streams 或 Amazon Data Firehose。如需設定事件串流的相關資訊，請參閱使用 Amazon Pinpoint 透過 Kinesis 和 Firehose 串流應用程式事件資料。

查詢 Amazon Pinpoint 中指標的元件和參數

若要查詢指標的資料，請將 get 請求傳送至適當的 Amazon Pinpoint API 指標資源。在您的請求中，您可以針對下列查詢元件，使用支援的參數來定義您的查詢：

  • 專案 – 提供專案 ID 當作 application-id 參數值來指定專案。此參數是所有指標的必要參數。

  • 行銷活動 – 提供行銷活動 ID 當作 campaign-id 參數值來指定行銷活動。只有行銷活動指標才需要此參數。

  • 旅程 – 提供旅程 ID 當作 journey-id 參數值來指定旅程。僅行程參與和執行指標以及行程活動執行指標需要此參數。

  • 旅程活動 – 提供旅程活動 ID 當作 journey-activity-id 參數值，藉此指定旅程活動。僅行程活動執行指標需要此參數。

  • 日期範圍 – (選用) 若要依日期範圍篩選資料，請使用支援的開始和結束時間參數，提供日期範圍的第一個和最後一個日期和時間。這些值應依延伸的 ISO 8601 格式顯示，並使用國際標準時間 (UTC)，例如 2019 年 7 月 19 日 8:00 PM UTC 即以 2019-07-19T20:00:00Z 顯示。

    日期範圍包含在內，且必須不超過 31 個日曆日。此外，第一個日期和時間必須小於從當天起算 90 天。若沒有指定日期範圍，Amazon Pinpoint 會傳回前 31 個日曆天的資料。除行程執行指標和行程活動執行指標外，所有指標都支援日期範圍參數。

  • 指標 – 提供指標名稱當作 kpi-name 參數值可指定指標。此值會說明相關聯的指標，並由兩個以上的術語組成；這些術語都是由小寫的英數字元組成，並以連字號分隔。範例包括 email-open-rate 和 successful-delivery-rate。除行程執行指標和行程活動執行指標外，所有指標都需要此參數。如需支援指標的完整清單及要針對每個項目使用的 kpi-name 值，請參閱專案、行銷活動和旅程的標準指標。

您傳送查詢後，Amazon Pinpoint 會以 JSON 回應傳回查詢結果。在回應中，結果的結構會因您查詢的指標而不同。

有些指標只提供一個值，例如行銷活動已交付的訊息數。其他指標提供多個值，而且通常會依相關欄位將這些值分組，例如每個行銷活動執行時交付的訊息數 (依行銷活動分組)。若指標提供並分組多個值，則 JSON 回應即會包含一個欄位，指出分組資料所用的欄位。若要進一步了解查詢結果的結構，請參閱 使用 JSON 查詢結果。