Adicionar uma oferta em uma página da Web add-an-offer-in-web

Para chamar o mecanismo de oferta em uma página da Web, insira uma chamada para um código JavaScript diretamente na página. Essa chamada retorna o conteúdo da oferta em um elemento direcionado.

O URL de chamada de script tem essa aparência:

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

O parâmetro "env" recebe o nome interno do ambiente ativo dedicado às interações anônimas.

Para apresentar uma oferta, precisamos criar um ambiente e um espaço de oferta no Adobe Campaign e, em seguida, configurar a página HTML.

Os seguintes casos de uso detalham as possíveis opções para integrar ofertas via JavaScript.

Opção 1: modo HTML html-mode

Apresentar uma oferta anônima presenting-an-anonymous-offer

Etapa 1: Preparar o mecanismo de oferta

Etapa 2: atualizar o conteúdo da página de HTML

A página HTML deve incluir um elemento com um atributo @id com o valor do nome interno do espaço de oferta criado ("i_internal name space"). A oferta será inserida neste elemento pelo Interaction.

No nosso exemplo, o atributo @id recebe o valor "i_SPC12", onde "SPC12" é o nome interno do espaço de oferta criado anteriormente:

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

No nosso exemplo, a URL para chamar o script é a seguinte ("OE3" é o nome interno do ambiente ativo):

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

Essa chamada estática gerará automaticamente uma chamada dinâmica contendo todos os parâmetros necessários do mecanismo de oferta.

Esse comportamento permite usar vários espaços de ofertas na mesma página, gerenciados por uma única chamada do mecanismo de oferta.

Etapa 3: exibir os resultados na página de HTML

O conteúdo da representação da oferta é retornado para a página HTML pelo Mecanismo de oferta:

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

Apresentar uma oferta identificada presenting-an-identified-offer

Para apresentar uma oferta a um contato identificado, o processo é semelhante ao processo detalhado nesta seção.

No conteúdo da página da Web, é necessário adicionar o script a seguir para identificar o contato durante a chamada para o mecanismo de oferta:

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

Usar uma função de renderização de HTML using-an-html-rendering-function

Para gerar a representação de oferta HTML automaticamente, é possível usar uma função de renderização.

Opção 2: modo XML xml-mode

Apresentar uma oferta presenting-an-offer

Campaign Interação permite retornar um nó XML para a página HTML que chama o mecanismo de oferta. Este nó XML pode ser processado por funções a serem desenvolvidas no lado do cliente.

A chamada para o mecanismo de oferta tem esta aparência:

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

O nó XML retornado tem esta aparência:

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

O caso de uso abaixo detalha as configurações a serem executadas no Adobe Campaign para habilitar o modo XML e, em seguida, mostrar o resultado da chamada para o mecanismo na página de HTML.

Usar uma função de renderização using-a-rendering-function-

É possível usar uma função de renderização XML para criar uma apresentação de ofertas. Essa função modificará o nó XML retornado à página de HTML durante a chamada para o mecanismo de oferta.

Configurar uma integração SOAP

Os serviços da Web SOAP fornecidos para o gerenciamento de ofertas são diferentes daqueles normalmente usados no Adobe Campaign. Eles podem ser acessados por meio da URL de interação descrita na seção anterior e permitem apresentar ou atualizar ofertas para um determinado contato.

Apresentação da oferta offer-proposition

Para uma apresentação de oferta via SOAP, adicione o comando nms:proposta#Propose seguido pelos seguintes parâmetros:

Em resposta à query, o serviço SOAP retorna os seguintes parâmetros:

Atualização da oferta offer-update

Adicione o comando nms:interação#UpdateStatus à URL, seguido desses parâmetros:

Exemplo usando uma chamada SOAP example-using-a-soap-call

Veja um exemplo de código para uma chamada 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 )
  {
  }
  %>