使用IMS與Adobe Target整合

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

注意

AEM 6.5新增了對Adobe Target Standard API的支援。Target Standard API使用IMS驗證。

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

API選擇由用於AEM/Target整合的驗證方法驅動。
另請參閱 租使用者ID和使用者端代碼 區段。

必備條件

開始此程式之前:

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

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

    • 這可讓特定開發人員擁有在Adobe Developer主控台中啟用整合的許可權。
    • 如需詳細資訊,請參閱 管理開發人員.

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

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

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

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

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

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

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

  6. 確認方式 建立憑證.

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

    注意

    保持此設定開啟,以下情況下將再次需要它: 完成AEM中的IMS設定.

為Adobe Target與AEM的整合設定IMS

使用Adobe Developer Console時,您需要使用AEM將使用的Adobe Target建立專案(整合),然後指派所需的許可權。

建立專案

開啟Adobe Developer Console以使用AEM將使用的Adobe Target建立專案:

  1. 開啟專案的Adobe Developer主控台:

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

  2. 將會顯示您擁有的任何專案。 選取 建立新專案 — 位置和使用將取決於:

    • 如果您還沒有任何專案, 建立新專案 將會是底部中心。

      建立新專案 — 第一個專案

    • 如果您已有專案,這些專案將會列示於 建立新專案 將位於右上方。

      建立新專案 — 多個專案

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

  4. 選取 Adobe Target,則 下一個

    注意

    如果您已訂閱Adobe Target,但未看到它列出,則應檢視 先決條件.

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

  6. 檢閱認證,並繼續 下一個

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

    注意

    顯示的產品設定檔取決於您是否具備:

    • Adobe Target Standard — 僅限 預設工作區 可用
    • Adobe Target Premium — 列出所有可用的工作區,如下所示

  8. 將會確認建立。

指派許可權給整合

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

  1. 開啟Adobe Admin Console

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

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

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

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

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

在Adobe Developer Console — 專案中,您可以看到所有整合專案的清單:

選取 檢視 (特定專案專案右側)以顯示有關設定的更多詳細資料。 這些類別包括:

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

您需要其中的一些專案,才能在AEM的IMS架構中完成Adobe Target的整合。

完成AEM中的IMS設定

返回AEM後,您可以從Target的Adobe Developer主控台整合中新增所需值,以完成IMS設定:

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

  2. 選取 下一個.

  3. 您可以在此處使用 Adobe Developer Console中專案設定的詳細資料

    • 標題:您的文字。
    • 授權伺服器:從以下位置複製/貼上此 aud裝載 以下區段,例如 https://ims-na1.adobelogin.com 在以下範例中
    • API金鑰:從以下位置複製此專案: 概觀 區段
    • 使用者端密碼:在中產生此專案 概觀 區段和副本
    • 裝載:從以下位置複製此專案: 產生JWT 區段

    技術帳戶設定

  4. 使用​建立​確認。

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

確認IMS設定

若要確認設定是否如預期般運作,請執行下列動作:

  1. 開啟:

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

    例如:

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

  3. 選取 檢查健康狀態 (從工具列),後面接著 Check.

  4. 如果成功,您會看到訊息:

設定Adobe TargetCloud Service

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

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

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

    建立設定 對話方塊將會開啟。

  3. 輸入 標題 此外,如果您願意,也可以 名稱 (如果留空,這將從標題產生)。

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

  4. 使用​建立​確認。

    編輯元件 對話方塊將會開啟。

  5. 在「 」中輸入詳細資料 Adobe Target設定 標籤:

    • 驗證: IMS

    • 租使用者ID:Adobe IMS租使用者ID。 另請參閱 租使用者ID和使用者端代碼 區段。

      注意

      IMS需要從Target本身取得此值。 您可以登入Target,並從URL擷取租使用者ID。

      例如,如果URL為:

      https://experience.adobe.com/#/@yourtenantid/target/activities

      然後您會使用 yourtenantid.

    • 使用者端代碼:請參閱 租使用者ID和使用者端代碼 區段。

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

    • API型別:REST

    • A4T Analytics Cloud設定:選取用於Target活動目標和量度的Analytics雲端設定。 如果您在鎖定目標內容時使用Adobe Analytics作為報表來源,則需要此專案。 如果您沒有看到雲端設定,請參閱中的注意事項 設定A4T Analytics Cloud設定.

    • 使用準確定位:預設會選取此核取方塊。 如果選取,雲端服務設定將等待內容載入後再載入內容。 請參閱下列附註。

    • 從Adobe Target同步區段:選取此選項可下載Target中定義的區段,以便在AEM中使用它們。 當API型別屬性為REST時,您必須選取此選項,因為不支援內嵌區段,而且您一律需要使用來自Target的區段。 (請注意,AEM辭彙「區段」等同於Target「對象」。)

    • 使用者端資源庫:選取您想要使用AT.js使用者端程式庫,還是mbox.js (已棄用)。

    • 使用Tag Management系統來提供使用者端資源庫:使用DTM (已棄用)、AdobeLaunch或任何其他標籤管理系統。

    • 自訂AT.js:如果您勾選Tag Management方塊或使用預設的AT.js,請保留空白。 或者,您也可以上傳自訂AT.js。 僅當您已選取AT.js時顯示。

    注意

    使用Target Classic API的Cloud Service設定 已棄用(使用Adobe Recommendations設定索引標籤)。

  6. 按一下 連線到目標 以初始化與Adobe Target的連線。

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

  7. 選取 確定 在訊息上,後面接著 確定 ,以確認設定。

  8. 您現在可以繼續前往 新增目標框架 以設定將傳送至Target的ContextHub或ClientContext引數。 請注意,這可能不是將AEM體驗片段匯出至Target的必要專案。

租使用者ID和使用者端代碼

替換為 Adobe Experience Manager 6.5.8.0,則「使用者端代碼」欄位已新增至Target設定視窗。

設定租使用者ID和使用者端代碼欄位時,請注意下列事項:

  1. 對於大多數客戶而言,租使用者ID和使用者端代碼是相同的。 這表示兩個欄位包含相同的資訊且相同。 請務必在兩個欄位中輸入租使用者ID。
  2. 若是舊版用途,您也可以在「租使用者ID」和「使用者端代碼」欄位中輸入不同的值。

在這兩種情況下,請注意:

  • 根據預設,使用者端代碼(如果先新增)也會自動複製到「租使用者ID」欄位中。
  • 您可以選擇變更預設的租使用者ID集。
  • 因此,對Target進行的後端呼叫將以租使用者ID為基礎,而對Target進行的使用者端呼叫將以使用者端代碼為基礎。

如前所述,第一個案例最常用於AEM 6.5。無論是哪一種方式,請確定 兩者 欄位包含正確的資訊,具體取決於您的需求。

注意

如果您想要變更現有的Target組態:

  1. 重新輸入租使用者ID。
  2. 重新連線至Target。
  3. 儲存設定。

本頁內容