沙箱工具

最後更新： 2025年5月5日

主題：

建立對象：

開發人員
使用者
管理員
主機

NOTE

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

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

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

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

沙箱工具支援的物件

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

即時客戶資料平台物件

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

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

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

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

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促銷活動和歷程的一封或多封電子郵件中參考。
Adobe Journey Optimizer	行銷活動		行銷活動可與所有與設定檔、對象、結構、內嵌訊息和相依物件相關的專案一起複製。有些項目不會複製，例如決定項目、資料使用標籤及語言設定。如需無法複製的物件完整清單，請參閱[將物件匯出至另一個沙箱]

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

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

將物件匯出到套件中

NOTE

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

NOTE

只有當您擁有存取物件的許可權時，才能匯入套件。

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

將物件加入至新封裝

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

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

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

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

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

將物件新增至現有封裝並發佈

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

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

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

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

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

封裝中的物件清單，醒目顯示發佈選項。

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

發佈封裝確認對話方塊，醒目提示發佈選項。

NOTE

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

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

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

將套件匯入目標沙箱

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沙箱以加快開發流程。

匯出整個沙箱

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

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

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

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

已成功建立封裝，請選取發佈以發佈封裝。

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

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

匯入整個沙箱套件

NOTE

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

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

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

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

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

NOTE

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

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

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

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

監視匯入詳細資料

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

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

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

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

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

NOTE

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

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

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

教學課程影片

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

video poster

https://video.tv.adobe.com/v/3446101/?learn=on&captions=chi_hant

後續步驟

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

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

recommendation-more-help