沙箱工具

NOTE
沙箱工具是同時支援Real-Time Customer Data Platform和Journey Optimizer的基礎功能,可改善開發週期效率和設定準確性。

您必須擁有下列兩個角色型存取控制許可權,才能使用沙箱工具功能:
- manage-sandboxview-sandbox
- manage-package

提高沙箱之間的設定準確性,並利用沙箱工具功能順暢地匯出和匯入沙箱之間的沙箱設定。 使用沙箱工具來減少實作程式的價值實現時間,並跨沙箱移動成功的設定。

您可以使用沙箱工具功能來選取不同的物件,並將它們匯出到套件中。 套件可以包含單一物件或多個物件。 封裝中包含的任何物件都必須來自相同的沙箱。

沙箱工具支援的物件 supported-objects

沙箱工具功能可讓您將Adobe Real-Time Customer Data Platform和Adobe Journey Optimizer物件匯出至封裝。

Real-time Customer Data Platform物件 real-time-cdp-objects

下表列出目前沙箱工具支援的Adobe Real-Time Customer Data Platform物件:

平台
物件
詳細資料
客戶資料平台
來源
出於安全原因,不會將來源帳戶認證復寫到目標沙箱中,而是需要手動更新。 依照預設,來源資料流會以草稿狀態複製。
客戶資料平台
客群
僅支援​ 客戶對象 ​型別​ 細分服務。 用於同意和管理的現有標籤將複製到相同的匯入工作中。 檢查合併原則相依性時,系統將在具有相同XDM類別的目標沙箱中自動選取預設合併原則。
客戶資料平台
身分
在Adobe沙箱中建立時,系統會自動刪除重複的Target標準身分名稱空間。 對象規則中的所有屬性都已在聯合結構描述中啟用時,才能複製對象。 必須先移動並啟用統一設定檔的必要結構描述。
客戶資料平台
結構描述
用於同意和管理的現有標籤將複製到相同的匯入工作中。 使用者可靈活地匯入未啟用統一設定檔選項的結構描述。 封裝中不包含結構描述關聯邊緣案例。
客戶資料平台
資料集
資料集複製時會預設停用整合設定檔設定。
客戶資料平台
同意和治理原則
將使用者建立的自訂原則新增至套件,並橫跨沙箱移動這些原則。

下列物件已匯入,但處於草稿或已停用的狀態:

功能
物件
狀態
匯入狀態
Source資料流
草稿
匯入狀態
歷程
草稿
整合式設定檔
資料集
已停用整合式設定檔
原則
資料治理原則
停用

Adobe Journey Optimizer物件 abobe-journey-optimizer-objects

下表列出目前沙箱工具支援的Adobe Journey Optimizer物件與限制:

平台
物件
詳細資料
Adobe Journey Optimizer
客群
對象可以復製為歷程物件的相依物件。 您可以選取建立新受眾或重複使用目標沙箱中的現有受眾。
Adobe Journey Optimizer
結構描述
歷程中使用的結構描述可以復製為相依物件。 您可以選取建立新結構描述,或重複使用目標沙箱中的現有結構描述。
Adobe Journey Optimizer
合併原則
歷程中使用的合併原則可以復製為相依物件。 在目標沙箱中,您​ 無法 ​建立新的合併原則,您只能利用現有的合併原則。
Adobe Journey Optimizer
歷程 — 畫布詳細資料
畫布上的歷程呈現方式包含歷程中的物件,例如條件、動作、事件、讀取對象等,這些物件均已複製。 跳轉活動會從複製中排除。
Adobe Journey Optimizer
活動
將會複製歷程中使用的事件和事件詳細資訊。 它一律會在目標沙箱中建立新版本。
Adobe Journey Optimizer
動作
歷程中使用的電子郵件和推播訊息可以復製為相依物件。 用於訊息個人化的歷程欄位中使用的管道動作活動不會檢查完整性。 不會複製內容區塊。

可以複製歷程中使用的更新設定檔動作。 也會複製歷程中使用的自訂動作和動作詳細資訊。 它一律會在目標沙箱中建立新版本。
Adobe Journey Optimizer
歷程
將整個歷程新增至套件時,將會複製歷程所依賴的大部分物件,包括對象、結構描述、事件和動作。
Adobe Journey Optimizer
內容範本
內容範本可以復製為歷程物件的相依物件。 獨立範本可讓您輕鬆在Journey Optimizer行銷活動和歷程中重複使用自訂內容。
Adobe Journey Optimizer
片段
片段可以復製為歷程物件的相依物件。 片段是可重複使用的元件,可在各個Journey Optimizer促銷活動和歷程的一封或多封電子郵件中參考。

不會複製曲面(例如預設集)。 系統會根據訊息型別和表面名稱,自動選取目標沙箱上最接近的相符專案。 如果在目標沙箱上找不到表面,則表面複製將失敗,導致訊息複製失敗,因為訊息需要表面才能用於設定。 在這種情況下,至少需要為訊息的正確通道建立一個表面,副本才能運作。

匯出歷程時,不支援將自訂身分型別當做相依物件使用。

將物件匯出到套件中 export-objects

NOTE
所有匯出動作都會記錄在稽核記錄中。
NOTE
只有當您擁有存取物件的許可權時,才能匯入套件。

此範例會記錄匯出結構描述並將其新增到封裝的程式。 您可以使用相同的程式匯出其他物件,例如資料集、歷程等等。

將物件加入至新封裝 add-object-to-new-package

從左側導覽選取​ 結構描述,然後選取​ 瀏覽 ​標籤,其中會列出可用的結構描述。 接著,選取所選結構描述旁邊的省略符號(...),下拉式清單就會顯示控制項。 從下拉式清單中選取​ 新增到封裝

結構描述清單,顯示反白顯示新增至封裝控制項的下拉式功能表。

從​ 新增至封裝 ​對話方塊中,選取​ 建立新封裝 ​選項。 提供封裝的Name和選用的描述,然後選取​ 新增

已選取建立新封裝並醒目提示新增的新增至封裝對話方塊。

您返回到​ 結構描述 ​環境。 您現在可以依照下列的後續步驟,將其他物件加入您建立的封裝。

將物件新增至現有封裝並發佈 add-object-to-existing-package

若要檢視可用的結構描述清單,請從左側導覽選取​ 結構描述,然後選取​ 瀏覽 ​索引標籤。 接著,選取選取的結構描述旁邊的省略符號(...),在下拉式功能表中檢視控制選項。 從下拉式清單中選取​ 新增到封裝

結構描述清單,顯示反白顯示新增至封裝控制項的下拉式功能表。

新增至封裝 ​對話方塊就會顯示。 選取「現有封裝」選項,然後選取「封裝名稱」下拉式清單,並選取所需的封裝。 最後,選取​ 新增 ​以確認您的選擇。

新增到封裝對話方塊,顯示下拉式清單中選取的封裝。

會列出加入封裝的物件清單。 若要發佈套件並使其可匯入沙箱,請選取​ Publish

封裝中的物件清單,醒目提示Publish選項。

選取​ Publish ​以確認發佈封裝。

Publish封裝確認對話方塊,醒目提示Publish選項。

NOTE
發佈後,無法變更套件的內容。 為避免相容性問題,請確保已選取所有必要的資產。 如果必須進行變更,您必須建立新封裝。

您會回到沙箱環境中的​ 套件 ​索引標籤,您可以在其中看到新發佈的套件。

醒目提示新發佈封裝的沙箱封裝清單。

將套件匯入目標沙箱 import-package-to-target-sandbox

NOTE
所有匯入動作都會記錄在稽核記錄中。

若要將套件匯入目標沙箱,請導覽至沙箱​ 瀏覽 ​標籤,並選取沙箱名稱旁邊的加號(+)選項。

沙箱瀏覽索引標籤醒目提示匯入封裝選取專案。

使用下拉式功能表,選取您要匯入目標沙箱的​ 封裝名稱。 新增將用於未來監視的​ 工作名稱。 依預設,在匯入套件的結構描述時,統一設定檔將會停用。 切換​ 為設定檔 ​啟用結構描述以啟用此設定,然後選取​ 下一步

匯入詳細資訊頁面顯示封裝名稱下拉式清單選項

封裝物件與相依性頁面提供此封裝中包含的所有資產清單。 系統會自動偵測成功匯入所選父物件所需的相依物件。 任何遺失的屬性都會顯示在頁面頂端。 選取「檢視詳細資料」以取得更詳細的劃分。

封裝物件和相依性頁面顯示遺漏的屬性。

NOTE
相依物件可以用目標沙箱中的現有物件取代,這可讓您重複使用現有物件,而不是建立新版本。 例如,當您匯入包含方案的套件時,可以重複使用目標沙箱中現有的自訂欄位群組和身分名稱空間。 或者,當您匯入包含歷程的套件時,可以重複使用目標沙箱中的現有區段。
沙箱工具目前不支援更新或覆寫現有物件。 您可以選擇建立新物件,或繼續使用現有物件而不進行修改。

若要使用現有物件,請選取相依物件旁的鉛筆圖示。

![封裝物件與相依性]頁面會顯示包含在封裝中的資產清單。(https://experienceleague.adobe.com/images/ui/sandbox-tooling/package-objects-and-dependencies.png?lang=zh-Hant)

隨即顯示建立新或使用現有專案的選項。 選取​ 使用現有的

顯示相依物件選項建立新的和使用現有的的封裝物件和相依性頁面。

欄位群組 ​對話方塊會顯示物件可用的欄位群組清單。 選取所需的欄位群組,然後選取​ 儲存

欄位群組對話方塊上顯示的欄位清單,醒目顯示儲存選取專案。

您返回到封裝物件和相依性頁面。 從這裡,選取​ 完成 ​以完成封裝匯入。

![封裝物件和相依性頁面會顯示包含在封裝中的資產清單,並醒目提示完成。]

匯出和匯入整個沙箱

NOTE
目前,匯出或匯入整個沙箱時僅支援Real-time Customer Data Platform物件。 目前不支援歷程之類的Adobe Journey Optimizer物件。

您可以將所有支援的物件型別匯出至完整的沙箱套件,然後跨各種沙箱匯入套件以複製物件設定。 例如,此功能可讓您:

  • 如果您需要重設沙箱,請重新匯入沙箱以重新產生物件的所有設定
  • 將套件匯入其他沙箱,並將其用作Blueprint沙箱以加快開發流程。

匯出整個沙箱 export-entire-sandbox

若要匯出整個沙箱,請瀏覽至沙箱 套件 ​索引標籤,並選取​ 建立套件

沙箱 封裝索引標籤醒目提示建立封裝。

在建立封裝對話方塊中,選取封裝的​ 整個沙箱。 為您的新封裝提供封裝名稱,並從下拉式清單中選取​ 沙箱。 最後,選取​ 建立 ​以確認您的專案。

建立封裝對話方塊顯示已完成的欄位並醒目提示建立。

已成功建立封裝,請選取​ Publish ​以發佈封裝。

醒目提示新發佈封裝的沙箱封裝清單。

您會回到沙箱環境中的​ 套件 ​索引標籤,您可以在其中看到新發佈的套件。

匯入整個沙箱套件 import-entire-sandbox-package

NOTE
所有物件都會當作新物件匯入目標沙箱中。 最佳實務是將完整的沙箱套件匯入空的沙箱。

若要將套件匯入目標沙箱,請瀏覽至沙箱 瀏覽 ​標籤,並選取沙箱名稱旁的加號(+)選項。

沙箱瀏覽索引標籤醒目提示匯入封裝選取專案。

使用下拉式功能表,使用​ 封裝名稱 ​下拉式功能表選取完整沙箱。 新增將用於未來監視的​ 工作名稱 ​和選用的​ 工作描述,然後選取​ 下一步

匯入詳細資訊頁面顯示封裝名稱下拉式清單選項

NOTE
您必須擁有封裝中包含之所有物件的完整許可權。 如果您沒有許可權,匯入作業將會失敗並顯示錯誤訊息。

您會進入封裝物件與相依性頁面,您可以在此頁面檢視匯入和排除物件的物件與相依性數目。 從這裡,選取​ 匯入 ​以完成封裝匯入。

封裝物件與相依性頁面顯示不支援之物件型別的內嵌訊息,並醒目提示匯入。

留出一些時間讓匯入完成。 完成時間會因封裝中的物件數目而異。 您可以從沙箱 工作 ​索引標籤監視匯入工作。

監視匯入詳細資料 view-import-details

若要檢視匯入的詳細資料,請瀏覽至沙箱 工作 ​標籤,然後從清單中選取封裝。 或者,使用搜尋列來搜尋套件。

沙箱工作索引標籤會醒目提示匯入套件選項。

在沙箱環境的​ 工作 ​索引標籤中,從右邊的詳細資料窗格中選取​ 檢視匯入摘要

沙箱匯入索引標籤會在右窗格中反白顯示檢視匯入詳細資料選項。

匯入摘要 ​對話方塊會顯示匯入的劃分以及進度百分比。

NOTE
您可以導覽至特定的詳細目錄頁面,以檢視物件清單。

顯示匯入詳細資料的匯入詳細資料對話方塊。

匯入完成時,會在Platform UI中收到通知。 您可以從警示圖示存取這些通知。 如果工作失敗,您可以從這裡導覽至疑難排解。

教學課程影片

以下影片旨在協助您瞭解沙箱工具,並概述如何建立新套件、發佈套件和匯入套件。

後續步驟

本檔案會示範如何在Experience PlatformUI中使用沙箱工具功能。 如需沙箱的相關資訊,請參閱沙箱使用手冊

如需使用沙箱API執行不同作業的步驟,請參閱沙箱開發人員指南。 如需Experience Platform中沙箱的整體概觀,請參閱概觀檔案

recommendation-more-help
e243ad8f-a318-46b3-9930-159a80f82b42