개인화 구문 personalization-syntax

Journey Optimizer의 Personalization은 동일한 식에서 함께 작동하는 두 개의 보조 구문을 사용합니다.

현재 있는 컨텍스트를 이해하는 것은 런타임 오류를 방지하는 데 중요합니다. 예를들어, Handlebars가 이 함수를 PQL 식으로 계산하지 않고 도우미로 확인하려고 하므로 {{...}} 내부에 배치된 PQL 함수 호출이 실패합니다.

예

속성 구조는 Adobe Experience Platform XDM 스키마에서 정의됩니다. 자세히 알아보기.

구문 일반 규칙 general-rules

예약된 키워드 reserved-keywords

특정 키워드는 Profile Query Language(PQL)에서 예약되어 개인화 표현식에서 필드 또는 변수 이름으로 직접 사용할 수 없습니다. XDM 스키마에 예약된 키워드와 일치하는 이름을 가진 필드가 포함된 경우 백틱(`)을 사용하여 이스케이프 처리하여 식에서 참조해야 합니다.

예약된 키워드는 다음과 같습니다.

예:

프로필 스키마에 이름이 next인 필드가 있는 경우 백틱으로 래핑해야 합니다.

{{profile.person.`next`.name}}

백틱스가 없으면 오류가 발생하여 개인화 편집기의 유효성 검사가 실패합니다.

특수 속성 키에 대한 PQL 구문 규칙 pql-special-keys

예약된 키워드 외에 두 개의 추가 사례에서는 PQL 표현식에서 백틱 이스케이프가 필요합니다.

하이픈 넣기 속성 키 hyphenated-keys

XDM 스키마에 하이픈이 있는 필드 이름(예: my-field, event-type)이나 숫자로 시작하거나 숫자가 들어 있는 이름이 포함된 경우 PQL 식 내의 백틱으로 키를 래핑하십시오.

{%= profile.events.`order-total` > 100 %}

PQL 표현식에 백틱이 없으면 하이픈이 빼기 연산자로 해석되어 PQL 구문 오류가 발생합니다.

컨텍스트 속성의 숫자 이벤트 ID numeric-event-ids

이벤트 ID가 숫자인 컨텍스트 이벤트 특성을 참조할 때(예: 1697323153) 백틱으로 래핑하십시오. 이는 formatDate()과(와) 같은 함수 내에도 적용됩니다.

{% let ts = formatDate(toDateTime(context.journey.events.`1697323153`.timestamp), "dd/MM/yyyy") %}
{{ts}}

문자 강제 변환 type-coercion

PQL은 강력한 형식입니다. 값을 비교하거나 전달할 때 양쪽이 같은 유형이어야 합니다. 일반적인 사례:

사용 가능한 네임스페이스 namespaces

도우미 helpers-all

Handlebars 도우미는 매개 변수 뒤에 올 수 있는 간단한 식별자입니다. 각 매개 변수는 Handlebars 표현식입니다. 이러한 도우미는 템플릿의 모든 컨텍스트에서 액세스할 수 있습니다.

이러한 블록 도우미는 도우미 이름 앞에 #이(가) 있어 같은 이름의 일치하는 닫는 /이(가) 필요합니다.

블록은 블록 열기({{# }})와 닫기({{/}})가 있는 식입니다.

도우미 함수에 대한 자세한 내용은 이 섹션을 참조하세요.

리터럴 유형 literal-types

Adobe Journey Optimizer은(는) 다음 리터럴 형식을 지원합니다.

모범 사례 best-practices

개인화 표현식을 작성하기 전에 이러한 구문 규칙을 검토하십시오. 대부분의 런타임 오류는 Handlebars와 PQL 컨텍스트를 혼합하여 발생합니다.

올바른 조건부 블록 구문을 사용하십시오

항상 {%#if%} / {%else if%} / {%else%} / {%/if%}을(를) 사용하십시오. {% if %} / {% elseif %} / {% endif %} 구문은 지원되지 않습니다.

{%#if profile.loyalty.tier = "gold"%}
Gold member content
{%else if profile.loyalty.tier = "silver"%}
Silver member content
{%else%}
Default content
{%/if%}

Handlebars 블록 {{...}}에서 PQL 함수를 호출하지 마십시오

{{...}}은(는) Handlebars 변수 및 도우미만 확인하며 PQL은 평가하지 않습니다. {{...}} 내에 upperCase()과(와) 같은 PQL 함수를 래핑하면 “도우미를 찾을 수 없습니다” 오류가 발생합니다. 대신 {%= ... %}을(를) 사용합니다.

{{#each}}을(를){%#if%}​과(와) 결합할 때 명명된 루프 별칭을 사용합니다.

this.field은(는) Handlebars 렌더러에서 확인되지만 {%#if%} 조건 내에서 PQL 평가기에서 확인하지 않습니다. 두 컨텍스트에서 필드를 확인할 수 있도록 as |item|(으)로 명명된 별칭을 정의합니다.

{{#each profile.orders as |order|}}
  {%#if order.status = "pending"%}
  Order {{order.id}} is pending.
  {%/if%}
{{/each}}

반복하기 전에 변수에 PQL 함수 결과 할당

topN과(와) 같은 PQL UDF는 {{#each}} 내에서 직접 호출할 수 없습니다. 먼저 {% let %}(으)로 평가한 다음 결과를 반복합니다.

{% let topOrders = topN(profile.orders, price, 3) %}
{{#each topOrders}}
  {{this.name}} — {{this.price}}€
{{/each}}

반복적인 함수 호출을 방지하려면 {% let %}을(를) 사용합니다

계산된 값이 두 번 이상 필요한 경우 변수에 저장합니다. 이렇게 하면 가독성이 향상되고 평가가 중복되지 않습니다.

{% let cleanName = replaceAll(profile.person.name.firstName, "[^a-zA-Z]", "") %}
Hi {{cleanName}}, your code is: WELCOME-{%= upperCase(cleanName) %}

올바른 인수 순서를 사용하여dateDiff

dateDiff(start, end)이(가) 먼저 이전 날짜를 사용합니다. 미래 날짜까지 남은 일 수를 계산하려면 현재 날짜를 첫 번째 인수로 전달합니다.

{% let daysLeft = dateDiff(getCurrentZonedDateTime(), stringToDate(profile.loyalty.expiryDate)) %}

PQL의 같음 비교에==​이(가) 아닌 =을(를) 사용합니다.

PQL에서는 같음을 위해 단일 = 연산자를 사용합니다. ==을(를) 사용하면 구문 오류가 발생합니다.

하이픈이 있는 필드 이름에 백틱 사용 - PQL 식에서만 사용

XDM 스키마 필드 이름에 하이픈(예: order-total)이 포함된 경우 백틱으로 래핑하여 하이픈이 빼기 연산자로 구문 분석되지 않도록 하십시오. {%= ... %} PQL 식에서만 지원되며 {{...}} Handlebars 블록에서는 지원되지 않습니다.

{%= profile.events.`order-total` > 100 %}

바로 사용할 수 있는 표현식을 콘텐츠로 직접 복사하려면 Personalization 레시피를 참조하십시오.