Een voorstel toevoegen op een webpagina add-an-offer-in-web

Om de motor van de Aanbieding in een Web-pagina te roepen, neem direct een vraag aan een code van JavaScript in de pagina op. Deze vraag keert de aanbiedingsinhoud in een gericht element terug.

Het script dat URL aanroept ziet er als volgt uit:

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

De "env"parameter ontvangt de interne naam van het levende milieu gewijd aan anonieme interactie.

Om een aanbieding te presenteren, moeten wij een milieu en een aanbiedingsruimte in Adobe Campaign creëren, dan de pagina van HTML vormen.

In de volgende gebruiksgevallen worden de mogelijke opties voor het integreren van aanbiedingen via JavaScript beschreven.

Optie 1: HTML-modus html-mode

Een anonieme aanbieding presenteren presenting-an-anonymous-offer

Stap 1: Bereid de motor van de Aanbieding voor

Stap 2: Werk de inhoud van de pagina van HTML bij

De HTML-pagina moet een element met een @id-kenmerk bevatten met de waarde van de interne naam van de gemaakte aanbiedingsruimte ("i_internal name space"). Het aanbod zal in dit element door Interaction worden opgenomen.

In ons voorbeeld ontvangt het kenmerk @id de waarde "i_SPC12", waarbij "SPC12" de interne naam is van de eerder gemaakte aanbiedingsruimte:

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

In ons voorbeeld is de URL voor het aanroepen van het script als volgt ("OE3" is de interne naam van de live omgeving):

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

Deze statische vraag zal automatisch een dynamische vraag produceren die alle parameters bevat nodig door de motor van de Aanbieding.

Dit gedrag laat u verscheidene aanbiedingsruimten op de zelfde pagina gebruiken, die door één enkele vraag aan de motor van de Aanbieding worden beheerd.

Stap 3: Toon de resultaten in de pagina van HTML

De inhoud van de aanbiedingsweergave wordt door de aanbiedingsengine aan de HTML-pagina geretourneerd:

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

Een geïdentificeerde aanbieding presenteren presenting-an-identified-offer

Om een aanbieding aan een geïdentificeerd contact voor te stellen, is het proces gelijkaardig zoals gedetailleerd ​ in deze sectie ​.

In de inhoud van de Web-pagina, moet u het volgende manuscript toevoegen dat de contact tijdens de vraag aan de motor van de Aanbieding zal identificeren:

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

Een HTML-renderfunctie gebruiken using-an-html-rendering-function

Als u de representatie van de HTML-aanbieding automatisch wilt genereren, kunt u een renderfunctie gebruiken.

Optie 2: XML-modus xml-mode

Een voorstel presenteren presenting-an-offer

De module van de Interactie van de campagne ​ ​laat u een knoop van XML aan de pagina terugkeren van HTML die de motor van de Aanbieding omhoog roept. Dit XML-knooppunt kan worden verwerkt door functies die aan de kant van de klant moeten worden ontwikkeld.

De vraag aan de motor van de Aanbieding kijkt als dit:

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

Het geretourneerde XML-knooppunt ziet er als volgt uit:

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

In het onderstaande gebruiksgeval worden de configuraties beschreven die in Adobe Campaign moeten worden uitgevoerd om de XML-modus in te schakelen en wordt vervolgens het resultaat van de aanroep naar de engine op de HTML-pagina weergegeven.

Een renderfunctie gebruiken using-a-rendering-function-

Het is mogelijk een XML-renderfunctie te gebruiken om een aanbiedingspresentatie te maken. Deze functie wijzigt het XML-knooppunt dat tijdens het aanroepen van de Offertenengine naar de HTML-pagina wordt geretourneerd.

SOAP-integratie instellen

De SOAP-webservices die voor het beheer van aanbiedingen worden aangeboden, verschillen van de services die gewoonlijk in Adobe Campaign worden gebruikt. U hebt toegang tot deze bestanden via de interactie-URL die in de vorige sectie is beschreven. U kunt nu aanbiedingen voor een bepaalde contactpersoon presenteren of bijwerken.

Voorstel offer-proposition

Voor een aanbiedingsvoorstel via SOAP, voeg het nms :proposition #Propose bevel toe dat door de volgende parameters wordt gevolgd:

Als antwoord op de vraag, zal de dienst van SOAP de volgende parameters terugkeren:

Aanbieding bijwerken offer-update

Voeg het nms :interaction #UpdateStatus bevel aan URL toe, die door deze parameters wordt gevolgd:

Voorbeeld met een SOAP-aanroep example-using-a-soap-call

Hier volgt een voorbeeld van code voor een SOAP-aanroep:

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