이 페이지에서: 데이터 집합 조회 활동을 사용하여 런타임에 Adobe Experience Platform 레코드 데이터 집합에서 데이터를 동적으로 검색하고 개인화 및 의사 결정을 위해 외부 데이터로 여정을 보강하는 방법에 대해 알아봅니다.
데이터 세트 조회 활동을 통해 런타임 중에 Adobe Experience Platform 레코드 데이터 세트에서 동적으로 데이터를 가져올 수 있습니다. 이 기능을 활용하면 프로필 또는 이벤트 페이로드에 없는 데이터에 액세스할 수 있게 되어 고객 상호 작용이 더 관련성 있게 알맞은 시간에 이루어지도록 할 수 있습니다.
주요 이점:
- 실시간 개인화: 보강된 데이터를 사용하여 고객 경험을 사용자 지정합니다.
- 동적 의사 결정: 외부 데이터를 사용하여 여정 논리와 작업을 실행합니다.
- 향상된 데이터 액세스: 특정 키에 연결된 제품 메타데이터, 가격 테이블 또는 관계형 데이터를 검색합니다.
반드시 알아야 할 사항 must-read
데이터 세트 조회를 구성하기 전에 이러한 요구 사항을 검토하십시오.
데이터 세트 활성화
Adobe Experience Platform에서 조회에 대해 데이터 집합을 사용하도록 설정해야 합니다. 자세한 정보는 이 섹션에서 확인할 수 있습니다. 사용 Adobe Experience Platform 데이터.
제한 및 제한 사항
- 데이터 세트당 최대 10개의 여정 조회 활동.
- 최대 20개의 선택된 필드.
- 조회 키 배열의 최대 50개 키.
- 보강된 데이터 크기는 10KB로 제한됩니다.
추가 성능 고려 사항
아래 권장 사항은 게재 기능의 지연을 방지하기 위한 지침입니다.
데이터 세트 조회 활동 구성 configure
데이터 집합 조회 활동을 구성하려면 다음 단계를 수행합니다.
-
Orchestration 범주를 펼친 다음 데이터 집합 조회 활동을 캔버스에 놓습니다.
여정에서 Adobe Experience Platform 데이터 집합 조회 활동
-
레이블과 설명을 추가합니다.
-
데이터 집합 필드에서 필요한 특성이 있는 데이터 집합을 선택합니다.
note NOTE 찾고 있는 데이터 세트가 목록에 표시되지 않는 경우 조회를 위해 활성화했는지 확인하십시오. 자세한 내용은 읽어야 함 섹션을 참조하십시오. -
데이터 세트에서 가져올 특정 필드를 선택합니다.
-
리프 노드(스키마의 최하위 레벨에 있는 필드)만 선택할 수 있습니다. 필드는 기본 값(문자열, 숫자, 부울, 날짜 등)이어야 합니다.
-
목록(배열) 및 맵(키-값 개체)을 선택할 수 없습니다.
accordion 예
-
-
조회 키 필드에서 결정 항목 특성과 데이터 세트 모두에 있는 조인 키를 선택합니다. 이 키는 시스템에서 선택한 데이터 세트에서 검색하는 데 사용됩니다.
-
키는 SKU, 이메일 ID 또는 기타 식별자와 같은 여정 컨텍스트에서 파생된 표현식일 수 있습니다. 예:
@profile.email또는list(@event{purchase_event.products.sku}) -
문자열 또는 문자열 목록만 지원됩니다.
note important IMPORTANT 고급 모드를 사용하여 조회 키를 정의해야 합니다. 단순 모드를 사용하여 키를 설정하면 데이터 집합 조회 활동 출력을 다운스트림 활동에서 컨텍스트 특성으로 사용할 수 없으며, 조건 활동에서 "데이터 집합 조회를 찾을 수 없음" 오류가 발생하여 @datasetLookup{}구문이 실패합니다.accordion 예
-
여정에서 보강된 데이터 사용
데이터 집합 조회 활동으로 검색된 데이터는 개체 배열로 여정 컨텍스트에 저장됩니다. 여정 표현식 편집기 및 개인화 편집기에서 사용할 수 있으며, 보강된 데이터를 기반으로 조건부 논리 및 개인화된 메시징을 가능하게 합니다.
-
여정 식 편집기:
고급 모드 편집기에 액세스하여
@datasetLookup{MyDatasetLookUpActivity1.entities}구문을 사용합니다. 고급 표현식 편집기로 작업하는 방법을 알아봅니다 -
Personalization 편집기:
{{context.journey.datasetLookup.1482319411.entities}}구문을 사용합니다.
사용 사례의 예
시나리오:Send 가정용품에 40달러 이상을 사용하는 사용자에게 쿠폰을 제공합니다.
여정 흐름:
-
구매 이벤트: 사용자의 장바구니에서 SKU를 캡처합니다.
-
데이터 집합 조회 활동:
- 데이터 집합:
products-dataset(기본 키로 SKU). - 조회 키:
list(@event{purchase_event.products.sku}). - 반환할 필드:
["SKU", "category", "price"].
- 데이터 집합:
-
조건 활동:
-
범주가 "세대"인 SKU를 필터링합니다.
code language-none @event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookupActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}
또는
-
가정용품에 대한 총 지출을 집계하여 $40 임계값과 비교합니다.
code language-none sum(@event{purchase_event.products.all( in(currentEventField.sku, @datasetlookup{MyDatasetLookUpActivity1.entities.all(currentDatasetLookupField.category == 'household').sku} ) )}.price}, ',', true ) > 40
-
-
Personalization 편집기:
보강된 데이터를 사용하여 이메일 콘텐츠를 개인화합니다.
code language-none {% let householdTotal = 0 %} {{#each journey.datasetlookup.3709000.entities as |product|}} {%#if get(product, "category") = "household"%} {% let householdTotal = householdTotal + product.price %}{%/if%} {{/each}} "Hi, thanks for spending " + {%= householdTotal %} + " on household products. Here is your reward!"
시나리오: 프로필의 충성도 상태가 플래티넘인 전자 메일 계정을 식별합니다. 이 시나리오에서는 충성도 계정이 이메일 ID와 연결되고, 충성도 데이터를 표준 프로필 조회 스토어에서 사용할 수 없습니다.
여정 흐름:
-
프로필 이벤트 트리거: 프로필 또는 이벤트 컨텍스트에서 전자 메일 ID를 캡처합니다.
-
데이터 집합 조회 활동:
- 데이터 집합:
loyalty-member-dataset(기본 키로 전자 메일). - 조회 키:
@profile.email. - 반환할 필드:
["email", "loyaltyTier"].
- 데이터 집합:
-
조건 활동:
충성도 계층을 기반으로 여정을 분기합니다.
code language-none @datasetLookup{MyDatasetLookUpActivity1.entity.loyaltyMember.loyaltyTier} == 'Platinum' -
Personalization 편집기:
보강된 충성도 계층 데이터를 사용하여 아웃바운드 통신을 개인화합니다.
code language-none {{context.journey.datasetLookup.1482319411.entity.loyaltyMember.loyaltyTier}}
문제 해결 troubleshooting
조건 활동의 “데이터 세트 조회를 찾을 수 없음” 오류 troubleshooting-not-found
증상: 데이터 세트 조회 활동이 여정에 올바르게 구성되어 있어도 조건 활동의 고급 표현식 편집기에서 @datasetLookup{} 구문이 “데이터 세트 조회를 찾을 수 없음” 오류를 반환합니다.
원인: 데이터 집합 조회 활동의 조회 키가 단순 모드를 사용하여 설정되었습니다. 고급 모드에서 키가 정의되지 않으면 활동 출력이 다운스트림 활동에서 컨텍스트 속성으로 노출되지 않습니다.
수정: 데이터 집합 조회 활동을 열고 조회 키 필드를 찾은 다음 고급 모드(으)로 전환하여 키 식을 다시 정의합니다. 활동을 저장하고 여정을 다시 게시합니다.
이 단원에는 이 주제와 관련된 해석, 검색 및 질문 답변을 지원하기 위한 구조화된 지식이 포함되어 있습니다.
이해를 돕기 위해 이 정보를 이 페이지의 설명서와 통합해야 합니다. 두 소스 모두 독립적으로 사용하기 위한 것은 아닙니다. 이 페이지에서는 기능에 대해 설명하지만, 용어, 의도, 적용 가능성 및 제약 조건을 명확히 하는 데 도움이 되는 추가 컨텍스트를 제공합니다.
- TL;DR: 이 페이지에서는 실시간 개인화 및 조건부 논리를 위해 여정 런타임 시 AEP 레코드 데이터 세트 데이터를 동적으로 검색하도록 데이터 세트 조회 활동을 구성하는 방법을 설명합니다.
의도:
- 런타임 시 외부 AEP 레코드 데이터를 가져오기 위해 여정에 데이터 세트 조회 활동을 추가합니다.
- 조회 중에 검색할 특정 데이터 세트 필드(리프 노드/기본 값)를 선택합니다
- 여정 컨텍스트를 데이터 세트 레코드와 연결하려면 고급 모드에서 조회 키를 정의하십시오.
- 여정 표현식 편집기 또는 개인화 편집기에서 보강된 데이터 세트 데이터 사용
- 조회 키에 단순 모드를 사용하여 발생한 “데이터 세트 조회를 찾을 수 없음” 오류 문제 해결
용어집:
- 데이터 집합 조회 활동: 조인 키 (제품별)를 사용하여 런타임에 AEP 레코드 데이터 집합에서 데이터를 검색하는 여정 오케스트레이션 활동
- 리프 노드: 기본 값(문자열, 숫자, 부울, 날짜) (제품별)을(를) 포함하는 스키마 계층 구조의 최하위 수준에 있는 필드
- 조회 키: 선택한 데이터 집합 (제품별)의 레코드에 대해 여정 컨텍스트 데이터를 일치시키는 데 사용되는 조인 식(문자열 또는 문자열 목록)
- 보강된 데이터: 데이터 집합 조회 활동으로 검색되고 다운스트림 활동 (제품별)에서 사용할 수 있도록 여정 컨텍스트에 일시적으로 저장된 데이터
보호 기능:
- 데이터 세트당 최대 10개의 여정 조회 활동.
- 조회 활동당 최대 20개의 선택된 필드.
- 조회 키 배열의 최대 50개 키.
- 보강된 데이터 크기는 10KB로 제한됩니다.
- 데이터 세트가 활동 구성에 표시되려면 먼저 Adobe Experience Platform에서 조회를 위해 활성화되어야 합니다.
- 리프 노드(기본 값)만 선택할 수 있으며 배열과 맵은 선택할 수 없습니다.
- 문자열 또는 문자열 목록만 조회 키로 지원됩니다.
- 조회 키는 고급 모드에서 정의해야 합니다. 단순 모드를 사용하면 활동 출력을 컨텍스트 속성 다운스트림으로 사용할 수 없습니다.
- 보강된 데이터는 일시적이며 여정 런타임 및 아웃바운드 활동 개인화 동안에만 사용할 수 있습니다.
- 최상의 성능을 위해 여정당 5개의 조회 활동으로 제한(권장). 시스템에서 적용하는 엄격한 제한은 여정당 10개의 활동입니다. 조회당 최대 20개의 속성도 권장됩니다.
용어:
- 정식 이름: 데이터 세트 조회 활동 — 약어: n/a — 변형: AEP 데이터 조회, 데이터 보강 활동
- 동의어: “조회 키” = “조인 키”
- 혼동하지 마십시오. “데이터 세트 조회 활동” ≠ “경험 이벤트 조회” — 데이터 세트 조회는 시계열 경험 이벤트가 아닌 레코드 데이터 세트 데이터를 검색합니다
FAQ:
- Q: 내 데이터 세트가 데이터 세트 필드 드롭다운에 표시되지 않는 이유는 무엇입니까? — Adobe Experience Platform에서 조회를 위해 데이터 세트를 활성화해야 합니다. 반드시 알아야 함 섹션의 지침에 따라 활성화합니다.
- Q:
@datasetLookup{}이(가) 조건에 “데이터 세트 조회를 찾을 수 없음” 오류를 반환하는 이유는 무엇입니까? — 조회 키가 고급 모드 대신 단순 모드를 사용하여 정의되었습니다. 고급 모드에서 다시 정의하고 여정을 다시 게시합니다. - Q: 데이터 집합에서 배열을 검색하거나 필드를 매핑할 수 있습니까? — 아니요. 원시 리프 노드 필드(문자열, 숫자, 부울, 날짜)만 선택할 수 있습니다.
- Q: 전자 메일의 보강된 데이터에 액세스하려면 어떻게 합니까? —
{{context.journey.datasetLookup.<activityId>.entities}}구문과 함께 개인화 편집기를 사용합니다. - Q: 보강된 데이터가 여정 종료 후 지속됩니까? — 아니요. 보강된 데이터는 일시적이며 여정 런타임 세션 중에만 사용할 수 있습니다.