개인화 추가 build-personalization-expressions

이 페이지에서: 개인화 편집기를 사용하여 프로필 특성, 대상, 오퍼 결정 및 컨텍스트 특성과 같은 소스에서 개인화 식을 추가, 사용자 지정 및 확인하는 방법을 알아봅니다.

개인화 편집기는 Journey Optimizer에서 개인화의 중심입니다. 이메일, 푸시 및 오퍼와 같은 개인화를 정의해야 하는 모든 컨텍스트에서 사용할 수 있습니다.

개인화 편집기 인터페이스에서 모든 데이터를 선택하고, 정렬하고, 맞춤화하고, 유효성을 검사하여 콘텐츠에 대한 맞춤화된 개인화를 만들 수 있습니다.

개인화를 추가할 수 있는 위치 where

개인화 추가 아이콘 아이콘을 사용하여 모든 필드의 Journey Optimizer​에 개인화를 추가할 수 있습니다. 자세한 내용을 보려면 아래 섹션을 확장하십시오.

메시지

메시지의 경우 제목 줄 필드와 같이 메시지의 다른 위치에 개인화를 추가할 수 있습니다.

콘텐츠의 다른 섹션에도 추가할 수 있습니다. 예를 들어 푸시 알림의 경우 제목, 본문, 사용자 지정 소리, 배지사용자 지정 데이터 필드에 개인화를 추가할 수 있습니다.

이메일 디자이너

전자 메일 Designer에서 전자 메일 콘텐츠를 편집할 때 상황별 도구 모음의 아이콘을 사용하여 대부분의 텍스트 요소에 개인화를 추가할 수 있습니다.

URL

Journey Optimizer을 사용하면 메시지에서 URL​을(를) 개인화할 수도 있습니다. 개인화된 URL은 프로필 속성에 따라 수신자를 웹사이트의 특정 페이지 또는 개인화된 마이크로사이트로 이동합니다. 자세히 알아보기

{width="50%"}

note
NOTE
URL 개인화는 외부 링크, 구독 취소 링크옵트아웃 유형의 링크에서 사용할 수 있습니다.
이메일 구성
이메일 채널 구성을 만들 때 하위 도메인, 헤더 및 URL 추적 매개 변수에 대해 개인화된 값을 정의할 수 있습니다. 자세히 알아보기
오퍼
오퍼 표시​에서 텍스트 유형 콘텐츠를 사용할 때 개인화를 추가할 수 있습니다. 개인화된 오퍼를 만드는 방법을 알아봅니다

Personalization 소스 sources

탐색 창에서는 개인화를 위한 소스를 선택할 수 있습니다. 사용 가능한 소스는 다음과 같습니다.

NOTE
작성 워크플로우를 사용하여 생성된 보강 속성을 사용하여 대상자를 타겟팅하는 경우 이러한 보강 속성을 활용하여 메시지를 개인화할 수 있습니다. 대상 데이터 보강 특성을 사용하는 방법을 알아보세요

개인화 추가 add

중앙 작업 영역은 개인화 구문을 작성하는 위치입니다. 특성을 사용하여 메시지를 개인화하려면 왼쪽 탐색 창에서 특성을 찾은 다음 + 단추를 클릭하여 식에 추가하십시오.

+ 아이콘 옆에 있는 줄임표 메뉴를 사용하면 각 속성에 대한 자세한 내용을 확인하고 자주 사용하는 특성을 즐겨찾기에 추가할 수 있습니다. 즐겨찾기에 추가된 특성은 탐색 창의 즐겨찾기 메뉴에서 액세스할 수 있습니다.

NOTE
기본적으로 속성 창에는 채워진 속성만 표시됩니다. 모든 특성을 표시하려면 검색 필드 위에 있는 단추를 선택하고 채워진 특성만 표시 옵션을 끄십시오.

또한 문자열 유형 프로필 속성이 비어 있는 경우 표시될 기본 대체 텍스트를 정의할 수 있습니다. 이렇게 하려면 특성 옆에 있는 줄임표 버튼을 클릭하고 대체 텍스트로 삽입​을 선택합니다. 프로필에 대한 특성 값이 비어 있는 경우 기본적으로 표시되는 텍스트를 작성한 다음 추가​를 클릭합니다.

다음 예에서는 개인화 편집기를 사용하여 생일이 오늘 인 프로필을 선택한 다음 해당 요일에 해당하는 특정 오퍼를 삽입하여 맞춤화를 완료할 수 있습니다.

표현식 편집 옵션 options

중앙 작업 영역은 개인화 표현식을 작성하는 데 도움이 되는 다양한 도구를 제공합니다.

사용 가능한 옵션은 다음과 같습니다.

  1. 찾기 / 찾기 및 바꾸기: 식을 검색하고 코드 부분을 자동으로 바꿉니다.

  2. 실행 취소 / 다시 실행: 마지막 작업을 실행 취소/다시 실행합니다.

  3. 자동 완성: 입력할 때 코드를 자동으로 제안하고 완료합니다. 이 기능은 HTML 및 텍스트 형식에서만 사용할 수 있으며 프로필 및 컨텍스트 속성을 지원합니다. 이 옵션을 토글하여 비활성화하면 편집기는 기본 HTML 코드 자동 완성 기능을 대신 제공합니다.

    {align="center" width="70%" modal="regular"}

  4. HTML / JSON / 텍스트: 코드 형식을 식별합니다. 이렇게 하면 시스템이 선택한 언어를 기반으로 유효성 검사 및 자동 완성 기능을 조정할 수 있습니다.

  5. 유효성 검사: 식의 구문을 확인하십시오. 자세한 내용은 이 섹션을 참조하십시오.

  6. 조각으로 저장: 표현식을 표현식 조각으로 저장합니다. 이 섹션에서 자세히 알아보기

  7. 글꼴 크기: 가독성을 높이기 위해 편집기 내의 콘텐츠 글꼴 크기를 조정합니다.

  8. 자동 줄 바꿈: 자동 줄 바꿈을 사용하거나 사용하지 않도록 설정하여 긴 식을 한 줄에 표시하거나 편집기 내에서 줄 바꿈할 수 있습니다. 옵션은 다음과 같습니다.

    • 해제(기본값) - 줄 바꿈이 없습니다. 긴 줄은 편집기 보기를 넘어 확장되므로 수평 스크롤이 필요합니다.
    • On - 편집기 너비의 줄을 줄바꿈합니다.
    • 줄 바꿈 열 - 줄 문자가 80자에 도달하면 줄을 바꿈합니다.
    • Bounded - 편집기 너비 또는 80자 중 더 작은 문자를 줄바꿈합니다.
  9. 알약: 특성을 작은 "알약"으로 표시하여 긴 특성 경로를 숨겨서 가독성을 향상시킵니다. 속성을 클릭하여 전체 경로를 표시합니다.

    note
    NOTE
    이 옵션은 프로필 속성, 컨텍스트 속성 및 다이내믹 미디어에만 사용할 수 있습니다.

탐색 창에서는 개인화 표현식을 작성하는 데 도움이 되는 추가 기능을 사용할 수 있습니다.

  • 도우미 함수 - 도우미 함수를 사용하면 계산, 데이터 서식 또는 전환, 조건 등 데이터에 대한 작업을 수행하고 개인 맞춤화의 컨텍스트에서 조작할 수 있습니다. 사용 가능한 도우미 기능에 대해 자세히 알아보기

  • 즐겨찾기 - 즐겨찾기에 추가한 특성이 이 목록에 표시됩니다. 이를 통해 가장 자주 사용하는 항목에 빠르게 액세스할 수 있습니다. 즐겨찾기에 특성을 추가하려면 줄임표 메뉴를 클릭하고 즐겨찾기에 추가​를 선택하십시오.

  • 조건 - 라이브러리에서 만든 조건부 규칙을 활용하여 동적 콘텐츠를 메시지에 추가합니다. 이를 통해 조건을 기반으로 메시지의 여러 변형을 만들 수 있습니다. 동적 콘텐츠를 만드는 방법을 알아봅니다

  • 조각 - 현재 샌드박스에 생성되거나 저장된 표현식 조각을 활용합니다. 조각은 Journey Optimizer 캠페인 및 여정에서 참조할 수 있는 재사용 가능한 구성 요소입니다. 이 기능을 사용하면 마케팅 사용자가 개선된 디자인 프로세스에서 콘텐츠를 빠르게 조합하는 데 사용할 수 있는 여러 사용자 지정 콘텐츠 블록을 미리 빌드할 수 있습니다. 개인화에 식 조각을 사용하는 방법을 알아봅니다

TIP
바로 사용할 수 있는 표현식을 찾고 계십니까? Personalization 레서피 페이지에서는 날짜 형식 지정, 카운트다운 타이머, 조건부 폴백, 시간 전용 표시 등의 가장 일반적인 사용 사례에 대한 복사 붙여넣기 패턴을 제공합니다.

개인화 표현식이 준비되면 개인화 편집기에서 유효성을 검사해야 합니다. 자세한 내용은 이 섹션을 참조하십시오.

유효성 검사 메커니즘 validation-mechanisms

편집기 창을 닫으려면 추가 단추를 클릭하면 식의 유효성 검사가 자동으로 실행됩니다. 유효성 검사 단추를 사용하여 개인화 구문을 확인할 수도 있습니다.

아래 섹션을 확장하여 개인화를 확인할 때 발생할 수 있는 일반적인 오류를 확인합니다.

일반적인 오류
  • 경로 "XYZ"를 찾을 수 없음

스키마에 정의되지 않은 필드를 참조하려고 할 때

이 경우 firstName1​은(는) 프로필 스키마에 특성으로 정의되어 있지 않습니다.

code language-none
{{profile.person.name.firstName1}}
  • 변수 "XYZ"에 대한 형식이 일치하지 않습니다. 배열이 필요합니다. 문자열을 찾았습니다.

배열 대신 문자열을 반복하려고 할 때.

이 경우 product​은(는) 배열이 아닙니다.

code language-none
{{each profile.person.name.firstName as |product|}}
 {{product.productName}}
{{/each}}
  • 잘못된 Handlebars 구문입니다.'[XYZ}}'​을(를) 찾음

잘못된 Handlebars 구문이 사용되는 경우.

Handlebars 식은 {{expression}}(으)로 둘러싸여 있습니다.

code language-none
   {{[profile.person.name.firstName}}
  • 잘못된 세그먼트 정의
code language-none
No segment definition found for 988afe9f0-d4ae-42c8-a0be-8d90e66e151

오퍼의 경우 특정 오류가 발생할 수 있습니다. 자세한 내용을 보려면 아래 섹션을 확장하십시오.

오퍼와 관련된 특정 오류

이메일 또는 푸시 메시지의 오퍼 통합과 관련된 오류의 패턴은 다음과 같습니다.

code language-none
Offer.<offerType>.[PlacementID].[ActivityID].<offer-attribute>

유효성 검사는 개인화 편집기에서 개인화 콘텐츠를 확인하는 동안 수행됩니다.

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
오류 제목 유효성 검사/해결 방법
ID placementID 및 유형 OfferPlacement의 리소스를 찾을 수 없음
ID activityID 및 유형의 리소스를 찾을 수 없음
ActivityID 및/또는 PlacementID를 사용할 수 있는지 확인
리소스를 확인할 수 없습니다. 배치의 componentType은 offerType 오퍼와 일치해야 합니다.
공개 URL이 offerId에 없습니다. 이미지 오퍼(결정 및 배치 쌍과 연결된 모든 개인화된 및 폴백)에는 공개 URL이 채워져 있어야 합니다(deliveryURL은 비어 있지 않아야 함).
결정에 프로필이 아닌 속성이 포함되어 있습니다. 오퍼 모델 사용에는 프로필 속성만 포함되어야 합니다.
결정 사용을 가져오는 도중 오류가 발생했습니다. 이 오류는 API가 오퍼 모델을 가져오려고 할 때 발생할 수 있습니다.
오퍼 속성 offer-attribute가 잘못되었습니다. 오퍼 DRP에서 참조된 오퍼 속성이 유효한지 확인합니다. 다음은 유효한 속성입니다.
이미지: deliveryURL, linkURL
텍스트: 콘텐츠
HTML: 콘텐츠

빠른 참조 quick-reference

이 단원에는 이 주제와 관련된 해석, 검색 및 질문 답변을 지원하기 위한 구조화된 지식이 포함되어 있습니다.

이해를 돕기 위해 이 정보를 이 페이지의 설명서와 통합해야 합니다. 두 소스 모두 독립적으로 사용하기 위한 것은 아닙니다. 이 페이지에서는 기능에 대해 설명하지만, 용어, 의도, 적용 가능성 및 제약 조건을 명확히 하는 데 도움이 되는 추가 컨텍스트를 제공합니다.

개요

TL;DR

이 페이지에서는 Journey Optimizer 개인화 편집기를 사용하여 프로필 속성, 대상, 오퍼 의사 결정 및 컨텍스트 속성을 포함한 소스에서 개인화 표현식을 선택, 빌드, 사용자 정의 및 확인하는 방법을 설명합니다.

의도

  • Journey Optimizer에서 개인화를 추가할 수 있는 위치 이해(메시지, 이메일 Designer, URL, 이메일 구성, 오퍼)
  • 표현식에 적합한 개인화 소스 선택
  • 편집기 작업 영역에서 속성 추가 및 표현식 작성
  • 편집기 도구 사용: 찾기/바꾸기, 자동 완성, 유효성 검사, 알약, 조각으로 저장
  • 탐색 창 기능 사용: 도우미 기능, 즐겨찾기, 조건, 조각
  • 표현식의 유효성 검사 및 일반적인 오류 해결
용어집
  • Personalization 편집기: 개인화 표현식을 작성, 사용자 지정 및 확인하기 위한 Journey Optimizer의 중앙 UI 도구입니다. 개인화를 정의할 수 있는 모든 위치에서 사용할 수 있습니다. (제품별)
  • Personalization 소스: 식을 만드는 데 사용할 수 있는 데이터 범주(프로필 특성, 타겟 특성, 대상, 오퍼 결정 및 컨텍스트 특성)입니다.
  • 컨텍스트 특성: 여정 또는 캠페인별 데이터(이벤트, 속성, 사용자 지정 작업 응답)는 여정 또는 캠페인에서 채널 작업을 사용하는 경우에만 개인화에 사용할 수 있습니다. (제품별)
  • 알약: 가독성을 개선하기 위해 긴 특성 경로를 압축되고 클릭 가능한 토큰으로 렌더링하는 개인화 편집기 표시 모드입니다. 프로필 속성, 컨텍스트 속성 및 다이내믹 미디어에만 사용할 수 있습니다. (제품별)
  • 자동 완성: 입력할 때 코드를 자동으로 제안하고 완료하는 편집기 기능입니다. HTML 및 텍스트 형식에만 사용할 수 있으며 프로필 및 컨텍스트 특성만 지원합니다. (제품별)
  • 표현식 조각: 캠페인 및 여정 전반에서 참조할 수 있는 재사용 가능한 개인화 표현식 구성 요소입니다. (제품별)
  • 대체 텍스트: 지정된 프로필에 대해 문자열 유형 프로필 특성이 비어 있을 때 표시되는 기본 문자열입니다. "대체 텍스트로 삽입"을 통해 특성별로 구성됩니다.
용어
  • 표준 이름: 개인화 편집기
  • 혼동하지 마십시오. Personalization 편집기(메시지, 이메일, 푸시 알림 및 오퍼에서 콘텐츠 식을 만드는 데 사용됨 - Handlebars 및 PQL 구문 모두 지원)≠ 고급 표현식 편집기(데이터 소스 및 이벤트 정보에 대한 조건, 사용자 지정 대기 활동 및 작업 매개 변수 매핑에 대한 여정에서 사용됨 - 개인화 편집기와 다른 기본 제공 함수 및 연산자를 제공합니다.)
  • 프로필 특성(XDM 스키마 기반, 모든 컨텍스트에서 사용 가능) ≠ 컨텍스트 특성(여정/캠페인별, 해당 컨텍스트에서만 사용 가능) ≠ Target 특성(오케스트레이션된 캠페인만 해당)
  • 혼동하지 마십시오: HTML/Text에 대한 자동 완성(개인화 특성 완성 제안) ≠ 기본 HTML 코드 자동 완성(토글이 비활성화될 때 편집기 기본값)
보호 기능 및 제한 사항
  • 자동 완성은 HTML 및 텍스트 형식에만 사용할 수 있으며 프로필 및 컨텍스트 속성만 지원합니다.
  • 환약 표시 모드는 프로필 속성, 컨텍스트 속성 및 다이내믹 미디어에만 사용할 수 있습니다.
  • URL 개인화는 외부 링크, 구독 취소 링크 및 옵트아웃 링크 유형에만 사용할 수 있습니다.
  • 기본적으로 속성 창에는 채워진 속성만 표시됩니다. 모든 스키마 속성을 표시하려면 "채워진 속성만 표시"를 끄십시오.
  • 오퍼 모델 사용에는 프로필 속성만 포함되어야 합니다. 의사 결정에 프로필이 아닌 속성이 있으면 유효성 검사 오류가 발생합니다.
FAQ

Q: Journey Optimizer에서 개인화를 추가할 수 있는 위치는 어디입니까?

이메일 제목 줄, 푸시 알림 필드(제목, 본문, 사용자 정의 사운드, 배지, 사용자 정의 데이터), 이메일 Designer 텍스트 요소, URL(외부 링크, 구독 취소 링크, 옵트아웃), 이메일 구성 하위 도메인/헤더/URL 추적 매개 변수 및 오퍼 텍스트 유형 표시를 포함하여 개인화 추가 아이콘이 있는 모든 필드.

Q: 사용 가능한 개인화 원본은 무엇입니까?

프로필 속성, 타겟 속성(오케스트레이션된 캠페인만 해당), 대상, 오퍼 의사 결정 및 컨텍스트 속성(여정/캠페인 이벤트 및 사용자 지정 작업 응답)입니다.

Q: 식을 확인하는 방법은 무엇입니까?

추가 를 클릭하여 편집기를 닫으면 유효성 검사가 자동으로 실행됩니다. 유효성 검사 버튼을 사용하여 수동으로 트리거할 수도 있습니다. 일반적인 오류: 경로를 찾을 수 없음(스키마에 필드가 없음), 유형 불일치(문자열을 배열로 반복), 잘못된 Handlebars 구문 및 잘못된 세그먼트 정의.

Q: 알약 옵션은 어떤 기능을 합니까?

편집기에서 가독성을 높이기 위해 긴 속성 경로를 압축되고 클릭 가능한 토큰으로 렌더링합니다. 프로필 속성, 컨텍스트 속성 및 다이내믹 미디어에만 사용할 수 있습니다.

Q: 특성 창에 일부 특성만 표시되는 이유는 무엇입니까?

기본적으로 창에는 채워진 속성만 표시됩니다. 검색 필드 위에 있는 설정 아이콘을 선택하고 "채워진 속성만 표시"를 끄면 모든 스키마 속성이 표시됩니다.

recommendation-more-help
journey-optimizer-help