Campaigns

What it does and when to use it

A campaign is one email sent to many people: a newsletter, a launch, a sale. You choose who gets it and when; Azimea checks each person’s consent and sends it. Several emails can share one campaign (for example “Black Friday”, with a period and a goal), so they are planned and measured together.

Use a campaign when the moment is yours to choose. When the moment depends on what each person did, use a flow.

How it works

Who it goes to: a segment, or everyone who may receive email. You can leave out another segment, and anyone who got a campaign, flow or cart email in the last days (1 to 90), so nobody gets two in a row.
The people are fixed when it starts. Whoever joins the segment later does not get this email.
Every person passes the sending gate: a marketing campaign reaches subscribers, and existing customers where your checkout tells buyers you may write to them. A service message campaign (a change to your terms, an outage) reaches everyone with a working address; choosing it asks you to confirm it carries no offer.
It goes out now, at a time you set (at least 5 minutes and at most a year ahead), or at each person’s best time: within 24 hours of the start, each person gets it at the hour they usually open; people Azimea knows too little about get it at the start.

Options

Option	What it does
A/B test	Tests the subject, the whole email or the sender name, with one or two other versions. A share of the audience (10 to 50%) gets the versions; after 1 to 24 hours the best one by opens, clicks, orders or revenue goes to everyone else.
Control group	Keeps 5, 10 or 20% of the people out on purpose, the same people for every email of the campaign, so the report shows what the emails really added.
Link tags	Adds Google Analytics tags to the links, so visits from the email show in your analytics. On unless you turn it off.
Approval	A member’s campaign waits for an owner or admin; sending or scheduling it is the approval. Sent back, it returns as a draft with a note.
Pause	Stops a campaign while it is going out; what has already left cannot be recalled. Resume whenever you like.
Resend	After it has gone out, a copy goes as a new draft to the people it reached who did not open it (or did not click), by default three days later.

What each status means and what to do

The campaign

Status or reason	What it means	What you do
`Draft`	Being written: it can still be changed or deleted.	Finish it, then send it or schedule it.
`Sending`	Its emails are being queued now; what already went out cannot be stopped.	Pause it if something is wrong: what is not yet queued waits.
`Sent`	Every email reached the queue; delivery follows on its own.	Read its report; resend to people who did not open, if you want.
`Failed`	The start stopped midway; the reason is written on the campaign.	Read the reason on the campaign; contact support if it is not clear.
`Scheduled`	Waiting for its time. It is locked like a sent campaign.	Cancel the schedule to edit it again: it becomes a draft.

When a person does not get it

The reasons a person in the audience does not get the email:

Status or reason	What it means	What you do
`sending.gate_bounced`	The person's address does not work any more.	Nothing: the address is no longer used.
`sending.gate_complained`	The person marked one of your emails as spam.	Nothing: they are never written to again.
`sending.gate_no_basis`	The person has not subscribed and is not an existing customer, so marketing may not reach them.	Expected for people who only typed their address at checkout. To reach them, ask for consent; or make a message about their own order a service email.
`sending.gate_not_declared`	You have not yet declared how your shop collects consent, so no marketing goes out, even to subscribers.	Settings › Consent: choose your method and declare it.
`sending.gate_soft_opt_in_off`	The person is an existing customer, but your shop uses a consent checkbox, not a notice at checkout, so buying alone does not allow marketing.	Expected with a checkbox: only those who ticked it receive marketing. Switch to notice at checkout only if your checkout really shows that notice.
`sending.gate_topic_opted_out`	The person turned off the topic this email belongs to; they still receive your other topics.	Nothing: respect their choice.
`sending.gate_unsubscribed`	The person unsubscribed from your marketing emails.	Nothing: they said no. Service emails still reach them.

After it leaves, each email moves through the email statuses: Queued, Sent, Delivered or Bounced.

Events involved

A campaign is not started by an event. Its results (opens, clicks, orders and revenue) are in the campaign’s report and in Reports.

Set it up in the dashboard

Campaigns › New campaign: write the email or start from a template.
Choose who gets it, and what to leave out.
Choose What it is for: Marketing, or Service message for an email that only informs.
Optional: an A/B test, a control group, link tags.
Send the campaign now, or Schedule it; turn on Send at each person’s best time if you want. A member presses Ask for approval instead.

Do it from your code

Campaigns are started from the dashboard. Your product can keep the audience current through the contacts API, and send one-to-one emails through POST /sending/emails. See What you can build today.

Troubleshooting

Symptom	Likely cause	Fix
Far fewer recipients than contacts	Many contacts have no basis for marketing (they only typed their address at checkout, or bought in a shop that uses a checkbox).	Expected; grow consent with a sign-up form or the checkout box.
No one received it, every email `Suppressed` with `gate_not_declared`	Consent is not declared.	Settings › Consent: choose your method and declare it.
The A/B test has no winner yet	The wait you chose has not passed.	Wait; the rest of the audience gets the winner when it is chosen.
Someone who joined the segment today did not get it	People are fixed when the campaign starts.	Send them a resend or add them to a flow.