集合管理函数 collection-management-functions

表达式语言还引入了一组查询集合的函数。

这些职能说明如下。 在以下示例中,我们使用包含集合的事件有效负载:

                {
   "_experience":{
      "campaign":{
         "message":{
            "profile":{
               "pushNotificationTokens":[
                  {
                     "token":"token_1",
                     "application":{
                        "_id":"APP1",
                        "name":"MarltonMobileApp",
                        "version":"1.0"
                     }
                  },
                  {
                     "token":"token_2",
                     "application":{
                        "_id":"APP2",
                        "name":"MarketplaceApp",
                        "version":"1.0"
                     }
                  },
                  {
                     "token":"token_3",
                     "application":{
                        "_id":"APP3",
                        "name":"VendorApp",
                        "version":"2.0"
                     }
                  }
               ]
            }
         }
      }
   },
   "timestamp":"1536160728"
}

函数“all(<condition>)”

all ​函数使用布尔表达式在给定集合上启用过滤器的定义。

<listExpression>.all(<condition>)

例如,在所有应用程序用户中,您可以使用IOS 13(布尔表达式“IOS 13==使用的应用程序”)获取这些用户。 此函数的结果是包含与布尔表达式匹配项目的过滤列表(例如:应用程序用户1、应用程序用户34、应用程序用户432)。

在数据Source条件活动中,您可以检查​ all ​函数的结果是否为null。 您还可以将此​ 所有 ​函数与其他函数(如​ count)组合。 有关详细信息,请参阅数据Source条件活动

示例1:

我们要检查用户是否已安装了应用程序的特定版本。 为此,我们将获得与版本为1.0的移动应用程序关联的所有推送通知令牌。然后,我们使用​ count ​函数执行一个条件,以检查返回的令牌列表是否至少包含一个元素。

count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all(currentEventField.application.version == "1.0").token}) > 0

结果为true。

示例2:

此处,我们使用​ count ​函数来检查集合中是否有推送通知令牌。

count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all().token}) > 0

结果将会是真。

NOTE
当​ all() ​函数中的筛选条件为空时,筛选器将返回列表中的所有元素。 但是,为了计算集合的元素数,不需要all函数。
count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.token})

表达式的结果为​ 3

示例3:

在此处,我们检查个人在过去24小时内是否未收到任何通信。 我们使用基于集合的两个元素的两个表达式,过滤从ExperiencePlatform数据源检索到的体验事件集合。 特别是,将事件的时间戳与​ nowWithDelta ​函数返回的dateTime进行比较。

count(#{ExperiencePlatform.MarltonExperience.experienceevent.all(
   currentDataPackField.directMarketing.sends.value > 0 and
   currentDataPackField.timestamp > nowWithDelta(-1, "days")).timestamp}) == 0

如果没有体验事件符合这两个条件,则结果将为true。

示例4:

在此处,我们要检查个人在过去7天内是否至少启动过一次应用程序,以便触发推送通知,邀请他们启动教程。

count(
 #{ExperiencePlatform.AnalyticsData.experienceevent.all(
 nowWithDelta(-7,"days") <= currentDataPackField.timestamp
 and currentDataPackField.application.firstLaunches.value > 0
)._id}) > 0
NOTE
currentEventField ​仅在处理事件集合时可用,currentDataPackField ​在处理数据源集合时可用,currentActionField ​在处理自定义操作响应集合时可用。
处理具有​ allfirst ​和​ last ​的集合时,我们会逐个循环集合的每个元素。 currentEventFieldcurrentDataPackField ​和​ currentActionField ​对应于正在循环的元素。

函数“first(<condition>)”和“last(<condition>)”

first ​和​ last ​函数在返回满足筛选条件的列表的第一个/最后一个元素时,也启用集合上的筛选条件的定义。

<listExpression>.first(<condition>)

<listExpression>.last(<condition>)

示例1:

此表达式返回与版本为1.0的移动应用程序关联的第一个推送通知令牌。

@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.first(currentEventField.application.version == "1.0").token

结果为“token_1”。

示例2:

此表达式返回与版本为1.0的移动应用程序关联的最后一个推送通知令牌。

@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.last(currentEventField.application.version == "1.0").token}

结果为“token_2”。

NOTE
体验事件将作为集合,以反向时间顺序从Adobe Experience Platform中进行检索,因此:
  • first ​函数将返回最近的事件
  • last ​函数将返回最旧的函数。

示例3:

我们检查第一个(最新)DMA ID为非零值的Adobe Analytics事件是否具有等于602的值。

#{ExperiencePlatform.AnalyticsProd_EvarsProps.experienceevent.first(
currentDataPackField.placeContext.geo.dmaID > 0).placeContext.geo.dmaID} == 602

函数“at(<index>)”

at ​函数允许您根据索引引用集合中的特定元素。
索引0是集合的第一个索引。

<listExpression>.at(<index>)

示例:

此表达式返回列表的第二个推送通知令牌。

@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.at(1).token}

结果为“token_2”。

其他示例

此表达式根据SKU值返回产品名称。 这些产品的列表包含在事件列表中,条件为事件ID。

#{ExperiencePlatform.ExperienceEventFieldGroup.experienceevent.all(currentDataPackField._aepgdcdevenablement2.purchase_event.receipt_nbr == "10-337-4016").
_aepgdcdevenablement2.purchase_event.productListItems.all(currentDataPackField.SKU == "AB17 1234 1775 19DT B4DR 8HDK 762").name}

此表达式检索商业事件的产品列表中最后一个产品的名称,其中事件类型为“productListAdds”,总价大于或等于150。

 #{ExperiencePlatform.ExperienceEventFieldGroup.experienceevent.last(
currentDataPackField.eventType == "commerce.productListAdds").productListItems.last(currentDataPackField.priceTotal >= 150).name}
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76