在具有Web视图的本机应用程序中通过AEP Mobile SDK实施Target

本文分享在移动应用程序中实施Adobe Target的最佳实践，该应用程序使用Adobe Experience Platform Mobile SDK在Web视图中使用本机代码。

本文使用来自GitHub存储库🔗的Adobe Experience Platform Mobile SDK和在Swift中编写的Target集成作为示例iOS应用程序。

在现实中，您的企业应用程序可能会使用移动应用程序中的Web视图。 Web视图是一个使用URL加载网页的容器。 该容器类似于没有控件的浏览器窗口。 在iOS中，处理网页时，Web视图容器可充当Safari浏览器。

先决条件

要开始使用Adobe Experience Platform Mobile SDK，您必须执行一些先决任务。

有关详细信息，请参阅Adobe Experience Platform Mobile SDK文档中的Adobe Target。

将本机代码与Web视图同步

在使用Web视图的本机应用程序中实施Target时，面临的挑战是Adobe Experience Platform Mobile SDK已生成了Adobe解决方案无缝工作所需的所有必要标识符。 但是，这些标识符对Web视图尚不可见，因为这些标识符在本机Platform环境中不存在。 因此，您必须创建一个桥接器以将某些SDK标识符传递到Web视图，以便访客身份保留在Web环境中。 如果不正确执行此操作，则会导致重复访问，从而影响您的报表。

幸运的是，Adobe Experience Platform Mobile SDK提供了一种方便的方法来生成Web视图使用并保留同一访客所需的Adobe参数，如以下示例代码中所示：

Identity.appendTo(url: URL(string: url), completion: {appendedURL, error in
  print("appendedURL \(String(describing: appendedURL))")
  // load the url with ECID on the main thread
  DispatchQueue.main.async {
    let request = NSMutableURLRequest(url: appendedURL!)
    self.webView.load(request as URLRequest)
  }
});

有关Identity.appendTo方法的详细信息，并查看如何使用该方法的示例，请参阅​ Mobile SDK文档 ​中的Swift >示例。

使用Identity.appendTo，此URL：

https://vadymus.github.io/ateng/at-order-confirmation/index.html?a=1&b=2

转换为：

https://vadymus.github.io/ateng/at-order-confirmation/index.html?a=1&b=2&adobe_mc=TS%3D1660667205%7CMCMID%3D69624092487065093697422606480535692677%7CMCORGID%3DEB9CAE8B56E003697F000101%40AdobeOrg

如您所见，URL附加了adobe_mc参数。 此参数包含下列内容的编码值：

Identity.getUrlVariables是一种替代Adobe Experience Platform Mobile SDK方法，它返回包含Experience Cloud Identity Service URL变量的格式正确的字符串。 有关详细信息，请参阅​ 标识API引用 ​中的getUrlVariables。

传递用于相同会话体验的Target会话ID

还需要执行一个额外的步骤，以使Target用户历程在本机视图和Web视图之间无缝工作。 此步骤包括从Adobe Experience Platform Mobile SDK提取Target会话ID并将其传递给移动设备应用程序的Web视图。

Target.getSessionId提取可以作为mboxSession参数传递到Web视图URL的会话ID：

Target.getSessionId { (id, err) in
    // read Target sessionId
}

在Web视图中测试

通过单击Adobe QA链接在Activity detail页面上生成Web预览链接，以显示弹出窗口来复制每个体验预览链接，如下所示：

?at_preview_token=mhFIzJSF7JWb-RsnakpBqi_s83Sl64hZp928VWpkwvI&at_preview_index=1_1&at_preview_listed_activities_only=true

Web预览链接包含其他at_preview_index和at_preview_listed_activities_only参数。 复制这些参数以使用Web链接参数构建移动友好的预览链接。

例如：

com.adobe.targetmobile://?at_preview_token=mhFIzJSF7JWb-RsnakpBqhBwj-TiIlZsRTx_1QQuiXLIJFdpSLeEZwKGPUyy57O_&at_preview_index=1_1&at_preview_listed_activities_only=true

在iOS Safari浏览器中打开该链接后，您的应用程序会捕获AppDelegate类中的URL，类似于以下示例：

func application(_ app: UIApplication, open url: URL, options: [UIApplicationOpenURLOptionsKey : Any] = [:]) -> Bool {
  print("url= \(String(describing: url.absoluteString))")
  //...

现在，您已捕获应用程序中的所有必要参数，可以在必要时将这些参数传递到Web：

Identity.appendTo(url: URL(string: url), completion: {appendedURL, error in
  let urlWithWebPreviewLink = appendedURL + "&" + myPreviewLinkFromAppDelegate

Web视图链接的最终输出可能如下所示：

https://vadymus.github.io/ateng/at-order-confirmation/index.html?a=1&b=2&adobe_mc=TS%3D1660667205%7CMCMID%3D69624092487065093697422606480535692677%7CMCORGID%3DEB9CAE8B56E003697F000101%40AdobeOrg&at_preview_token=mhFIzJSF7JWb-RsnakpBqi_s83Sl64hZp928VWpkwvI&at_preview_index=1_1&at_preview_listed_activities_only=true