[Premium]{class="badge positive" title="Target Premium에 포함된 내용을 확인합니다."}

Velocity을(를) 사용하여 디자인 사용자 지정

Last update: Sun Aug 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:

Adobe Target Recommendations에서 권장 사항 디자인을 사용자 지정하려면 공개 원본 Velocity 디자인 언어를 사용하십시오.

Velocity 개요 section_C431ACA940BC4210954C7AEFF6D03EA5

Velocity에 대한 정보는 https://velocity.apache.org에 있습니다.

모든 Velocity 논리, 구문 등을 권장 사항 디자인에 사용할 수 있습니다. 즉, JavaScript 대신 Velocity을(를) 사용하여 for 루프, if 문 및 기타 코드를 만들 수 있습니다.

productPage mbox 또는 CSV 업로드에서 Recommendations (으)로 전송된 엔터티 특성은 "다중 값" 특성을 제외하고 디자인에 표시할 수 있습니다. 모든 유형의 특성을 보낼 수 있지만, Target은(는) 형식이 "multi-value"인 특성을 템플릿을 반복할 수 있는 배열로 전달하지 않습니다(예: entityN.categoriesList).

이러한 값은 다음 구문으로 참조합니다.

$entityN.variable

엔터티 특성 이름은 선행 $ 문자 뒤에 Velocity 템플릿 언어(VTL) 식별자가 있는 Velocity 줄임 표기법을 따라야 합니다. VTL 식별자는 알파벳 문자(a-z 또는 A-Z)로 시작해야 합니다.

속도 엔티티 속성 이름은 다음 문자 유형으로 제한됩니다.

알파벳(a-z, A-Z)
숫자(0-9)
하이픈 ( - )
밑줄( _ )

다음 특성은 Velocity 배열로 사용할 수 있습니다. 따라서 색인을 통해 반복하거나 참조할 수도 있습니다.

entities
entityN.categoriesList

예:

#foreach ($category in $entity1.categoriesList)
<br/>$category
#end

또는

#if ($entities[0].categoriesList.size() >= 3 )
$entities[0].categoriesList[2]
#end

Velocity 변수(특성)에 대한 자세한 내용은 https://velocity.apache.org/engine/releases/velocity-1.7/user-guide.html#variables을(를) 참조하십시오.

디자인에서 프로필 스크립트를 사용하는 경우 스크립트 이름 앞에 있는 $는 \(백슬래시)로 이스케이프해야 합니다. 예:

\${user.script_name}

NOTE

하드 코딩되거나 루프를 통해 디자인에서 참조할 수 있는 최대 개체 수는 99개입니다. 템플릿 스크립트 길이는 최대 65,000자까지 포함할 수 있습니다.

예를 들어 다음과 유사한 내용을 표시하는 디자인을 원하는 경우,

velocity_example 이미지

다음 코드를 사용할 수 있습니다.

<table style="border:1px solid #CCCCCC;">
<tr>
<td colspan="3" style="font-size: 130%; border-bottom:1px solid
#CCCCCC;"> You May Also Like... </td>
</tr>
<tr>
<td style="border-right:1px solid #CCCCCC;">
<div class="search_content_inner" style="border-bottom:0px;">
<div class="search_title"><a href="$entity1.pageUrl"
style="color: rgb(112, 161, 0); font-weight: bold;">
$entity1.id</a></div>
By $entity1.message <a href="?x14=brand;q14=$entity1.message">
(More)</a><br/>
sku: $entity1.prodId<br/> Price: $$entity1.value
<br/><br/>
</div>
</td>
<td style="border-right:1px solid #CCCCCC; padding-left:10px;">
<div class="search_content_inner" style="border-bottom:0px;">
<div class="search_title"><a href="$entity2.pageUrl"
style="color: rgb(112, 161, 0); font-weight: bold;">
$entity2.id</a></div>
By $entity2.message <a href="?x14=brand;q14=$entity2.message">
(More)</a><br/>
sku: $entity2.prodId<br/>
Price: $$entity2.value
<br/><br/>
</div>
</td>
<td style="padding-left:10px;">
<div class="search_content_inner" style="border-bottom:0px;">
<div class="search_title"><a href="$entity3.pageUrl"
style="color: rgb(112, 161, 0); font-weight: bold;">
$entity3.id</a></div>
By $entity3.message <a href="?x14=brand;q14=$entity3.message">
(More)</a><br/>
sku: $entity3.prodId<br/> Price: $$entity3.value
<br/><br/>
</div>
</td>
</tr>
</table>

NOTE

속성 이름을 나타내는 태그 앞에 속성 값 뒤에 텍스트를 추가하려면 형식 표기법을 사용하여 속성 이름을 묶을 수 있습니다. 예: ${entity1.thumbnailUrl}.gif.

또한 디자인에서 algorithm.name 및 algorithm.dayCount을(를) 엔터티 특성으로 사용할 수 있으므로 하나의 디자인을 사용하여 여러 기준을 테스트할 수 있으며 기준 이름을 디자인에 동적으로 표시할 수 있습니다. 이는 방문자에게 자신이 "최상위 판매자" 또는 "이 항목을 본 사용자가 구매한 항목"을 검토 중임을 보여줍니다. 이러한 특성을 사용하여 dayCount("지난 2일 동안 최상위 판매자" 등과 같이 기준에 사용된 데이터의 일 수)을 표시할 수도 있습니다.

Velocity 템플릿의 숫자로 작업

기본적으로 Velocity 템플릿은 모든 엔터티 특성을 문자열 값으로 취급합니다. 계산 연산을 수행하거나 엔티티 속성을 다른 숫자 값과 비교하기 위해 엔티티 속성을 숫자 값으로 처리할 수 있습니다. 엔티티 속성을 숫자 값으로 처리하려면 다음 단계를 수행합니다.

더미 변수를 선언하고 임의의 정수 또는 이중 값으로 초기화합니다.
사용할 엔터티 특성이 비어 있지 않은지 확인합니다(Target Recommendations' 템플릿 파서가 템플릿을 확인하고 저장하는 데 필요).
1단계에서 만든 더미 변수의 parseInt 또는 parseDouble 메서드에 엔터티 특성을 전달하여 문자열을 정수 또는 이중 값으로 변환합니다.
새 숫자 값에 대한 연산 또는 비교를 수행합니다.

예: 할인 가격 계산

할인을 적용하기 위해 항목의 표시 가격을 $0.99만큼 낮추려고 한다고 가정합니다. 다음 접근 방식을 사용하여 이 결과를 얻을 수 있습니다.

#set( $double = 0.1 )

#if( $entity1.get('priceBeforeDiscount') != '' )
    #set( $discountedPrice = $double.parseDouble($entity1.get('priceBeforeDiscount')) - 0.99 )
    Item price: $$discountedPrice
#else
    Item price unavailable
#end

예: 항목 등급에 따라 표시할 별 수 선택

항목의 숫자 평균 고객 등급에 따라 적절한 수의 별표를 표시한다고 가정합니다. 다음 접근 방식을 사용하여 이 결과를 얻을 수 있습니다.

#set( $double = 0.1 )

#if( $entity1.get('rating') != '' )
    #set( $rating = $double.parseDouble($entity1.get('rating')) )
    #if( $rating >= 4.5 )
        <img src="5_stars.jpg">
    #elseif( $rating >= 3.5 )
        <img src="4_stars.jpg">
    #elseif( $rating >= 2.5 )
        <img src="3_stars.jpg">
    #elseif( $rating >= 1.5 )
        <img src="2_stars.jpg">
    #else
        <img src="1_star.jpg">
    #end
#else
    <img src="no_rating_default.jpg">
#end

예: 항목의 길이를 분 단위로 기반으로 시간(시, 분) 계산

동영상 길이를 분 단위로 저장하지만 시간 및 분 단위로 표시한다고 가정합니다. 다음 접근 방식을 사용하여 이 결과를 얻을 수 있습니다.

#if( $entity1.get('length_minutes') )
#set( $Integer = 1 )
#set( $nbr = $Integer.parseInt($entity1.get('length_minutes')) )
#set( $hrs = $nbr / 60)
#set( $mins = $nbr % 60)
#end

문자열 값에서 대체 수행 section_01F8C993C79F42978ED00E39956FA8CA

문자열 내의 값을 대체하도록 디자인을 수정할 수 있습니다. 예를 들어, 미국에서 사용되는 소수점 구분 기호를 유럽 및 기타 국가에서 사용되는 쉼표 구분 기호로 바꾸는 경우.

다음 코드는 조건부 판매 가격 책정 예제의 한 줄을 보여 줍니다.

<span class="price">$entity1.value.replace(".", ",") &euro;</span><br>

다음 코드는 판매 가격에 대한 완전한 조건부 예제입니다.

<div class="price">
    #if($entity1.hasSalesprice==true)
    <span class="old">Statt <s>$entity1.salesprice.replace(".", ",") &euro;</s></span><br>
    <span style="font-size: 10px; float: left;">jetzt nur</span> $entity1.value.replace(".", ",") &euro;<br> #else
    <span class="price">$entity1.value.replace(".", ",") &euro;</span><br> #end
    <span style="font-weight:normal; font-size:10px;">
                                        $entity1.vatclassDisplay
                                        <br/>
                                        $entity1.delivery
                                        <br>
                                    </span>

템플릿 크기 사용자 지정 및 빈 값 확인 default

다음 템플릿은 Velocity 스크립트를 사용하여 엔터티 표시의 동적 크기 조정을 제어하므로 Recommendations에서 반환된 일치하는 엔터티가 충분하지 않은 경우 빈 HTML 요소를 생성하지 않도록 일대다 결과를 사용합니다. 이 스크립트는 백업 권장 사항이 적합하지 않고 Partial Template Rendering이(가) 활성화된 시나리오에 가장 적합합니다.

다음 HTML 코드 조각은 4x2 기본 디자인에서 기존 HTML 부분을 대체합니다(간결성을 위해 CSS가 여기에 포함되지 않음).

다섯 번째 엔티티가 존재하는 경우 스크립트는 닫는 div를 삽입하고 <div class="at-table-row">가 포함된 새 행을 엽니다.
4x2를 사용하면 표시되는 최대 결과는 8이지만, 이 경우 $count <=8을 수정하여 더 작거나 더 큰 목록을 사용자 지정할 수 있습니다.
로직이 여러 행에 엔티티의 균형을 맞추지 않습니다. 예를 들어 5개 또는 6개의 엔티티를 표시하려는 경우 동적으로 맨 위에 3개, 맨 아래에 2개(또는 맨 위에 3개, 맨 아래에 3개)가 되지 않습니다. 상단 행에는 두 번째 행이 시작되기 전에 네 개의 항목이 표시됩니다.

<div class="at-table">
  <div class="at-table-row">
    #set($count=1)
    #foreach($e in $entities)
        #if($e.id != "" && $count < $entities.size() && $count <=8)
            #if($count==5)
                </div>
                <div class="at-table-row">
            #end
            <div class="at-table-column">
                <a href="$e.pageUrl"><img src="$e.thumbnailUrl" class="at-thumbnail" />
                    <br/>
                    <h3>$e.name</h3>
                    <br/>
                    <p class="at-light">$e.message</p>
                    <br/>
                    <p class="at-light">$$e.value</p>
                </a>
            </div>
            #set($count = $count + 1)
        #end
    #end
  </div>
</div>

recommendation-more-help

3d9ad939-5908-4b30-aac1-a4ad253cd654