[Premium]{class="badge positive" title="Découvrez les fonctionnalités incluses dans Target Premium."}

Personnalisation d’une conception à l’aide de Velocity

Utilisez le langage de conception Open Source Velocity pour personnaliser les conceptions de recommandations dans Adobe Target Recommendations.

Velocity - Aperçu section_C431ACA940BC4210954C7AEFF6D03EA5

Vous trouverez des informations sur Velocity à l'adresse https://velocity.apache.org.

Toute la logique, la syntaxe et ainsi de suite Velocity peut être utilisée pour une conception de recommandation. Cela signifie que vous pouvez créer des boucles for, des instructions if et d’autres codes à l’aide de Velocity plutôt que de JavaScript.

Les attributs d’entité envoyés à Recommendations dans la mbox productPage ou le transfert CSV peuvent être affichés dans une conception, à l’exception des attributs "à plusieurs valeurs". N’importe quel type d’attribut peut être envoyé. Cependant, Target ne transmet pas d’attributs de type "multi-valeur" en tant que tableau sur lequel un modèle peut itérer (par exemple entityN.categoriesList).

Ces valeurs sont référencées par la syntaxe suivante :

$entityN.variable

Les noms d’attributs d’entité doivent suivre la notation abrégée Velocity, qui consiste en un caractère $ de début, suivi d’un identifiant de langage de modèle (VTL) Velocity. L’identifiant VTL doit commencer par un caractère alphabétique (a-z ou A-Z).

Les noms d’attributs d’entité Velocity sont limités aux types de caractères suivants :

Les attributs suivants sont disponibles sous forme de tableaux Velocity. À ce titre, elles peuvent être itérées ou référencées par l’intermédiaire d’un index.

Par exemple :

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

OU

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

Pour plus d’informations sur les variables Velocity (attributs), voir https://velocity.apache.org/engine/releases/velocity-1.7/user-guide.html#variables.

Si vous utilisez un script de profil dans votre conception, le $ précédant le nom du script doit être échappé avec une \ (barre oblique inverse). Par exemple :

\${user.script_name}

Par exemple, si vous souhaitez qu’une conception affiche ce qui suit :

utilisez le code suivant :

<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>

Vous pouvez également utiliser algorithm.name et algorithm.dayCount comme attributs d’entité dans les conceptions. Ainsi, une conception peut être utilisée pour tester plusieurs critères et le nom du critère peut être affiché de manière dynamique dans la conception. Cela indique au visiteur qu’il consulte « les meilleurs vendeurs » ou « les personnes qui ont consulté ceci ont acheté cela ». Vous pouvez même utiliser ces attributs pour afficher le dayCount (nombre de jours de données utilisé dans les critères, comme "éléments les plus vendus au cours des deux derniers jours", etc.).

Utilisation de nombres dans les modèles Velocity

Par défaut, les modèles Velocity traitent tous les attributs d’entité comme des valeurs de chaîne. Vous pouvez considérer un attribut d’entité comme une valeur numérique afin d’effectuer une opération mathématique ou de le comparer à une autre valeur numérique. Pour traiter un attribut d’entité comme une valeur numérique, procédez comme suit :

Exemple : calcul d’un prix de remise

Supposons que vous souhaitiez réduire le prix affiché d’un article de 0,99 $ pour appliquer une remise. Pour obtenir ce résultat, vous pouvez utiliser l’approche suivante :

#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

Exemple : choix du nombre d’étoiles à afficher en fonction de l’évaluation d’un article

Supposons que vous souhaitiez afficher un nombre approprié d’étoiles en fonction de l’évaluation client numérique moyenne d’un article. Pour obtenir ce résultat, vous pouvez utiliser l’approche suivante :

#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

Exemple : calcul du temps en heures et en minutes en fonction de la durée en minutes d’un article

Supposons que vous stockiez la durée d’un film en minutes, mais que vous souhaitiez afficher la durée en heures et en minutes. Pour obtenir ce résultat, vous pouvez utiliser l’approche suivante :

#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

Affichage d’un article clé avec les produits recommandés section_7F8D8C0CCCB0403FB9904B32D9E5EDDE

Vous pouvez modifier votre conception pour afficher votre élément clé à côté des autres produits recommandés. Par exemple, vous voulez peut-être afficher l’élément actuel pour référence à côté des recommandations.

Pour ce faire, créez une colonne dans votre conception qui utilise l’attribut $key sur lequel vous basez votre recommandation plutôt que l’attribut $entity. Par exemple, le code pour votre colonne clé peut ressembler à ceci :

<div class="at-table-column">
   <a href="$key.pageURL">
      <img src=$key.thumbnailUrl" class="at-thumbnail"/>
      <br/><h3>$key.name</h3>
      <br/><p class="at-light">$key.message</p>
      <br/><p class="at-light">$key.value</p>
   </a>
</div>

Le résultat est une conception comme la suivante, où une colonne affiche l’élément clé.

Lors de la création de votre activité Recommendations, si l’élément clé est tiré du profil du visiteur, par exemple "dernier article acheté", Target affiche un produit aléatoire dans le Visual Experience Composer (VEC). Cela est dû à l’indisponibilité du profil lors de la conception de l’activité. Quand les visiteurs visualisent la page, ils visualiseront l’élément clé attendu.

Exécution de remplacements dans une valeur de chaîne section_01F8C993C79F42978ED00E39956FA8CA

Vous pouvez modifier votre conception afin de remplacer les valeurs d’une chaîne. Par exemple, en remplaçant le séparateur décimal avec point utilisé aux États-Unis par le séparateur avec virgule utilisé en Europe et dans d’autres pays.

Le code suivant présente une ligne unique dans un exemple de tarification de vente conditionnelle :

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

Le code suivant est un exemple conditionnel complet d’un prix de vente :

<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>

Personnalisation de la taille du modèle et vérification des valeurs vides default

En utilisant un script Velocity pour contrôler le dimensionnement dynamique de l’affichage de l’entité, le modèle suivant prend en charge un résultat de 1 à plusieurs pour éviter de créer des éléments d’HTML vides lorsqu’il n’y a pas assez d’entités correspondantes renvoyées de Recommendations. Ce script est idéal pour les scénarios lorsque les recommandations de sauvegarde n’ont pas de sens et que Partial Template Rendering est activé.

L’extrait HTML suivant remplace la partie HTML existante dans la conception par défaut 4 x 2 (le CSS n’est pas inclus ici, par souci de concision) :

<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>