**终止支持通知：** AWS 将于 2026 年 10 月 30 日终止对亚马逊 Pinpoint 的支持。2026 年 10 月 30 日之后，您将不再能够访问 Amazon Pinpoint 控制台或 Amazon Pinpoint 资源（端点、分段、活动、旅程和分析）。有关更多信息，请参阅 [Amazon Pinpoint 终止支持](https://docs.aws.amazon.com/console/pinpoint/migration-guide)。**注意：** APIs 与短信相关、语音、移动推送、OTP 和电话号码验证不受此更改的影响，并受 AWS 最终用户消息的支持。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 将 Amazon Pinpoint 与您的应用程序集成
将 Amazon Pinpoint 与您的客户端代码集成以了解用户并与之互动。
在您完成集成并且用户启动您的应用程序后，该应用程序将连接到 Amazon Pinpoint 服务以添加或更新*端点*。端点表示您可以向其发送消息的目标，例如用户设备、电子邮件地址或电话号码。
然后，您的应用程序可提供使用情况数据或*事件*。在 Amazon Pinpoint 控制台中查看事件数据，以了解您拥有的用户的数量、这些用户使用您的应用程序的频率和时间等。
在您的应用程序提供端点和事件后，您可以使用此信息为特定受众（即*分段*）定制消息收发活动。（您也可以直接发送收件人的简单列表而不创建活动。）
使用本节中的主题以将 Amazon Pinpoint 与移动或 Web 应用程序集成。这些主题包含与 JavaScript、Android、Swift 或 Flutter 应用程序集成的代码示例和过程。要开始集成应用程序，请参阅[使用 Amplify 将你的前端应用程序连接到亚马逊 Pinpoin AWS t](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)
+ [使用 Amplify 将你的前端应用程序连接到亚马逊 Pinpoin AWS t](integrate-sdk.md)
+ [在应用程序中注册 Amazon Pinpoint 端点](integrate-endpoints.md)
+ [在您的应用程序中报告 Amazon Pinpoint 事件](integrate-events.md)
# 通过 AWS SDK 使用 Amazon Pinpoint
AWS 软件开发工具包（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 的示例，请参阅[将 Amazon Pinpoint 与 AWS SDK 结合使用的代码示例](service_code_examples.md)。
**示例可用性**
找不到所需的内容？ 通过使用此页面底部的**提供反馈**链接请求代码示例。
# 使用 Amplify 将你的前端应用程序连接到亚马逊 Pinpoin AWS t
使用 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 的每个端点表示用户的设备之一。将用户分配 IDs 到终端节点后，您可以在控制台中查看有关用户活动的图表，例如**每日活跃用户**和**每月活跃用户**。
## 开始前的准备工作
如果你还没有这样做，请集成适用于 Android 或 iOS 的 AWS 移动 SDK，或者将 AWS Amplify JavaScript 库与你的应用程序集成。有关更多信息，请参阅 [使用 Amplify 将你的前端应用程序连接到亚马逊 Pinpoin AWS t](integrate-sdk.md)。
## 在安卓或 iOS AWS 版 SDKs 的移动设备上注册终端
您可以使用 Android 或 iOS AWS 版移动设备 SDKs 注册和自定义端点。有关更多信息以及要查看代码示例，请参阅以下文档：
+ Android 开发工具包文档中的[在应用程序中注册端点](https://docs.amplify.aws/gen1/swift/sdk/analytics/endpoints/)。
+ iOS 开发工具包文档中的[在应用程序中注册端点](https://docs.amplify.aws/gen1/android/sdk/analytics/endpoints/)。
## 在 AWS Ampli JavaScript fy 库中注册端点
您可以使用 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 事件
在您的移动或网络应用程序中，您可以使用 AWS 移动 SDKs 或[亚马逊 Pinpoint 事件 API](https://docs.aws.amazon.com/pinpoint/latest/apireference/rest-api-events.html) 向亚马逊 Pinpoint 报告使用数据或*事件*。您可以报告事件以捕获会话时间、用户购买行为、登录尝试或您需要的任何自定义事件类型之类的信息。
在您的应用程序报告事件之后，您可在 Amazon Pinpoint 控制台中查看分析。**分析**页面上的图表提供了用户行为的多个方面的指标。有关更多信息，请参阅《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 移动版 SDKs 和 A AWS mplify JavaScript 库，您可以调用 Amazon Pinpoint API 来报告以下类型的事件：
**会话事件**
指示用户打开和关闭您的应用程序的时间及频率。
应用程序报告会话事件之后，您可以使用 Amazon Pinpoint 控制台中的**分析**页面来查看**会话**、**每日活动端点**、**7 天保留率**等的图表。
**自定义事件**
通过分配自定义事件类型定义的非标准事件。您可以将自定义属性和指标添加到自定义事件。
在控制台中的**分析**页面上，**事件**选项卡显示了您的应用程序报告的所有自定义事件的指标。
**货币化事件**
报告您的应用程序产生的收入以及用户购买的商品数。
在**分析**页面上，**收入**选项卡显示了 **收入**、**付费用户**、**销售数量**等的图表。
**身份验证事件**
指示用户对您的应用程序进行身份验证的频率。
在**分析**页面上，**用户**选项卡显示了**登录**、**注册**和**身份验证失败**的图表。
## 开始前的准备工作
执行以下操作（如果您尚未这样做）：
+ 将您的应用与 Amp AWS lify 集成。请参阅[使用 Amplify 将你的前端应用程序连接到亚马逊 Pinpoin AWS t](integrate-sdk.md)。
+ 更新您的应用程序以注册端点。请参阅[在应用程序中注册 Amazon Pinpoint 端点](integrate-endpoints.md)。
## 使用安卓或 iOS AWS 版 SDKs 的手机报告事件
你可以使用 SDKs适用于 iOS 和 Android 的移动应用程序，让 AWS 移动应用程序向亚马逊 Pinpoint 报告事件。
有关更新应用程序以记录事件并将其提交到亚马逊 Pinpoint 的更多信息，请参阅 Amplify AWS 文档中的以下页面：
+ iOS SDK 文档中的[分析](https://docs.amplify.aws/swift/build-a-backend/add-aws-services/analytics/)
+ Android SDK 文档中的[分析](https://docs.amplify.aws/android/build-a-backend/add-aws-services/analytics/)
## 使用 AWS Amplify 库 JavaScript 报告事件
您可以使用 Amplify AWS 库启用 JavaScript 和 React Native 应用程序向亚马逊 Pinpoint 报告应用程序使用事件。 JavaScript 有关更新应用程序以向亚马逊 Pinpoint 提交事件的更多信息，请参阅 Amplify AWS 文档中的[分析](https://docs.amplify.aws/nextjs/build-a-backend/add-aws-services/analytics/)。 JavaScript
## 使用 Amazon Pinpoint API 报告事件
您可以使用亚马逊 Pinpoint API 或 AWS 软件开发工具包向亚马逊 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)
+ [设置 Flutter 推送通知](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)