이벤트 설명

트랜잭션 메시징 데이터 모델 정보

트랜잭션 메시지는 Adobe Campaign 데이터 모델을 사용하여 별도의 두 개의 표를 추가로 사용합니다. 이러한 , NmsRtEventNmsBatchEvent​에는 동일한 필드가 포함되어 있으며 한 번에 실시간 이벤트와 다른 한 쪽의 일괄 처리 이벤트를 관리할 수 있습니다.

SOAP 메서드

이 섹션에서는 트랜잭션 메시지 모듈 스키마와 연관된 SOAP 방법에 대해 자세히 설명합니다.

두 개의 PushEvent 또는 PushEvents SOAP 메서드는 두 개의 nms:rtEventnms:BatchEvent datasas에 연결되어 있습니다. 이벤트가 "일괄 처리" 또는 "실시간" 유형인지 결정하는 정보 시스템입니다.

  • PushEvents 를 사용하여 메시지에 단일 이벤트를 삽입할 수 있습니다.
  • PushEvents 를 사용하면 메시지에 일련의 이벤트를 삽입할 수 있습니다.

두 메서드에 액세스하기 위한 WSDL 경로는 다음과 같습니다.

  • http://hostname/nl/jsp/schemawsdl.jsp?schema=nms: rtEvent를 사용하여 실시간 유형 스키마에 액세스합니다.
  • http://hostname/nl/jsp/schemawsdl.jsp?schema=nms: batchEvents을 사용하여 배치 유형 스키마에 액세스합니다.

두 메서드 모두 트랜잭션 메시징 모듈에 로그온하기 위한 <urn:sessiontoken> 요소를 포함합니다. 신뢰할 수 있는 IP 주소를 통해 식별 방법을 사용하는 것이 좋습니다. 세션 토큰을 검색하려면 로그온 SOAP 호출을 수행한 다음 가져오기 토큰 뒤에 로그오프를 수행합니다. 여러 RT 호출에 동일한 토큰을 사용합니다. 이 섹션에 포함된 예는 권장되는 세션 토큰 방법을 사용하는 것입니다.

로드 밸런싱을 사용하는 경우 RT 메시지 수준에서 사용자/암호 인증을 사용할 수 있습니다. 예제:

<PushEvent xmlns="urn:nms:rtEvent">
<sessiontoken>mc/PASSWORD</sessiontoken>
<domEvent>
<rtEvent wishedChannel="41" type="rt_MobileJourney_iOS_Push" registrationToken="c3ddc8aaecc24822df25d0f49865cca61ea3f86c61bfa53ae4d37294e37f4a1c" hashlpId="27EE7571EC14DBA23B9B5CC0EF79BB782DAECF4C03C88E5D92CC9B9DAC4E5DDA" correlationId="415b7593-4f6f-e911-811f-00505691247c" xmlns="">
<mobileApp uuid="236B24DC-C073-412F-8BCB-AC7207096258" _operation="none"/>
<ctx>...</ctx>
</rtEvent>
</domEvent>
</PushEvent>

PushEvent 메서드는 이벤트를 포함하는 <urn:domevent> 매개 변수로 구성됩니다.

PushEvents 메서드는 이벤트를 포함하는 <urn:domeventcollection> 매개 변수로 구성됩니다.

PushEvent 사용 예:

<urn:PushEvent>

 <sessiontoken>___921f9b38-72ac-49ad-b481-ab32973efc50</sessiontoken>
 
 <urn:domEvent>
 
   <rtEvent>
   
   ...
   
   </rtEvent>
 
 </urn:domEvent>

</urn:PushEvent>
노트

PushEvents 메서드를 호출하는 경우 표준 XML을 준수하도록 부모 XML 요소를 추가해야 합니다. 이 XML 요소는 이벤트에 포함된 다양한 <rtevent> 요소의 프레임을 만듭니다.

PushEvents 사용 예:

<urn:PushEvents>

 <sessiontoken>___921f9b38-72ac-49ad-b481-ab32973efc50</sessiontoken>
 
 <urn:domEventCollection>
 
   <Events>
   
     <rtEvent>... </rtEvent>
     
     <rtEvent>... </rtEvent>
     
     ...
   
   </Events>
 
 </urn:domEventCollection>

</urn:PushEvents>

<rtevent><batchevent> 요소에는 필수 하위 요소뿐만 아니라 속성 집합도 있습니다.<ctx> 메시지 데이터 통합을 위한 것입니다.

노트

<batchevent> 요소를 사용하면 이벤트를 "일괄 처리" 큐에 추가할 수 있습니다. <rtevent>​은 이벤트를 "실시간" 큐에 추가합니다.

<rtevent><batchevent> 요소의 필수 속성은 @type 및 @email. @type 값은 실행 인스턴스를 구성할 때 정의된 항목별 목록 값과 같아야 합니다. 이 값을 사용하면 배달 중에 이벤트 컨텐츠에 연결할 템플릿을 정의할 수 있습니다.

<rtevent> configuration example:

<rtEvent type="order_confirmation" email="john.doe@domain.com" origin="eCommerce" wishedChannel="0" externalId="1242" mobilePhone="+33620202020"> 

이 예에서는 두 개의 채널이 제공됩니다.이메일 주소와 휴대폰 번호입니다. wentChannel​을 사용하면 이벤트를 메시지로 변환할 때 사용할 채널을 선택할 수 있습니다. "0" 값은 이메일 채널, "1" 값은 모바일 채널 등에 해당합니다.

이벤트 배달을 연기하려면 원하는 날짜 뒤에 scheduled 필드를 추가합니다. 이 날짜에 이벤트가 메시지로 바뀝니다.

@wishedChannel 및 @emailFormat 속성을 숫자 값으로 채우는 것이 좋습니다. 데이터 스키마 설명에 숫자 값과 레이블을 연결하는 함수 테이블이 있습니다.

노트

허가된 모든 속성에 대한 자세한 설명과 값은 nms:rtEventnms:BatchEvent 데이터스키마에 대한 설명에 사용할 수 있습니다.

<ctx> 요소에는 메시지 데이터가 포함되어 있습니다. XML 내용이 열려 있으므로 전달할 컨텐츠에 따라 구성할 수 있습니다.

노트

전달 중에 서버가 오버로드되지 않도록 메시지에 포함된 XML 노드의 수와 크기를 최적화하는 것이 중요합니다.

데이터 예:

   <ctx>
               <client>
                        <firstname>John</firstname>
                        <lastname>Doe</lastname>
               </client>
               <action>
                         <type>Order confirmation</type>
                          <number>CN23453</number>
               </action>
               <orderdetails>
                          <article num="1">
                                   <name>Generic USB key</name>
                                   <price>20</price>
                           </article>
               </orderdetails>
    </ctx>

SOAP 호출에 의해 반환된 정보

이벤트를 수신하면 Adobe Campaign은 고유한 반환 ID를 생성합니다. 보관된 이벤트 버전의 ID입니다.

중요

SOAP 호출을 받을 때 Adobe Campaign은 이메일 주소 형식을 확인합니다. 이메일 주소 형식이 잘못된 경우 오류가 반환됩니다.

  • 이벤트 처리가 성공한 경우 메서드에서 반환되는 식별자의 예:

    <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns="http://xml.apache.org/xml-soap" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
       <SOAP-ENV:Body>
          <urn:PushEventResponse SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:urn="urn:nms:rtEvent">
             <plId xsi:type="xsd:long">72057594037935966</plId>
          </urn:PushEventResponse>
       </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    

반환 식별자의 값이 0보다 엄격하게 크면 이벤트가 Adobe Campaign에서 성공적으로 보관되었음을 의미합니다.

그러나 이벤트를 처리하지 못하면 오류 메시지 또는 0과 같은 값을 반환합니다.

  • 쿼리에 로그인이 포함되어 있지 않거나 지정한 연산자에 필요한 권한이 없는 경우 실패한 이벤트의 처리 예:

    <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
       <SOAP-ENV:Body>
          <SOAP-ENV:Fault>
             <faultcode>SOAP-ENV:Client</faultcode>
             <faultstring xsi:type="xsd:string">Error while reading parameters of method 'PushEvent' of service 'nms:rtEvent'.</faultstring>
             <detail xsi:type="xsd:string">Invalid login or password. Connection denied.</detail>
          </SOAP-ENV:Fault>
       </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    
  • 쿼리의 오류로 인해 실패한 이벤트의 예(XML 분류가 준수하지 않음):

    <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
       <SOAP-ENV:Body>
          <SOAP-ENV:Fault>
             <faultcode>SOAP-ENV:Client</faultcode>
             <faultstring xsi:type="xsd:string">The XML SOAP message is invalid (service 'PushEvent', method 'nms:rtEvent').</faultstring>
             <detail xsi:type="xsd:string"><![CDATA[(16:8) : Expected end of tag 'rtevent'
    Error while parsing XML string '<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:nms:rtEvent">
       <soapenv:Header/>
       <soapenv:Body>
          <urn:PushEvent>
             <urn:sessiontoken>mc/</urn:sessiontoken>
             <urn:domEvent>
    <rtevent type="create_account" email="esther.hall@adobe.com" origin="eCommerce" wishedChannel="email" 
          externalId="1596" language="english" country="EN" emailFormat="2"
          mobilePhone="+447700123123">
      <ctx>
       <website name="eCommerce" url="http://www.eCo']]></detail>
          </SOAP-ENV:Fault>
       </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    
  • 0의 식별자를 반환하고 실패하여 반환되는 이벤트의 예(잘못된 메서드 이름):

    <SOAP-ENV:Envelope xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:ns="http://xml.apache.org/xml-soap" xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
       <SOAP-ENV:Body>
          <urn:PushEventResponse SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/" xmlns:urn="urn:nms:rtEvent">
             <plId xsi:type="xsd:long">0</plId>
          </urn:PushEventResponse>
       </SOAP-ENV:Body>
    </SOAP-ENV:Envelope>
    

이 페이지에서는

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now