**支援終止通知：**2026 年 10 月 30 日， AWS 將結束對 Amazon Pinpoint 的支援。2026 年 10 月 30 日之後，您將無法再存取 Amazon Pinpoint 主控台或 Amazon Pinpoint 資源 (端點、區段、行銷活動、旅程和分析)。如需詳細資訊，請參閱 [Amazon Pinpoint 終止支援](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：**與 SMS、語音、行動推播、OTP 和電話號碼驗證相關的 APIs 不受此變更影響，並受 AWS 最終使用者傳訊支援。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 將 Amazon Pinpoint 與您的應用程式整合
將 Amazon Pinpoint 與您的用戶端程式碼整合，以了解並吸引使用者。
在您整合 且您的使用者啟動應用程式後，它會連線到 Amazon Pinpoint 服務來新增或更新*端點*。端點代表您可以傳訊的目的地—例如使用者裝置、電子郵件地址或電話號碼。
然後，您的應用程式可以提供用量資料或*事件*。在 Amazon Pinpoint 主控台檢視事件資料，了解您有多少使用者、他們多常使用您的應用程式、何時使用等資訊。
在您的應用程式提供端點和事件之後，您可以使用此資訊來為特定對象或*客群*量身打造簡訊行銷活動。(您也可以直接傳送訊息給一份簡單的收件人清單，而不需要建立行銷活動。)
使用本節的主題，將 Amazon Pinpoint 與行動或 Web 應用程式整合。這些主題包含了與 JavaScript、Android、Swift 或 Flutter 應用程式整合的程式碼範例和程序。若要開始整合您的應用程式，請參閱[使用 AWS Amplify 將您的前端應用程式連線至 Amazon Pinpoint](integrate-sdk.md)。
您可以在用戶端以外的地方，使用[支援的 AWS SDK](sdk-general-information-section.md) 或 [Amazon Pinpoint API](https://docs.aws.amazon.com/pinpoint/latest/apireference/)，匯入端點、匯出事件資料、定義客戶客群、建立和執行行銷活動等。
**Topics**
+ [搭配 AWS SDK 使用 Amazon Pinpoint](sdk-general-information-section.md)
+ [使用 AWS Amplify 將您的前端應用程式連線至 Amazon Pinpoint](integrate-sdk.md)
+ [在應用程式中註冊 Amazon Pinpoint 端點](integrate-endpoints.md)
+ [在您的應用程式中報告 Amazon Pinpoint 事件](integrate-events.md)
# 搭配 AWS SDK 使用 Amazon Pinpoint
AWS 軟體開發套件 (SDKs) 適用於許多熱門的程式設計語言。每個 SDK 都提供 API、程式碼範例和說明文件，讓開發人員能夠更輕鬆地以偏好的語言建置應用程式。
| SDK 文件 | 代碼範例 |
| --- | --- |
| [適用於 C\$1\$1 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-cpp) | [適用於 C\$1\$1 的 AWS SDK 程式碼範例](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/cpp) |
| [AWS CLI](https://docs.aws.amazon.com/cli) | [AWS CLI 程式碼範例](https://docs.aws.amazon.com/code-library/latest/ug/cli_2_code_examples.html) |
| [適用於 Go 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-go) | [適用於 Go 的 AWS SDK 程式碼範例](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/gov2) |
| [適用於 Java 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-java) | [適用於 Java 的 AWS SDK 程式碼範例](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javav2) |
| [適用於 JavaScript 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-javascript) | [適用於 JavaScript 的 AWS SDK 程式碼範例](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/javascriptv3) |
| [適用於 Kotlin 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-kotlin) | [適用於 Kotlin 的 AWS SDK 程式碼範例](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/kotlin) |
| [適用於 .NET 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-net) | [適用於 .NET 的 AWS SDK 程式碼範例](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/dotnetv3) |
| [適用於 PHP 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-php) | [適用於 PHP 的 AWS SDK 程式碼範例](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/php) |
| [AWS Tools for PowerShell](https://docs.aws.amazon.com/powershell) | [AWS Tools for PowerShell 程式碼範例](https://docs.aws.amazon.com/code-library/latest/ug/powershell_5_code_examples.html) |
| [適用於 Python (Boto3) 的 AWS SDK](https://docs.aws.amazon.com/pythonsdk) | [適用於 Python (Boto3) 的 AWS SDK 程式碼範例](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/python) |
| [適用於 Ruby 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-ruby) | [適用於 Ruby 的 AWS SDK 程式碼範例](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/ruby) |
| [適用於 Rust 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-rust) | [適用於 Rust 的 AWS SDK 程式碼範例](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/rustv1) |
| [適用於 SAP ABAP 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-sapabap) | [適用於 SAP ABAP 的 AWS SDK 程式碼範例](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/sap-abap) |
| [適用於 Swift 的 AWS SDK](https://docs.aws.amazon.com/sdk-for-swift) | [適用於 Swift 的 AWS SDK 程式碼範例](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/swift) |
如需 Amazon Pinpoint 專用範例，請參閱 [使用 AWS SDKs Amazon Pinpoint 程式碼範例](service_code_examples.md)。
**可用性範例**
找不到所需的內容嗎？ 請使用本頁面底部的**提供意見回饋**連結申請程式碼範例。
# 使用 AWS Amplify 將您的前端應用程式連線至 Amazon Pinpoint
使用 AWS Amplify 將您的應用程式與 整合 AWS。如需 Swift 應用程式的詳細資訊，請參閱 Amplify for Swift 文件中的[開始使用](https://docs.amplify.aws/gen1/swift/start/getting-started/introduction/)。如果是 Android 應用程式，請參閱 Amplify for Android SDK 文件中的[開始使用](https://docs.amplify.aws/gen1/android/start/getting-started/introduction/)。如需 React Native 應用程式的詳細資訊，請參閱 Amplify JavaScript 文件中的[開始使用](https://docs.amplify.aws/gen1/react-native/start/getting-started/introduction/)。如需 Flutter 應用程序的詳細資訊，請參閱 Flutter SDK 文件中的[開始使用](https://docs.amplify.aws/gen1/flutter/start/getting-started/introduction/)。這些主題可協助您：
+ 設定您的後端資源。
+ 使用 Amplify 程式庫將您的應用程式連接到後端資源。
若要進一步了解如何將前端應用程式連線至 Amazon Pinpoint 進行分析、應用程式內訊息和推播通知，請參閱 [AWS Amplify](https://docs.amplify.aws/react/build-a-backend/)。
## 下一步驟
將 AWS Amplify 與您的應用程式整合後，請更新您的程式碼，將使用者的裝置註冊為端點。如需詳細資訊，請參閱[在應用程式中註冊 Amazon Pinpoint 端點](integrate-endpoints.md)。
# 在應用程式中註冊 Amazon Pinpoint 端點
使用者啟動工作階段時 (例如透過啟動行動應用程式)，您的行動或 Web 應用程式可以使用 Amazon Pinpoint 自動註冊 (或更新) *端點*。端點代表使用者啟動工作階段所針對的裝置。它包含屬性來描述裝置，也可以包含您定義的自訂屬性。端點也可以代表與客戶通訊的其他方法，例如電子郵件地址或行動電話號碼。
當您的應用程式註冊端點之後，您可以根據端點的屬性來區隔對象。然後，您可以透過量身訂做的簡訊行銷活動，與這些客群交流。您也可以使用 Amazon Pinpoint 主控台中的**分析**頁面，檢視有關端點註冊和活動的圖表，例如**新端點**和**每日作用中端點**。
您可以將單一使用者 ID 指派給多個端點。使用者 ID 代表單一使用者，而每個獲指派使用者 ID 的端點代表使用者的其中一個裝置。您將使用者 ID 指派給端點之後，可以在主控台檢視使用者活動相關圖表，例如**每日作用中使用者**和**每月作用中使用者**。
## 開始之前
如果您尚未這麼做，請整合適用於 Android 或 iOS 的 AWS Mobile SDK，或整合 AWS Amplify JavaScript 程式庫與您的應用程式。如需詳細資訊，請參閱[使用 AWS Amplify 將您的前端應用程式連線至 Amazon Pinpoint](integrate-sdk.md)。
## 使用適用於 Android 或 iOS AWS 的行動 SDKs註冊端點
您可以使用適用於 Android 或 iOS 的 AWS Mobile SDK 來註冊和自訂端點。 SDKs 如需詳細資訊及檢視程式碼範例，請參閱下列文件：
+ Android 開發套件文件中的[在您的應用程式中註冊端點](https://docs.amplify.aws/gen1/swift/sdk/analytics/endpoints/)。
+ iOS 開發套件文件中的[在您的應用程式中註冊端點](https://docs.amplify.aws/gen1/android/sdk/analytics/endpoints/)。
## 向 AWS Amplify JavaScript 程式庫註冊端點
您可以使用 AWS Amplify JavaScript 程式庫在應用程式中註冊和更新端點。如需詳細資訊，以及檢視程式碼範例，請參閱 AWS Amplify JavaScript 文件中的[更新端點](https://docs.amplify.aws/gen1/nextjs/build-a-backend/more-features/analytics/analytics-migration-guide/#analyticsupdateendpoint)。
## 後續步驟
在您更新應用程式以註冊端點後，當使用者啟動您的應用程式時，裝置資訊和自訂屬性會提供給 Amazon Pinpoint。您可以使用此資訊來定義對象客群。您也可以使用 主控台來查看端點指標和獲指派使用者 IDs的使用者。您也可以完成 中的步驟[在您的應用程式中報告 Amazon Pinpoint 事件](integrate-events.md)，以更新應用程式來報告用量資料。
# 在您的應用程式中報告 Amazon Pinpoint 事件
在行動或 Web 應用程式中，您可以使用 AWS Mobile SDKs或 [Amazon Pinpoint 事件 API](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-events.html) 向 Amazon Pinpoint 報告用量資料或*事件*。您可以報告事件來擷取資訊，例如，工作階段時間、使用者的購買行為、登入嘗試、或您需要的任何自訂事件類型。
您的應用程式回報事件之後，您可以在 Amazon Pinpoint 主控台檢視分析。**Analytics (分析)** 頁面上的圖表提供許多使用者行為層面的指標。詳情請參閱 *Amazon Pinpoint 使用者指南*中的 [Amazon Pinpoint 分析圖表參考](https://docs.aws.amazon.com/pinpoint/latest/userguide/analytics-charts.html)。
若要在 Amazon Pinpoint 以外的地方分析或儲存資料，可以設定 Amazon Pinpoint 將資料串流到 Amazon Kinesis。如需詳細資訊，請參閱[使用 Amazon Pinpoint 透過 Kinesis 和 Firehose 串流應用程式事件資料](event-streams.md)。
透過使用 AWS Mobile SDKs和 AWS Amplify JavaScript 程式庫，您可以呼叫 Amazon Pinpoint API 來報告下列類型的事件：
**工作階段事件**
指出使用者開啟和關閉您的應用程式的時間和頻率。
應用程式報告工作階段事件後，使用 Amazon Pinpoint 主控台的**分析**頁面，檢視**工作階段**、**每日作用中端點**、**7 天保留率**等圖表。
**自訂事件**
您指派自訂事件類型所定義的非標準事件。您可以將自訂屬性和指標新增到自訂事件。
在主控台的 **Analytics (分析)** 頁面，**Events (事件)** 標籤會顯示應用程式報告的所有自訂事件的指標。
**獲利事件**
報告您的應用程式產生的營收，以及使用者購買的項目數。
在 **Analytics (分析)** 頁面，**Revenue (營收)** 標籤會顯示 **Revenue (營收)**、**Paying users (付費使用者)**、**Units sold (售出品項數量)** 等圖表。
**身分驗證事件**
指出使用者向您的應用程式進行驗證的頻率。
在 **Analytics (分析)** 頁面，**Users (使用者)** 標籤會顯示 **Sign-ins (登入次數)**、**Sign-ups (註冊次數)** 和 **Authentication failures (身分驗證失敗)** 的圖表。
## 開始之前
如果您尚未執行以下操作，請現在執行：
+ 將您的應用程式與 AWS Amplify 整合。請參閱 [使用 AWS Amplify 將您的前端應用程式連線至 Amazon Pinpoint](integrate-sdk.md)。
+ 更新您的應用程式來註冊端點。請參閱 [在應用程式中註冊 Amazon Pinpoint 端點](integrate-endpoints.md)。
## 使用適用於 Android 或 iOS AWS 的行動 SDKs報告事件
您可以使用適用於 iOS 和 Android AWS 的 Mobile SDKs，讓行動應用程式向 Amazon Pinpoint 報告事件。
如需更新應用程式以記錄事件並將其提交至 Amazon Pinpoint 的詳細資訊，請參閱 AWS Amplify 文件中的下列頁面：
+ iOS 開發套件文件中的[分析](https://docs.amplify.aws/swift/build-a-backend/add-aws-services/analytics/)
+ Android 開發套件文件中的[分析](https://docs.amplify.aws/android/build-a-backend/add-aws-services/analytics/)
## 使用 AWS Amplify JavaScript 程式庫報告事件
您可以使用 AWS Amplify JavaScript 程式庫，讓 JavaScript 和 React Native 應用程式向 Amazon Pinpoint 報告應用程式用量事件。如需更新應用程式以將事件提交到 Amazon Pinpoint 的詳細資訊，請參閱 AWS Amplify JavaScript 文件中的[分析](https://docs.amplify.aws/nextjs/build-a-backend/add-aws-services/analytics/)。
## 使用 Amazon Pinpoint API 報告事件
您可以使用 Amazon Pinpoint API 或 AWS SDK 大量將事件提交至 Amazon Pinpoint。詳情請參閱 *Amazon Pinpoint API 參考*中的[事件](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-events.html)。
## 後續步驟
在您更新應用程式以報告事件後，它會將用量資料傳送至 Amazon Pinpoint。您可以在 主控台中檢視此資料，並將其串流至 Amazon Kinesis。您也可以更新您的應用程式，以處理您使用 Amazon Pinpoint 傳送的推送通知。如需詳細資訊，請參閱[AWS 《 最終使用者傳訊推送使用者指南](https://docs.aws.amazon.com//push-notifications/latest/userguide/what-is-service.html)》中的下列主題。
+ [設定推送通知](https://docs.aws.amazon.com//push-notifications/latest/userguide/procedure-enable-push.html)
+ [設定 Swift 推播通知](https://docs.aws.amazon.com//push-notifications/latest/userguide/mobile-push.html#apns-setup)
+ [設定 Android 推播通知](https://docs.aws.amazon.com//push-notifications/latest/userguide/mobile-push.html#mobile-push-android)
+ [設定流暢推播通知](https://docs.aws.amazon.com//push-notifications/latest/userguide/mobile-push.html#mobile-push-flutter)
+ [設定 React Native 推播通知](https://docs.aws.amazon.com//push-notifications/latest/userguide/mobile-push.html#mobile-push-react-native)
+ [建立專案](https://docs.aws.amazon.com//push-notifications/latest/userguide/mobile-push.html#mobile-push-create-project)
+ [處理推送通知](https://docs.aws.amazon.com//push-notifications/latest/userguide/mobile-push.html#integrate-push-services)