설명서CampaignCampaign v8 설명서

이벤트 설명 이해 about-event-desc

Last update: Tue Sep 03 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 주제:

작성 대상:

  • 중간
  • 사용자

트랜잭션 메시지 데이터 모델 about-mc-datamodel

트랜잭션 메시지는 Adobe Campaign 데이터 모델을 사용하며 두 개의 별도 테이블을 추가로 사용합니다. 이러한 테이블 NmsRtEvent 및 NmsBatchEvent ​은(는) 동일한 필드를 포함하며 한 번에 실시간 이벤트를 관리하고 다른 한 번에 일괄 이벤트를 관리할 수 있도록 해줍니다.

SOAP 메서드 soap-methods

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

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

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

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

  • 실시간 형식 스키마에 액세스하려면 http://hostname/nl/jsp/schemawsdl.jsp?schema=nms:rtEvent ​하십시오.
  • http://hostname/nl/jsp/schemawsdl.jsp?schema=nms:batchEvent(으)로 일괄 처리 유형 스키마에 액세스할 수 있습니다.

두 메서드에는 트랜잭션 메시지 모듈에 로그온하기 위한 <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>

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

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

PushEvent 사용 예:

<urn:PushEvent>

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

 <urn:domEvent>

   <rtEvent>

   ...

   </rtEvent>

 </urn:domEvent>

</urn:PushEvent>
NOTE
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> ​이(가) 있습니다.

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

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

이벤트 배달을 연기하려면 scheduled 필드 뒤에 기본 설정 날짜를 추가하십시오. 이벤트는 이 날짜에 메시지로 변환됩니다.

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

NOTE
모든 승인된 특성과 해당 값에 대한 자세한 설명은 nms:rtEvent 및 nms:BatchEvent 데이터 스키마에 대한 설명에서 확인할 수 있습니다.

<ctx> 요소에 메시지 데이터가 포함되어 있습니다. 해당 XML 콘텐츠는 열려 있습니다. 즉, 전달할 콘텐츠에 따라 구성할 수 있습니다.

NOTE
게재 중에 서버를 오버로드할 수 있도록 메시지에 포함된 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 호출에서 반환된 정보 information-returned-by-the-soap-call

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

IMPORTANT
SOAP 호출을 받으면 Adobe Campaign은 이메일 주소 형식을 확인합니다. 이메일 주소 형식이 올바르지 않으면 오류가 반환됩니다.

  • 이벤트 처리가 성공적으로 수행된 경우 메서드에서 반환된 식별자의 예:

    code language-none 
    <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과 같은 값을 반환합니다.

  • 쿼리에 로그인이 없거나 지정된 연산자에 필수 권한이 없는 경우 실패한 이벤트의 처리 예:

    code language-none 
    <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 분류가 준수되지 않음):

    code language-none 
    <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>

  • 실패하고 제로 식별자를 반환하는 이벤트의 예(잘못된 메서드 이름):

    code language-none 
    <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>
recommendation-more-help
35662671-8e3d-4f04-a092-029a056c566b