AudienceStream用 Adobe Campaign コネクタ構成ガイド
この記事では、Customer Data HubアカウントでAdobe Campaignコネクタを構成する方法について説明します。
必要条件
- Adobe Campaignアカウント
- SOAP APIの資格情報
あなたの資格情報については、Adobeの担当者にお問い合わせください。 - AudienceStreamサーバーのIPアドレスをホワイトリストに登録
IPアドレスがAdobeによってホワイトリストに登録されていない場合、トレース機能は次のエラーを表示します：Action Failure: Error: received non-successful http response status = 403
コネクタのアクション
| アクション名 | AudienceStream | EventStream |
|---|---|---|
| カスタムSOAPリクエストを送信 | ✓ | ✗ |
構成の構成
コネクタマーケットプレイスに移動し、新しいコネクタを追加します。コネクタの追加方法の一般的な指示については、コネクタについての記事を参照してください。
このコネクタは、Adobe CampaignのSOAPログオン方法を使用してSOAP APIに接続します。詳細については、Adobe Campaignの接続性ドキュメンテーションを参照してください。
ベンダーを構成するには、次の手順に従ってください：
- Configureタブで、コネクタインスタンスにタイトルを提供します。
- Adobeから受け取ったSOAP APIのユーザー名とパスワードを入力します。
- Adobeから受け取ったSOAP APIエンドポイントを入力します。ドメインのみを含めてください。
例：サーバーパスが<http://example.com/nl/jsp/soaprouter.jsp>の場合、このフィールドには"example.com"のみを入力します。 - 実装に関する追加のメモを提供します。
- 接続を確立をクリックしてAPI接続を確認します。
アクション構成 - パラメータとオプション
次へをクリックするか、アクションタブに移動します。ここでコネクタアクションを構成します。
このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
アクション - カスタムSOAPリクエストを送信
パラメータ
| パラメータ | 説明 |
|---|---|
| SOAPActionヘッダー値 |
|
| SOAPリクエストボディテンプレート変数 |
|
| SOAPリクエストボディテンプレート |
|
| SOAPレスポンスエラー識別子 |
|
| 任意のフォールトコードとフォールトストリングレスポンスに対してエラーをスロー |
|
詳細なヘルプについては、Adobe Campaign v6.1構成ガイドを参照してください。
追加の注意事項
-
SOAPリクエストボディテンプレートが必要です。
- テンプレートをサポートされているフィールドに注入するには、その名前を二重中括弧で囲むだけです。例：
{{SomeTemplateName}}。 - 一般的な構文と拡張については、テンプレートガイドを参照してください。
- テンプレートをサポートされているフィールドに注入するには、その名前を二重中括弧で囲むだけです。例：
-
Adobe Campaign APIの呼び出しにはセッショントークンが必要です
- 適切な場所にテンプレートに含めてください。
- このトークンをテンプレートに含めるために、予約されたテンプレートキーワード
{{sessionToken}}を使用します。 - 予約キーワードは事前に定義され、自動的にあなたのために入力されます。
-
テンプレート変数はオプションです。
- ネストされたテンプレート変数の名前を付けるには、ドット表記を使用します。例：
items.name。 - ネストされたテンプレート変数は通常、データレイヤーリスト属性から作成されます。
- 詳細については、テンプレート変数ガイドを参照してください。
- ネストされたテンプレート変数の名前を付けるには、ドット表記を使用します。例：
使用例
PostEvent SOAPリクエストを送信するためのサンプル構成です。
| パラメータ - オプション | 説明 |
|---|---|
| SOAPActionヘッダー値 |
|
| SOAPリクエストボディテンプレート変数 |
|
| 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: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 Call ResponseのHTTPステータスが200-299であるか、または"SOAP Response Error Identifier"の値を含む場合、アクションは失敗とみなされます。この例では、レスポンスに識別子"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
ベンダードキュメンテーション
最終更新日 :: 2022年June月28日