DocumentationCampaignDocumentation de Campaign Classic v7

[S’applique également à la v8.]{class="badge positive" title="S’applique également à Campaign v8."}

Instructions de pré-traitement pre-processing-instructions

Last update: Fri Jul 19 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Rubriques :

Créé pour :

  • Utilisateur ou utilisatrice
  • Développeur

Vous pouvez utiliser une syntaxe spécifique dans le contenu de la diffusion afin d’ajouter des instructions et de créer un script pour l’URL de l’email suivi. Les <%@ ne sont pas des instructions JavaScript. Cette syntaxe est propre à Adobe Campaign.

Elles ne s'appliquent que dans le contexte du contenu de la diffusion. C’est la seule méthode pour écrire le script de l’URL d’un email et qu’elle soit encore trackée (en plus des paramètres d’URL). Elles peuvent être vues comme un copié/collé automatique appliqué pendant l’analyse de la diffusion avant la détection des liens à tracker.

Il existe trois types d’instructions :

  • include  : principalement pour factoriser du code dans des options, des blocs de personnalisation, des fichiers externes ou des pages. En savoir plus
  • value  : pour donner accès aux champs de la diffusion, aux variables de diffusion et aux objets personnalisés chargés dans la diffusion. En savoir plus
  • foreach  : pour exécuter en boucle un tableau chargé en tant qu’objet personnalisé. En savoir plus

Elles peuvent être testées directement à partir de l'assistant de diffusion. Elles s’appliquent dans la prévisualisation du contenu et lorsque vous cliquez sur le bouton de tracking pour afficher la liste des URL.

include include

Les exemples suivants sont parmi les plus couramment utilisés :

  • Inclusion du lien de la page miroir :

    code language-none 
    <%@ include view="MirrorPage" %>

  • URL de la page miroir :

    code language-none 
    View as a <a href="<%@ include view='MirrorPageUrl' %>" _label="Mirror Page" _type="mirrorPage">web page.

  • URL de désinscription par défaut :

    code language-none 
    <%@ include option='NmsServer_URL' %>/webApp/unsub?id=<%= escapeUrl(recipient.cryptedId)%>

  • Autres exemples :

    code language-none 
    <%@ include file='http://www.google.com' %>
<%@ include file='file:///X:/france/service/test.html' %>
<%@ include option='NmsServer_URL' %>

    Utilisez le bouton de personnalisation de l’assistant de diffusion pour obtenir la syntaxe correcte.

value value

Cette instruction donne accès aux paramètres de la diffusion qui sont constants pour tous les destinataires.

Syntaxe :

<%@ value object="myObject" xpath="@myField" index="1" %>

Où :

  • object  : nom de l’objet (exemple : diffusion, fournisseur, autre).
    L’objet peut être :

    • delivery  : pour la diffusion en cours (voir les détails et les restrictions dans la sous-section ci-dessous).
    • provider  : pour le fournisseur/routage de diffusion actuel (nms:externalAccount).
    • Objet de script supplémentaire : si un objet est chargé dans le contexte via : Propriétés > Personnalisation > Ajouter des objets dans le contexte d’exécution.
    • Élément de la boucle foreach : voir la section Foreach ci-dessous.

  • xpath  : xpath du champ.

  • index (facultatif) : si object est un tableau (pour les objets de script supplémentaires), index d’élément dans le tableau (démarre à 0).

delivery objet  delivery-object

Pour la personnalisation de l’email, l’objet diffusion est accessible de deux manières différentes :

  • Utilisation de JavaScript :

    code language-none 
    <%= delivery.myField %>`.

    Dans la diffusion d’objets JavaScript, les champs personnalisés ne sont pas pris en charge. Ils fonctionnent dans la prévisualisation, mais pas dans le MTA parce que celui-ci ne peut accéder qu'au schéma de diffusion d’usine.

  • Utilisation d’un pré-traitement :

    code language-none 
    <%@ value object="delivery"

Attention

Si vous utilisez les instructions suivantes pour les diffusions envoyées par midsourcing, le champ personnalisé @myCustomField doit être ajouté au schéma nms:delivery sur les plateformes marketing et de midsourcing :

<%@ value object="delivery" xpath="@myCustomField" %>

Pour les variables/paramètres de diffusion, utilisez la syntaxe suivante (à l’aide de l’objet diffusion) :

<%@ value object="delivery" xpath="variables/var[@name='myVar']/@stringValue" %>

value dans une section Javascript value-in-javascript

Pour autoriser l’utilisation de la valeur <%@ dans des sections Javascript, deux objets spéciaux sont remplacés par <% et %> :

<%@ value object='startScript' %>
<%@ value object='endScript' %>

Par exemple :

<%@ value object='startScript' %> var iMode = <%@ value object="delivery" xpath="@deliveryMode" %> if(iMode == 1) { ... } else { ... }`
`<%@ value object='endScript' %> is expanded in something like <% var iMode = 1 if(iMode == 1) { ... } else { ... } %>.

foreach foreach

Cette instruction permet une itération sur un tableau d'objets chargés dans la diffusion pour tracker les liens individuels associés aux objets.

Syntaxe :

<%@ foreach object="myObject" xpath="myLink" index="3" item="myItem" %> <%@ end %>

Où :

  • object  : nom de l’objet où commencer, généralement un objet de script supplémentaire, mais il peut s’agir d’une diffusion.
  • xpath (facultatif) : xpath de la collection à exécuter en boucle. La valeur par défaut est « . », ce qui signifie que l’objet est le tableau à exécuter en boucle.
  • index (facultatif) : si xpath n’est pas « . » et l’objet lui-même est un tableau, index d’élément de l’objet (démarre à 0).
  • item (facultatif) : nom d’un nouvel objet accessible avec <%@ value dans la boucle foreach. Par défaut le nom du lien dans le schéma.

Exemple :

Dans les propriétés/personnalisation de la diffusion, chargez un tableau d’articles et une table de relations entre le destinataire et les articles.

L’affichage de liens vers ces articles peut se faire simplement avec un script JavaScript comme suit :

<%
  for(var i=0; i<recipient.rcpArticle.length; i++ )
  {
    %><a href="http://nl.net?a.jsp?article=<%=recipient.rcpArticle[i].article.@id%>">article</a><%
  }
%>

Avec cette solution, les liens vers tous les articles sont trackés sans distinction. Vous pouvez déterminer qu’un destinataire a cliqué sur un lien d’article, mais vous ne pouvez pas savoir quel article.

La solution consiste à :

  1. Précharger tous les articles possibles dans un tableau de script supplémentaire de la diffusion - articleList[] - ce qui signifie qu’il doit y avoir un nombre fini d’articles possibles.

  2. Écrire une fonction JavaScript au début du contenu.

    code language-none 
    <%@ value object='startScript' %>
function displayArticle(articleId)
{
  <%@ foreach object="articleList" item="article" %>
    if( articleId == <% value object="article" xpath="@id" %> )
    {
      <%@ value object='endScript' %>
        <a href="http://nl.net?a.jsp?article=<%@ value object="article" xpath="@id" %>">article</a>
      <%@ value object='startScript' %>
    }
  <%@ end @%>
}
<%@ value object='endScript' %>

  3. Afficher l’article en appelant la fonction.

    code language-none 
    <%
for(var i=0; i<recipient.rcpArticle.length; i++ )
{
 displayArticle(recipient.rcpArticle[i].article.@id)
}
%>
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1