Campaigns
Group posts into a named push, track budget and targets, and follow attribution from a post back to a lead or sale.
A campaign is a record under Social Media → AI Workforce → Campaigns that bundles related posts, sets measurable targets, and creates the UTM link so CRM leads and sales orders can trace themselves back to the post that brought them in.
The campaign form#
| Field | Meaning |
|---|---|
| Name | Required, unique per company. |
| Objective | Awareness, Engagement, Traffic, Lead Generation, Sales, or Retention. |
| State | Planning, Running, Finished, or Cancelled. |
| Starts / Ends | The date range. End must be at or after start. |
| Owner | Defaults to the person who creates it. |
| Lead Agent | The agent that owns this campaign's content by default. When a post is added to the campaign and has no agent of its own, it inherits this one. |
| Budget | Monetary, in the company currency. |
| Target Posts, Target Engagement, Target Leads | Numeric goals. Progress bars below calculate automatically. |
| Campaign Brief | HTML brief for the team. |
| Attribution Campaign | A utm.campaign record, created automatically the first time the campaign is started. Links every lead and order that arrives with a UTM tag back here. |
| Default Source / Default Medium | Defaults to SmartERP Social and Social Media when available. |
| Track Links | When on (the default on each post), UTM parameters are appended to every URL in that post's message. |
State transitions#
| Button | From | To | Notes |
|---|---|---|---|
| Start | Planning | Running | Creates the utm.campaign record if it does not already exist. |
| Finish | Running | Finished | |
| Cancel | Planning, Running | Cancelled | |
| Reset to Draft | Finished, Cancelled | Planning |
What the posts tab shows#
Each row shows the post's name, state, scheduled date and agent. The totals at the bottom roll up across all the posts in this campaign:
- Published posts, Pending (in the approval queue), Scheduled posts.
- Total Views, Total Engagement (likes + comments + shares), Engagement Rate.
- Posts vs Target (%) and Engagement vs Target (%), computed against your targets.
Adding a post to a campaign#
On the post form, set Campaign. The post inherits the campaign's Lead Agent if it has none. Checking Track Links (on by default) means the platform will receive the message with UTM parameters appended to every URL.
To see what will actually be sent, open Message With Tracked Links on the post. Press Apply Tracked Links to write the tagged text into the post's message field permanently.
Note
UTM parameters are only added once the campaign has been started, because the utm.campaign record (which provides the utm_campaign value) is created at that moment. A post in a Planning campaign keeps its URLs unmodified until the campaign is started.
Attribution: how a post links to a lead#
- Start the campaign. Odoo creates a
utm.campaignrecord. - A post in the campaign is published with its tracked links.
- A visitor clicks the link. The UTM parameters land in their browser.
- When they fill in a form or a lead is created from that click, the lead inherits the UTM campaign.
- CRM → Leads, filter by Campaign, or open the
utm.campaignrecord and check its linked leads and orders.
The utm.campaign record is the bridge. Every Odoo model that inherits utm.mixin (leads, orders, subscription contracts) carries this attribution automatically with no extra setup.
Multi-company#
Each campaign belongs to one company. The Campaigns list shows only the companies the current user is allowed to see.
Tips#
- Set Target Posts and Target Engagement before the campaign starts. The progress bars are much more useful once you have a goal to compare against.
- Assign a Lead Agent to the campaign. New posts added through Actions → View Posts → New will inherit the agent, so you do not have to set it on every post.
- Keep Track Links on unless the post is for a platform (like Telegram) where URLs are displayed as-is and appended parameters would look odd to readers. In that case, turn it off on the individual post.