이벤트 설명

마지막 업데이트: 2023-08-01

주제:
Transactional Messaging
이 항목에 대한 자세한 내용 보기
Message Center
이 항목에 대한 자세한 내용 보기

작성 대상:

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

트랜잭션 메시지는 Adobe Campaign 데이터 모델을 사용하며 두 개의 별도 테이블을 추가로 사용합니다. 다음 표, NmsRtEvent 및 NmsBatchEvent에는 동일한 필드가 포함되어 있으며 이를 통해 한 쪽은 실시간 이벤트를 관리하고 다른 쪽은 일괄 이벤트를 관리할 수 있습니다.

SOAP 메서드

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

2 푸시 이벤트 또는 푸시 이벤트 SOAP 메서드는 다음 두 항목에 연결됩니다 nms:rtEvent 및 nms:BatchEvent 데이터 스키마. 이벤트가 "일괄 처리" 유형인지 또는 "실시간" 유형인지를 결정하는 정보 시스템입니다.

푸시 이벤트 메시지에 단일 이벤트를 삽입할 수 있습니다.
푸시 이벤트 일련의 이벤트를 메시지에 삽입할 수 있습니다.

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

http://hostname/nl/jsp/schemawsdl.jsp?schema=nms:rtEvent 실시간 유형 스키마에 액세스합니다.
http://hostname/nl/jsp/schemawsdl.jsp?schema=nms:batchEvent 배치 유형 스키마에 액세스합니다.

WSDL 파일 생성에 대한 자세한 내용은 이 섹션.

두 메서드 모두 <urn:sessiontoken> 트랜잭션 메시지 모듈에 로그온하기 위한 요소입니다. 신뢰할 수 있는 IP 주소를 통해 식별 방법을 사용하는 것이 좋습니다. 세션 토큰을 검색하려면 로그온 SOAP 호출을 수행한 다음 get 토큰 뒤에 로그오프를 수행합니다. 여러 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>

다음 푸시 이벤트 메서드는 <urn:domevent> 이벤트를 포함하는 매개 변수.

다음 푸시 이벤트 메서드는 <urn:domeventcollection> 이벤트를 포함하는 매개 변수.

PushEvent 사용 예:

<urn:PushEvent>

 <sessiontoken>___921f9b38-72ac-49ad-b481-ab32973efc50</sessiontoken>

 <urn:domEvent>

   <rtEvent>

   ...

   </rtEvent>

 </urn:domEvent>

</urn:PushEvent>

노트

에 대한 호출의 경우 푸시 이벤트 메서드에서 표준 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">

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

이벤트 게재를 연기하려면 scheduled 필드 뒤에 기본 설정 날짜가 옵니다. 이벤트는 이 날짜에 메시지로 변환됩니다.

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

노트

모든 승인된 속성과 해당 값에 대한 자세한 설명은 의 설명에서 사용할 수 있습니다. nms:rtEvent 및 nms:BatchEvent dataschema.

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

이전 페이지

이벤트 설명

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

SOAP 메서드

SOAP 호출에서 반환된 정보

이 페이지의

다음 보기:

학습

설명서

커뮤니티

지원

리소스

Adobe 계정

Adobe