Funzioni di gestione delle raccolte collection-management-functions
Il linguaggio delle espressioni introduce anche un set di funzioni per le raccolte di query.
Queste funzioni sono descritte di seguito. Negli esempi seguenti, utilizziamo il payload dell’evento contenente una raccolta:
{
"_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"
}
Funzione "all(<condition>)"
La funzione all abilita la definizione di un filtro per una determinata raccolta utilizzando un'espressione booleana.
<listExpression>.all(<condition>)
Ad esempio, tra tutti gli utenti dell’app, puoi ottenere quelli che utilizzano IOS 13 (espressione booleana "app utilizzata == IOS 13"). Il risultato di questa funzione è l’elenco filtrato contenente gli elementi che corrispondono all’espressione booleana (ad esempio: utente app 1, utente app 34, utente app 432).
In un'attività Condizione Data Source è possibile verificare se il risultato della funzione all è nullo o meno. È inoltre possibile combinare questa funzione all con altre funzioni quali count. Per ulteriori informazioni, vedere Attività condizione Data Source.
Esempio 1:
Vogliamo verificare se un utente ha installato una versione specifica di un’applicazione. Per questo otteniamo tutti i token di notifica push associati alle applicazioni mobili per le quali la versione è 1.0. Quindi eseguiamo una condizione con la funzione count per verificare che l'elenco di token restituito contenga almeno un elemento.
count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all(currentEventField.application.version == "1.0").token}) > 0
Il risultato è vero.
Esempio 2:
In questo caso, usiamo la funzione count per verificare se la raccolta contiene token di notifica push.
count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.all().token}) > 0
Il risultato sarà vero.
count(@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.token})
Il risultato dell'espressione è 3.
Esempio 3:
Qui controlliamo se un individuo non ha ricevuto alcuna comunicazione nelle ultime 24 ore. La raccolta di eventi di esperienza recuperata dall’origine dati di Experience Platform viene filtrata utilizzando due espressioni basate su due elementi della raccolta. In particolare, la marca temporale dell'evento viene confrontata con la data/ora restituita dalla funzione nowWithDelta.
count(#{ExperiencePlatform.MarltonExperience.experienceevent.all(
currentDataPackField.directMarketing.sends.value > 0 and
currentDataPackField.timestamp > nowWithDelta(-1, "days")).timestamp}) == 0
Il risultato sarà vero se non c’è un evento esperienza che corrisponde alle due condizioni.
Esempio 4:
Qui vogliamo verificare se un singolo utente ha avviato un’applicazione almeno una volta negli ultimi 7 giorni, ad esempio per attivare una notifica push che invita l’utente ad avviare un’esercitazione.
count(
#{ExperiencePlatform.AnalyticsData.experienceevent.all(
nowWithDelta(-7,"days") <= currentDataPackField.timestamp
and currentDataPackField.application.firstLaunches.value > 0
)._id}) > 0
Funzioni "first(<condition>)" e "last(<condition>)"
Le funzioni first e last abilitano inoltre la definizione di un filtro nella raccolta restituendo il primo/ultimo elemento dell'elenco che soddisfa il filtro.
<listExpression>.first(<condition>)
<listExpression>.last(<condition>)
Esempio 1:
Questa espressione restituisce il primo token di notifica push associato alle applicazioni mobili la cui versione è 1.0.
@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.first(currentEventField.application.version == "1.0").token
Il risultato è "token_1".
Esempio 2:
Questa espressione restituisce l’ultimo token di notifica push associato alle applicazioni mobili la cui versione è 1.0.
@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.last(currentEventField.application.version == "1.0").token}
Il risultato è "token_2".
- La funzione first restituirà l'evento più recente
- La funzione last restituirà quella meno recente.
Esempio 3:
Verifichiamo se il primo evento Adobe Analytics (più recente) con un valore diverso da zero per l’ID DMA ha un valore uguale a 602.
#{ExperiencePlatform.AnalyticsProd_EvarsProps.experienceevent.first(
currentDataPackField.placeContext.geo.dmaID > 0).placeContext.geo.dmaID} == 602
Funzione "at(<index>)"
La funzione at consente di fare riferimento a un elemento specifico di una raccolta in base a un indice.
L'indice 0 è il primo indice della raccolta.
<listExpression>.at(<index>)
Esempio:
Questa espressione restituisce il secondo token di notifica push dell’elenco.
@event{LobbyBeacon._experience.campaign.message.profile.pushNotificationTokens.at(1).token}
Il risultato è "token_2".
Altri esempi
Questa espressione restituisce i nomi dei prodotti in base al valore SKU. L’elenco di questi prodotti è incluso nell’elenco degli eventi, con la condizione che è l’ID evento.
#{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}
Questa espressione recupera il nome dell’ultimo prodotto nell’elenco dei prodotti di un evento commerciale in cui il tipo di evento è "productListAdds" e il prezzo totale è maggiore o uguale a 150.
#{ExperiencePlatform.ExperienceEventFieldGroup.experienceevent.last(
currentDataPackField.eventType == "commerce.productListAdds").productListItems.last(currentDataPackField.priceTotal >= 150).name}