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定義を使用して、Adobe Campaign Classicからv8へのMigratorをTealium Toolsに追加します:
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(移行済み)
となります。 - 新しいコネクタの構成とアクションを確認します。
- プロファイルを保存し、公開します。
許可するIPアドレス
TealiumのIPアドレスをAdobe Campaignの許可リスト(Adobe Experience Platform > Control Panel > Instances)に追加する必要があります。
詳細については、Adobe Campaign: IPアドレスの許可リストを参照してください。
アクション
アクション名 | AudienceStream | EventStream |
---|---|---|
カスタムSOAPリクエストの送信(バッチ処理) | ✓ | ✓ |
カスタムSOAPリクエストの送信 | ✓ | ✓ |
アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。
以下のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。
カスタムSOAPリクエストの送信(バッチ処理)
バッチ制限
このアクションは、ベンダーへの大量のデータ転送をサポートするためにバッチリクエストを使用します。リクエストは、以下のいずれかの閾値が満たされるまでキューに入れられます:
- リクエストの最大数:200
- 最古のリクエストからの最大時間:10分
- リクエストの最大サイズ:1MB
パラメータ
パラメータ | 説明 |
---|---|
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レスポンスエラー識別子 | レスポンスにエラー文字列が含まれている場合、それは失敗としてマークされます。デフォルトでは、HTTP レスポンスステータスが200 -299 の範囲外である場合も失敗としてマークされます。 |
カスタムSOAPリクエストの送信
パラメータ
パラメータ | 説明 |
---|---|
SOAPアクションヘッダー値 | 例:nms:rtEvent#PushEvent 。この値は SOAPAction HTTP ヘッダーに割り当てられます。 |
SOAPリクエストボディテンプレート | 送信するためのSOAP リクエストボディテンプレートを提供します。詳細はテンプレートガイドを参照してください。テンプレートは名前で二重中括弧によってサポートされたフィールドに注入されます、例えば{{SomeTemplateName}}。 |
SOAPリクエストボディテンプレート変数 | SOAPリクエストボディテンプレート のデータ入力としてテンプレート変数を提供します。詳細はテンプレート変数ガイドを参照してください。ネストされたテンプレート変数はドット表記法で名前を付けます、例えばitems.name 。ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。 |
SOAPレスポンスエラー識別子 | レスポンスにエラー文字列が含まれている場合、それは失敗としてマークされます。デフォルトでは、HTTP レスポンスステータスが200 -299 の範囲外である場合も失敗としてマークされます。 |
最終更新日 :: 2024年September月6日