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.
Das Plugin installieren
Abschnitt betitelt „Das Plugin installieren“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.
sf plugins trust allowlist add --name @campaign-audience-builder/sf-plugin-cabsf plugins install @campaign-audience-builder/sf-plugin-cabDer 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.
Zielgruppen kopieren
Abschnitt betitelt „Zielgruppen kopieren“-
Listen Sie die Zielgruppen der Quell-Org auf:
Terminal-Fenster sf cab audience list -o uat -
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 -
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.
Befehle
Abschnitt betitelt „Befehle“| Befehl | Was er tut |
|---|---|
sf cab audience list | Zeigt die Zielgruppen einer Org mit API-Namen, Ordnern und den Zielgruppen, die sich nicht exportieren lassen. |
sf cab audience export | Schreibt die ausgewählten Zielgruppen in eine JSON-Datei. |
sf cab audience import | Schreibt 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 migrate | Exportiert und importiert in einem Schritt und behält die Exportdatei. |
Mit --help zeigt ein Befehl alle Flags und Beispiele.
Was der Import macht
Abschnitt betitelt „Was der Import macht“- 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.
Einen Import rückgängig machen
Abschnitt betitelt „Einen Import rückgängig machen“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:
sf cab audience import -o prod --file cab-backup-prod-20261014-1412.jsonDie Wiederherstellung löscht keine Zielgruppen, die der Import angelegt hat; ihre Ausgabe listet sie auf.
In einer Pipeline importieren
Abschnitt betitelt „In einer Pipeline importieren“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-Code | Bedeutung |
|---|---|
| 0 | Alle Zielgruppen wurden importiert oder sind unverändert. |
| 1 | Nichts wurde geändert, wegen eines Fehlers oder einer Antwort „Nein“. |
| 68 | Einige Zielgruppen wurden importiert, andere sind gescheitert oder wurden übersprungen. |
Alle Optionen stehen im Repository sf-plugin-cab auf GitHub.

