SOAP을 통한 통합(서버측) integration-via-soap-server-side

오퍼 관리에 제공되는 SOAP 웹 서비스는 Adobe Campaign에서 일반적으로 사용되는 서비스와 다릅니다. 이전 섹션에 설명된 상호 작용 URL을 통해 액세스할 수 있으며, 지정된 연락처에 대한 오퍼를 제시하거나 업데이트할 수 있습니다.

오퍼 제안 offer-proposition

SOAP을 통한 오퍼 제안에 대해 nms:proposition#Propose 명령과 다음 매개 변수를 추가합니다.

  • targetId: 받는 사람의 기본 키(복합 키일 수 있음).
  • maxCount: 연락처의 오퍼 제안 수를 지정합니다.
  • 컨텍스트: 스페이스 스키마에 컨텍스트 정보를 추가할 수 있습니다. 사용된 스키마가 nms:interaction ​인 경우 <empty> ​을(를) 추가해야 합니다.
  • categories: 오퍼가 속해야 하는 범주/IE를 지정합니다.
  • 테마: 오퍼가 속해야 하는 테마를 지정합니다.
  • uuid: Adobe Campaign 영구 쿠키의 값("uuid230").
  • nli: Adobe Campaign 세션 쿠키의 값("nlid")입니다.
  • noProp: "true" 값을 사용하여 제안 삽입을 비활성화합니다.
NOTE
targetIdmaxCount 설정은 필수입니다. 다른 것들은 선택 사항입니다.

쿼리에 대한 응답으로 SOAP 서비스는 다음 매개 변수를 반환합니다.

  • interactionId: 인터랙션의 ID입니다.
  • 제안: XML 요소에는 각각 고유한 ID와 HTML 표현이 있는 제안 목록이 포함됩니다.

오퍼 업데이트 offer-update

nms:interaction#UpdateStatus 명령을 URL에 추가한 다음 다음 매개 변수를 추가합니다.

  • 제안: 문자열로, 오퍼 제안 중 출력으로 제공된 제안 ID가 포함되어 있습니다. 오퍼 제안을 참조하세요.
  • 상태: 문자열 형식이며 오퍼의 새 상태를 지정합니다. 가능한 값은 nms:common 스키마의 propositionStatus 열거형에 나열됩니다. 예를 들어, 기본적으로 숫자 3은 수락됨 상태에 해당합니다.
  • context: XML 요소를 사용하면 공간 스키마에 컨텍스트 정보를 추가할 수 있습니다. 사용된 스키마가 nms:interaction ​인 경우 <empty> ​을(를) 추가해야 합니다.

SOAP 호출 사용 예 example-using-a-soap-call

다음은 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 )
  {
  }
  %>
recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1