文件Journey OptimizerJourney Optimizer 指南

新增個人化 build-personalization-expressions

Last update: Mon Mar 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • 中繼
  • 開發人員

個人化編輯器是Journey Optimizer中個人化的核心。 它可用於您需要定義個人化的每個內容，例如電子郵件、推播和選件。

在個人化編輯器介面中，您可以選取、排列、自訂及驗證所有資料，為您的內容建立自訂個人化。

我可以在哪裡新增個人化

您可以使用 新增個人化圖示 圖示，在每一個欄位的​ Journey Optimizer ​中新增個人化。

訊息

在郵件中，可以在郵件的不同位置新增個人化，例如​ 主旨列 ​欄位。

您也可以在內容的其他區段中新增。 例如，對於推播通知，可以在​ 標題、內文、自訂聲音、徽章 ​和​ 自訂資料 ​欄位中新增個人化。

電子郵件 Designer

在電子郵件Designer中編輯電子郵件內容時，您可以使用內容相關工具列中的圖示，在文字區塊和URL中新增個人化。

產品建議

在您的​ 優惠方案代表 ​中使用文字型別內容時，您可以新增個人化。 瞭解如何建立個人化優惠

URL

Journey Optimizer也可讓您個人化訊息中的​ URL。 個人化 URL 會根據輪廓屬性，將收件者帶往網站特定頁面或個人化微網站。 URL個人化可用於這些型別的連結： 外部連結、取消訂閱連結 ​和​ 選擇退出。

請參閱個人化URL範例
  • https://www.adobe.com/users/{{profile.person.name.lastName}}
  • https://www.adobe.com/users?uid={{profile.person.name.firstName}}
  • https://www.adobe.com/usera?uid={{context.journey.technicalProperties.journeyUID}}
  • https://www.adobe.com/users?uid={{profile.person.crmid}}&token={{context.token}}

{width="50%"}

NOTE
在個人化編輯器中編輯個人化URL時，基於安全考量，會停用協助程式功能和對象成員資格。
url內使用的個人化權杖不支援空格。

Personalization來源 sources

畫面左側會顯示網域選擇器，讓您選取個人化的來源。 可用的來源包括：

  • 設定檔屬性 ：列出與Adobe Experience Platform資料模型(XDM)檔案中說明的設定檔結構描述相關的所有參考。
  • 對象 ：列出在Adobe Experience Platform細分服務中建立的所有對象。 此處提供分段的相關詳細資訊。
  • 優惠決定 ：列出與特定位置相關聯的所有優惠。 選取版位，然後將優惠方案插入內容中。 如需有關如何管理優惠方案的完整檔案，請參閱本節。
  • 內容屬性 ：當歷程或行銷活動中使用管道動作活動（電子郵件、推播、簡訊）時，與事件和屬性相關的內容屬性可用於個人化。 在此區段中呈現了運用內容屬性的個人化範例。
NOTE
如果您使用使用構成工作流程產生的擴充屬性來鎖定對象，您可以運用這些擴充屬性來個人化您的訊息。 瞭解如何使用對象擴充屬性

新增個人化 add

中央工作區是您建置個人化語法的位置。 若要使用屬性來個人化您的訊息，請在左側導覽窗格中找出該屬性，然後按一下+按鈕，將該屬性加入運算式中。

+圖示旁的省略符號功能表可讓您取得每個屬性的詳細資訊，並將您最常用的屬性新增至我的最愛。 新增至我的最愛屬性可從左側導覽窗格中的​ 我的最愛 ​功能表存取。

此外，您可以定義預設後援文字，當字串型別的設定檔屬性為空白時將會顯示。 若要這麼做，請按一下屬性旁的省略符號按鈕，然後選取​ 插入後援文字。 如果設定檔的屬性值是空的，則寫入預設應顯示的文字，然後按一下​ 新增。

在下列範例中，個人化編輯器可讓您選取今天生日的設定檔，然後插入與今天對應的特定選件來完成自訂。

運算式編輯工具

中央工作區提供各種工具，協助您撰寫個人化運算式。

可選擇下列選項：

  1. 尋找 / 尋找並取代：搜尋您的運算式並自動取代部分程式碼。

  2. 還原 / 重做：還原/重做上一個操作。

  3. 自動完成：在您輸入時自動建議並完成程式碼。 此功能僅適用於HTML和文字格式，並支援「設定檔」和「內容」屬性。 如果透過切換功能停用，編輯器將提供原生HTML程式碼自動完成。

    {align="center" width="70%" modal="regular"}

  4. HTML / JSON / 文字：識別您的程式碼格式。 這可讓系統根據選取的語言調整驗證及自動完成功能。

  5. 驗證：檢查運算式的語法。 請參閱此章節深入瞭解。

  6. 另存為片段：將運算式另存為運算式片段。 請參閱本節以進一步瞭解

  7. 字型大小：調整編輯器內內容的字型大小，以提高可讀性。

  8. 自動換行：啟用或停用自動換行，允許長運算式顯示在單行或包含在編輯器中。 選項包括：

    • 關閉 （預設） — 無自動換行。 長線超出編輯器檢視範圍，需要水準捲動。
    • On — 以編輯器的寬度換行。
    • 自動換行 — 當行字元達到80個字元時換行。
    • 已繫結 — 以編輯器寬度或80個字元（以較小者為準）來換行。

在導覽窗格中，有其他功能可協助您建置個人化運算式。

  • 輔助函式 — 輔助函式可讓您對資料執行操作，例如計算、資料格式或轉換、條件，並在個人化的內容中操作它們。 進一步瞭解可用的協助程式功能

  • 我的最愛 — 您新增至我的最愛屬性會顯示在此清單中。 這可讓您快速存取您使用頻率最高的專案。 若要新增屬性至您的最愛，請按一下省略符號選單，然後選擇​ 新增至我的最愛。

  • 條件 — 運用在程式庫中建立的條件式規則，將動態內容新增至您的訊息。 這可讓您根據條件建立訊息的多個變體。 瞭解如何建立動態內容

  • 片段 — 運用已建立或儲存至目前沙箱的運算式片段。 片段是可重複使用的元件，可跨Journey Optimizer個行銷活動和歷程參照。 此功能允許預先建置多個自訂內容區塊，可供行銷使用者在改良的設計流程中快速組合內容。 瞭解如何使用運算式片段進行個人化

一旦您的個人化運算式準備就緒，就需要由個人化編輯器驗證。 請參閱此章節深入瞭解。

驗證機制 validation-mechanisms

當您按一下​ 新增 ​按鈕以關閉編輯器視窗時，會自動執行運算式的驗證。 您也可以使用​ 驗證 ​按鈕來檢查您的個人化語法。

展開以下區段以檢視驗證個人化時可能發生的常見錯誤。

常見錯誤
  • 找不到「XYZ」路徑

嘗試參照結構描述中未定義的欄位時。

在此情況下，firstName1 ​未定義為設定檔結構描述中的屬性：

code language-none 
{{profile.person.name.firstName1}}
  • 變數"XYZ"的型別不相符。 必須是陣列。 找到字串。

嘗試對字串而非陣列重複時。

在此情況下，product ​不是陣列：

code language-none 
{{each profile.person.name.firstName as |product|}}
 {{product.productName}}
{{/each}}
  • 無效的Handlebars語法。 找到‘[XYZ}}’

使用無效的Handlebars語法時。

Handlebars運算式周圍有​ {{expression}}

code language-none 
   {{[profile.person.name.firstName}}
  • 無效的區段定義
code language-none 
No segment definition found for 988afe9f0-d4ae-42c8-a0be-8d90e66e151

若是選件，可能會發生特定錯誤。 展開下列區段以取得詳細資訊：

與優惠方案相關的特定錯誤

與電子郵件或推播訊息中的優惠方案整合相關的錯誤具有以下模式：

code language-none 
Offer.<offerType>.[PlacementID].[ActivityID].<offer-attribute>

驗證會在個人化編輯器中的個人化內容驗證期間執行。

table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2
錯誤標題 驗證/解析度
找不到ID為placementID且型別為OfferPlacement的資源
找不到id activityID和型別OfferActivity的資源		 檢查ActivityID和/或PlacementID是否可用
無法驗證資源。 位置中的componentType應符合offerType選件
offerId中未出現公用URL。 影像選件（與決定和位置配對相關的所有個人化和遞補）應填入公用URL （deliveryURL不應空白）。
決定包含非設定檔屬性。 選件模型使用方式應僅包含設定檔屬性。
擷取決策使用方式時發生錯誤。 當API嘗試擷取選件模型時，可能會發生此錯誤。
優惠屬性offer-attribute無效。 檢查優惠方案drp中參照的優惠方案屬性是否有效。 以下是有效的屬性：
影像： deliveryURL， linkURL
文字： content
HTML：內容
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76