동적 조각 사용 dynamic-fragments

이 페이지에서: Adobe Journey Optimizer에서 동적 조각 해상도를 사용하여 프로필 특성, 데이터 세트 조회 또는 전송 시 전달된 컨텍스트 데이터를 기반으로 런타임 시 메시지에 삽입할 게시된 조각을 선택하는 방법을 알아봅니다.

Adobe Journey Optimizer은(는) 런타임에 동적 조각 확인​을(를) 지원하므로 전송 시 전달된 프로필 특성, 데이터 세트 조회 또는 컨텍스트 데이터를 기반으로 메시지에 삽입된 조각을 선택할 수 있습니다. 이렇게 하면 캠페인 또는 여정 논리를 복제하지 않고도 고도로 개인화된 콘텐츠를 사용할 수 있습니다.

개요 overview

정적 조각​은(는) 디자인 타임에 메시지에 포함됩니다. 모든 받는 사람에 대해 동일한 조각이 사용됩니다. 동적 조각​은(는) 받는 사람마다 런타임에 조각 ID를 확인합니다. 즉, 다른 프로필이 동일한 캠페인이나 여정 내에서 완전히 다른 콘텐츠 블록을 받을 수 있습니다.

동적 조각 ID는 다음 세 가지 소스에서 가져올 수 있습니다.

사전 요구 사항 prerequisites

동적 조각을 사용하기 전에 다음 사항이 준비되었는지 확인하십시오.

1단계: 조각 만들기 및 게시 create-fragment

조각을 동적으로 참조하기 전에 Journey Optimizer에 게시해야 합니다.

2단계: 동적 조각 참조를 사용하여 메시지 작성 author-message

개인화 편집기에서 다음 구문을 사용하여 동적 조각 자리 표시자를 삽입합니다.

{{fragment id=dynamic_fragment_id}}

식별자 dynamic_fragment_id은(는) 변수 이름입니다. 조각 조회가 수행되기 전에 해당 값을 확인해야 합니다. 데이터 세트 조회 표현식, 프로필 속성 또는 컨텍스트 데이터를 사용하여 해결합니다.

데이터 세트 조회에서 해결 resolve-from-dataset

조각 ID가 AEP 데이터 세트(예: 스타일-조각 매핑 테이블)에 저장된 경우 datasetLookup 도우미 함수를 사용하여 해결하십시오.

{{
  {datasetLookup datasetId="<your-dataset-id>" key=profile.style attribute="fragmentId"}
}}

{{fragment id=dynamic_fragment_id}}

이 예제에서 데이터 집합에는 스타일 값으로 처리된 행(예: style1)이 포함되어 있습니다. 지정된 프로필의 경우 조회가 해당 fragmentId 열 값을 검색하여 dynamic_fragment_id에 할당하면 해당 값을 사용하여 조각을 확인합니다.

컨텍스트 데이터에서 해결 resolve-from-context

전송 시 조각 ID가 API 요청 컨텍스트의 일부로 제공되는 경우 context 네임스페이스를 사용하여 이를 참조합니다.

{{fragment id=context.audiencePayload.fragmentId}}

경로 context.audiencePayload은(는) CSV 대상 파일에서 가져온 또는 API 요청 컨텍스트를 통해 전달된 모든 특성에 필요한 접두사입니다. CSV의 열 이름(예: fragmentId)이 접두사를 따릅니다.

프로필 속성에서 확인 resolve-from-profile

조각 ID가 Adobe Experience Platform에 프로필 속성으로 저장된 경우 다음을 직접 참조하십시오.

{{fragment id=profile.mi.fragmentId}}

3단계: 조회 접근 방식을 위한 데이터 세트 구성 configure-dataset

데이터 세트 조회 접근 방식을 사용하는 경우 데이터 세트 스키마 및 데이터를 업데이트하여 조각 ID를 전달합니다.

데이터 집합 구조 예:

4단계: 전송 시 컨텍스트 데이터 전달 pass-context-data

컨텍스트 데이터(예: CSV 대상 권장 사항 파일)에서 조각 ID를 해결하는 경우 필수 컨텍스트 접두사 아래의 API 요청에서 조각 ID를 전달하십시오.

캠페인 증명 API를 사용하는 경우 context 개체에 조각 ID를 포함하십시오.

{
  "recipients": [
    {
      "userId": "<profile-email>",
      "namespace": "email"
    }
  ],
  "inChannelData": {
    "channel": "email",
    "emailAddresses": ["<delivery-address>"]
  },
  "context": {
    "audiencePayload": {
      "fragmentId": "<published-fragment-id>",
      "systemSource": "<optional-system-value>"
    }
  }
}

접두사 context.audiencePayload이(가) 필요합니다. 라이브 캠페인을 실행할 때 이 키 맵 아래에 중첩된 속성을 CSV 대상 파일의 열에 직접 추가합니다.

5단계: 증명 및 유효성 검사 proof-validate

캠페인을 활성화하기 전에 캠페인 증명 API를 사용하여 동적 조각이 올바르게 확인되는지 그리고 렌더링된 이메일 출력이 예상대로 작동하는지 확인합니다.

Campaign API에 대한 자세한 내용은 Journey Optimizer API 설명서를 참조하세요.

가드레일 및 제한 사항 guardrails

동적 조각을 사용하는 경우 다음 제한 사항이 적용됩니다.

조각에 적용되는 추가 보호 기능은 이 섹션에서 사용할 수 있습니다.

오류 처리 error-handling

동적 조각이 런타임 시 해결되지 않으면 영향을 받는 프로필에 대한 제외 이벤트가 생성됩니다. 현재 모든 조각 렌더링 실패는 단일 총괄 오류 유형으로 분류됩니다.

조각 해결 오류를 디버깅하려면