Ajouter une offre sur une page web add-an-offer-in-web

Pour appeler le moteur d'offres dans une page web, insérez un appel à un code JavaScript directement dans la page. Cet appel renvoie le contenu de l'offre dans un élément ciblé.

L'URL d'appel au script est de la forme suivante :

<script id="interactionProposalScript" src="https://<SERVER_URL>/nl/interactionProposal.js?env=" type="text/javascript"></script>

Le paramètre "env" reçoit le nom interne de l'environnement en ligne dédié aux interactions anonymes.

Pour présenter une offre, il faut donc créer un environnement ainsi qu'un emplacement pour l'offre dans Adobe Campaign, puis configurer la page HTML.

Les cas d'utilisations suivants présentent les différentes options possibles dans l'intégration d'offres via Javascript.

Option 1 : mode HTML html-mode

Présentation d'une offre anonyme presenting-an-anonymous-offer

Étape 1 : préparation du moteur d'offres

Étape 2 : mise à jour du contenu de la page HTML

La page HTML doit inclure un élément avec un attribut @id avec la valeur du nom interne de l'emplacement créé ("i_internal name space"). L'offre sera insérée dans cet élément par Interaction.

Dans l'exemple, l'attribut @id reçoit la valeur "i_SPC12" où "SPC12" est le nom interne de l'emplacement précédemment créé :

<div id="i_SPC12"></div>

Dans l'exemple, l'URL d'appel au script est la suivante ("OE3" est le nom interne de l'environnement en ligne) :

<script id="interactionProposalScript" src="https://instance.adobe.org:8080/nl/interactionProposal.js?env=OE3" type="text/javascript"></script>

Cet appel statique va automatiquement générer un appel dynamique contenant tous les paramètres nécessaires au moteur d'offres.

Ce comportement permet d'avoir plusieurs emplacements sur la même page gérés par un seul appel au moteur d'offres.

Étape 3 : affichage des résultats dans la page HTML

Le contenu du rendu de l'offre est renvoyé à la page HTML par le moteur d'offres :

<div id="banner_header">
 <div id="i_SPC12">
   <table>
    <tbody>
        <tr>
            <td><h3>Fly to Japan!</h3></td>
        </tr>
        <tr>
            <td><img width="150px" src="https://instance.adobe.org/res/Track/874fdaf72ddc256b2d8260bb8ec3a104.jpg"></td>
            <td>
            <p>Discover Japan for 2 weeks at an unbelievable price!!</p>
            <p><b>2345 Dollars - All inclusive</b></p>
        </td>
        </tr>
    </tbody>
    </table>
 </div>
<script src="https://instance.adobe.org:8080/nl/interactionProposal.js?env=OE3" id="interactionProposalScript" type="text/javascript"></script>
</div>

Présentation d'une offre identifiée presenting-an-identified-offer

Pour présenter une offre à un contact identifié, le processus est similaire à celui détaillé dans cette section.

Dans le contenu de la page web, vous devez ajouter le script suivant qui permettra d'identifier le contact lors de l'appel au moteur d'offres :

<script type="text/javascript">
  interactionTarget = <contact_identifier>;
</script>

Utilisation d'une fonction de rendu HTML using-an-html-rendering-function

Vous pouvez utiliser une fonction de rendu afin que la représentation HTML de l'offre soit automatiquement générée.

Option 2 : mode XML xml-mode

Présentation d'une offre presenting-an-offer

Le module Interaction de Campaign vous permet de renvoyer un nœud XML à la page HTML qui appelle le moteur d'offres. Ce nœud XML peut être traité par des fonctions à développer côté client.

L'appel au moteur d'offres est de la forme suivante :

<script type="text/javascript" id="interactionProposalScript" src="https://<SERVER_URL>/nl/interactionProposal.js?env=&cb="></script>

Le noeud XML retourné est de la forme suivante :

<propositions>
 <proposition id="" offer-id="" weight="" rank="" space="" div=""> //proposition identifiers
   ...XML content defined in Adobe Campaign...
 </proposition>
 ...
</propositions>

Le cas d'utilisation suivant décrit les paramétrages à effectuer dans Adobe Campaign pour activer le mode XML, puis montre le résultat de l'appel au moteur dans la page HTML.

Utiliser une fonction de rendu using-a-rendering-function-

Il est possible d'utiliser une fonction de rendu XML pour créer une présentation d'offre. Cette fonction modifie le nœud XML renvoyé à la page HTML lors de l'appel au moteur d'offres.

Configuration d'une intégration SOAP

Les services web SOAP fournis pour la gestion des offres sont différents de ceux habituellement utilisés dans Adobe Campaign. Ils sont accessibles via l'URL d'interaction décrite dans la section précédente et permettent de proposer ou mettre à jour des offres pour un contact donné.

Proposition d'offres offer-proposition

Pour une proposition d'offres via SOAP, vous devez ajouter la commande nms:proposition#Propose, suivie des paramètres suivants :

En réponse à la requête, le service SOAP renverra les paramètres suivants :

Mise à jour d'une offre offer-update

Ajoutez la commande nms:interaction#UpdateStatus dans l'URL, puis les paramètres suivants :

Exemple d'utilisation d'un appel SOAP example-using-a-soap-call

Voici un exemple de code pour un appel SOAP :

<%
  var space = request.parameters.sp
  var cnx = new HttpSoapConnection(
    "https://" + request.serverName + ":" + request.serverPort + "/interaction/" + env + "/" + space,
    "utf-8",
    HttpSoapConnection.SOAP_12)
  var session = new SoapService(cnx, "nms:interaction")
  var action = request.parameters.a
  if( action == undefined )
    action = 'propose'

  try
  {
    switch( action )
    {
    case "update":
      var proposition = request.parameters.p
      var status      = request.parameters.st
      session.addMethod("UpdateStatus", "nms:interaction#UpdateStatus",
       ["proposition", "string",
        "status",      "string",
        "context",     "NLElement"],
       [])
      session.UpdateStatus(proposition, status, <undef/>)
      var redirect = request.parameters.r
      if( redirect != undefined )
        response.sendRedirect(redirect)
      break;

    case "propose":
      var count = request.parameters.n
      var target = request.parameters.t
      var categorie = request.parameters.c
      var theme = request.parameters.th
      var layout = request.parameters.l
      if( count == undefined )
        count = 1
      session.addMethod("Propose", "nms:proposition#Propose",
       ["targetId",      "string",
        "maxCount",      "string",
         "categories",    "string",
         "themes",        "string",
        "context",       "NLElement"],
       ["interactionId", "string",
        "propositions",  "NLElement"])
      response.setContentType("text/html")
      var result = session.Propose(target, count, category, theme, <empty/>)
      var props = result[1]
  %><table><tr><%
      for each( var propHtml in props.proposition.*.mdSource )
      {
        %><td><%=propHtml%></td><%
      }
  %></tr></table><%
      break;
    }
  }
  catch( e )
  {
  }
  %>