如何在使用 PushEngage 的应用推送通知中添加深度链接

当用户点按推送通知时，将您的应用用户直接发送到 Android 或 iOS 应用内的特定屏幕。深度链接将用户直接带到您想要的位置，而不是仅仅打开应用的首页，这可能是一个产品页面、订单状态屏幕、特别优惠或任何其他应用内目的地。

本指南将引导您完成在 PushEngage Dashboard 中为 Android 和 iOS 设置深度链接的过程。

开始之前

请确保 PushEngage 已安装并在您的移动应用（Android、iOS、Flutter 或 React Native）中正常运行。如果您尚未完成此操作，请按照您平台的设置指南进行操作：

Flutter 设置指南

iOS 设置指南

React Native 设置指南

准备好您的深度链接 URL。这是您的应用用于打开特定屏幕的 URL 或 URI 方案（例如：myapp://products/123 或 https://yourapp.com/offers）。

什么是深度链接？

深度链接是一个特殊的 URL，它指向您移动应用内的特定页面或屏幕。当用户点按带有深度链接的推送通知时，他们会被直接带到该屏幕，而不是仅仅打开应用的首页。

示例：

• myapp://orders/456：在应用中打开订单 #456
• https://yourstore.com/sale：在应用中打开促销页面
• app://www.yourapp.com/trigger：打开特定的工作流程屏幕

通过 PushEngage Dashboard 添加深度链接

针对 Android 应用推送

1. 登录您的 PushEngage Dashboard。
2. 转到 App Push » Create Campaign。
3. 选择 Android 作为平台。
4. 填写通知的 Title 和 Message。
5. 向下滚动到 Deep Link 字段。
6. 输入您的深度链接 URL（例如：myapp://products/123）。
7. 点击 Send / Schedule 发送通知。

针对 iOS 应用推送

1. 登录您的 PushEngage Dashboard。
2. 转到 App Push » Create Campaign。
3. 选择 iOS 作为平台。
4. 填写通知的 Title 和 Message。
5. 向下滚动到 Deep Link 字段。
6. 输入您的深度链接 URL（例如：myapp://offers/summer-sale）。
7. 点击 Send / Schedule 发送通知。

如果在 iOS 上未设置深度链接，点按通知将仅打开应用。请注意，在 Android 和 iOS 上，深度链接的字符限制最多可达 1,600 个字符。

在您的应用代码中处理深度链接

发送带有深度链接的通知后，您的应用需要监听它并将用户导航到正确的屏幕。以下是每个平台上的操作方法：

Flutter

PushEngage.deepLinkStream.listen((data) {
  String? deepLink = data?['deepLink'];
  if (deepLink == null) return;
  Uri uri = Uri.parse(deepLink);
  if (uri.path == '/offers') {
    Navigator.pushNamed(context, '/offers');
  }
});

另外，如果希望您的应用自行处理路由，请确保在 iOS 的 Info.plist 中将 PushEngageAutoHandleDeeplinkURL 设置为 NO。

React Native

PushEngage.onValueChanged((data) => {
  const { deepLink } = data;
  // Navigate based on the deep link value
  if (deepLink === '/orders') {
    navigation.navigate('Orders');
  }
});

iOS (Swift)

PushEngage.setNotificationOpenHandler { result in
  let deepLink = result.notificationAction.actionID
  // Route the user to the correct screen
}

提示：对于 iOS，如果在 Info.plist 中将 PushEngageAutoHandleDeeplinkURL 设置为 YES，SDK 将自动在浏览器中打开任何 HTTP 或 HTTPS deep link URL。如果希望在应用内处理路由，请将其设置为 NO。

Android (Intent Filter)

对于 Android，请在 AndroidManifest.xml 中添加一个 intent filter，以便应用可以接收 deep link URL：

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <data android:scheme="myapp" android:host="www.yourapp.com" />
</intent-filter>

您现在已通过 PushEngage 为应用推送通知设置了 deep linking。当用户点击通知时，无论您是从仪表板还是通过 API 发送通知，他们都将被直接带到正确的屏幕。

如果您遇到任何问题，请单击此处联系我们。我们的支持团队将很乐意为您提供帮助。