View a markdown version of this page

Adobe Marketing Agent の統合 - Amazon Quick

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

Adobe Marketing Agent の統合

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 がサポートする認証方法の詳細については、「」を参照してください認証方法。

[開始する前に]

統合を設定する前に、以下があることを確認してください。

  • Adobe Marketing Agent にアクセスできるアクティブな Adobe アカウント。

  • カスタム OAuth アプリまたは Service-to-Service OAuth の場合: Adobe ウェブサイトの Adobe Developer Console にアクセスして、アプリを作成し、クライアント認証情報を取得します。

  • API キーの場合: 必要なマーケティングデータアクセススコープを持つ Adobe が発行した API キー。

  • Amazon Quick サブスクリプションの要件については、「」を参照してくださいコンソールで統合を設定する。

Adobe の設定

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

カスタム OAuth アプリまたは Service-to-Service OAuth 認証の場合は、Adobe ウェブサイトの Adobe Developer 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 でのコネクタのセットアップ

使用可能なタブから接続する

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

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

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

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

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

チームの作成タブから を作成する

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

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

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

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

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

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

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

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

    2. カスタム 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 があらかじめ入力されています。

    3. 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

    4. API キーの場合は、次のフィールドを設定します。

      • API キー – Adobe API キー。

      • E メール (オプション) – API キーに関連付けられた E メールアドレス。

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

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

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

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

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

使用可能なアクション

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

の管理とトラブルシューティング

コネクタを編集、共有、または削除するには、「」を参照してください既存の統合の管理。

認証問題

  • サインインが失敗する (デフォルトの OAuth アプリまたはカスタム OAuth アプリ) – Adobe アカウントがアクティブであり、Adobe に直接サインインできることを確認します。カスタム OAuth アプリの場合、Adobe Developer Console アプリのリダイレクト URI が Amazon Quick コールバック URL と一致することを確認します。

  • 無効なクライアント認証情報 (カスタム OAuth アプリまたは Service-to-Service OAuth) — クライアント ID とクライアントシークレットが Adobe Developer Console アプリの値と一致していることを確認します。

  • API キー認証が失敗する – API キーが取り消されていないこと、および実行するオペレーションに必要なスコープがあることを確認します。