支援終止通知：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)」，其可協助您監控與評估交易訊息的績效。例如您可以使用指標了解自己傳送了多少交易電子郵件或 SMS 訊息，或者有多少訊息已交付給收件人。Amazon Pinpoint 會針對您為專案傳送的所有交易電子郵件和 SMS 訊息，自動收集並彙總相關資料。資料可存放 90 天。
若使用 Amazon Pinpoint Analytics API 查詢資料，可以選擇定義查詢範圍、資料、群組和篩選條件的各種選項。您可以使用參數來執行此作業；這些參數會指定您希望查詢的專案和指標，以及任何您希望套用的日期類型篩選條件。
本主題會提供範例，說明如何選擇這些選項以及查詢專案的交易訊息資料。
先決條件
在您查詢交易訊息的分析資料前，收集以下可用於定義查詢的資訊，將會對您有所幫助：
-
專案 ID – 傳送訊息的專案的唯一識別符。在 Amazon Pinpoint API 中，此值存放在
application-id屬性內。在 Amazon Pinpoint 主控台上，此值是所有專案頁面上的專案 ID。 -
日期範圍 – (選用) 查詢資料日期範圍的第一個和最後一個日期和時間。日期範圍包含在內，且必須不超過 31 個日曆日。此外，也必須從當天起算少於 90 天。若沒有指定日期範圍，Amazon Pinpoint 會自動查詢前 31 個日曆天的資料。
-
指標 – 要查詢的指標名稱，明確地說就是指標的
kpi-name值。如需支援指標的完整清單及每個指標的kpi-name值，請參閱 專案、行銷活動和旅程的標準指標。
這也有助於您判斷是否要根據相關欄位對資料進行分組。若您執行此作業，您可以選擇旨在為您自動分組資料的指標，來簡化您的分析和報告。例如 Amazon Pinpoint 提供了多個標準指標，用於回報已交付給收件人的交易 SMS 訊息數。其中一項指標會依日期 (txn-sms-delivered-grouped-by-date) 自動分組資料。另一項指標會依國家或地區 (txn-sms-delivered-grouped-by-country) 自動分組資料。第三個指標只傳回一個值 - 訊息已交付給收件人的數目 (txn-sms-delivered)。如果沒有標準指標能按您想要的方式分組資料，您可以開發一系列的查詢，傳回您想要的資料。然後，手動拆分或合併查詢結果，使其成為您設計的自訂群組。
最後，請務必確認您已獲得授權存取您希望查詢的資料。如需詳細資訊，請參閱查詢 Amazon Pinpoint 分析資料的 IAM 政策。
