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

コネクタアクション

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

構成の構成

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

コネクタを追加した後、以下の構成を構成します：

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

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

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

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

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

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

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

パラメータ

パラメータ	説明
Email	必須。受信者のメールアドレス。
Event ID	必須。送信したいイベントのタイプ。このIDはイベント定義を作成する際に生成されます。追加情報については、Adobe Campaign ドキュメントを参照してください。
Expiration Date	オプション。この日付後にトランザクショナルイベントの送信がキャンセルされます。
Scheduled Send Date	オプション。この日付にトランザクショナルイベントが処理され、トランザクショナルメッセージが送信されます。
Template Name	データを渡すためにテンプレートを使用する場合、「Transactional Message Content Template」と入力し、メインテンプレートの名前を入力します。名前に二重中括弧を含めないでください。例えば、`SomeTemplateName` を使用し、`{{SomeTemplateName}}` は使用しないでください。
Template Variables	「Transactional Message Content Template」のデータ入力用にテンプレート変数を提供します。詳細については、コネクターテンプレート変数を参照してください。ドット表記でネストされたテンプレート変数の名前を付けます。例：`items.name` ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。
Transactional Message Content Template	エンリッチされたトランザクショナルメッセージコンテンツを記述するテンプレート。テンプレートは、サポートされているフィールドに名前で二重中括弧を使用して挿入されます。例：`{{SomeTemplateName}}`。エンリッチされたメッセージコンテンツの使用についての追加情報は、Adobeの Campaign ドキュメントを参照してください。
Transactional API Endpoint	オプション。デフォルト値 “`mc`” に続くコネクタ構成からのテナントIDを上書きするために指定します。これは通常、ステージインスタンスで作業する場合に適用されます。例：ステージテナントIDが “`geometrixx-mkt-stage3`” の場合、Transactional API Endpoint を “`geometrixx`” に上書きします。

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

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

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

パラメータ

パラメータ	説明
Workflow ID	Adobeコンソールで構成されたワークフローのID。
Source	トリガーリクエストのソースを示すために使用されます。
Parameter Map	パラメータを使用してワークフローを呼び出すことが可能です。パラメータの値をその名前にマップします。 String、Number、Boolean、および Date/Time タイプがサポートされています。

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

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

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

パラメータ

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