View a markdown version of this page

Adobe Marketing Agent 整合 - Amazon Quick

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Adobe Marketing Agent 整合

透過 Adobe Marketing Agent 動作連接器,您可以透過自然語言直接在 Amazon Quick 中使用 Adobe Experience Platform 行銷資料和 AI 驅動的行銷功能。

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 開發人員主控台,以建立應用程式並取得用戶端登入資料。

  • 對於 API 金鑰:Adobe 發行的 API 金鑰,具有所需的行銷資料存取範圍。

  • 如需 Amazon Quick 訂閱需求,請參閱 在主控台中設定整合。

設定 Adobe

如果您使用預設 OAuth 應用程式身分驗證,請略過本節並繼續 在 Amazon Quick 中設定連接器。

對於自訂 OAuth 應用程式或 Service-to-Service OAuth 身分驗證,請在 Adobe 網站上的 Adobe 開發人員主控台中註冊應用程式,並將 Amazon Quick 回呼 URL 新增https://{region}.quicksight.aws.amazon.com/sn/oauthcallback為重新導向 URI。將 {region} 取代為您的AWS區域 (例如 us-east-1)。記錄用戶端 ID 和用戶端秘密 - 您在設定 Amazon Quick 時需要它們。針對 API 金鑰身分驗證,從您的 Adobe 帳戶產生 API 金鑰。

在 Amazon Quick 中設定連接器

從可用索引標籤連線

如果您想要使用預設 OAuth 應用程式身分驗證,您可以直接從可用索引標籤連線,而不需要其他組態。

  1. 在 Amazon Quick 主控台中,選擇連接器。

  2. 在可用索引標籤上,尋找 Adobe Marketing Agent 並選擇連線。

  3. 完成 Adobe 登入流程並授予請求的許可。

若要使用其他身分驗證方法之一設定連接器,請使用為您的團隊建立索引標籤,如下所述。

從為您的團隊建立索引標籤建立

  1. 在 Amazon Quick 主控台中,選擇連接器。

  2. 選擇為您的團隊建立索引標籤。

  3. 尋找並選擇 Adobe Marketing Agent。

  4. 輸入連接器的名稱。或者,選擇 + 新增描述以新增描述。

  5. 針對連線類型,選擇公有網路。

  6. 針對 OAuth 組態,選擇下列其中一種身分驗證方法,並設定必要欄位。

    1. 對於預設 OAuth 應用程式:

      不需要額外的登入資料。選擇 Next (下一步) 繼續。

    2. 對於自訂 OAuth 應用程式,請設定下列欄位:

      • 用戶端 ID – 來自 Adobe Developer Console 應用程式的用戶端 ID。

      • Public 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 金鑰。

      • Email (選用) – 與 API 金鑰相關聯的電子郵件地址。

  7. 選擇下一步。

  8. 如果您選擇預設 OAuth 應用程式或自訂 OAuth 應用程式,則會開啟 Adobe 授權視窗。檢閱請求的許可,然後選擇允許。

  9. 在檢閱頁面上,檢閱連接器的可用動作。選擇下一步。

  10. 在發佈頁面上,選擇誰可以存取連接器。您可以為組織中的每個人啟用存取權,或搜尋特定的團隊或群組。

  11. 選擇發布。

可用動作

設定連接器後,Adobe Marketing Agent 公開的動作即可使用。若要查看連接器目前的一組動作,請前往 Amazon Quick 主控台中連接器的可用動作檢視。

管理和故障診斷

若要編輯、共用或刪除連接器,請參閱 管理現有的整合。

驗證問題

  • 登入失敗 (預設 OAuth 應用程式或自訂 OAuth 應用程式) – 確認您的 Adobe 帳戶處於作用中狀態,而且您可以直接登入 Adobe。對於自訂 OAuth 應用程式,請確認 Adobe 開發人員主控台應用程式中的重新導向 URI 符合 Amazon Quick 回呼 URL。

  • 無效的用戶端登入資料 (自訂 OAuth 應用程式或服務Service-to-Service OAuth) – 驗證用戶端 ID 和用戶端秘密是否符合 Adobe 開發人員主控台應用程式中的值。

  • API 金鑰驗證失敗 – 確認 API 金鑰尚未撤銷,且具有您要執行之操作所需的範圍。