Campaigns
A campaign groups posts that belong together, for example Spring sale. Each campaign has a name, which people see, and a value, which goes to your analytics: it tags the links in the posts that belong to the campaign (for example as utm_campaign, where a link rewriter or UmbSocial Pro does that).
In the composer
Section titled “In the composer”The Campaign field works like the tags on a page. A post has at most one campaign.
- Start typing: the campaigns whose name has what you typed are listed, the most recently used first. Choose one.
- A name that doesn’t exist yet appears as Add ”…”. Choose it (or press Enter) and the campaign is added and picked. You need the Write permission, which you already have to compose. The value is always made from the name here.
- The field shows the campaign’s value as a hint, so you can see what the links will carry.
- Clear the field to take the post out of its campaign.
Names are unique ignoring case: spring sale and Spring Sale are the same campaign; if two people add the same name at once, they both get the one campaign.
The value
Section titled “The value”The value is made from the name: lower-case, with anything other than letters, digits and . _ ~ - turned into a - (Spring Sale! becomes spring-sale). If another campaign already has it, a number is added (spring-sale-2). A manager can edit it, using only lower-case letters, digits and . _ ~ -, at most 100 characters; every value is unique.
Managing campaigns
Section titled “Managing campaigns”UmbSocial › Campaigns, in the UmbSocial section’s sidebar next to Queue, Compose and Published, lists every campaign with its value, how many posts use it and when it was last used. It needs the Manage settings permission, but not Umbraco’s Settings section, so editors can manage campaigns without it. Filter by name, page through the list, and use Create campaign to add one with a value of your choosing.
Open a campaign to rename it, and to edit its value or make it again from the new name. A rename keeps the value unless you change it; a new value reaches the posts not yet sent. Posts already sent keep the links they went out with, so they keep their value.
In a campaign’s menu:
- Merge into… moves its posts to another campaign you pick, and removes it.
- Delete removes it. A campaign no post uses is removed at once. When posts use it you are asked first (posts still scheduled will go out without its tagging); they keep no campaign afterwards.
Every post that is moved, renamed or cleared gets an entry in its history. Handlers can react to each change: see the campaign notifications.
On the Published page
Section titled “On the Published page”The Published page can be filtered by campaign.
Upgrading
Section titled “Upgrading”Posts written before campaigns were campaigns carry their old free text. When the site updates, each different text (ignoring case and spacing) becomes a campaign, named as it was first written, with a value made from it, and its posts are pointed at it.
Extending
Section titled “Extending”The campaign reaches a link rewriter as the CampaignKey and CampaignValue on its LinkRewriteContext. The management API has the endpoints.