Zum Inhalt springen

Zielgruppen zwischen Orgs übertragen

Nach diesen Schritten gibt es die Zielgruppen einer Org auch in einer anderen, mit ihren Filtern, Ordnern und den Einträgen der Filterbibliothek und Zielvorhaben, die sie nutzen.

Bevor Sie beginnen

Berechtigung
In der Ziel-Org Erstell-, Bearbeitungs- und Löschzugriff auf die CAB-Objekte, etwa über den Berechtigungssatz Campaign Audience Builder User. Siehe Berechtigungssätze.

Das Open-Source-Plugin sf-plugin-cab für die sf CLI kopiert Zielgruppen zwischen Salesforce-Orgs, zum Beispiel beim Go-live aus einer Sandbox in die Produktion. Es nutzt die Org-Aliase, die Ihre sf CLI schon kennt; eine eigene Anmeldung gibt es nicht.

Sie brauchen eine aktuelle sf CLI mit Node 22 oder neuer (sf update), einen Alias für jede Org und Campaign Audience Builder in beiden Orgs.

Terminal-Fenster
sf plugins trust allowlist add --name @campaign-audience-builder/sf-plugin-cab
sf plugins install @campaign-audience-builder/sf-plugin-cab

Der erste Befehl setzt das Plugin auf die Allowlist der sf CLI, damit die Installation nicht nachfragt. Später aktualisieren Sie das Plugin mit sf plugins update.

  1. Listen Sie die Zielgruppen der Quell-Org auf:

    Terminal-Fenster
    sf cab audience list -o uat
  2. Sehen Sie, was ein Import in die Ziel-Org ändern würde. Dabei ändert sich nichts:

    Terminal-Fenster
    sf cab audience migrate --source-org uat --target-org prod --all --dry-run
  3. Kopieren Sie die Zielgruppen. Der Befehl zeigt den Plan und fragt einmal, bevor er die Org ändert:

    Terminal-Fenster
    sf cab audience migrate --source-org uat --target-org prod --all

Statt --all wählen Sie Zielgruppen mit --name (API-Name oder Name) oder --folder (ein Ordnerpfad wie "Marketing/EMEA"). Ohne Auswahl zeigt der Befehl eine Liste zum Auswählen. Eine Kombinations- oder Waterfall-Sequenz bringt die Zielgruppen mit, die sie nutzt.

BefehlWas er tut
sf cab audience listZeigt die Zielgruppen einer Org mit API-Namen, Ordnern und den Zielgruppen, die sich nicht exportieren lassen.
sf cab audience exportSchreibt die ausgewählten Zielgruppen in eine JSON-Datei.
sf cab audience importSchreibt die Zielgruppen aus einer Datei in eine Org. Zeigt zuerst einen Plan und sichert die Zielgruppen der Ziel-Org, die er aktualisiert.
sf cab audience migrateExportiert und importiert in einem Schritt und behält die Exportdatei.

Mit --help zeigt ein Befehl alle Flags und Beispiele.

  • Eine Zielgruppe wird über ihren API-Namen einer Zielgruppe der Ziel-Org zugeordnet, ohne Rücksicht auf Groß- und Kleinschreibung. Eine Entsprechung wird aktualisiert, eine Zielgruppe ohne Entsprechung angelegt. Eine Zielgruppe ohne API-Namen lässt sich nicht zuordnen, daher überspringt der Export sie.
  • Jede Zielgruppe wird in einer Transaktion geschrieben: Scheitert ein Teil, bleibt die Zielgruppe der Ziel-Org, wie sie war. Eine Aktualisierung lässt Zeitpläne, Ausführungsverlauf und Kampagnenmitglieder der Ziel-Org verknüpft.
  • Ordner, Einträge der Filterbibliothek und Zielvorhaben werden über ihren eindeutigen Namen zugeordnet, dann über ihren Namen. Der Import kann fehlende anlegen, ändert vorhandene aber nie. Bei einem Eintrag der Filterbibliothek, der in der Quell-Org ein Standard ist, fragt er, ob er Standard bleibt; die Vorgabe ist Nein.
  • Eine gesperrte Verknüpfung mit der Filterbibliothek lässt sich nur in CAB selbst anlegen. Der Import übernimmt die Zielgruppe dann ohne die Verknüpfung und warnt; verknüpfen Sie den Eintrag in der Ziel-Org erneut.
  • Filterwerte, die wie Datensatz-IDs aussehen, ergeben eine Warnung, denn eine ID aus einer Org kann in einer anderen falsch sein.
  • Zielgruppen der Ziel-Org, die nicht in der Datei stehen, bleiben, wie sie sind.

Nicht kopiert werden Zeitpläne, geplante Aktionen, Abschlussaktionen, Ausführungsergebnisse und Kampagnenmitglieder.

Vor seiner ersten Änderung sichert der Import die Zielgruppen, die er aktualisiert, zum Beispiel in cab-backup-prod-20261014-1412.json. Importieren Sie diese Datei, um ihnen ihre frühere Definition zurückzugeben:

Terminal-Fenster
sf cab audience import -o prod --file cab-backup-prod-20261014-1412.json

Die Wiederherstellung löscht keine Zielgruppen, die der Import angelegt hat; ihre Ausgabe listet sie auf.

In einer Pipeline fragt der Befehl nie. Geben Sie jede Antwort mit einem Flag, etwa --missing-folders create, --missing-templates create, --missing-outcomes create, --template-defaults clear und --yes. Fehlt eine Antwort, hält der Befehl vor jeder Änderung an und nennt das Flag.

Exit-CodeBedeutung
0Alle Zielgruppen wurden importiert oder sind unverändert.
1Nichts wurde geändert, wegen eines Fehlers oder einer Antwort „Nein“.
68Einige Zielgruppen wurden importiert, andere sind gescheitert oder wurden übersprungen.

Alle Optionen stehen im Repository sf-plugin-cab auf GitHub.