Lägg till ett erbjudande på en webbsida add-an-offer-in-web

Om du vill anropa erbjudandemotorn på en webbsida infogar du ett anrop till en JavaScript-kod direkt på sidan. Det här anropet returnerar erbjudandeinnehållet i ett riktat element.

Skriptet som anropar URL ser ut så här:

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

Parametern env tar emot det interna namnet på den aktiva miljön som är dedikerad till anonyma interaktioner.

För att kunna presentera ett erbjudande måste vi skapa en miljö och ett erbjudandeutrymme i Adobe Campaign och sedan konfigurera HTML-sidan.

I följande exempel beskrivs de möjliga alternativen för att integrera erbjudanden via JavaScript.

Alternativ 1: HTML-läge html-mode

Presentera ett anonymt erbjudande presenting-an-anonymous-offer

Steg 1: Förbered erbjudandemotorn

Steg 2: Uppdatera HTML-sidans innehåll

Sidan HTML måste innehålla ett element med ett @id-attribut med värdet för det interna namnet på erbjudandeutrymmet ("i_internal name space"). Erbjudandet kommer att infogas i detta element av Interaction.

I vårt exempel får attributet @id värdet "i_SPC12", där "SPC12" är det interna namnet på det erbjudandeutrymme som skapats tidigare:

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

I det här exemplet är URL:en för att anropa skriptet följande ("OE3" är det interna namnet på den aktiva miljön):

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

Detta statiska anrop genererar automatiskt ett dynamiskt anrop som innehåller alla parametrar som krävs av erbjudandemotorn.

Med det här beteendet kan du använda flera erbjudandemellanslag på samma sida, som hanteras av ett enda anrop till erbjudandemotorn.

Steg 3: Visa resultatet på HTML-sidan

Innehållet i erbjudanderepresentationen skickas tillbaka till HTML-sidan av erbjudandemotorn:

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

Presentera ett identifierat erbjudande presenting-an-identified-offer

Processen liknar den som beskrivs i det här avsnittetom du vill visa ett erbjudande för en identifierad kontakt.

I innehållet på webbsidan måste du lägga till följande skript som identifierar kontakten under anropet till erbjudandemotorn:

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

Använda en HTML-återgivningsfunktion using-an-html-rendering-function

Du kan använda en återgivningsfunktion om du vill generera representationen av HTML automatiskt.

Alternativ 2: XML-läge xml-mode

Presentera ett erbjudande presenting-an-offer

Med modulen Interaktion i kampanjen kan du returnera en XML-nod till HTML-sidan som anropar erbjudandemotorn. Denna XML-nod kan bearbetas av funktioner som ska utvecklas på kundsidan.

Anropet till erbjudandemotorn ser ut så här:

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

Den returnerade XML-noden ser ut så här:

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

Användningsexemplet nedan beskriver de konfigurationer som ska utföras i Adobe Campaign för att aktivera XML-läget och visar sedan resultatet av anropet till motorn på HTML-sidan.

Använda en återgivningsfunktion using-a-rendering-function-

Det går att använda en XML-återgivningsfunktion för att skapa en erbjudandepresentation. Den här funktionen ändrar XML-noden som returneras till HTML-sidan under anropet till erbjudandemotorn.

Konfigurera en SOAP

De SOAP webbtjänsterna som tillhandahålls för hantering av erbjudanden skiljer sig från de som vanligtvis används i Adobe Campaign. De kan nås via den interaktions-URL som beskrivs i föregående avsnitt och du kan presentera eller uppdatera erbjudanden för en viss kontakt.

Erbjudandeförslag offer-proposition

Lägg till kommandot nms:proposition#Propose följt av följande parametrar för ett erbjudande via SOAP:

Som svar på frågan returnerar SOAP följande parametrar:

Erbjudandeuppdatering offer-update

Lägg till kommandot nms:interaction#UpdateStatus i URL:en, följt av följande parametrar:

Exempel på hur du använder ett SOAP example-using-a-soap-call

Här är ett exempel på kod för ett SOAP anrop:

<%
  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 )
  {
  }
  %>