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

コネクタのアクション

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

構成の構成

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

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

テクニカルアカウントID
- テクニカルアカウントIDは、Adobe I/O Consoleで見つけることができます。
- 詳細については、Authenticating and accessing Adobe Experience Platform APIsを参照してください。
組織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での統合作成の一部として生成されます。
- 詳細については、Authenticating and accessing Adobe Experience Platform APIsを参照してください。

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

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

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

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

トランザクションイベントを送信するには、まずイベントを作成し、構成する必要があります。詳細については、Configuring a transactional eventとManaging transactional messagesを参照してください。

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

パラメータ

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

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

詳細については、AdobeのドキュメンテーションのTriggering a signal activityを参照してください。

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

パラメータ

パラメータ	説明
Workflow ID	あなたのAdobeコンソールで構成されたワークフローのID。
Source	トリガーリクエストのソースを示すために使用されます。
Parameter Map	パラメータ付きでワークフローを呼び出すことが可能です。パラメータの値をその名前にマップします。文字列、数値、ブール値、日付/時間のタイプがサポートされています。

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

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

詳細については、Creating Profiles with APIs, Updating Profiles with APIs、およびRetrieving profile with APIsを参照してください。

パラメータ

パラメータ	説明
Update Strategy	必須適用可能な更新戦略を選択します。 Create Only — 既存のプロファイルを検索し、見つからない場合は新しいプロファイルを作成します。 Update Only — 既存のプロファイルを検索し、更新します。 Create or Update — 既存のプロファイルを検索し、見つかった場合は更新し、見つからない場合は新しいプロファイルを作成します。
Filter	更新戦略が Create Or Update または Update Only の場合、必須です。一意の結果を返すフィルタを選択することを強く推奨します。詳細については、Composite Identification Keyを参照してください。検索結果が複数のプロファイルを返す場合、最初のプロファイルのみが更新されます。
Is Custom Filter	about custom filters.を参照してください。
Template Variables	データ入力としてテンプレート変数を提供します。詳細については、Template Variables Guideを参照してください。ネストされたテンプレート変数はドット表記法で名前を付けます。例：`items.name` ネストされたテンプレート変数は通常、データレイヤーリスト属性から作成されます。
Templates	Body Dataで参照されるテンプレートを提供します。詳細については、Templates Guideを参照してください。テンプレートは、名前で二重中括弧を使用してサポートされるフィールドに挿入されます。例：`{{SomeTemplateName}}`