與Adobe Target整合,使用Adobe I/O

AEM透過Target Standard API與Adobe Target整合時,需要設定Adobe IMS(Identity Management系統)和Adobe I/O。

注意

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 I/O
    • Adobe Target和
    • Adobe IMS(Identity Management系統)
  • 您組織的系統管理員應使用Admin Console,將組織中所需的開發人員新增至相關的產品設定檔。

    • 這可為特定開發人員提供權限,以在Adobe I/O內啟用整合。
    • 如需詳細資訊,請參閱管理開發人員

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

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

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

  2. 在​Security​區段中,選取​Adobe IMS設定

  3. 選擇​Create​以開啟​Adobe IMS Technical Account Configuration

  4. 使用​雲配置​下拉式清單,選擇​Adobe Target

  5. 激活​建立新證書​並輸入新別名。

  6. 使用​建立憑證​確認。

  7. 選取​下載(或​下載公開金鑰)將檔案下載至本機磁碟,以便在設定Adobe Target整合的Adobe I/O與AEM時使用。

    注意

    保持此設定開啟,當在AEM中完成IMS設定時,將會再次需要此設定。

設定Adobe Target與AEM整合的Adobe I/O

您需要使用AEM將使用的Adobe Target建立Adobe I/O專案(整合),然後指派所需的權限。

建立專案

開啟Adobe I/O主控台,使用AEM將使用的Adobe Target建立I/O專案:

注意

另請參閱Adobe I/O教學課程

  1. 開啟專案的Adobe I/O主控台:

    https://console.adobe.io/projects

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

    • 如果您尚未有任何專案,建立新專案​將位於中央底部。

      建立新專案 — 第一個專案

    • 如果您已有現有專案,則會列出這些專案,而右上角會是​建立新專案

      建立新專案 — 多個專案

  3. 選擇​添加到項目,後跟​API:

  4. 選擇​Adobe Target,然後選擇​Next:

    注意

    如果您已訂閱Adobe Target,但未看到其列出,則應檢查Prerequestes

  5. 上傳您的公開金鑰,並在完成時繼續進行下 一步:

  6. 查看憑據,然後繼續​Next:

  7. 選取所需的產品設定檔,然後繼續​儲存已設定的API:

    注意

    顯示的產品設定檔視您是否具備:

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

  8. 建立將得到確認。

為整合指派權限

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

  1. 開啟Adobe Admin Console:

  2. 導覽至​Products(頂端工具列),然後選取​Adobe Target - <your-tenant-id>(從左側面板)。

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

  4. 選取​整合,然後是必要的整合設定。

  5. 選擇​Editor​作為​Product Role;而不是​觀察者

儲存的Adobe I/O整合專案詳細資訊

從「Adobe I/O專案」主控台,您可以看到所有整合專案的清單:

選擇​View(特定項目項的右側)以顯示有關配置的詳細資訊。 這些包括:

  • 專案概述
  • 分析
  • 憑證
    • 服務帳戶(JWT)
      • 憑據詳細資訊
      • 產生JWT
  • API
    • 例如,Adobe Target

您需要完成AEM中Target的Adobe I/O整合,才能執行其中部分操作。

在AEM中完成IMS設定

返回AEM後,您就可以從Target的Adobe I/O整合新增必要值,以完成IMS設定:

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

  2. 選擇​Next

  3. 您可以在此處使用Adobe I/O🔗中的詳細資訊:

    • 標題:你的簡訊。
    • 授權伺服器:從下方的Payloads區段 "aud" 的行 ​複製/貼上,例如 "https://ims-na1.adobelogin.com" 在以下範例中
    • API索引鍵:從TargetAdobe I/O整 🔗 合的「概觀」區段複製
    • 用戶端密碼:在TargetAdobe I/O整 🔗 合的「概觀」區段中產生,並複製
    • 裝載:從TargetAdobe I/O整 的「產生JWT」區段複製

  4. 使用​Create​確認。

  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. 從工具欄中選擇​檢查健康狀態,然後選擇​檢查

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

設定Adobe TargetCloud Service

現在可以參考設定,讓Cloud Service使用Target Standard API:

  1. 開啟​工具​菜單。 然後,在​Cloud Services​區段內,選取​舊版Cloud Services

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

    將會開啟​建立配置​對話框。

  3. 輸入​Title,如果需要,輸入​Name(如果保留為空白,則從標題生成)。

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

  4. 使用​Create​確認。

    將開啟「編輯元件」對話框。

  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設定:選取用於目標活動目標和量度的Analytics雲端設定。如果您在鎖定目標內容時使用Adobe Analytics作為報表來源,則需要此功能。 如果您沒有看見雲端設定,請參閱設定A4T Analytics Cloud設定中的附註。

    • 使用精確鎖定目標:依預設,此核取方塊會選取。如果選取此選項,雲端服務設定會在載入內容之前等待內容載入。 請參閱以下備注。

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

    • 用戶端程式庫:選取您要AT.js用戶端程式庫或mbox.js(已廢止)。

    • 使用標籤管理系統來傳送用戶端程式庫:使用DTM(已淘汰)、Adobe啟動或任何其他標籤管理系統。

    • 自訂AT.js:如果您勾選「標籤管理」方塊或使用預設的AT.js,請保留空白。或者上傳自訂AT.js。 只有在您已選取AT.js時才會顯示。

    注意

    已棄用配置Cloud Service以使 用Target Classic API(使用Adobe Recommendations設定標籤)。

  6. 按一下​連線至Target​以初始化與Adobe Target的連線。

    如果連接成功,則顯示消息​Connection successful

  7. 在消息上選擇​OK,然後在對話框上選擇​OK​以確認配置。

  8. 您現在可以繼續新增Target架構以設定將傳送至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. 儲存設定。

本頁內容