Skip to content

Add results to a Campaign

After these steps, the people in the audience are members of the campaign with the status you chose.

Before you begin

Permission
Read access to Campaign and create access to Campaign Member. Campaign Cleansing also needs delete access to Campaign Member. See Permission sets.

Run the audience first, or open the results of its last run. See Work with audience results. What a campaign add does and which results it reaches is described in How actions work.

  1. On the results page, select Add to Campaign.

  2. In Campaign, search for the campaign. To create one, select New Campaign at the end of the list, fill in Create New Campaign and save it.

  3. Choose the Member Status the new members get.

  4. Optional: set member fields, decide what happens to existing members, and turn on cleansing. See the sections below.

  5. Select Done.

Each section header shows a summary of its settings while it’s closed. A section whose settings differ from the default opens by itself.

If schedules already update the campaign, a notice says so; Show More lists them. When one of them cleanses the whole campaign, the notice warns that its next run may remove the members you add.

  1. Select Set Campaign Member Field.

  2. In Field, choose the Campaign Member field to fill.

  3. In Field Mapping, choose where the value comes from: a field of the result or its parent records, up to three relationship levels, or a related value or aggregate under Audience Data Graph. To write the same value for everyone, select Enter Fixed Value instead.

CAB offers only fields whose type fits, and each Campaign Member field only once. How related values and aggregates are calculated is in Related data and Data Inclusions. Each field adds work to the add, so map only what you need.

Under Membership updates, Update existing campaign members? decides what happens to people who are already in the campaign:

  • Keep existing member status and fields leaves them as they are. This is the default.
  • Update existing member status and fields gives them the member status and field values of this add.

Campaign Cleansing under Cleansing Settings removes campaign members who aren’t in the results before the new members are added. It needs the Professional edition. See Editions and features.

  • Limit cleansing to this Audience removes only members that this audience added.
  • Ignore the following status(es) keeps members with the statuses you choose.

Under Measure results, pick outcomes for this add, and optionally a control group. See Measure extra conversions with a control group.

A message confirms the add with a link to the campaign. A large add continues in the background, and you get a notification when it’s finished; follow it under Background operations. See Limits and requirements.

In the audience’s run history, Added to Campaigns lists the add with its new, updated, unchanged and removed members. See See size and membership changes.

Automation in your org, such as a flow or an Apex trigger, can block the removal of a campaign member. CAB then keeps the removals that worked, adds the new members anyway, and shows Cleansing incomplete with the number of members it couldn’t remove. They stay in the campaign.

In the run history, the column Failed Removals shows the count for each campaign. It appears only when at least one add of the run couldn’t remove members.

Select the count to open Failed Removals. It lists each member by name, linked to the Campaign Member record. A single error is shown once above the list; different errors are listed with their member counts, and the table gets an Error column. A member deleted since then, or one you can’t access, shows as Record unavailable.

Fix the cause, for example the automation that blocks the removal, then add the audience to the campaign again. A schedule retries the removals on its next run.