使用Adobe I/O與Adobe Target整合

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

注意

Adobe Target標準API的支援是6.5版AEM的新增功能。Target Standard API使用IMS驗證。

在中使用Adobe Target經典APIAEM仍支援向後相容。 Target Classic API使用用戶憑據驗證

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

必備條件

開始此過程之前:

  • Adobe 支援必須為您的帳戶提供:

    • Adobe控制台
    • Adobe I/O
    • Adobe Target和
    • AdobeIMS(Identity Management系統)
  • 貴組織的系統管理員應使用Admin Console,將貴組織所需的開發人員新增至相關的產品設定檔。

    • 這可讓特定開發人員擁有在Adobe I/O中啟用整合的權限。
    • 如需詳細資訊,請參閱管理開發人員

配置IMS配置——生成公鑰

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

  1. 在AEM開啟​工具​菜單。

  2. 在​Security​區段中,選擇​AdobeIMS配置

  3. 選擇​建立​以開啟​AdobeIMS技術帳戶配置

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

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

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

  7. 選擇​下載(或​下載公開密鑰)將檔案下載到本地驅動器,以便在配置用於與AEM整合的Adobe Target的Adobe I/O時使用。

    注意

    保持此配置開啟狀態,當完成中的IMS配置時,將AEM再次需要此配置。

為Adobe Target整合配AEM置Adobe I/O

您需要與將使用的Adobe Target建立Adobe I/O項目(整合)AEM,然後分配所需的權限。

建立項目

開啟Adobe I/O控制台以建立將使用以下功能的I/O項AEM目:

注意

另請參閱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標準版——僅​預設工作區​可用
    • Adobe Target高級版——列出所有可用工作區,如下所示

  8. 將確認建立。

將權限分配給整合

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

  1. 開啟Adobe Admin Console:

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

  3. 選擇「產品描述檔」,然後從顯示的清單中選擇您所需的工作區。 例如,預設工作區。

  4. 選擇​整合,然後選擇所需的整合設定。

  5. 選擇​Editor​作為​產品角色;而非​觀察者

為Adobe I/O整合項目儲存的詳細資訊

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

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

  • 專案概觀
  • 分析
  • 認證
    • 服務帳戶(JWT)
      • 憑據詳細資訊
      • 生成JWT
  • APIS
    • 例如,Adobe Target

其中一些需要您完成中Target的Adobe I/O整合AEM。

完成中AEM的IMS配置

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

  1. 返回🔗中開啟的AEMIMS配置。

  2. 選擇​Next

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

    • 標題:您的文字。
    • 授權伺服器:從下方的Payloadsection "aud" 行複製/ ​貼上此選項,例如 "https://ims-na1.adobelogin.com" 在下方範例中
    • API金鑰:從TargetAdobe I/O整 🔗 合的「概述」區段複製此項
    • 用戶端密碼:在TargetAdobe I/O整 🔗 合的「概述」區段中產生此項,並複製
    • 裝載:從TargetAdobe I/O整 合的 Generate JWTsection複製此項

  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. 從工具欄中選擇​Check Health ,然後選擇​Check

  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:AdobeIMS租用戶ID。另請參閱租用戶ID和用戶端代碼一節。

      注意

      對於IMS,此值必須取自Target本身。 您可以登入Target,並從URL擷取租用戶ID。

      例如,若URL為:

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

      然後您會使用yourtenantid

    • 用戶端代碼:請參閱「 租用戶ID和用戶端 代碼」區段。

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

    • API類型:REST

    • A4TAnalytics Cloud配置:選取用於目標活動目標和度量的Analytics雲端設定。如果您在定位內容時使用Adobe Analytics作為報告來源,則需要此功能。 如果您看不到雲端設定,請參閱設定A4TAnalytics Cloud設定中的附註。

    • 使用精確的定位:預設情況下,此複選框處於選中狀態。如果選取此選項,雲端服務設定會等待載入內容後再載入內容。 請參閱以下附註。

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

    • 用戶端程式庫:選擇您要AT.js用戶端程式庫或mbox.js(已過時)。

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

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

    注意

    已不建議使用Target Classic API的Cloud Service配置(使用「Adobe Recommendations設定」頁籤)。

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

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

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

  8. 您現在可以繼續新增Target Framework,以設定將傳送至Target的ContextHub或ClientContext參數。 請注意,匯出體驗片段至Target時可AEM能不需要這個功能。

租用戶ID和用戶端代碼

Adobe Experience Manager6.5.8.0中,「客戶端代碼」欄位已添加到「目標」配置窗口。

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

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

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

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

如前所述,第一個案例是6.AEM5中最常見的案例。無論如何,請根據您的需求,確定​both​欄位皆包含正確的資訊。

注意

如果要更改現有的Target配置:

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

本頁內容

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now