컬렉션 관리 기능

표현식 언어에는 컬렉션을 쿼리할 수 있는 함수 집합도 소개합니다.

이러한 기능은 아래에 설명되어 있습니다. 다음 예에서 컬렉션을 포함하는 이벤트 페이로드를 사용하겠습니다.

                { 
   "_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).

데이터 소스 조건 활동에서 all 함수의 결과가 null인지 여부를 확인할 수 있습니다. 이 all 함수를 count 등의 다른 함수와 결합할 수도 있습니다. 자세한 내용은 데이터 소스 조건 활동을 참조하십시오.

예 1:

사용자가 특정 버전의 응용 프로그램을 설치했는지 확인합니다. 이와 관련하여 버전이 1.0인 모바일 응용 프로그램과 연결된 모든 푸시 알림 토큰을 가져옵니다. 그런 다음 count 함수를 사용하여 반환된 토큰 목록에 하나 이상의 요소가 포함되어 있는지 확인합니다.

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

결과는 사실이다.

예제 2:

여기에서 count 함수를 사용하여 컬렉션에 푸시 알림 토큰이 있는지 확인합니다.

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

결과는 참이다.

노트

all() 함수의 필터링 조건이 비어 있으면 필터는 목록의 모든 요소를 반환합니다. 그러나 컬렉션의 요소 수를 계산하기 위해 모든 함수가 필요하지 않습니다.

count(@{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
노트

currentEventField 은 이벤트 컬렉션과 currentDataPackField를 조작할 때만 사용할 수 있습니다.
데이터 소스 컬렉션을 조작할 때. all, firstlast​로 컬렉션을 처리할 때
컬렉션의 각 요소를 하나씩 루프합니다. currentEventFieldcurrentDataPackField
가 반복 중인 요소에 해당합니다.

"first(<condition>)" 및 "last(<condition>)" 함수

또한 firstlast 함수는 필터를 충족하는 목록의 첫 번째/마지막 요소를 반환하는 동안 컬렉션에 대한 필터 정의를 활성화합니다.

<listExpression>.first(<condition>)

<listExpression>.last(<condition>)

예 1:

이 표현식은 버전이 1.0인 모바일 응용 프로그램에 연결된 첫 번째 푸시 알림 토큰을 반환합니다.

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

결과는 "token_1"입니다.

예제 2:

이 표현식은 버전이 1.0인 모바일 응용 프로그램에 연결된 마지막 푸시 알림 토큰을 반환합니다.

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

결과는 "token_2"입니다.

노트

경험 이벤트는 Adobe Experience Platform에서 시간순 반대로 컬렉션으로 검색되므로

  • first 함수는 최신 이벤트를 반환합니다.
  • last 함수는 가장 오래된 것을 반환합니다.

예 3:

DMA ID에 대해 0이 아닌 값이 있는 첫 번째(가장 최근) Adobe Analytics 이벤트의 값이 602인지 여부를 확인합니다.

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

"at(<index>)" 함수

at 함수를 사용하면 인덱스에 따라 컬렉션의 특정 요소를 참조할 수 있습니다.
인덱스 0은 컬렉션의 첫 번째 인덱스입니다.

<listExpression>.at(<index>)

예제:

이 표현식은 목록의 두 번째 푸시 알림 토큰을 반환합니다.

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

결과는 "token_2"입니다.

이 페이지에서는