Fonctions de gestion des collections collection-management-functions
Le langage d’expression s’accompagne également d’un ensemble de fonctions permettant d’interroger les collections.
Ces fonctions sont expliquées ci-dessous. Dans les exemples suivants, nous allons utiliser la payload d’événement contenant une collection :
{
"_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"
}
La fonction « all(<condition>) »
La fonction all permet de définir un filtre sur une collection donnée en utilisant une expression booléenne.
<listExpression>.all(<condition>)
Par exemple, parmi tous les utilisateurs de l’application, vous pouvez extraire ceux qui utilisent IOS 13 (expression booléenne « app used == IOS 13 »). Le résultat de cette fonction est une liste filtrée contenant les éléments qui correspondent à l’expression booléenne (exemple : utilisateur 1 de l’application, utilisateur 34 de l’application, utilisateur 432 de l’application).
Dans une activité Condition de source de données, vous pouvez vérifier si le résultat de la fonction all est nul ou non. Vous pouvez également combiner cette fonction all à d’autres fonctions, telles que count. Pour plus d’informations, voir Activité Condition de source de données.
Exemple 1 :
Nous voulons vérifier si un utilisateur a installé une version spécifique d’une application. Pour ce faire, nous récupérons tous les jetons de notification push associés aux applications mobiles dont la version est égale à 1.0. Ensuite, nous exécutons une condition avec la fonction count pour vérifier que la liste de jetons renvoyée contient au moins un élément.
count(@{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all(currentEventField.application.version == "1.0").token}) > 0
Le résultat est true.
Exemple 2 :
Ici, nous utilisons la fonction count pour vérifier s’il existe des jetons de notification push dans la collection.
count(@{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all().token}) > 0
Le résultat sera true.
count(@{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.token})
Le résultat de l’expression est 3.
Exemple 3 :
Dans cet exemple, nous allons vérifier si un individu n’a reçu aucune communication au cours des dernières 24 heures. Nous allons filtrer la collection d’événements d’expérience récupérés à partir de la source de données Experience Platform, en utilisant deux expressions basées sur deux éléments de la collection. En particulier, l’horodatage de l’événement est comparé à la valeur dateTime renvoyée par la fonction nowWithDelta.
count(#{ExperiencePlatform.MarltonExperience.experienceevent.all(
currentDataPackField.directMarketing.sends.value > 0 and
currentDataPackField.timestamp > nowWithDelta(-1, "days")).timestamp}) == 0
Le résultat sera true si aucun événement d’expérience ne correspond aux deux conditions.
Exemple 4 :
Notre objectif ici est de vérifier si un individu a lancé au moins une application au cours des 7 derniers jours afin, par exemple, de déclencher une notification push l’invitant à démarrer un tutoriel.
count(
#{ExperiencePlatform.AnalyticsData.experienceevent.all(
nowWithDelta(-7,"days") <= currentDataPackField.timestamp
and currentDataPackField.application.firstLaunches.value > 0
)._id}) > 0
lors de la manipulation de collections de sources de données. Lors du traitement de collections avec les fonctions all, first et last, nous
les exécutons en boucle sur chaque élément de la collection. currentEventField et currentDataPackField
correspondent à l’élément exécuté en boucle.
Les fonctions « first(<condition>) » et « last(<condition>) »
Les fonctions first et last activent également la définition d’un filtre sur la collection, tout en renvoyant le premier/dernier élément de la liste qui correspond au filtre.
<listExpression>.first(<condition>)
<listExpression>.last(<condition>)
Exemple 1 :
Cette expression renvoie le premier jeton de notification push associé aux applications mobiles dont la version est égale à 1.0.
@{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.first(currentEventField.application.version == "1.0").token
Le résultat est « token_1 ».
Exemple 2 :
Cette expression renvoie le dernier jeton de notification push associé aux applications mobiles dont la version est égale à 1.0.
@{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.last​(currentEventField.application.version == "1.0").token}
Le résultat est « token_2 ».
- La fonction first renvoie l’événement le plus récent.
- La fonction last renvoie l’événement le plus ancien.
Exemple 3 :
Nous vérifions si la valeur du premier événement Adobe Analytics (le plus récent), dont l’ID DMA a une valeur non nulle, est égale à 602.
#{ExperiencePlatform.AnalyticsProd_EvarsProps.experienceevent.first(
currentDataPackField.placeContext.geo.dmaID > 0).placeContext.geo.dmaID} == 602
La fonction « at(<index>) »
La fonction at vous permet de référencer un élément spécifique d’une collection conformément à un index.
L’index 0 est le premier de la collection.
<listExpression>.at(<index>)
Exemple :
Cette expression renvoie le deuxième jeton de notification push de la liste.
@{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.at(1).token}
Le résultat est « token_2 ».
Autres exemples
#{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}
#{ExperiencePlatform.ExperienceEventFieldGroup.experienceevent.last(
currentDataPackField.eventType == "commerce.productListAdds").productListItems.last(currentDataPackField.priceTotal >= 150).name}