Adición de una oferta en una página web add-an-offer-in-web

Para llamar al motor de oferta en una página web, inserte una llamada a un código JavaScript directamente en la página. Esta llamada devuelve el contenido de la oferta en un elemento de destino.

La secuencia de comandos que llama a la URL tiene este aspecto:

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

El parámetro “env” recibe el nombre interno del entorno en directo dedicado a las interacciones anónimas.

Para presentar una oferta, se debe crear un entorno y un espacio de oferta en Adobe Campaign y, a continuación, configurar la página HTML.

Los siguientes casos de uso detallan las posibles opciones para integrar ofertas mediante JavaScript.

Opción 1: modo HTML html-mode

Presentación de una oferta anónima presenting-an-anonymous-offer

Paso 1: preparar el motor de oferta

Paso 2: actualizar el contenido de la página del HTML

La página HTML debe incluir un elemento con un atributo @id con el valor del nombre interno del espacio de oferta creado ("espacio de nombre i_internal"). La oferta se insertará en este elemento mediante interacción.

En este ejemplo, el atributo @id recibe el valor “i_SPC12”, donde “SPC12” es el nombre interno del espacio de oferta creado anteriormente:

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

En este ejemplo, la URL para llamar a la secuencia de comandos es la siguiente (“OE3” es el nombre interno del entorno en directo):

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

Esta llamada estática genera automáticamente una llamada dinámica que contiene todos los parámetros necesarios para el motor de oferta.

Este comportamiento permite utilizar varios espacios de oferta en la misma página, que se van a administrar mediante una sola llamada al motor de oferta.

Paso 3: mostrar los resultados en la página del HTML

El motor de oferta devuelve el contenido de la representación de la oferta a la página del HTML:

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

Presentación de una oferta identificada presenting-an-identified-offer

Para presentar una oferta a un contacto identificado, el proceso es similar al detallado en esta sección.

En el contenido de la página web, se debe añadir la siguiente secuencia de comandos que identificará al contacto durante la llamada al motor de oferta:

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

Uso de una función de renderización de HTML using-an-html-rendering-function

Para generar la representación de oferta HTML automáticamente, se puede utilizar una función de renderización.

Opción 2: modo XML xml-mode

Presentación de una oferta presenting-an-offer

El módulo Interaction de la campaña le permite devolver un nodo XML a la página del HTML que llama al motor de oferta. Este nodo XML se puede procesar mediante funciones que se van a desarrollar en el lado del cliente.

La llamada al motor de oferta tiene este aspecto:

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

El nodo XML devuelto tiene el siguiente aspecto:

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

El caso de uso siguiente detalla las configuraciones que se deben realizar en Adobe Campaign para activar el modo XML y mostrar el resultado de la llamada al motor en la página del HTML.

Uso de una función de renderización using-a-rendering-function-

Es posible utilizar una función de renderización XML para crear una presentación de oferta. Esta función modifica el nodo XML que se devuelve a la página del HTML durante la llamada al motor de oferta.

SOAP Configuración de una integración de

Los servicios web SOAP proporcionados para la administración de ofertas son diferentes de los utilizados en Adobe Campaign. Se puede acceder a ellos a través de la dirección URL de interacción descrita en la sección anterior y permiten presentar o actualizar ofertas para un contacto determinado.

Propuesta de oferta offer-proposition

Para una propuesta de oferta mediante SOAP, añada el comando nms:proposition#Propose seguido de los parámetros siguientes:

Como respuesta a la consulta, el servicio SOAP devuelve los siguientes parámetros:

Actualización de oferta offer-update

Añada el comando nms:interaction#UpdateStatus a la dirección URL, seguido de estos parámetros:

Ejemplo de uso de una llamada a SOAP example-using-a-soap-call

A continuación, se muestra un ejemplo de código para una llamada 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 )
  {
  }
  %>