Adobe Campaign v8 コネクタ構成ガイド
この記事では、Adobe Campaign v8 コネクタの構成方法について説明します。
構成
TealiumでAdobe Campaign v8コネクタを構成するには、まずAdobeで接続用のOAuthサーバー間認証情報を生成する必要があります。詳細については、Adobe: OAuthサーバー間認証を使用してプロジェクトにAPIを追加するを参照してください。
Adobeの認証情報を生成し、コネクタを構成するには、以下の手順を完了してください:
- 新しいAdobe Developer Consoleプロジェクトを作成するか、既存のプロジェクトを使用します。詳細については、Adobe: プロジェクト概要を参照してください。
- プロジェクトの認証情報に関連付けたいAdobeサービスをプロジェクトに追加します。詳細については、Adobe: サービス概要を参照してください。このコネクタには以下のサービスが必要です:
- Adobe Campaign API
- I/O Management API
- これらの認証情報で管理したいAdobe Campaign API製品プロファイルを選択します。
- サービスをプロジェクトに追加した後、プロジェクトの認証情報にアクセスできます。詳細については、Adobe: 認証情報を参照してください。
プロジェクト概要に移動し、認証情報セクションでOAuthサーバー間を選択します。このコネクタに必要な認証情報は以下の通りです:
- クライアントID(APIキー)
- クライアントシークレット
- テクニカルアカウントのメール
- 認証情報をメモして、コネクタの構成を完了するためにTealiumに戻ります。
- Tealiumでコネクタマーケットプレイスに移動し、新しいAdobe Campaign v8コネクタを追加します。コネクタの追加方法についての一般的な説明は、コネクタについてを参照してください。
- コネクタを追加した後、次の構成を構成します:
- クライアントID
- 必須:クライアントID(APIキー)。
- クライアントシークレット
- 必須:クライアントシークレット。
- サーバーホスト
- 必須:サーバーホストを提供します。
例えば、API URLhttps://example.campaign.adobe.com/nl/jsp/soaprouter.jsp
のホストはexample.campaign.adobe.com
です。
- 必須:サーバーホストを提供します。
- クライアントID
- Adobeで、Adobe Adminコンソールの開発者セクションに移動します。詳細については、Adobe: 開発者の管理を参照してください。
- Adobeプロジェクトの認証情報からテクニカルアカウントのメールを使用して新しい開発者を追加します。
- 追加した開発者にAdobe Campaign v8へのアクセスを許可します。
- Adobe Adminコンソールからユーザーを追加します。
- 追加した開発者のメールを追加します。
- Adobe Campaign Managed Cloudサービスを追加し、認証情報を作成する際に選択した製品プロファイルを含めます。 詳細については、Adobe: ユーザー権限の管理を参照してください。
- Adobe Campaignクライアントコンソールで新しく作成された技術オペレータを更新します。詳細については、Adobe: Campaignクライアントコンソール内の技術アカウントオペレータを更新するを参照してください。
移行
Adobe Campaign ClassicコネクタをAdobe Campaign V8コネクタに移行するには、Adobe Campaign Classicからv8 Migratorツールを使用します。
Tealium Toolsを使用してAdobe Analyticsタグを移行するには、次の手順を完了してください:
- 次のURLでJSON定義を使用してTealium ToolsにAdobe Campaign Classicからv8 Migratorを追加します:
https://solutions.tealium.net/hosted/tealiumTools/acc_to_v8/acc_to_v8.json
。カスタムツールの追加についての詳細は、カスタムツールの管理を参照してください。 - イベントコネクタまたはオーディエンスコネクタに移動し、Tealium ToolsからAdobe Campaign Classicからv8 Migratorツールを起動します。
- アクションの移行方法を選択します。既存のAdobe Campaign Classicアクションを無効にするには、既存のアクションを無効にするを選択します。アクティブなアクションのみを移行するには、アクティブなアクションのみを移行するを選択します。
- ドロップダウンリストから移行の範囲を選択します:
- すべてのAdobe Campaign Classicアクション
- 特定のAdobe Campaign Classicアクション
- 特定のAdobe Campaign Classicコネクタ
- プロジェクトのAdobe CampaignクライアントIDとクライアントシークレットを入力します。サーバーホストは既存のAdobe Campaign Classic構成から自動的に抽出されます。
- 開始をクリックします。
Migratorツールは自動的に既存のAdobe Campaign Classicコネクタを新しいAdobe Campaign v8コネクタに移行します。コネクタの名前は同じで、接尾辞はV8 (Migrated)
になります。 - 新しいコネクタの構成とアクションを確認します。
- プロファイルを保存して公開します。
許可するIPアドレス
Tealium IPアドレスをAdobe Campaign許可リスト(Adobe Experience Platform > Control Panel > Instances)に追加する必要があります。
詳細については、Adobe Campaign: IPアドレスの許可リストを参照してください。
アクション
アクション名 | AudienceStream | EventStream |
---|---|---|
Send Custom SOAP Request (Batched) | ✓ | ✓ |
Send Custom SOAP Request | ✓ | ✓ |
アクション名を入力し、ドロップダウンメニューからアクションタイプを選択します。
次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
Send Custom SOAP Request (Batched)
バッチ制限
このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。以下のいずれかの閾値が満たされるまでリクエストがキューに入れられます:
- 最大リクエスト数:200
- 最古のリクエストからの最大時間:10分
- リクエストの最大サイズ:1 MB
パラメータ
パラメータ | 説明 |
---|---|
SOAPアクションヘッダー値 | 例:nms:rtEvent#PushEvent のSOAP アクション。この値は SOAPAction HTTP ヘッダーに割り当てられます。 |
SOAPリクエストボディプレフィックス | SOAP リクエストの開始部分のテンプレートを提供します。例:<?xml version=" 1.0" encoding="utf- 8"?><soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:urn="urn:nms:rtEvent"><soapenv:Header/><soapenv:Body><urn:PushEvent><urn:domEvent> 。SOAP リクエストボディプレフィックスにテンプレート変数を使用できます。詳細については、コネクターテンプレートについてを参照してください。 |
SOAPリクエストボディデータ | SOAP リクエストバッチアイテムを送信するためのテンプレートを提供します。SOAP リクエストボディデータにテンプレート変数を使用できます。 |
SOAPリクエストボディサフィックス | SOAP リクエストの終了部分のテンプレートを提供します。例:</urn:domEvent></urn:PushEvent></soapenv:Body></soapenv:Envelope> 。SOAP リクエストボディサフィックスにテンプレート変数を使用できます。 |
SOAPリクエストボディジョイナー | バッチ処理時にボディアイテム間に使用する文字または文字列。指定されていない場合は空文字列が使用されます。 |
SOAPリクエストテンプレート変数 | SOAPリクエストボディプレフィックス 、SOAPリクエストボディデータ 、SOAPリクエストボディサフィックス のデータ入力用にテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。ドット表記でネストされたテンプレート変数を名前付けします。例えば、 items.name 。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
SOAPレスポンスエラー識別子 | レスポンスにエラー文字列が含まれている場合、それは失敗としてマークされます。デフォルトでは、200 -299 範囲外のHTTP レスポンスステータスも失敗としてマークされます。 |
Send Custom SOAP Request
パラメータ
パラメータ | 説明 |
---|---|
SOAP アクションヘッダー値 | 例:nms:rtEvent#PushEvent のSOAP アクション。この値は SOAPAction HTTP ヘッダーに割り当てられます。 |
SOAP リクエストボディテンプレート | 送信されるSOAP リクエストボディテンプレートを提供します。詳細については、コネクターテンプレートについてを参照してください。テンプレートは名前で二重中括弧によってサポートされるフィールドに注入されます。例えば、{{SomeTemplateName}} 。 |
SOAP リクエストボディテンプレート変数 | SOAP リクエストボディテンプレート のデータ入力としてテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。ドット表記を使用してネストされたテンプレート変数を名前付けします。例えばitems.name 。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
SOAP レスポンスエラー識別子 | レスポンスにエラー文字列が含まれている場合、それは失敗としてマークされます。デフォルトでは、200 -299 範囲外のHTTP レスポンスステータスも失敗としてマークされます。 |
最終更新日 :: 2025年June月13日