使用IMS與Adobe Analytics整合

上次更新: 2023-09-14

透過Analytics Standard API整合AEM與Adobe Analytics時,需要使用Adobe Developer Console設定Adobe IMS (Identity Management系統)。

注意

AEM 6.5.12.0新增對Adobe Analytics Standard API 2.0的支援。此版本的API支援IMS驗證。

在AEM中使用Adobe Analytics Classic API 1.4仍支援回溯相容性。 此 Analytics Classic API使用使用者認證.

API選取是由用於AEM/Analytics整合的驗證方法驅動。

如需詳細資訊,請參閱 移轉至2.0 API.

先決條件

開始此程式之前:

  • Adobe支援 必須為以下專案布建您的帳戶:

    • Adobe主控台
    • Adobe Developer Console
    • Adobe Analytics和
    • Adobe IMS (Identity Management系統)
  • 您組織的系統管理員應使用Admin Console,將您組織中所需的開發人員新增到相關的產品設定檔。

    • 這可讓特定開發人員在Adobe Developer Console中啟用整合。
    • 另請參閱 管理開發人員.

設定IMS設定 — 產生公開金鑰

設定的第一個階段是在AEM中建立IMS設定並產生公開金鑰。

  1. 在AEM中開啟 工具 功能表。

  2. 安全性 區段,選取 Adobe IMS設定.

  3. 選取 建立 以開啟 Adobe IMS技術帳戶設定.

  4. 使用下方的下拉式清單 雲端設定,選取 Adobe Analytics.

  5. 啟動 建立新憑證 並輸入新別名。

  6. 確認 建立憑證.

    Adobe IMS技術帳戶設定精靈

  7. 選取 下載 (或 下載公開金鑰)將檔案下載至本機磁碟機,以便在下列情況下可以使用: 為Adobe Analytics與AEM的整合設定IMS.

    注意

    將此設定保持開啟;此設定在 在AEM中完成IMS設定.

    新增金鑰至Adobe I/O的「資訊」對話方塊

為Adobe Analytics與AEM的整合設定IMS

使用Adobe Developer Console,建立與Adobe Analytics (供AEM使用)的專案(整合),然後指派所需的許可權。

建立專案

若要使用AEM能使用的Adobe Analytics建立專案,請開啟Adobe Developer Console:

注意

目前,Adobe僅支援Adobe Developer主控台的 服務帳戶(JWT) 認證型別。

請勿使用 OAuth伺服器對伺服器 未來將支援的認證型別。

  1. 開啟專案的Adobe Developer Console:

    https://developer.adobe.com/console/projects

  2. 系統會顯示您擁有的任何專案。 選取 建立新專案 — 位置和使用情況取決於以下因素:

    • 如果您還沒有任何專案, 建立新專案 是中下。

      建立新專案 — 第一個專案

    • 如果您已有現有的專案,則會列出和 建立新專案 位於右上角。

      建立新專案 — 多個專案

  3. 選取 新增至專案 後面接著 API

    開始使用您的新專案

  4. 選取 Adobe Analytics,然後 下一個

    注意

    如果您已訂閱Adobe Analytics,但它並未列出,您應檢視 必要條件.

    新增API

  5. 選取 服務帳戶(JWT) 做為驗證型別,然後繼續使用 下一個

    選取驗證型別

  6. 上傳您的公開金鑰,完成後,請繼續 下一個

    上傳您的公開金鑰

  7. 檢閱認證,然後繼續進行 下一個

    檢閱認證

  8. 選取所需的產品設定檔,並繼續 儲存已設定的API

    選取所需的產品設定檔

  9. 設定已確認。

指派許可權給整合

現在將必要的許可權指派給整合:

  1. 開啟Adobe Admin Console

  2. 瀏覽至 產品 (頂端工具列),然後選取 ADOBE ANALYTICS - <your-tenant-id> (從左側面板)。

  3. 選取 產品設定檔,然後從呈現的清單中選取您所需的工作區。 例如,預設工作區。

  4. 選取 API認證,則為所需的整合設定。

  5. 選取 編輯者 作為 產品角色;而非 觀察者.

為Adobe Developer主控台整合專案儲存的詳細資訊

從Adobe Developer專案主控台,您可以檢視所有整合專案的清單:

若要顯示有關設定的進一步詳細資訊,請選取特定專案專案。 這些類別包括:

  • 專案概述
  • Insights
  • 認證
    • 服務帳戶(JWT)
      • 認證詳細資料
      • 產生JWT
  • API
    • 例如,Adobe Analytics

您必須完成其中部分的整合,才能在AEM中整合Adobe Analytics。

在AEM中完成IMS設定

返回AEM時,您可以新增Analytics整合專案中所需的值來完成IMS設定:

  1. 返回 在AEM中開啟的IMS設定.

  2. 選取 下一個.

  3. 在這裡,您可以使用 為Adobe Developer主控台整合專案儲存的詳細資訊

    AEM IMS設定詳細資料

  4. 使用​建立​確認。

  5. 您的Adobe Analytics設定會顯示在AEM主控台中。

    IMS 設定

確認IMS設定

若要確認組態是否如預期般運作:

  1. 開啟:

    • https://localhost<port>/libs/cq/adobeims-configuration/content/configurations.html

    例如:

    • https://localhost:4502/libs/cq/adobeims-configuration/content/configurations.html
  2. 選取您的設定。

  3. 選取 檢查健康狀態 ,接著再按 檢查.

    IMS設定 — 檢查健康狀態

  4. 如果成功,您會看到一則確認訊息。

設定Adobe Analytics Cloud服務

現在可供使用Analytics Standard API的Cloud Service參考設定:

  1. 開啟 工具 功能表。 然後,在 Cloud Service 區段,選取 舊版Cloud Service.

  2. 向下捲動至 Adobe Analytics 並選取 立即設定.

    建立設定 對話方塊開啟。

  3. 輸入 標題 如果您願意,也可以 名稱 (如果保留為空白,則會從標題產生)。

    您也可以選取所需的範本(如果有多個範本可用)。

  4. 使用​建立​確認。

    編輯元件 對話方塊開啟。

  5. 請在以下欄位中輸入詳細資料: Analytics設定 標籤:

    • 驗證: IMS

    • IMS設定:選取IMS設定的名稱

  6. 若要初始化與Adobe Analytics的連線,請按一下 連線至Analytics.

    如果連線成功,則訊息會顯示 連線成功 隨即顯示。

  7. 選取 確定 在訊息上。

  8. 視需要完成其他引數,接著 確定 ,以便您確認組態。

  9. 您現在可以繼續前往 新增Analytics框架 以設定傳送至Adobe Analytics的引數。

本頁內容