Adobe Campaign Standardコネクタ構成ガイド

コネクタアクション

アクション名	訪問プロファイル	イベントデータ
トランザクションイベントを送信	✓	✗
シグナルアクティビティをトリガー	✓	✗
プロファイルを作成または更新	✓	✗

構成の構成

コネクタマーケットプレイスに移動し、新しいコネクタを追加します。詳細については、コネクタについてを参照してください。

コネクタを追加した後、次の構成を構成します。

テクニカルアカウントID
- テクニカルアカウントIDは、Adobe I/O Consoleで確認できます。
- 詳細については、Adobe Experience Platform APIの認証とアクセスを参照してください。
組織ID
- 組織IDは、Adobe I/O Consoleで確認できます。
テナントID
- テナントIDは、Adobe Marketing CloudのURLで確認できます。
- 例：https://yourtenantid.experiencecloud.adobe.com/campaign.html
APIキー
- APIキー（クライアントID）は、Adobe I/O Consoleで確認できます。
シークレットキー
- クライアントシークレットは、Adobe I/O Consoleで確認できます。
秘密鍵
- 秘密鍵は、Adobe Consoleでインテグレーションを作成する際に生成されます。
- 詳細については、Adobe Experience Platform APIの認証とアクセスを参照してください。

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

続行をクリックして、コネクタアクションを構成します。アクションの名前を入力し、リストからアクションタイプを選択します。

アクション - トランザクションイベントを送信

トランザクションイベントを送信するには、最初にイベントを作成して構成する必要があります。詳細については、トランザクションイベントの構成およびトランザクションメッセージの管理を参照してください。

トランザクションイベントの送信に使用されるAPIエンドポイントは、構成によって異なります。

パラメータ

パラメータ	説明
メールアドレス	（必須）受信者のメールアドレス。
イベントID	（必須）送信するイベントのタイプ。このIDは、イベント定義の作成時に生成されます。詳細については、Adobe Campaignドキュメントを参照してください。
有効期限	（任意）この日付を過ぎると、トランザクションイベントの送信がキャンセルされます。
送信予定日時	（任意）この日時にトランザクションイベントが処理され、トランザクションメッセージが送信されます。
テンプレート名	テンプレートを使用してデータを渡す場合は、「トランザクションメッセージコンテンツテンプレート」に入力し、メインテンプレートの名前を指定します。名前に二重波括弧を含めないでください。たとえば、`{{SomeTemplateName}}`ではなく`SomeTemplateName`を使用します。
テンプレート変数	「トランザクションメッセージコンテンツテンプレート」のデータ入力としてテンプレート変数を指定します。詳細については、コネクターテンプレート変数を参照してください。ネストされたテンプレート変数には、ドット記法で名前を付けます。例：`items.name` ネストされたテンプレート変数は、通常、データレイヤーのリスト属性から作成されます。
トランザクションメッセージコンテンツテンプレート	拡張されたトランザクションメッセージのコンテンツを記述するテンプレート。テンプレートは、サポートされているフィールドに二重波括弧で囲んだ名前を使用して挿入されます。例：`{{SomeTemplateName}}`。拡張メッセージコンテンツの使用に関する詳細については、AdobeのCampaignドキュメントを参照してください。
トランザクションAPIエンドポイント	（任意）コネクタ構成のテナントIDの前に「`mc`」を付けたデフォルト値を上書きする場合に指定します。これは通常、ステージインスタンスで作業する場合に適用されます。例：ステージのテナントIDが「`geometrixx-mkt-stage3`」の場合、トランザクションAPIエンドポイントを「`geometrixx`」に上書きします。

アクション - シグナルアクティビティをトリガー

詳細については、Adobeドキュメントのシグナルアクティビティのトリガーを参照してください。

シグナルアクティビティをトリガーするには、RESTワークフロー／実行APIを使用します。

パラメータ

パラメータ	説明
ワークフローID	Adobe Consoleで構成されたワークフローのID。
ソース	トリガーリクエストの送信元を示すために使用します。
パラメータマップ	パラメータを指定してワークフローを呼び出すことができます。パラメータの値をその名前にマッピングします。文字列、数値、ブール値、および日付／時刻の各タイプがサポートされています。

アクション - プロファイルを作成または更新

プロファイルを取得、作成、または更新するため、Adobe ProfileAndServices APIにリクエストが送信されます。

詳細については、APIを使用したプロファイルの作成、APIを使用したプロファイルの更新、およびAPIを使用したプロファイルの取得を参照してください。

パラメーター

パラメーター	説明
更新方法	（必須）適用する更新方法を選択します。作成のみ — 既存のプロファイルを検索し、見つからない場合は新しいプロファイルを作成します。更新のみ — 既存のプロファイルを検索して更新します。作成または更新 — 既存のプロファイルを検索し、見つかった場合は更新し、それ以外の場合は新しいプロファイルを作成します。
フィルター	更新方法が作成または更新または更新のみの場合は必須です。一意の結果を返すフィルターを選択することを強く推奨します。詳細については、複合識別キーを参照してください。検索結果で複数のプロファイルが返された場合、最初のプロファイルのみが更新されます。
カスタムフィルターかどうか	カスタムフィルターについてを参照してください。
テンプレート変数	テンプレート変数をデータ入力として指定します。詳細については、コネクターテンプレート変数を参照してください。ネストされたテンプレート変数にはドット記法で名前を付けます。例：`items.name` ネストされたテンプレート変数は通常、データレイヤーのリスト属性から作成されます。
テンプレート	本文データで参照するテンプレートを指定します。詳細については、コネクタテンプレートについてを参照してください。テンプレートは、サポートされているフィールドに二重波括弧を使用して名前で挿入されます。例：`{{SomeTemplateName}}`