將內容片段匯出到 Adobe Target exporting-content-fragments-to-adobe-target

CAUTION
  • AEM內容片段會匯出至Adobe Target的預設工作區。
  • AEM必須根據與Adobe Target整合下的指示與Adobe Target整合。

您可以將在Adobe Experience Manager as a Cloud Service (AEM)中建立的內容片段匯出至Adobe Target (Target)。 然後,它們可以當作Target活動中的選件,以大規模測試並個人化體驗。

有一個選項可用於將內容片段匯出至Adobe Target:

  • JSON:支援Headless內容傳送

若要準備您的執行個體以將AEM內容片段匯出至Adobe Target,您需要:

之後,您可以:

內容片段可以匯出至Adobe Target中的預設工作區,或匯出至Adobe Target的使用者定義工作區。

NOTE
Adobe Target本身並不存在Adobe Target工作區。 這些區段是在Adobe IMS (Identity Management系統)中定義和管理,然後使用Adobe Developer Console來選取用於各種解決方案。
NOTE
Adobe Target工作區可用來允許組織(群組)的成員僅針對此組織建立和管理優惠方案及活動,不將存取權授予其他使用者。 例如,全球關注的國家/地區特定組織。

先決條件 prerequisites

需要下列動作:

  1. 您必須將AEM與Adobe Target整合。

新增雲端設定 add-the-cloud-configuration

在匯出片段之前,您需要將​ Adobe Target ​的​ 雲端設定 ​新增到片段或資料夾。 這也可讓您:

  • 指定要用於匯出的格式選項
  • 選取Target工作區作為目的地
  • 選取外部化器網域,以重寫內容片段中的參照(選用)

可以在所需資料夾的​ 頁面屬性 ​中選取所需的選項,或選取片段,或同時選取兩者;必要時,會繼承規格。

  1. 導覽至​ Assets ​主控台。

  2. 開啟適當資料夾或片段的​ 頁面屬性

    note note
    NOTE
    如果您將雲端設定新增至內容片段父資料夾,設定將由所有子系繼承。
    如果您將雲端設定新增至內容片段本身,該設定會由所有變數繼承。
  3. 選取「雲端服務」標籤。

  4. 在​ Cloud Service設定 ​下,從下拉式清單中選取​ Adobe Target

    note note
    NOTE
    可自訂內容片段選件的JSON格式。 若要這麼做,請定義客戶內容片段元件,然後註明如何在元件Sling模型中匯出其屬性。
    檢視核心元件: 核心元件 — 內容片段
  5. 在​ Adobe Target ​下選取:

    • 適當的設定
    • 所需的格式選項
    • Adobe Target工作區
    • 如有必要 — 外部化器網域
    note caution
    CAUTION
    外部化器網域是選用的。
    當您想要匯出的內容指向特定的​ 發佈 ​網域時,會設定AEM外部化程式。 如需詳細資訊,請參閱設定AEM連結外部器
    另請注意,外部化器網域僅與傳送至Target的內容片段內容相關,與檢視選件內容之類的中繼資料無關。

    例如,針對資料夾:

    資料夾 — Cloud Service

  6. 儲存並關閉

新增舊組態 add-the-legacy-configuration

IMPORTANT
新增舊版設定是一種特殊情況,僅支援匯出內容片段。

新增雲端設定以使用Launch by Adobe後,若要將AEM與Adobe Target整合,您還需要使用舊版設定手動與Adobe Target整合。

建立Target雲端設定 creating-a-target-cloud-configuration

若要讓AEM與Adobe Target互動,請建立Target雲端設定。 若要建立設定,您必須提供Adobe Target使用者端代碼和使用者認證。

您只會建立一次Target雲端設定,因為您可以將此設定與多個AEM行銷活動建立關聯。 如果您有多個Adobe Target使用者端代碼,請為每個使用者端代碼建立一個設定。

您可以設定雲端設定,以從Adobe Target同步區段。 如果您啟用同步,儲存雲端設定後,會立即在背景從Target匯入區段。

使用以下程式,在AEM中建立Target雲端設定:

  1. 透過​ AEM標誌 > Cloud Service > 工具 > 舊版Cloud Service ​瀏覽至​ 舊Cloud Service
    例如: (http://localhost:4502/libs/cq/core/content/tools/cloudservices.html)

    Adobe Experience Cloud ​總覽頁面隨即開啟。

  2. 在​ Adobe Target ​區段中,按一下​ 立即設定

  3. 在​ 建立組態 ​對話方塊中:

    1. 為設定提供​ 標題
    2. 選取​ Adobe Target設定 ​範本。
    3. 按一下​ 建立

您現在可以選取要編輯的新設定。

  1. 編輯對話方塊隨即開啟。

    config-target-settings-dialog

  2. 在​ Adobe Target設定 ​對話方塊中,提供這些屬性的值。

    • 驗證:此預設為IMS (已棄用使用者認證)

    • 使用者端代碼: Target帳戶使用者端代碼

    • 租使用者識別碼:租使用者識別碼

    • IMS設定:從下拉式清單中選取所需的設定

    • API型別:預設為REST (已棄用XML)

    • A4T Analytics Cloud設定:選取用於Target活動目標和量度的Analytics雲端設定。 如果您在鎖定目標內容時使用Adobe Analytics作為報表來源,則需要此專案。

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

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

    • 使用者端資料庫: ​此預設為AT.js (已棄用mbox.js)

      note note
      NOTE
      Target程式庫檔案AT.JS是新的Adobe Target實作程式庫,專為典型Web實作和單頁應用程式而設計。
      mbox.js已過時,並將在稍後階段移除。
      Adobe建議您使用AT.js而非mbox.js作為使用者端資料庫。
      AT.js對mbox.js資料庫提供數項改善專案:
      • 改善Web實施的頁面載入時間
      • 提升安全性
      • 單頁應用程式的更佳實作選項
      • AT.js包含target.js所包含的元件,因此不再需要呼叫target.js
      您可以在​ 使用者端資料庫 ​下拉式功能表中選取AT.js或mbox.js。
    • 使用Tag Management System來提供使用者端程式庫 — 選取此選項,即可使用Adobe Launch或其他標籤管理系統(或DTM,已棄用)的使用者端程式庫。

    • 自訂AT.js:瀏覽以上傳您的自訂AT.js。 留空將使用預設程式庫。

      note note
      NOTE
      依預設,當您選擇加入Adobe Target設定精靈時,會啟用「準確定位」 。
      準確定位表示雲端服務設定會等待內容載入後再載入內容。 因此,就效能而言,準確定位可能會在載入內容前造成幾毫秒的延遲。
      作者例項上一律會啟用「準確定位」 。 不過,在發佈執行個體上,您可以清除雲端服務設定(http://localhost:4502/etc/cloudservices.html)中「準確定位」旁的勾號,來選擇全域關閉準確定位。 無論您在雲端服務設定中的設定為何,您仍可開啟和關閉個別元件的準確定位。
      如果您有​ ​建立的目標元件,而且您變更此設定,您的變更不會影響這些元件。 您必須直接對這些元件進行任何變更。
  3. 按一下​ 連線至Adobe Target ​以初始化與Target的連線。 如果連線成功,會顯示訊息​ 連線成功。 在訊息上按一下​ [確定],然後在對話方塊上按一下​ [確定]

新增Target框架 adding-a-target-framework

設定Target雲端設定後,請新增Target框架。 此架構會識別從可用的ContextHub元件傳送至Adobe Target的預設引數。 Target會使用引數來決定套用至目前內容的區段。

您可以為單一Target設定建立多個架構。 如果您需要針對網站的不同區段傳送一組不同的引數至Target,則多個架構會很有用。 為您需要傳送的每組引數建立框架。 將網站的每個區段與適當的架構建立關聯。 請注意,一個網頁一次只能使用一個架構。

  1. 在您的Target設定頁面上,按一下「可用設定」旁的​ + (加號)。

  2. 在[建立架構]對話方塊中,指定​ 標題,選取​ Adobe Target架構,然後按一下[建立]​

    框架頁面隨即開啟。 Sidekick提供的元件代表來自ContextHub的資訊,您可以對應這些元件。

  3. 將代表您要用來對應之資料的「從屬端內容」元件拖曳至放置目標。 或者,將​ ContextHub存放區 ​元件拖曳到架構。

    note note
    NOTE
    對應時,引數會透過簡單字串傳遞至mbox。 您無法從ContextHub對應陣列。

    例如,若要使用網站訪客的​ 設定檔資料 ​來控制Target促銷活動,請將​ 設定檔資料 ​元件拖曳至頁面。 可用於對應至Target引數的設定檔資料變數隨即顯示。

  4. 選取適當欄中的​ 共用 ​核取方塊,以選取您要對Adobe Target系統可見的變數。

    note note
    NOTE
    同步引數是唯一方式 — 從AEM到Adobe Target。

您的框架隨即建立。 若要將架構復寫到發佈執行個體,請使用sidekick中的​ 啟動架構 ​選項。

將內容片段匯出至Adobe Target exporting-a-content-fragment-to-adobe-target

CAUTION
對於媒體資產(例如影像),只會將參考匯出至Target。 資產本身仍會儲存在AEM Assets中,並從AEM發佈例項傳送。
因此,在匯出至Target之前,必須發佈包含所有相關資產的內容片段。

若要將內容片段從AEM匯出至Target (在指定雲端設定後):

  1. 在​ Assets ​主控台中導覽至您的內容片段。

  2. 選取您要匯出至Target的內容片段。

  3. 選取​ 匯出至Adobe Target選件

    匯出至Adobe Target

  4. 視需要選取​ 不發佈 ​或​ Publish ​的匯出。

    note note
    NOTE
    實際顯示的動作取決於片段和相關資產的狀態。
    如果所有內容皆已發佈,且之後未進行任何修改,則會略過此步驟。
    note note
    NOTE
    選取​ Publish ​將會立即發佈內容片段,並將其傳送至Target。
  5. 在確認對話方塊中選取​ 確定

    您的內容片段現在應在Target中。

    note note
    NOTE
    匯出的各種詳細資料可在主控台的​ 清單檢視 ​和​ 內容 ​中看見。
    note note
    NOTE
    在Adobe Target中檢視內容片段時,看到的​ 上次修改 ​日期是上次在AEM中修改片段的日期,而非上次將片段匯出至Adobe Target的日期。
NOTE
或者,您可以使用頁面資訊功能表中的類似命令,從頁面編輯器執行匯出。

在Adobe Target中使用內容片段 using-your-content-fragments-in-adobe-target

執行先前的工作後,內容片段會顯示在Target的「選件」頁面中。 請參閱特定的Target檔案,瞭解您可以達到的目標。

NOTE
在Adobe Target中檢視內容片段時,看到的​ 上次修改 ​日期是上次在AEM中修改片段的日期,而非上次將片段匯出至Adobe Target的日期。

刪除已匯出至Adobe Target的內容片段 deleting-a-content-fragment-already-exported-to-adobe-target

就像匯出一樣,一旦選取片段,您也可以從​ Assets ​主控台的頂端工具列選取從Adobe Target刪除內容片段:

在Adobe Target 中刪除

如果片段已用於Target的選件,刪除已匯出至Target的內容片段可能會導致問題。 刪除片段會導致選件無法使用,因為AEM正在傳遞片段內容。

若要避免此類情況:

  • 如果內容片段目前未用於活動中,AEM可讓使用者刪除片段而不顯示警告訊息。

  • 如果Target中的活動目前正在使用內容片段,則會出現錯誤訊息,警告AEM使用者刪除片段可能會對活動造成的後果。

    AEM中的錯誤訊息不會禁止使用者(強制)刪除內容片段。 如果刪除內容片段:

    • 具有AEM內容片段的Target選件可能會顯示不良行為

      • 由於內容片段已推送至Target,因此選件很可能仍會呈現
      • 如果也在AEM中刪除了參照的資產,內容片段中的任何參照都無法正常運作。
    • 當然,由於內容片段在AEM中不再存在,因此無法再對內容片段進行任何修改。

其他資源 further-resources

如需詳細資訊,請參閱下列內容:

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab