支援終止通知：2026 年 10 月 30 日， AWS 將結束對 Amazon Pinpoint 的支援。2026 年 10 月 30 日之後，您將無法再存取 Amazon Pinpoint 主控台或 Amazon Pinpoint 資源 (端點、區段、行銷活動、旅程和分析)。如需詳細資訊，請參閱 Amazon Pinpoint 終止支援。注意：與 SMS、語音、行動推播、OTP 和電話號碼驗證相關的 APIs 不受此變更影響，並受 AWS 最終使用者傳訊支援。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
查詢多個行銷活動的 Amazon Pinpoint 資料
有兩種方式可查詢多個行銷活動的資料。最佳方式取決於您是否全要查詢與相同專案相關聯的行銷活動資料。若如此做，也取決於您要查詢這些行銷活動的全部資料，或僅查詢其部分資料。
若要查詢與不同專案相關聯的行銷活動資料，或是與相同專案相關聯的一部分行銷活動資料，最佳的方法便是建立及執行一系列的個別查詢，其中每個查詢都適用於您希望查詢其資料的每個行銷活動。上一節說明了如何查詢單一行銷活動的資料。
若要查詢與相同專案相關聯的全部行銷活動資料，您可以使用應用程式指標 API。提定下列必要參數的值：
您也可以透過日期範圍篩選資料。若沒有指定日期範圍，Amazon Pinpoint 會傳回前 31 個日曆天的資料。若要根據不同的日期篩選資料，請使用支援的日期範圍參數來指定日期範圍第一個和最後一個日期及時間。這些值應依延伸的 ISO 8601 格式顯示，並使用國際標準時間 (UTC)，例如 2019 年 7 月 19 日 8:00 PM UTC 即以 2019-07-19T20:00:00Z 顯示。日期範圍包含在內，且必須不超過 31 個日曆日。此外，第一個日期和時間必須小於從當天起算 90 天。
下列範例示範如何使用 Amazon Pinpoint REST API AWS CLI、 和 來查詢行銷活動的分析資料 AWS SDK for Java。您可以使用任何支援的 AWS SDK 來查詢行銷活動的分析資料。 AWS CLI 範例已針對 Microsoft Windows 格式化。針對 Unix、Linux 和 macOS，請將插入點 (^) 行接續字元替換成反斜線 (\)。
- REST API
-
若要使用 Amazon Pinpoint REST API 查詢多個行銷活動的分析資料，請傳送 HTTP(S) GET 請求到應用程式指標 URI。在 URI 中，指定必要路徑參數的適當值：
https://endpoint/v1/apps/application-id/kpis/daterange/kpi-name
其中：
-
端點是託管與行銷活動相關聯專案之 AWS 區域的 Amazon Pinpoint 端點。
-
application-id 是與行銷活動相關聯專案的唯一識別符。
-
kpi-name 是要查詢指標的 kpi-name 值。
所有參數都必須針對 URL 進行編碼。
若要套用篩選條件，擷取特定日期範圍的資料，請將 start-time 和 end-time 查詢參數及值附加到 URI。藉由使用這些參數，您便可以指定要擷取資料內含日期範圍的第一個及最後一個日期和時間 (格式為已擴充的 ISO 8601 格式)。請使用 & 符號來分隔參數。
例如，以下請求會擷取 2019 年 7 月 19 日至 2019 年 7 月 26 日間，專案中每個行銷活動交付訊息到的唯一端點數。
https://pinpoint.us-east-1.amazonaws.com/v1/apps/1234567890123456789012345example/kpis/daterange/unique-deliveries-grouped-by-campaign?start-time=2019-07-19T00:00:00Z&end-time=2019-07-26T23:59:59Z
其中：
-
pinpoint.us-east-1.amazonaws.com 是託管專案的 AWS 區域的 Amazon Pinpoint 端點。
-
1234567890123456789012345example 是與行銷活動相關聯專案的唯一識別符。
-
unique-deliveries-grouped-by-campaign 是端點交付行銷活動指標的 kpi-name 值，該指標傳回有多少個不重複端點，已收到每個行銷活動的訊息。
-
2019-07-19T00:00:00Z 是要擷取資料的第一個日期和時間，它是內含日期範圍的一部分。
-
2019-07-26T23:59:59Z 則是要擷取資料的最後一個日期和時間，它也是內含日期範圍的一部分。
- AWS CLI
-
若要使用 查詢多個行銷活動的分析資料 AWS CLI，請使用 get-application-date-range-kpi命令並指定所需參數的適當值：
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id application-id ^
--kpi-name kpi-name
其中：
若要套用篩選條件，擷取特定日期範圍的資料，請在您的查詢中包含 start-time 和 end-time 參數及值。藉由使用這些參數，您便可以指定要擷取資料內含日期範圍的第一個及最後一個日期和時間 (格式為已擴充的 ISO 8601 格式)。例如，以下請求會擷取 2019 年 7 月 19 日至 2019 年 7 月 26 日間，專案中每個行銷活動交付訊息到的唯一端點數。
C:\> aws pinpoint get-application-date-range-kpi ^
--application-id 1234567890123456789012345example ^
--kpi-name unique-deliveries-grouped-by-campaign ^
--start-time 2019-07-19T00:00:00Z ^
--end-time 2019-07-26T23:59:59Z
其中：
-
1234567890123456789012345example 是與行銷活動相關聯專案的唯一識別符。
-
unique-deliveries-grouped-by-campaign 是端點交付行銷活動指標的 kpi-name 值，該指標傳回有多少個不重複端點，已收到每個行銷活動的訊息。
-
2019-07-19T00:00:00Z 是要擷取資料的第一個日期和時間，它是內含日期範圍的一部分。
-
2019-07-26T23:59:59Z 則是要擷取資料的最後一個日期和時間，它也是內含日期範圍的一部分。
- SDK for Java
-
若要使用 查詢多個行銷活動的分析資料 AWS SDK for Java，請使用 Application Metrics API 的 GetApplicationDateRangeKpiRequest方法。為所需參數指定適當的值：
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("applicationId")
.withKpiName("kpiName")
其中：
若要套用篩選條件，擷取特定日期範圍的資料，請在您的查詢中包含 startTime 和 endTime 參數及值。藉由使用這些參數，您便可以指定要擷取資料內含日期範圍的第一個及最後一個日期和時間 (格式為已擴充的 ISO 8601 格式)。例如，以下請求會擷取 2019 年 7 月 19 日至 2019 年 7 月 26 日間，專案中每個行銷活動交付訊息到的唯一端點數。
GetApplicationDateRangeKpiRequest request = new GetApplicationDateRangeKpiRequest()
.withApplicationId("1234567890123456789012345example")
.withKpiName("unique-deliveries-grouped-by-campaign")
.withStartTime(Date.from(Instant.parse("2019-07-19T00:00:00Z")))
.withEndTime(Date.from(Instant.parse("2019-07-26T23:59:59Z")));
其中：
-
1234567890123456789012345example 是與行銷活動相關聯專案的唯一識別符。
-
unique-deliveries-grouped-by-campaign 是端點交付行銷活動指標的 kpi-name 值，該指標傳回有多少個不重複端點，已收到每個行銷活動的訊息。
-
2019-07-19T00:00:00Z 是要擷取資料的第一個日期和時間，它是內含日期範圍的一部分。
-
2019-07-26T23:59:59Z 則是要擷取資料的最後一個日期和時間，它也是內含日期範圍的一部分。
您傳送查詢後，Amazon Pinpoint 會以 JSON 回應傳回查詢結果。結果的結構會因您查詢的指標而不同。有些指標只會傳回一個值。其他指標則會傳回多個值，並會根據相關欄位為那些值進行分組。若指標傳回多個值，則 JSON 回應會包含欄位，指出使用了哪些欄位來為資料進行分組。
例如上述範例使用的端點交付 (依行銷活動分組) (unique-deliveries-grouped-by-campaign) 應用程式指標會傳回多個值 - 有多少個不重複端點，已收到每個與專案相關聯的行銷活動的訊息。本案例的 JSON 回應如下：
{
"ApplicationDateRangeKpiResponse":{
"ApplicationId":"1234567890123456789012345example",
"EndTime":"2019-07-26T23:59:59Z",
"KpiName":"unique-deliveries-grouped-by-campaign",
"KpiResult":{
"Rows":[
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"80b8efd84042ff8d9c96ce2f8example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"123.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"810c7aab86d42fb2b56c8c966example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"456.0"
}
]
},
{
"GroupedBys":[
{
"Key":"CampaignId",
"Type":"String",
"Value":"42d8c7eb0990a57ba1d5476a3example"
}
],
"Values":[
{
"Key":"UniqueDeliveries",
"Type":"Double",
"Value":"789.0"
}
]
}
]
},
"StartTime":"2019-07-19T00:00:00Z"
}
}
在此情況下，GroupedBys 欄位會指出值是以行銷活動 ID (CampaignId) 進行分組。
若要進一步了解查詢結果的結構，請參閱 使用 JSON 查詢結果。
