AudienceStream用Adobe Campaignコネクタ構成ガイド | サーバーサイドコネクター

必要条件

Adobe Campaignアカウント
SOAP APIクレデンシャル
クレデンシャルについては、Adobeの担当者にお問い合わせください。
AudienceStreamサーバーのIPアドレスをホワイトリストに登録

AdobeによってIPアドレスがホワイトリストに登録されていない場合、トレース機能は次のエラーを表示します: Action Failure: Error: received non-successful http response status = 403

コネクタアクション

アクション名	AudienceStream	EventStream
カスタムSOAPリクエスト送信	✓	✗

構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタを追加する一般的な手順については、コネクタについての記事を参照してください。

このコネクタはAdobe CampaignのSOAPログオン方法を使用してSOAP APIに接続します。詳細については、Adobe Campaignの接続ドキュメントを参照してください。

ベンダーを構成するには、以下の手順に従います：

構成タブでコネクタインスタンスのタイトルを入力します。
Adobeからアカウント用に受け取ったSOAP APIのユーザー名とパスワードを入力します。
Adobeからアカウント用に受け取ったSOAP APIエンドポイントを入力します。ドメインのみを含めます。
例：サーバーパスが<http://example.com/nl/jsp/soaprouter.jsp>の場合、このフィールドに「example.com」とだけ入力します。
実装に関する追加のノートを提供します。
接続確立をクリックしてAPIの接続性を確認します。

アクション構成 - パラメータとオプション

次へをクリックするか、アクションタブに移動します。ここでコネクタアクションを構成します。

このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

アクション - カスタムSOAPリクエスト送信

パラメータ

パラメータ	説明
SOAPActionヘッダー値	このパラメータは必須です例: `xtk:workflow#PostEvent`。
SOAPリクエストボディテンプレート変数	“SOAP Request Body Template"のデータ入力用にテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。ドット表記を使用してネストされたテンプレート変数を命名します。例: `items.name`。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます
SOAPリクエストボディテンプレート	必須。送信するSOAPリクエストボディテンプレートを提供します。詳細については、コネクタテンプレートについてを参照してください。テンプレートは、例えば`{{SomeTemplateName}}`のように、サポートされるフィールドに名前で注入されます。 Adobe Campaign APIコールにはセッショントークンが必要です。適切な場所にそれをテンプレートに含めてください。このトークンをテンプレートに含めるために、予約済みのテンプレートキーワード`{{sessionToken}}`を使用します。
SOAPレスポンスエラー識別子	レスポンスに以下のいずれかのエラー文字列が含まれている場合（OR条件）、それは失敗としてマークされます。デフォルトでは、200-299の範囲外のHTTPレスポンスステータスも失敗としてマークされます。
任意のフォルトコードとフォルト文字列レスポンスに対してエラーを投げる	ボディレスポンスに含まれる任意のフォルトコードまたはフォルト文字列がキャプチャされ、エラーとして返されます。

追加のヘルプについては、Adobe Campaign v6.1構成ガイドを参照してください。

追加のノート

SOAPリクエストボディテンプレートが必要です。
- サポートされるフィールドにテンプレートを注入するには、その名前を二重中括弧で囲みます。例: {{SomeTemplateName}}。
- 一般的な構文と拡張についての詳細は、コネクタテンプレートについてを参照してください。
Adobe Campaign APIコールにはセッショントークンが必要です
- 適切な場所にそれをテンプレートに含めてください。
- このトークンをテンプレートに含めるために、予約済みのテンプレートキーワード{{sessionToken}}を使用します。
- 予約キーワードは事前に定義され、自動的に入力されます。
テンプレート変数はオプションです。
- ネストされたテンプレート変数を命名するには、ドット表記を使用します。例: items.name。
- ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
- 詳細については、コネクターテンプレート変数を参照してください。

使用例

PostEvent SOAPリクエストを送信するためのサンプル構成です。

パラメータ - オプション	説明
SOAPActionヘッダー値	`xtk:workflow#PostEvent`のカスタム値を構成
SOAPリクエストボディテンプレート変数	`workflow1000`のカスタム値を`strWorkflowId`にマップ `importTask2000`のカスタム値を`strActivity`にマップ
SOAPリクエストボディテンプレート	`<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns0="urn:xtk:workflow"> <SOAP-ENV:Header /> <SOAP-ENV:Body> <ns0:PostEvent> <ns0:sessiontoken>{{sessionToken}}</ns0:sessiontoken> <ns0:strWorkflowId>{{strWorkflowId}}</ns0:strWorkflowId> <ns0:strActivity>{{strActivity}}</ns0:strActivity> </ns0:PostEvent> </SOAP-ENV:Body> </SOAP-ENV:Envelope>`
SOAPレスポンスエラー識別子	`SOAP-ENV:Fault`のカスタム値を構成

例のリクエスト

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
	xmlns:ns0="urn:xtk:workflow">
	<SOAP-ENV:Header />
	<SOAP-ENV:Body>
		<ns0:PostEvent>
			<ns0:sessiontoken>EXAMPLE_TEALIUM_POPULATED_TOKEN</ns0:sessiontoken>
            <ns0:strWorkflowId>workflow1000</ns0:strWorkflowId>
            <ns0:strActivity>importTask2000</ns0:strActivity>
		</ns0:PostEvent>
	</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

例のレスポンス

<?xml version='1.0'?>
	<SOAP-ENV:Envelope xmlns:xsd='http://www.w3.org/2001/XMLSchema'
		xmlns:xsi='http://www.w3.org/2001/XMLSchema-instance' xmlns:ns='urn:xtk:workflow'
		xmlns:SOAP-ENV='http://schemas.xmlsoap.org/soap/envelope/'>
		<SOAP-ENV:Body>
			<PostEventResponse xmlns='urn:xtk:workflow'
				SOAP-ENV:encodingStyle='http://schemas.xmlsoap.org/soap/encoding/'></PostEventResponse>
		</SOAP-ENV:Body>
	</SOAP-ENV:Envelope>

例外エラーレスポンス

SOAPコールレスポンスのHTTPステータスが200-299である場合、または「SOAPレスポンスエラー識別子」のいずれかを含む場合、アクションは失敗と見なされます。この例では、レスポンスに識別子「SOAP-ENV:Server」が含まれているため、アクションは失敗とマークされます。

<?xml version='1.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:Server</faultcode>
				<faultstring xsi:type='xsd:string'>SOP-330011 Error while executing
					the method 'PostEvent' of service 'xtk:workflow'.</faultstring>
			</SOAP-ENV:Fault>
		</SOAP-ENV:Body>
	</SOAP-ENV:Envelope>

フォルトコードとフォルト文字列レスポンスのエラーを投げる パラメータを有効にすると、コネクタはボディレスポンスに含まれるフォルトコードまたはフォルト文字列をエラーとして返します：

</soapenv:Body>
</soapenv:Envelope>; error_identifier = SOP-330011; Action Result Response: Http Response 200 <?xml version='1.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:Server</faultcode><faultstring xsi:type='xsd:string'>SOP-330011 Error while executing the method 'addAbandonedCart' of service 'va:abandoned_cart_event'.</faultstring><detail xsi:type='xsd:string'>ODB-240000 ODBC error: [Microsoft][SQL Server Native Client 11.0][SQL Server]Transaction (Process ID 108) was deadlocked on lock | communication buffer resources with another process and has been chosen as the deadlock victim. Rerun the transaction. SQLState: 40001
XSV-350023 Unable to save document of type 'abandoned_cart_events (va:abandoned_cart_event)'.
SOP-330011 Error while executing the method 'Write' of service 'xtk:persist|xtk:session'.</detail>
</SOAP-ENV:Fault>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

 <soapenv:Body>
<urn:addAbandonedCart>
         <urn:sessiontoken> {{ sessionToken }} </urn:sessiontoken>
         <urn:days_to_departure> {{ days_to_departure }} </urn:days_to_departure>
         <urn:recipient_id> {{ recipient_id }} </urn:recipient_id>
         <urn:abandoned_type> {{ abandoned_type }} </urn:abandoned_type>
         <urn:msg_id> {{ msg_id }} </urn:msg_id>
         <urn:origin_code> {{ origin_code }} </urn:origin_code>
         <urn:triggerType> {{ triggerType }} </urn:triggerType>
         <urn:velocity_id> {{ velocity_id }} </urn:velocity_id>
         <urn:timeGMT> {{ timeGMT }} </urn:timeGMT>
         <urn:experianId> {{ experianId }} </urn:experianId>
         <urn:main_dest_code> {{ main_dest_code }} </urn:main_dest_code>
</urn:addAbandonedCart>
</soapenv:Body>
</soapenv:Envelope>; error_identifier = SOP-330011; Action Time: 5088 ms

ベンダー文書

Adobe Campaign Classic v7: Webサービスコール