Email Marketing

Kampanjer

MarknadsplatsInnehåll och dokumentVersion 0.1.0manifest

Vad den är till för ​

Keep mailing lists with each contact's consent status and date, and prepare campaigns. Sending reaches real people and cannot be undone, so it always needs a human approval.

Vad paketet gör och inte gör ​

Mailing lists, the contacts on them with their consent status and date, and campaigns with a draft, scheduled, sent flow. Sending is irreversible and reaches real people, so it needs a human approval from a manager; agents may only propose it. Campaign statistics are numbers entered or imported, not computed. Contacts are personal data: keep consent_status and consent_date accurate and never mail a contact that is not opted_in.

Modeller ​

email_marketing_list ​

A mailing list contacts can belong to

Läsgrupp: email_marketing.user. Skrivgrupp: email_marketing.manager.

FältTypDataklassPersonuppgiftGruppAgenter serBeskrivning
nametextnonenejemail_marketing.useri klartextList name, for example Newsletter
descriptionlongtextnonenejemail_marketing.useri klartextWhat subscribers receive
is_publicboolnonenejemail_marketing.useri klartextWhether visitors can subscribe themselves

email_marketing_contact ​

A person on a mailing list

Läsgrupp: email_marketing.user. Skrivgrupp: email_marketing.user.

FältTypDataklassPersonuppgiftGruppAgenter serBeskrivning
list_idref → email_marketing_listnonenejemail_marketing.useri klartextThe list the contact is on
emailtextinternaljaemail_marketing.usermaskeradEmail address
nametextinternaljaemail_marketing.usermaskeradName of the contact
consent_statusselect (pending, opted_in, opted_out, bounced)internaljaemail_marketing.usermaskeradPermission to mail: pending, opted_in, opted_out, bounced
consent_datedateinternaljaemail_marketing.usermaskeradDay the contact gave or withdrew permission (YYYY-MM-DD)
consent_sourcetextinternaljaemail_marketing.usermaskeradWhere consent was collected, for example website signup form

email_marketing_campaign ​

One mailing sent to a list

Läsgrupp: email_marketing.user. Skrivgrupp: email_marketing.user.

FältTypDataklassPersonuppgiftGruppAgenter serBeskrivning
nametextnonenejemail_marketing.useri klartextInternal campaign name
subjecttextnonenejemail_marketing.useri klartextEmail subject line
preview_texttextnonenejemail_marketing.useri klartextShort text shown after the subject in inboxes
from_nametextnonenejemail_marketing.useri klartextSender name shown to recipients
from_emailtextnonenejemail_marketing.useri klartextSender address shown to recipients
list_idref → email_marketing_listnonenejemail_marketing.useri klartextThe list the campaign goes to
bodylongtextnonenejemail_marketing.useri klartextEmail content (HTML or Markdown, as the sender expects)
scheduled_fordatenonenejemail_marketing.useri klartextDay the campaign is to be sent (YYYY-MM-DD)
sent_ondatenonenejemail_marketing.useri klartextDay the campaign was sent (YYYY-MM-DD)
sent_countnumbernonenejemail_marketing.useri klartextEmails handed to the mail server
delivered_countnumbernonenejemail_marketing.useri klartextEmails accepted by recipients' servers
opened_countnumbernonenejemail_marketing.useri klartextRecipients who opened the email
clicked_countnumbernonenejemail_marketing.useri klartextRecipients who clicked a link
bounced_countnumbernonenejemail_marketing.useri klartextEmails that bounced
unsubscribed_countnumbernonenejemail_marketing.useri klartextRecipients who unsubscribed because of this campaign
stateselect (draft, scheduled, sent, cancelled)nonenejemail_marketing.useri klartextCampaign status: draft, scheduled, sent, cancelled

Arbetsflöden ​

email_marketing_campaign ​

ÅtgärdFlyttarVem får köra denGodkännande
email_marketing_campaign.schedulestate: draft → scheduledemail_marketing.usernej
email_marketing_campaign.sendstate: scheduled → sentemail_marketing.managerja
email_marketing_campaign.send_nowstate: draft → sentemail_marketing.managerja
email_marketing_campaign.unschedulestate: scheduled → draftemail_marketing.usernej
email_marketing_campaign.cancelstate: scheduled → cancelledemail_marketing.usernej

Behörighetsgrupper ​

Grupper som den här appen använder:

  • email_marketing.manager
  • email_marketing.user

Steg som kräver godkännande ​

Steg som en agent bara kan föreslå:

  • email_marketing_campaign.send
  • email_marketing_campaign.send_now

Vad agenter kan och inte kan göra ​

En agent kan läsa, söka, skapa och uppdatera poster i den här appen, och köra de åtgärder som inte kräver godkännande, inom behörighetsgrupperna för sin token.

Den kan bara föreslå de här stegen, och en person måste godkänna dem: email_marketing_campaign.send, email_marketing_campaign.send_now, email_marketing_list.delete, email_marketing_contact.delete, email_marketing_campaign.delete.

Personuppgifter maskeras som platshållare: email_marketing_contact.email, email_marketing_contact.name, email_marketing_contact.consent_status, email_marketing_contact.consent_date, email_marketing_contact.consent_source.

Beroenden ​

Inga.

Installera ​

Installera den från appen Customize (Marknadsplats), eller från kommandoraden:

bash
obop modules install-from email_marketing

Kräver en databas och administratörsbehörighet.

Bygg din egen ​

Modulguiden visar hur appar som den här skrivs