이벤트 설명

트랜잭션 메시지 데이터 모델

트랜잭션 메시지는 Adobe Campaign 데이터 모델을 기반으로 하며 두 개의 별도 테이블을 사용합니다. 이러한 , NmsRtEventNmsBatchEvent​는 동일한 필드를 포함하며, 한 번에 실시간 이벤트를 관리하고 다른 한 손에서는 배치 이벤트를 관리할 수 있습니다.

SOAP 메서드

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

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

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

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

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

두 메서드 모두 트랜잭션 메시지 모듈에 로그온하기 위한 <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> 요소를 사용하면 이벤트를 "batch" 큐에 추가할 수 있습니다. <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"> 

이 예제에서 두 개의 채널이 제공됩니다.이메일 주소와 휴대폰 번호입니다. WonderedChannel 을 사용하면 이벤트를 메시지로 변환할 때 사용할 채널을 선택할 수 있습니다. "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>
    
  • 실패 및 반환 이벤트의 예(잘못된 메서드 이름):

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

이 페이지에서는