Exportieren von Objekten in eine andere Sandbox copy-to-sandbox

Auf dieser Seite: Erfahren Sie, wie Sie Adobe Journey Optimizer-Objekte wie Journeys, Kampagnen, benutzerdefinierte Aktionen, Inhaltsvorlagen und Fragmente mithilfe des Paketexports und -imports zwischen Sandboxes kopieren.

Sie können Objekte wie Journeys, Kampagnen, benutzerdefinierte Aktionen, Inhaltsvorlagen oder Fragmente über mehrere Sandboxes hinweg kopieren, indem Sie die Funktionen für den Paketexport und -import verwenden. Ein Paket kann aus einem oder mehreren Objekten bestehen. Alle Objekte, die in einem Paket enthalten sind, müssen aus derselben Sandbox stammen.

Auf dieser Seite wird der Anwendungsfall der Sandbox-Werkzeuge im Kontext von Journey Optimizer beschrieben. Weitere Informationen zur Funktion selbst finden Sie im Adobe Experience Platform-Handbuch zu Sandbox-Tools.

NOTE
Diese Funktion erfordert die folgenden Berechtigungen von der Funktion Sandbox-Administration: „Sandboxes verwalten“ (oder „Sandboxes anzeigen“) und „Pakete verwalten“. Weitere Informationen

Der Kopiervorgang erfolgt über den Export und Import eines Pakets zwischen der Quell- und der Ziel-Sandbox. Nachfolgend erfahren Sie, wie Sie eine Journey von einer Sandbox in eine andere kopieren:

NOTE
Verwenden Sie für die Migration von Entscheidungs-Management-Objekten zur Entscheidungsfindung die dedizierte Decisioning Migration API, die eine automatisierte Abhängigkeitsauflösung und Rollback-Funktionen bietet, die speziell für die Migration von Entscheidungsentitäten entwickelt wurden.

Exportierte Objekte und Best Practices objects

Mit Journey Optimizer können Sie Journeys, Kampagnen (Aktions- und durch API ausgelöste Kampagnen sowie orchestrierte Kampagnen), benutzerdefinierte Aktionen, Inhaltsvorlagen, Fragmente und andere Objekte in eine andere Sandbox exportieren. In den folgenden Abschnitten finden Sie Informationen und Best Practices für jede Art von Objekt.

Allgemeine Best Practices global

  • Beim Kopieren eines Objekts werden alle Abhängigkeiten (z. B. verschachtelte Fragmente, Journey-Zielgruppen oder Aktionen) im übergeordneten Objekt korrekt aktualisiert, sodass eine korrekte Zuordnung in der Ziel-Sandbox gewährleistet ist.

  • Wenn ein exportiertes Objekt eine Profilpersonalisierung enthält, stellen Sie sicher, dass das entsprechende Schema in der Ziel-Sandbox vorhanden ist, um Probleme mit der Personalisierung zu vermeiden.

  • Landingpages werden derzeit nicht für die Migration zwischen Sandboxes unterstützt. Wenn Sie eine Journey in eine andere Sandbox kopieren, verweisen alle Verweise auf Landingpages in Ihrem Journey- oder E-Mail-Inhalt weiterhin auf die ursprünglichen (Quell-)Sandbox-Landingpage-IDs. Nach der Migration müssen Sie alle Verweise auf Landingpages in Ihrem Journey- und E-Mail-Inhalt manuell aktualisieren, um die richtigen Landingpage-IDs aus der Ziel-Sandbox zu verwenden. Siehe Erstellen und Veröffentlichen von Landingpages.

Journeys
  • Kopierte Abhängigkeiten: Wenn Sie eine Journey exportieren, kopiert Journey Optimizer nicht nur die Journey selbst, sondern auch die meisten Objekte, von denen die Journey abhängt: Zielgruppen, benutzerdefinierte Aktionen, Schemata, Ereignisse und Aktionen. Weitere Informationen zu kopierten Objekten finden Sie im Adobe Experience Platform-Handbuch zu Sandbox-Tools.

  • Manuelle Validierung empfohlen: Wir können nicht garantieren, dass alle verknüpften Elemente in die Ziel-Sandbox kopiert werden. Wir empfehlen Ihnen dringend, eine gründliche Prüfung durchzuführen, zum Beispiel vor der Veröffentlichung einer Journey. Auf diese Weise können Sie jedes potenziell fehlende Objekt identifizieren.

  • Entwurfsmodus und Eindeutigkeit: Die kopierten Objekte in der Ziel-Sandbox sind eindeutig, sodass kein Risiko besteht, vorhandene Elemente zu überschreiben. Sowohl die Journey als auch alle Nachrichten innerhalb der Journey werden im Entwurfsmodus übergeben. So können Sie vor der Veröffentlichung in der Ziel-Sandbox eine gründliche Validierung durchführen.

  • Metadaten: Der Kopiervorgang kopiert nur die Metadaten über die Journey und die Objekte in dieser Journey. Im Rahmen dieses Prozesses werden keine Profil- oder Datensatzdaten kopiert.

  • Benutzerdefinierte Aktionen

    • Beim Exportieren benutzerdefinierter Aktionen werden URL-Konfiguration und Payload-Parameter kopiert. Aus Sicherheitsgründen werden Authentifizierungsparameter jedoch nicht kopiert, sondern durch „INSERT SECRET HERE“ (Geheimnis hier einfügen) ersetzt. Konstante Parameterwerte für Anfrage-Header und Abfrage werden ebenfalls durch „INSERT SECRET HERE“ (Geheimnis hier einfügen) ersetzt.

      Dazu gehören die benutzerdefinierten Aktionen für spezielle Zwecke (Adobe Campaign Standard, Campaign Classic, Marketo Engage).

    • Wenn Sie beim Kopieren einer Journey in eine andere Sandbox für eine benutzerdefinierte Aktion während des Importvorgangs „Vorhandene verwenden“ auswählen, muss die ausgewählte benutzerdefinierte Aktion mit der benutzerdefinierten Quellaktion übereinstimmen (d. h. gleiche Konfiguration, Parameter usw.). Andernfalls weist die neue Journey-Kopie Fehler auf, die auf der Arbeitsfläche nicht korrigiert werden können.

  • Datenquellen, Feldergruppen und Ereignisse: Beim Kopieren einer Journey, die Ereignisse, Datenquellen oder Feldergruppen verwendet, prüft der Importvorgang automatisch, ob in der Ziel-Sandbox bereits Komponenten mit demselben Namen und Typ vorhanden sind. Beispielsweise wird ein unitäres Ereignis durch ein unitäres Ereignis mit demselben Namen in der Ziel-Sandbox ersetzt. Dasselbe gilt für Geschäftsereignisse, benutzerdefinierte Datenquellen und sowohl API-basierte als auch schemabasierte Feldergruppen, die in Journeys verwendet werden. Wenn ein unitäres Ereignis aus der Quell-Sandbox denselben Namen wie eine Ziel-Sandbox eines Geschäftsereignisses hat, wird sie weder kopiert noch erstellt. Dies gilt auch für alle anderen Komponenten.

Aktionskampagnen und durch API ausgelöste Kampagnen

Sie können Aktionskampagnen und durch API ausgelöste Kampagnen mithilfe von Paketexport und -import zwischen Sandboxes kopieren.

Diese Kampagnentypen werden zusammen mit allen Elementen kopiert, die sich auf das Profil, die Zielgruppe, das Schema, Inline-Nachrichten und abhängige Objekte beziehen.

Die folgenden Elemente werden jedoch nicht kopiert:

  • mehrsprachige Varianten und Spracheinstellungen,
  • Geschäftsregeln,
  • Tags,
  • Labels für Data Usage Labelling and Enforcement (DULE).

Achten Sie beim Kopieren von Aktionskampagnen oder durch API ausgelösten Kampagnen darauf, dass die unten aufgeführten Objekte in der Ziel-Sandbox überprüft werden, um Fehlkonfigurationen zu vermeiden:

  • Kanalkonfigurationen: Kanalkonfigurationen werden zusammen mit Kampagnen kopiert. Nachdem die Kampagnen kopiert wurden, müssen die Kanalkonfigurationen manuell in der Ziel-Sandbox ausgewählt werden.
  • Experimentelle Varianten und Einstellungen: Experimentelle Varianten und Einstellungen sind im Kampagnenkopierprozess enthalten. Validieren Sie diese Einstellungen nach dem Import in der Ziel-Sandbox.
  • Einheitliche Entscheidungsfindung: Entscheidungsrichtlinien und Entscheidungselemente werden für den Export und Import unterstützt. Stellen Sie sicher, dass entscheidungsbezogene Abhängigkeiten in der Ziel-Sandbox korrekt zugeordnet sind.
Orchestrierte Kampagnen

Sie können orchestrierte Kampagnen mithilfe von Paketexport und -import zwischen Sandboxes kopieren. Orchestrierte Kampagnen folgen demselben allgemeinen Muster wie andere Objekte. Was jedoch im Paket enthalten ist und was Sie in der Ziel-Sandbox vorbereiten müssen, unterscheidet sich von Aktionskampagnen oder durch API ausgelösten Kampagnen.

Um eine orchestrierte Kampagne zu exportieren, fügen Sie sie in der Quell-Sandbox zu einem Sandbox-Paket hinzu (unabhängig von ihrem Status), veröffentlichen Sie das Paket und importieren Sie das Paket anschließend in die Ziel-Sandbox.

Beachten Sie vor dem Import in die Produktion das folgende Verhalten und die folgenden Einschränkungen:

  • Entwurfskopie – Die importierte orchestrierte Kampagne wird in der Ziel-Sandbox immer als Entwurf erstellt, unabhängig vom Status der orchestrierten Quellkampagne.

  • Neues Objekt bei jedem Import – Beim erneuten Importieren eines Pakets wird eine neue orchestrierte Kampagne erstellt. Eine zuvor importierte Kampagne wird nicht überschrieben oder aktualisiert.

  • Der erneute Export desselben Pakets wird nicht unterstützt – Wenn dasselbe Paket nach dem bereits erfolgten Export ein zweites Mal veröffentlicht wird, führt dies dazu, dass Aktivitäten innerhalb der importierten Kampagne in einen Fehlerstatus geraten. In diesem Fall müssen Sie die betroffenen Aktivitäten löschen und manuell neu erstellen. Diese Einschränkung wird in einer zukünftigen Version behoben.

  • Abhängigkeiten werden nicht alle automatisch kopiert – Wenn Sie einem Paket nur die orchestrierte Kampagne hinzufügen, wird dadurch nicht automatisch die vollständige Abhängigkeitskette einbezogen. Kanalkonfigurationen, relationale Speicherschemata, Datensätze und Geschäftsregeln sind nicht enthalten, es sei denn, Sie berücksichtigen diese explizit (weitere Informationen finden Sie im nächsten Punkt).

    Beim Paketimport listet Journey Optimizer die in der Ziel-Sandbox aufzulösenden Objekte auf. Für die gängigsten Objekte gelten die folgenden Regeln:

    • Kampagne – Wählen Sie immer Neu erstellen aus.
    • Zielgruppen – Für Adobe Experience Platform-Zielgruppen können Sie Neu erstellen oder Vorhandene verwenden auswählen. Für Zielgruppen orchestrierter Kampagnen müssen Sie Vorhandene verwenden auswählen und diese der entsprechenden Zielgruppe in der Ziel-Sandbox zuordnen.
    • Zusammenführungsrichtlinien – Wählen Sie Vorhandene verwenden aus und ordnen Sie diese der entsprechenden Zusammenführungsrichtlinie zu, oder verwenden Sie die Standardrichtlinie in der Ziel-Sandbox.

    Verwenden Sie nach dem Import Warnhinweise in der orchestrierten Kampagne, um verbleibende Lücken zu finden (z. B. kann eine Profil- oder Targeting-Ressource, die in der Ziel-Sandbox noch nicht vorhanden ist, dazu führen, dass eine Aktivität ein leeres Ziel aufweist, bis Sie dies beheben).

  • Was Sie separat hinzufügen oder anpassen müssen – Folgendes ist im Export der orchestrierten Kampagne nicht enthalten:

    • Kanalkonfigurationen – Sie werden nicht mit dem Paket exportiert oder importiert. Damit E-Mail- und andere Kanalaktivitäten ohne manuelle Korrekturen funktionieren, muss die Ziel-Sandbox bereits über eine Kanalkonfiguration verfügen, deren Name exakt mit der Quelle übereinstimmt (Groß-/Kleinschreibung beachten) und die denselben Kanal verwendet. Andernfalls werden Ihnen nach dem Import Warnhinweise zu den Aktivitäten angezeigt. Öffnen Sie jede betroffene Aktivität und wählen oder erstellen Sie die korrekte Kanalkonfiguration.

    • Relationale Speicherschemata und Datensätze – Wenn Ihre Kampagne von einem bestimmten Datenmodell abhängig ist, planen Sie die Export-/Importreihenfolge von Schemata und Datensätzen so, dass Abhängigkeiten bei Bedarf vorhanden sind (beim Exportieren eines Datensatzes werden in der Regel die zugehörigen Schemaanforderungen abgerufen, beim alleinigen Exportieren eines Schemas ist dessen Datensatz jedoch nicht enthalten). Beachten Sie, dass importierte Datensätze nicht automatisch für orchestrierte Kampagnen aktiviert werden – Sie müssen sie nach dem Import in der Ziel-Sandbox manuell aktivieren.

    • Geschäftsregeln und ähnliche Richtlinienobjekte – Sie sind im Export der orchestrierten Kampagne nicht enthalten. Wenn Ihre Kampagne davon abhängt, stellen Sie sicher, dass diese in der Ziel-Sandbox vorhanden sind, oder erstellen Sie sie dort neu.

    • Profil-Zielgruppendimension – Die Profil-Zielgruppendimension ist im Export nicht enthalten. Wenn sie in der Ziel-Sandbox nicht vorhanden ist, bleiben die entsprechenden Aktivitäten in der importierten orchestrierten Kampagne leer, bis Sie sie manuell konfigurieren.

Entscheidungsfindung
  • Die folgenden Objekte müssen in der Ziel-Sandbox vorhanden sein, bevor Entscheidungsfindungsobjekte kopiert werden können:

    • In allen Entscheidungsfindungsobjekten verwendete Profilattribute,
    • die Feldergruppe der benutzerdefinierten Angebotsattribute,
    • die Schemata von Datenströmen, die für Kontextattribute in Regeln, Rangfolgen oder Begrenzungen verwendet werden.
  • Die Sandbox-Kopie für Rangfolgeformeln mit KI-Modellen wird derzeit nicht unterstützt.

  • Beim Kopieren einer Kampagne werden Entscheidungselemente (Angebotselemente) nicht automatisch mitkopiert. Stellen Sie sicher, dass Sie diese einzeln über die Option „Zu Paket hinzufügen“ kopieren.

  • Wenn eine Entscheidungsrichtlinie über eine Auswahlstrategie verfügt, müssen Entscheidungselemente separat hinzugefügt werden. Wenn sie manuelle oder Fallback-Entscheidungselemente enthält, werden diese automatisch als direkte Abhängigkeiten hinzugefügt.

  • Stellen Sie beim Kopieren von Entscheidungsentitäten sicher, dass Sie Entscheidungselemente vor jedem anderen Objekt kopieren. Wenn Sie beispielsweise zuerst eine Sammlung kopieren und in der neuen Sandbox keine Angebote vorhanden sind, bleibt diese neue Sammlung leer.

  • Wenn Sie Entitäten mit Abhängigkeiten (z. B. Schema, Segmente) kopieren, klicken Sie für die Entität auf „Neu erstellen“, um deren Auswahl aufzuheben und die Option „Vorhandene verwenden“ für abhängige Artefakte anzuzeigen. Für zusätzliche Abhängigkeiten kann es erforderlich sein, diesen Schritt weiter unten in der Hierarchie zu wiederholen.

    Beispiel: Um beim Importieren einer Kampagne ein Datenstromschema in einer Regel wiederzuverwenden, klicken Sie auf „Neu erstellen“ für DECISIONING_STRATEGY und dann erneut auf DECISIONING_RULES, um die Option „Vorhandene verwenden“ für das Datenstromschema anzuzeigen.

  • Stellen Sie bei Entitäten, die von einem Datenstrom-Kontextschema abhängig sind, sicher, dass der Datenstrom zuvor erstellt wurde, und wählen Sie ein vorhandenes Schema für diesen Datenstrom aus.

  • Wenn Sie beim Importieren direkt auf „Beenden“ klicken, werden alle Abhängigkeiten neu erstellt.

Inhaltsvorlagen
  • Wenn Sie eine Inhaltsvorlage exportieren, werden auch alle verschachtelten Fragmente mitkopiert.

  • Der Export von Inhaltsvorlagen kann manchmal zu einer Duplizierung von Fragmenten führen. Wenn beispielsweise zwei Vorlagen das gleiche Fragment freigeben und in getrennten Paketen kopiert werden, müssen beide Vorlagen das gleiche Fragment in der Ziel-Sandbox wiederverwenden. Um Duplikate zu vermeiden, wählen Sie während des Importvorgangs die Option „Vorhandene verwenden“. Erfahren Sie, wie man ein Paket importiert

  • Um Duplikate weiter zu vermeiden, wird empfohlen, Inhaltsvorlagen in einem einzigen Paket zu exportieren. Dadurch wird sichergestellt, dass das System Deduplizierungen effizient verwaltet.

Fragmente
  • Fragmente können über mehrere Status verfügen, z. B. „Live“, „Entwurf“ und „Live mit Entwurf in Bearbeitung“. Beim Exportieren eines Fragments wird sein letzter Entwurfsstatus in die Ziel-Sandbox kopiert.

  • Beim Exportieren eines Fragments werden auch alle verschachtelten Fragmente mitkopiert.

Journey-Fragmente
  • Journey-Fragmente (wiederverwendbare Sets von Journey-Knoten) werden für Sandbox-Tools unterstützt. Beim Exportieren eines Journey-Fragments wird dessen neuester Entwurfsstatus in die Ziel-Sandbox kopiert.

Hinzufügen von Objekten als Paket export

Um Objekte in eine andere Sandbox zu kopieren, müssen Sie sie zunächst als Paket in der Quell-Sandbox hinzufügen. Führen Sie folgende Schritte aus:

  1. Navigieren Sie zum Sammlungsbestand, in dem das erste zu kopierende Objekt gespeichert ist, z. B. die Liste „Journeys“. Klicken Sie auf das Symbol Weitere Aktionen (die drei Punkte neben dem Objektnamen) und dann auf Zum Paket hinzufügen.

  2. Wählen Sie im Fenster Zu Paket hinzufügen aus, ob Sie das Objekt einem vorhandenen Paket hinzufügen oder ein neues Paket erstellen möchten:

    • Vorhandenes Paket: Wählen Sie das Paket aus dem Dropdown-Menü aus.
    • Neues Paket erstellen: Geben Sie den Paketnamen ein. Sie können auch eine Beschreibung hinzufügen.
  3. Wiederholen Sie diese Schritte, um alle Objekte hinzuzufügen, die Sie mit Ihrem Paket exportieren möchten.

Veröffentlichen des Pakets zum Export publish

Nachdem Ihr Paket für den Export bereit ist, führen Sie die folgenden Schritte aus, um es zu veröffentlichen:

  1. Navigieren Sie zum Menü Administration > Sandboxes und wählen Sie die Registerkarte Pakete aus.

  2. Öffnen Sie das zu exportierende Paket, wählen Sie die zu exportierenden Objekte aus und klicken Sie auf Veröffentlichen.

    In diesem Beispiel möchten wir eine Journey, eine Inhaltsvorlage und ein Fragment exportieren.

  3. So verfolgen Sie den Status der Veröffentlichung des Pakets auf der Registerkarte Aufträge. Weitere Details zu einem Auftrag erhalten Sie, indem Sie diesen in der Liste auswählen und auf die Schaltfläche Importdetails anzeigen klicken.

Importieren des Pakets in die Ziel-Sandbox import

Sobald das Paket veröffentlicht wurde, müssen Sie es in die Ziel-Sandbox importieren. Führen Sie folgende Schritte aus:

  1. Navigieren Sie zum Menü Sandboxes und wählen Sie die Registerkarte Durchsuchen aus.

  2. Suchen Sie nach der Sandbox, in die Sie das Paket importieren möchten, und klicken Sie dann neben dem Namen auf das Symbol „+“.

    note
    NOTE
    Es sind nur Sandboxes innerhalb Ihrer Organisation verfügbar.
  3. Überprüfen Sie im Feld Ziel-Sandbox, ob die richtigen Ziel-Sandboxes ausgewählt sind, und wählen Sie das zu importierende Paket aus der Dropdown-Liste Paketname aus. Klicken Sie auf Weiter.

  4. Überprüfen Sie die Paketobjekte und Abhängigkeiten. Dies ist die Liste der Objekte, die dem Paket hinzugefügt wurden, zusammen mit anderen Objekten, von denen Journeys abhängen, wie Zielgruppen, Schemata, Ereignisse oder Aktionen.

    Für jedes Objekt können Sie entweder ein neues erstellen oder ein vorhandenes Objekt in der Ziel-Sandbox verwenden. Auf diese Weise können Sie beispielsweise Fragmentduplizierung vermeiden, die beim Import von Inhaltsvorlagen mit gemeinsamen Fragmenten auftreten kann.

  5. Klicken Sie auf die Schaltfläche Beenden oben rechts, um mit dem Kopieren des Pakets in die Ziel-Sandbox zu beginnen. Der Kopiervorgang hängt von der Komplexität der Objekte ab und davon, wie viele Objekte kopiert werden müssen.

  6. Klicken Sie auf den Importauftrag, um das Kopierergebnis zu überprüfen:

    • Klicken Sie auf die Schaltfläche Importierte Objekte anzeigen, um jedes einzelne kopierte Objekt anzuzeigen.
    • Klicken Sie auf die Schaltfläche Importdetails anzeigen, um die Importergebnisse für jedes Objekt zu überprüfen.

  7. Greifen Sie auf Ihre Ziel-Sandbox zu und führen Sie eine gründliche Prüfung aller kopierten Objekte durch.

recommendation-more-help
journey-optimizer-help