基于代码的体验表面

最近更新： 2025年6月2日

创建对象：

什么是表面？

基于代码的体验 surface 是为用户或系统交互而设计的任何实体，由URI唯一标识。该表面在应用程序实现中指定，并且必须匹配在基于代码的体验渠道配置中引用的表面。

在任何层级的容器中，表面都可以被视为存在实体（接触点）的容器。

可以是网页、移动设备应用程序、桌面应用程序，以及大型实体中的特定内容位置（例如 div）或非标准显示模式（例如，自助服务终端或桌面应用程序横幅）。
还可以扩展到用于非显示或抽象显示目的的特定内容容器（例如，传递给服务的 JSON Blob）。
它还可以是匹配各种客户端表面定义的通配符表面（例如，网站每个页面上的主图像位置可以在表面 URI 中进行转译，例如：web://mydomain.com/*#hero_image）。

注意

如果在同一表面上运行了多个基于代码的体验操作，则营销活动或历程的 优先级分数 将决定向最终用户交付的内容（如果最终用户符合多个操作的条件）。了解有关优先级分数的更多信息

表面URI 用作指向应用程序中不同用户界面元素或组件的精确标识符。表面URI基本上由多个部分组成：

下表列出了各种设备的一些表面 URI 定义示例。

Web 和移动

类型	URI	描述
Web	`web://domain.com/path/page.html#element`	表示特定域的特定页面中的单个元素，其中元素可以是标签，如以下示例中的标签：hero_banner、top_nav、menu、footer 等。
iOS 应用程序	`mobileapp://com.vendor.bundle/activity#element`	表示原生应用程序活动中的特定元素，如按钮或其他视图元素。
Android 应用程序	`mobileapp://com.vendor.bundle/#element`	表示原生应用程序中的特定元素。

其他设备类型

类型	URI	描述
桌面	`desktop://com.vendor.bundle/#element`	表示应用程序中的特定元素，如按钮、菜单、主横幅等。
TV 应用程序	`tvcd://com.vendor.bundle/#element`	表示智能电视或电视连接设备应用程序中的特定元素 - 捆绑 ID。
服务	`service://servicename/#element`	表示服务器端进程或其他手动实体。
自助服务终端	`kiosk://location/screen#element`	易于添加的其他潜在表面类型示例。
ATM	`atm://location/screen#element`	易于添加的其他潜在表面类型示例。

通配符表面

类型

URI

描述

通配符 Web

wildcard:web://domain.com/*#element

通配符表面 - 表示特定域下每个页面中的单个元素。

通配符 Web

wildcard:web://*domain.com/*#element

通配符表面 - 表示以“domain.com”结尾的所有域下每个页面中的单个元素。

在Journey Optimizer中，基于代码的体验渠道支持两种类型的客户实施：

基于您网站的Adobe Experience Platform Web SDK，或基于您移动应用程序的Adobe Experience Platform Mobile SDK；
使用AEP Edge Network服务器API的服务器端或混合服务器。

NOTE

在本节中了解关于实施先决条件的更多信息。

使用基于代码的体验，您可以修改粒度位置上的内容，这些位置由Journey Optimizer使用表面URI唯一标识。

这些表面URI的构成和处理取决于实施方法：

Web/移动SDK：您的Web/移动开发人员需要将这些粒度位置定义为简单字符串，因为Web/移动SDK能够基于当前URL/应用程序ID和位置字符串自动构建表面URI。
Edge Network API：应用程序/页面开发人员必须定义包含完整路径和使用内容的位置的完整表面URI，因为此类型的实施需要完整URI。

这就是为什么在创建基于代码的体验渠道配置时，您有两种方式可根据所选平台指定表面：

对于 Web、iOS 和 Android 平台，您需要输入 URL/应用程序ID 和 位置或路径 来构成表面。了解有关为Web和移动设备平台配置基于代码的体验的详细信息
如果平台是 Other，则需要输入完整的 表面URI，如上面的示例所示。了解有关为其他平台配置基于代码的体验的详细信息

recommendation-more-help