查詢行銷活動的 Amazon Pinpoint 分析資料

除了使用 Amazon Pinpoint 主控台的分析頁面外，也可以使用 Amazon Pinpoint Analytics API 查詢標準指標子集的分析資料，深入了解行銷活動的成果和互動趨勢。

這些指標每一個都是可測量的值，也稱為「關鍵績效指標 (KPI)」，可協助您監控與評估一或多個行銷活動的績效。例如，您可以使用指標了解行銷活動訊息送往的端點數量，或是這些訊息交付給預期端點的數量。

Amazon Pinpoint 會自動收集並彙總所有行銷活動的資料。資料可存放 90 天。如果您使用 Mobile AWS SDK 將行動應用程式與 Amazon Pinpoint 整合，Amazon Pinpoint 會將此支援擴展為包含其他指標，例如收件人開啟的推送通知百分比。如需整合行動裝置應用程式的資訊，請參閱 將 Amazon Pinpoint 與您的應用程式整合。

若使用 Amazon Pinpoint Analytics API 查詢資料，可以選擇定義查詢範圍、資料、群組和篩選條件的各種選項。您可以使用參數來執行此作業；這些參數會指定您希望查詢的專案、行銷活動和指標，以及任何您希望套用的日期類型篩選條件。

本主題會提供範例，說明如何選擇這些選項，以及如何查詢一或多個行銷活動的資料。

先決條件

在您查詢一或多個行銷活動的分析資料前，收集以下用於定義查詢的資訊，對您將會有所助益：

• 專案 ID – 與行銷活動相關聯的專案的唯一識別符。在 Amazon Pinpoint API 中，此值存放在 application-id 屬性內。在 Amazon Pinpoint 主控台上，此值是所有專案頁面上的專案 ID。

• 行銷活動 ID – 行銷活動的唯一識別符 (若您只希望查詢個別行銷活動的資料的話)。在 Amazon Pinpoint API 中，此值存放在 campaign-id 屬性內。這個值不會顯示在主控台中。

• 日期範圍 – (選用) 查詢資料日期範圍的第一個和最後一個日期和時間。日期範圍包含在內，且必須不超過 31 個日曆日。此外，也必須從當天起算少於 90 天。若沒有指定日期範圍，Amazon Pinpoint 會自動查詢前 31 個日曆天的資料。

• 指標類型 – 要查詢的指標類型。有兩種類型：「應用程式指標」和「行銷活動指標」。「應用程式指標」可提供與專案相關聯所有行銷活動的資料，也稱為「應用程式」。「行銷活動指標」則只能提供單一行銷活動的資料。

• 指標 – 要查詢的指標名稱，明確地說就是指標的 kpi-name 值。如需支援指標的完整清單及每個指標的 kpi-name 值，請參閱 專案、行銷活動和旅程的標準指標。

這也有助於您判斷是否要根據相關欄位對資料進行分組。若您執行此作業，您可以選擇旨在為您自動分組資料的指標，來簡化您的分析和報告。例如 Amazon Pinpoint 提供多種標準指標，用於回報訊息已交付給行銷活動收件人的百分比。其中一項指標會依日期 (successful-delivery-rate-grouped-by-date) 自動分組資料。另一項指標會依行銷活動執行 (successful-delivery-rate-grouped-by-campaign-activity) 自動分組資料。第三個指標只傳回一個值 - 訊息已交付給所有行銷活動收件人的百分比 (successful-delivery-rate)。

如果沒有標準指標能按您想要的方式分組資料，您可以開發一系列的查詢，傳回您想要的資料。然後，手動拆分或合併查詢結果，使其成為您設計的自訂群組。

最後，請務必確認您已獲得授權存取您希望查詢的資料。如需詳細資訊，請參閱查詢 Amazon Pinpoint 分析資料的 IAM 政策。