翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Adobe Marketing Agent の統合
<a name="adobe-integration"></a>

Adobe Marketing Agent アクションコネクタを使用すると、自然言語で Adobe Experience Platform のマーケティングデータと AI を活用したマーケティング機能を Amazon Quick で直接操作できます。

Amazon Quick は、Adobe Marketing Agent の複数の認証方法をサポートしています。組織のセキュリティ要件に最適な方法を選択します。
+ **デフォルトの OAuth アプリケーション** –AWSが管理する OAuth アプリケーションを使用します。追加の認証情報は必要ありません。ユーザーは Adobe アカウントで直接認証されます。
+ **カスタム OAuth アプリ** – Adobe Developer Console に登録されたカスタマーマネージドアプリケーションを使用します。このオプションを使用すると、組織は OAuth 設定を完全に制御できます。
+ **Service-to-Service OAuth** – ユーザー操作なしでserver-to-server認証にクライアント認証情報を使用します。自動ワークフローに適しています。
+ **API キー** – 認証に API キーを使用します。サービスアカウントアクセスパターンに適しています。

Amazon Quick がサポートする認証方法の詳細については、「」を参照してください[認証方法](quick-action-auth.md)。

## [開始する前に]
<a name="adobe-integration-prerequisites"></a>

統合を設定する前に、以下があることを確認してください。
+ Adobe Marketing Agent にアクセスできるアクティブな Adobe アカウント。
+ **カスタム OAuth アプリ**または **Service-to-Service OAuth** の場合: [Adobe ウェブサイトの Adobe Developer Console](https://developer.adobe.com/console) にアクセスして、アプリを作成し、クライアント認証情報を取得します。
+ **API キー**の場合: 必要なマーケティングデータアクセススコープを持つ Adobe が発行した API キー。
+ Amazon Quick サブスクリプションの要件については、「」を参照してください[コンソールで統合を設定する](integration-console-setup-process.md)。

## Adobe の設定
<a name="adobe-source-setup"></a>

**デフォルトの OAuth アプリ**認証を使用している場合は、このセクションをスキップして に進みます[Amazon Quick でのコネクタのセットアップ](#adobe-quicksuite-setup)。

カスタム OAuth アプリまたは Service-to-Service OAuth 認証の場合は、Adobe [ウェブサイトの Adobe Developer Console](https://developer.adobe.com/console) にアプリを登録し、Amazon Quick コールバック URL をリダイレクト URI `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`として追加します。{{{region}}} を自分のAWSリージョン (例: ) に置き換えます`us-east-1`。クライアント ID とクライアントシークレットを記録します。Amazon Quick を設定するときに必要になります。API キー認証の場合は、Adobe アカウントから API キーを生成します。

## Amazon Quick でのコネクタのセットアップ
<a name="adobe-quicksuite-setup"></a>

### 使用可能なタブから接続する
<a name="adobe-quick-connect"></a>

デフォルトの OAuth アプリ認証を使用する場合は、追加の設定なしで**、利用可能な**タブから直接接続できます。

1. Amazon Quick コンソールで、**コネクタ**を選択します。

1. **使用可能な**タブで、**Adobe Marketing Agent** を検索し、**Connect** を選択します。

1. Adobe サインインフローを完了し、リクエストされたアクセス許可を付与します。

他の認証方法のいずれかを使用してコネクタを設定するには、以下で説明するように、**Create for your team** タブを使用します。

### チームの作成タブから を作成する
<a name="adobe-full-setup"></a>

1. Amazon Quick コンソールで、**コネクタ**を選択します。

1. **チームの作成**タブを選択します。

1. **Adobe Marketing Agent** を検索して選択します。

1. コネクタ**の名前**を入力します。必要に応じて、 **\+ 説明を追加** を選択して説明を追加します。

1. Connection **type** で、**Public network** を選択します。

1. **OAuth 設定では**、次のいずれかの認証方法を選択し、必須フィールドを設定します。

   1. **デフォルトの OAuth アプリ**の場合:

      追加の認証情報は必要ありません。**[次へ]** を選択して続行します。

   1. **カスタム OAuth アプリ**の場合は、次のフィールドを設定します。
      + **クライアント ID** – Adobe Developer Console アプリのクライアント ID。
      + **パブリック OAuth クライアント** (オプション) – Adobe Developer Console アプリがパブリッククライアント (クライアントシークレットなし) として設定されている場合は、このオプションを選択します。
      + **クライアントシーク**レット — Adobe Developer Console アプリからのクライアントシークレット。
      + **トークン URL** – トークンエンドポイント。デフォルト: `https://aep-ai-ama.adobe.io/token`
      + **認可 URL** – 認可エンドポイント。デフォルト: `https://aep-ai-ama.adobe.io/authorize`
      + **リダイレクト URL** – Amazon Quick コールバック URL があらかじめ入力されています。

   1. **Service-to-Service OAuth **では、次のフィールドを設定します。
      + **クライアント ID** – Adobe Developer Console Server-to-Server 認証情報のクライアント ID。
      + **クライアントシーク**レット – Adobe Developer Console Server-to-Server 認証情報からのクライアントシークレット。
      + **トークン URL** – トークンエンドポイント。デフォルト: `https://aep-ai-ama.adobe.io/token`

   1. **API キー**の場合は、次のフィールドを設定します。
      + **API キー** – Adobe API キー。
      + **E** メール (オプション) – API キーに関連付けられた E メールアドレス。

1. [**次へ**] を選択します。

1. **デフォルトの OAuth アプリ**または**カスタム OAuth アプリ**を選択した場合、Adobe 認可ウィンドウが開きます。リクエストされたアクセス許可を確認し、**許可**を選択します。

1. **レビュー**ページで、コネクタで使用可能なアクションを確認します。[**次へ**] を選択します。

1. **公開**ページで、コネクタにアクセスできるユーザーを選択します。組織内のすべてのユーザーに対してアクセスを有効にしたり、特定のチームやグループを検索したりできます。

1. **[公開]** を選択します。

## 使用可能なアクション
<a name="adobe-integration-actions"></a>

コネクタを設定すると、Adobe Marketing Agent によって公開されるアクションが使用可能になります。コネクタの現在のアクションセットを確認するには、Amazon Quick コンソールのコネクタの**利用可能なアクション**ビューに移動します。

## の管理とトラブルシューティング
<a name="adobe-integration-troubleshooting"></a>

コネクタを編集、共有、または削除するには、「」を参照してください[既存の統合の管理](integration-workflows.md#managing-existing-integrations)。

### 認証問題
<a name="adobe-troubleshooting-auth"></a>
+ **サインインが失敗する (デフォルトの OAuth アプリまたはカスタム OAuth アプリ)** – Adobe アカウントがアクティブであり、Adobe に直接サインインできることを確認します。カスタム OAuth アプリの場合、Adobe Developer Console アプリのリダイレクト URI が Amazon Quick コールバック URL と一致することを確認します。
+ **無効なクライアント認証情報 (カスタム OAuth アプリまたは Service-to-Service OAuth)** — クライアント ID とクライアントシークレットが Adobe Developer Console アプリの値と一致していることを確認します。
+ **API キー認証が失敗**する – API キーが取り消されていないこと、および実行するオペレーションに必要なスコープがあることを確認します。