Sandbox-Werkzeuge
Für die Verwendung der Sandbox-Tooling-Funktion sind die folgenden beiden rollenbasierten Zugriffssteuerungsberechtigungen erforderlich:
-
manage-sandbox
oder view-sandbox
-
manage-package
Verbessern Sie die Konfigurationsgenauigkeit über Sandboxes hinweg und exportieren und importieren Sie Sandbox-Konfigurationen zwischen Sandboxes mit der Sandbox-Tooling-Funktion nahtlos. Verwenden Sie die Sandbox-Tools, um die Wertschöpfungszeit für den Implementierungsprozess zu reduzieren und erfolgreiche Konfigurationen über Sandboxes hinweg zu verschieben.
Sie können die Sandbox-Tooling-Funktion verwenden, um verschiedene Objekte auszuwählen und sie in ein Paket zu exportieren. Ein Paket kann aus einem oder mehreren Objekten bestehen. Alle Objekte, die in einem Paket enthalten sind, müssen aus derselben Sandbox stammen.
Für Sandbox-Tools unterstützte Objekte supported-objects
Die Sandbox-Tooling-Funktion bietet Ihnen die Möglichkeit, Adobe Real-Time Customer Data Platform und Adobe Journey Optimizer Objekte in ein Paket zu exportieren.
Real-time Customer Data Platform-Objekte real-time-cdp-objects
Änderungen an Audience-Importen mit mehreren Entitäten
Mit den B2B- können Sie keine Zielgruppen mit mehreren Entitäten mit B2B-Attributen und Erlebnisereignissen mehr importieren, wenn ein Paket, das diese Zielgruppen enthält, vor dem Upgrade veröffentlicht wurde. Diese Zielgruppen können nicht importiert werden und können nicht automatisch in die neue Architektur konvertiert werden.
Um diese Einschränkung zu umgehen, müssen Sie ein neues Paket mit den aktualisierten Zielgruppen erstellen und sie dann mithilfe von Sandbox-Tools in ihre jeweiligen Ziel-Sandboxes importieren.
In der folgenden Tabelle sind Adobe Real-Time Customer Data Platform Objekte aufgeführt, die derzeit für Sandbox-Tools unterstützt werden:
- Die Anmeldeinformationen für das Quellkonto werden aus Sicherheitsgründen nicht in der Ziel-Sandbox repliziert und müssen manuell aktualisiert werden.
- Der Quelldatenfluss wird standardmäßig in den Entwurfsstatus kopiert.
- Es wird nur Typ Kundenzielgruppe () unterstützt.
- Vorhandene Kennzeichnungen für Einverständnis und Governance werden im selben Importvorgang kopiert.
- Das System wählt beim Überprüfen der Abhängigkeiten von Zusammenführungsrichtlinien automatisch die standardmäßige Zusammenführungsrichtlinie in der Ziel-Sandbox mit derselben XDM-Klasse aus.
- Wenn beim Importieren von Zielgruppen ein vorhandenes Objekt mit demselben Namen erkannt wird, verwenden die Sandbox-Tools das vorhandene Objekt immer wieder, um die Vermehrung von Objekten zu vermeiden.
- Das System dedupliziert beim Erstellen von Identitäts-Namespaces für Adobe Standard automatisch in der Ziel-Sandbox.
- Zielgruppen können nur kopiert werden, wenn alle Attribute in Zielgruppenregeln im Vereinigungsschema aktiviert sind. Die erforderlichen Schemata müssen zunächst verschoben und für das einheitliche Profil aktiviert werden.
- Vorhandene Kennzeichnungen für Einverständnis und Governance werden im selben Importvorgang kopiert.
- Sie haben die Flexibilität, Schemas zu importieren, ohne die Option Einheitliches Profil zu aktivieren. Die Edge-Fall-Schemabeziehungen sind nicht im Paket enthalten.
- Wenn beim Importieren von Schemata/Feldergruppen ein vorhandenes Objekt mit demselben Namen erkannt wird, verwenden die Sandbox-Tools das vorhandene Objekt immer wieder, um eine Objektproliferation zu vermeiden.
Die folgenden Objekte werden importiert, haben jedoch den Status „Entwurf“ oder „Deaktiviert“:
Adobe Journey Optimizer-Objekte abobe-journey-optimizer-objects
In der folgenden Tabelle sind Adobe Journey Optimizer Objekte aufgeführt, die derzeit für Sandbox-Tools und Einschränkungen unterstützt werden:
Die folgenden Objekte, die auf der Journey verwendet werden, werden als abhängige Objekte kopiert. Während des Import-Workflows können Sie für jeden entweder „Neu erstellen oder Vorhandene verwenden auswählen:
- Zielgruppen
- Canvas-Details
- Inhaltsvorlagen
- Benutzerdefinierte Aktionen
- Datenquellen
- Ereignisse
- Feldergruppen
- Fragmente
- Schemata
Das System kopiert die auf der Journey verwendeten Ereignisse und Ereignisdetails und erstellt eine neue Version in der Ziel-Sandbox.
Die auf der Journey verwendete Aktion Profil aktualisieren kann kopiert werden. Benutzerdefinierte Aktionen können einem Paket unabhängig hinzugefügt werden. Auf der Journey verwendete Aktionsdetails werden ebenfalls kopiert. Es wird immer eine neue Version in der Ziel-Sandbox erstellt.
Benutzerdefinierte Aktionen können einem Paket unabhängig hinzugefügt werden. Nachdem eine benutzerdefinierte Aktion einer Journey zugewiesen wurde, kann sie nicht mehr bearbeitet werden. Um Aktualisierungen an benutzerdefinierten Aktionen vorzunehmen, sollten Sie:
- Verschieben benutzerdefinierter Aktionen vor dem Migrieren einer Journey
- Aktualisieren Sie Konfigurationen (z. B. Anfragekopfzeilen, Abfrageparameter und Authentifizierung) für benutzerdefinierte Aktionen nach der Migration
- Migrieren von Journey-Objekten mit den benutzerdefinierten Aktionen, die Sie im ersten Schritt hinzugefügt haben
Die folgenden in der Kampagne verwendeten Objekte werden als abhängige Objekte kopiert:
- Kampagnen
- Zielgruppen
- Schemata
- Inhaltsvorlagen
- Fragmente
- Nachricht/Inhalt
- Kanalkonfiguration
- Einheitliche Entscheidungsobjekte
- Experimenteinstellungen/-varianten
- Kampagnen können zusammen mit allen Elementen kopiert werden, die sich auf das Profil, die Zielgruppe, das Schema, Inline-Nachrichten und abhängige Objekte beziehen. Einige Elemente werden nicht kopiert, z. B. Datennutzungsbeschriftungen und Spracheinstellungen. Eine vollständige Liste der Objekte, die nicht kopiert werden können, finden Sie im Handbuch Exportieren von Objekten in eine andere Sandbox .
- Das System erkennt automatisch ein vorhandenes Kanalkonfigurationsobjekt in der Ziel-Sandbox und verwendet es erneut, wenn eine identische Konfiguration vorhanden ist. Wenn keine übereinstimmende Konfiguration gefunden wird, wird die Kanalkonfiguration beim Import übersprungen und Benutzende müssen die Kanaleinstellungen in der Ziel-Sandbox für diese Journey manuell aktualisieren.
- Benutzer können vorhandene Experimente und Zielgruppen in der Ziel-Sandbox als abhängige Objekte ausgewählter Kampagnen wiederverwenden.
Vor dem Kopieren von Decisioning-Objekten müssen die folgenden Objekte in der Ziel-Sandbox vorhanden sein:
- In allen Decisioning-Objekten verwendete Profilattribute
- Die Feldergruppe der benutzerdefinierten Angebotsattribute
- die Schemata von Datenströmen, die für Kontextattribute in Regeln, Rangfolgen oder Begrenzungen verwendet werden.
- Das Kopieren von Rangfolgeformeln, die KI-Modelle verwenden, wird derzeit nicht unterstützt.
- Entscheidungselemente (Angebotselemente) werden nicht automatisch einbezogen. Um sicherzustellen, dass sie übertragen werden, fügen Sie sie manuell mit der Option Zum Paket hinzufügen hinzu.
- Richtlinien, die eine Auswahlstrategie verwenden, erfordern, dass die zugehörigen Entscheidungselemente während des Kopiervorgangs manuell hinzugefügt werden. Bei Richtlinien, die manuelle oder Fallback-Entscheidungselemente verwenden, werden diese Elemente automatisch als direkte Abhängigkeiten einbezogen.
- Entscheidungselemente müssen zuerst und vor allen anderen zugehörigen Objekten kopiert werden.
In allen Decisioning-Objekten verwendete Profilattribute,
Die Feldergruppe der benutzerdefinierten Angebotsattribute,
Die Schemata von Datenströmen, die für Kontextattribute in Regeln, Rangfolge oder Begrenzung verwendet werden.
Oberflächen (z. B. Voreinstellungen) werden nicht kopiert. Das System wählt basierend auf dem Nachrichtentyp und dem Namen der Oberfläche automatisch die bestmögliche Übereinstimmung für die Ziel-Sandbox aus. Wenn keine Oberflächen in der Ziel-Sandbox gefunden werden, schlägt die Kopie der Oberfläche fehl, wodurch die Nachrichtenkopie fehlschlägt, da für eine Nachricht eine Oberfläche zur Einrichtung verfügbar sein muss. In diesem Fall muss mindestens eine Oberfläche für den richtigen Kanal der Nachricht erstellt werden, damit die Kopie funktioniert.
Benutzerdefinierte Identitätstypen werden beim Exportieren einer Journey nicht als abhängige Objekte unterstützt.
Exportieren von Objekten in ein Paket export-objects
In diesem Beispiel wird der Prozess des Exports eines Schemas und dessen Hinzufügen zu einem Paket dokumentiert. Sie können denselben Prozess verwenden, um andere Objekte zu exportieren, z. B. Datensätze, Journey und viele mehr.
Objekt zu einem neuen Paket hinzufügen add-object-to-new-package
Wählen Sie linken Navigationsbereich die Option Schemata“ und dann die Registerkarte Durchsuchen aus, auf der die verfügbaren Schemata aufgeführt sind. Klicken Sie als Nächstes auf das Auslassungszeichen (...
) neben dem ausgewählten Schema, und in einem Dropdown-Menü werden dann Steuerelemente angezeigt. Wählen Zum Paket hinzufügen aus dem Dropdown-Menü aus.
Wählen Sie Dialogfeld „Zum Paket hinzufügen die Option Neues Paket erstellen aus. Geben Sie einen Namen für Ihr Paket und eine optionale Beschreibung an und klicken Sie dann auf Hinzufügen.
Sie kehren zur Umgebung Schemata zurück. Sie können jetzt dem von Ihnen erstellten Paket zusätzliche Objekte hinzufügen, indem Sie die nächsten Schritte ausführen, die unten aufgeführt sind.
Objekt zu einem vorhandenen Paket hinzufügen und veröffentlichen add-object-to-existing-package
Um eine Liste der verfügbaren Schemata anzuzeigen, wählen Sie im linken Navigationsbereich Schemata und dann die Registerkarte Durchsuchen aus. Klicken Sie als Nächstes auf das Auslassungszeichen (...
) neben dem ausgewählten Schema, um die Steuerungsoptionen in einem Dropdown-Menü anzuzeigen. Wählen Zum Paket hinzufügen aus dem Dropdown-Menü aus.
Das Zu Paket hinzufügen wird angezeigt. Wählen Sie die Option Vorhandenes Paket aus, klicken Sie dann in Dropdown-Liste Paketname und wählen Sie das erforderliche Paket aus. Wählen Sie abschließend Hinzufügen aus, um Ihre Auswahl zu bestätigen.
Die Liste der dem Paket hinzugefügten Objekte wird aufgelistet. Um das Paket zu veröffentlichen und es für den Import in Sandboxes verfügbar zu machen, wählen Sie "".
Wählen Veröffentlichen aus, um die Veröffentlichung des Pakets zu bestätigen.
Sie kehren zur Registerkarte Pakete in der Umgebung Sandboxes zurück, auf der Sie das neue veröffentlichte Paket sehen können.
Paket in eine Ziel-Sandbox importieren import-package-to-target-sandbox
Um das Paket in eine Ziel-Sandbox zu importieren, navigieren Sie zur Registerkarte Durchsuchen und wählen Sie die Option Plus (+) neben dem Sandbox-Namen aus.
Wählen Sie über das Dropdown-Menü den Paketnamen den Sie in die Ziel-Sandbox importieren möchten. Fügen Sie einen Auftragsnamen hinzu, der für die zukünftige Überwachung verwendet wird. Standardmäßig wird Unified Profile deaktiviert, wenn die Schemata des Pakets importiert werden. Schalten Sie Schemata für Profil aktivieren um dies zu aktivieren, und klicken Sie dann auf Weiter.
Die Seite Paketobjekt und " enthält eine Liste aller in diesem Paket enthaltenen Assets. Das System erkennt automatisch abhängige Objekte, die für den erfolgreichen Import ausgewählter übergeordneter Objekte erforderlich sind. Alle fehlenden Attribute werden oben auf der Seite angezeigt. Wählen Sie Details anzeigen, um eine detailliertere Aufschlüsselung zu erhalten.
Um ein vorhandenes Objekt zu verwenden, wählen Sie das Stiftsymbol neben dem abhängigen Objekt aus.
Die Optionen zum Erstellen neuer oder zum Verwenden vorhandener werden angezeigt. Wählen Sie Use existing aus.
Das Feldgruppe zeigt eine Liste der für das Objekt verfügbaren Feldgruppen an. Wählen Sie die erforderlichen Feldergruppen aus und klicken Sie dann auf Speichern.
Sie kehren zur Seite " und Abhängigkeiten“ . Wählen Sie von hier aus Beenden, um den Package-Import abzuschließen.
Gesamte Sandbox exportieren und importieren
Sie können alle unterstützten Objekttypen in ein vollständiges Sandbox-Paket exportieren und dann das Paket über verschiedene Sandboxes hinweg importieren, um Objektkonfigurationen zu replizieren. Mit dieser Funktion können Sie beispielsweise:
- Importieren Sie eine Sandbox erneut, um alle Konfigurationen des -Objekts zu reproduzieren, wenn Sie die Sandbox zurücksetzen müssen
- Importieren Sie das Paket in andere Sandboxes und verwenden Sie es als Blueprint-Sandbox, um den Entwicklungsprozess zu beschleunigen.
Gesamte Sandbox exportieren export-entire-sandbox
Um eine gesamte Sandbox zu exportieren, navigieren Sie zur Registerkarte Sandboxes Pakete und wählen Sie Paket erstellen aus.
Wählen Sie Gesamte Sandbox für Pakettyp im Dialogfeld Paket erstellen aus. Geben Sie einen Paketnamen für Ihr neues Paket an und wählen Sie die Sandbox aus der Dropdown-Liste aus. Wählen Sie abschließend Erstellen aus, um Ihre Eingaben zu bestätigen.
Das Paket wurde erfolgreich erstellt. Wählen Sie Veröffentlichen aus, um das Paket zu veröffentlichen.
Sie kehren zur Registerkarte Pakete in der Umgebung Sandboxes zurück, auf der Sie das neue veröffentlichte Paket sehen können.
Importieren des gesamten Sandbox-Pakets import-entire-sandbox-package
Um das Paket in eine Ziel-Sandbox zu importieren, navigieren Sie zur Registerkarte Sandboxes Durchsuchen und wählen Sie die Option Plus (+) neben dem Sandbox-Namen aus.
Wählen Sie im Dropdown-Menü mithilfe der Dropdown-Liste Paketname die vollständige Sandbox aus. Fügen Sie einen Auftragsnamen, der für die zukünftige Überwachung verwendet wird, und eine optionale Auftragsbeschreibung hinzu und klicken Sie dann auf Weiter.
Sie gelangen auf die Seite Paketobjekt und Abhängigkeiten, auf der Sie die Anzahl der Objekte und Abhängigkeiten sehen können, die importierte und ausgeschlossene Objekte sind. Wählen Sie von hier Importieren, um den Package-Import abzuschließen.
Warten Sie etwas, bis der Import abgeschlossen ist. Die Dauer des Vorgangs kann von der Anzahl der Objekte im Paket abhängen. Sie können den Importauftrag über die Registerkarte Sandboxes Aufträge überwachen.
Importdetails überwachen view-import-details
Um die importierten Details anzuzeigen, navigieren Sie zur Registerkarte Sandboxes Vorgänge und wählen Sie das Paket aus der Liste aus. Alternativ können Sie über die Suchleiste nach dem Paket suchen.
Wählen Importzusammenfassung anzeigen im rechten Detailbereich auf der Registerkarte Vorgänge in der Sandbox-Umgebung aus.
Das Importzusammenfassung zeigt eine Aufschlüsselung der Importe mit Fortschritt in Prozent an.
Nach Abschluss des Imports erhalten Sie eine Benachrichtigung über den Import in der Experience Platform-Benutzeroberfläche. Sie können auf diese Benachrichtigungen über das Warnhinweissymbol zugreifen. Wenn ein Vorgang nicht erfolgreich war, können Sie von hier aus zur Fehlerbehebung navigieren.
Übertragen von Aktualisierungen der iterativen Objektkonfigurationen über Sandbox-Tools hinweg move-configs
Sie können Sandbox-Tools verwenden, um Objektkonfigurationen zwischen verschiedenen Sandboxes zu übertragen. Zuvor mussten Konfigurationsaktualisierungen an Ihren Objekten (z. B. Schemata, Feldergruppen und Datentypen) manuell neu erstellt oder neu importiert werden, um in andere Sandboxes übertragen zu werden. Mit dieser Funktion können Sie Sandbox-Tools verwenden, um Ihre Workflows zu beschleunigen und potenzielle Fehler zu reduzieren, indem Sie Ihre Konfigurationsaktualisierungen nahtlos über verschiedene Sandboxes hinweg übertragen.
- Die entsprechenden Berechtigungen für den Zugriff auf Sandbox-Tools.
- Ein neu erstelltes oder aktualisiertes Objekt (z. B. ein Schema) in Ihrer Quell-Sandbox.
Unterstützte Objekttypen für den Aktualisierungsvorgang
Die folgenden Objekttypen werden für die Aktualisierung unterstützt:
- Schemata
- Feldergruppen
- Datentypen
- Hinzufügen neuer Felder/Feldergruppen zur Ressource.
- Festlegen eines erforderlichen Felds als optional.
- Einführung neuer Pflichtfelder.
- Ein neues Beziehungsfeld wird eingeführt.
- Ein neues Identitätsfeld wird eingeführt.
- Anzeigename und Beschreibung der Ressource ändern.
- Entfernen zuvor definierter Felder.
- Umdefinieren vorhandener Felder, wenn das Schema für das Echtzeit-Kundenprofil aktiviert ist.
- Entfernen oder Einschränken zuvor unterstützter Feldwerte.
- Verschieben vorhandener Felder an eine andere Position in der Schemastruktur - Dadurch wird ein neues Feld in der Ziel-Sandbox erstellt, das vorherige Feld wird jedoch nicht entfernt.
- Aktivieren oder Deaktivieren des Schemas für die Teilnahme am Profil : Dieser Vorgang wird beim Vergleichsvorgang übersprungen.
- Zugriffssteuerungsbeschriftungen.
Gehen Sie wie folgt vor, um zu erfahren, wie Sie mit den Sandbox-Tools Ihre Objektkonfigurationen über verschiedene Sandboxes hinweg übertragen können.
Zuvor importierte Objekte
Führen Sie diese Schritte aus, wenn Ihr Anwendungsfall vorhandene Objekte in Ihrer Quell-Sandbox betrifft, die Konfigurationsaktualisierungen erfordern, nachdem sie bereits in andere Sandboxes gepackt und in diese importiert wurden.
Aktualisieren Sie zunächst das -Objekt in Ihrer Quell-Sandbox. Navigieren Sie beispielsweise zum Arbeitsbereich Schemata, wählen Sie Ihr Schema aus und fügen Sie eine neue Feldergruppe hinzu.
Navigieren Sie nach der Aktualisierung Ihres Schemas zu Sandboxes wählen Sie Pakete aus und suchen Sie nach dem vorhandenen Paket.
Überprüfen Sie Ihre Änderungen über die Package-Oberfläche. Wählen Sie Nach Updates suchen aus, um Änderungen an den Artefakten in Ihrem Paket anzuzeigen. Wählen Sie als Nächstes Unterschied anzeigen, um eine detaillierte Zusammenfassung aller Änderungen zu erhalten, die an Ihren Artefakten vorgenommen wurden.
Die View diff-Schnittstelle wird angezeigt. Weitere Informationen zu Ihren Quell- und Zielartefakten sowie die darauf anzuwendenden Änderungen finden Sie unter diesem Tool .
In diesem Schritt können Sie auch Mit KI zusammenfassen auswählen, um eine schrittweise Zusammenfassung aller Änderungen zu erhalten.
Wenn Sie bereit sind, wählen Paket aktualisieren und wählen Sie dann Bestätigen in dem Popup-Fenster, das angezeigt wird. Sobald der Auftrag abgeschlossen ist, können Sie die Seite aktualisieren und Verlauf anzeigen auswählen, um die Version Ihres Pakets zu überprüfen.
Um Ihre Änderungen zu importieren, gehen Sie zurück zum Verzeichnis Pakete und wählen Sie die Auslassungszeichen (...
) neben Ihrem Paket aus und klicken Sie auf Paket importieren. Experience Platform wählt vorhandene Objekte aktualisieren automatisch aus. Überprüfen Sie die Änderungen und klicken Sie dann auf Beenden.
Um Ihren Importprozess weiter zu überprüfen, navigieren Sie zu Ihrer Ziel-Sandbox und zeigen Sie das aktualisierte Objekt manuell aus dieser Sandbox an.
Manuell in der Ziel-Sandbox erstellte Objekte
Führen Sie diese Schritte aus, wenn Ihr Anwendungsfall das Anwenden von Konfigurationsänderungen auf Objekte umfasst, die manuell in separaten Sandboxes erstellt wurden.
Erstellen und veröffentlichen Sie zunächst ein neues Paket mit Ihrem aktualisierten Objekt.
Importieren Sie anschließend Ihr Paket in die Ziel-Sandbox, die die Objekte enthält, die Sie auch aktualisieren möchten. Wählen Sie während des Importvorgangs Vorhandene Objekte aktualisieren und verwenden Sie dann den Objektnavigator, um die Zielobjekte, auf die die Aktualisierungen angewendet werden sollen, manuell auszuwählen.
- Es ist optional, für abhängige Objekte ein Zielgruppen-Mapping in einer anderen Sandbox auszuwählen. Wenn keine ausgewählt ist, wird eine neue erstellt.
- Bei Identity-Namespaces erkennt das System automatisch, ob eine neue Identität erstellt werden muss, wenn eine vorhandene in der Ziel-Sandbox wiederverwendet werden muss.
Nachdem Sie die Zielobjekte identifiziert haben, die Sie aktualisieren möchten, klicken Sie auf Beenden.
Video-Tutorial
Das folgende Video soll Ihnen dabei helfen, die Sandbox-Tools besser zu verstehen, und beschreibt, wie Sie ein neues Paket erstellen, ein Paket veröffentlichen und ein Paket importieren.
Nächste Schritte
In diesem Dokument wurde gezeigt, wie die Sandbox-Tooling-Funktion in der Experience Platform-Benutzeroberfläche verwendet wird. Informationen zu Sandboxes finden Sie im Sandbox-Benutzerhandbuch.
Anweisungen zum Ausführen verschiedener Vorgänge mit der Sandbox-API finden Sie im Sandbox-Entwicklerhandbuch. Eine allgemeine Übersicht zu Sandboxes in Experience Platform finden Sie in der Übersichtsdokumentation.