Page is WIP
The Marketing Operations team works very closely with the Lifecyle Marketing team, and sometimes are tasked with deploying non-demand generation emails. These emails serve many different purposes and are not always operational (definition).
These issue templates are different from marketing emails and have their own checklists that apply. The SLA is 5 business days from final assets to send, but please put in issues as soon as you know you need to complete a send (even if you do not have final deliverables) as complexity may push out the SLA. Here are some helpful tips to consider when sending a customer email. If you require a marketing email, please work with the lifecycle team.
Marketing Ops is not responsible for the list pull. You must open an list request issue issue with the Marketing Strategy and Analytics team, or the appropriate data engineers.
Please follow information found on this page, as these emails are highly important, urgent and follow a different order of operations for deploy.
If there is going to be a release during EMEA work hours, please notify us ahead of time to arrange for coverage. If unplanned and urgent, follow the coverage matrix defined here
Requestor Responsibilities: Fill out the issue template with the following information:
Marketing Ops Responsibilities:
Update tokens as the examples below. Always preview the email for completeness.
| Token Name | Example Value | Note |
|---|---|---|
| {{my.Subject Line}} | Security Release: 16.0.2, 15.11.7, 15.10.8 | |
| {{my.Versions text update}} | These versions contain important security fixes and we strongly recommend that all GitLab installations be upgraded to one of these versions immediately | Token WIP, 1 of 2 versions to include |
| {{my.blog link}} | about.gitlab.com/releases/2023/06/05/security-release-gitlab-16-0-2-released | DO NOT include https:// |
| {{my.release}} | 16.0.2, 15.11.7, 15.10.8 | |
| {{my.utm-content}} | utm_content=June+05+2023 | |
| {{my.utm-medium-source-campaign}} | utm_medium=email&utm_source=marketo&utm_campaign=security+release+email | Do Not Edit - pre-filled |
Sub-processor has its own list people can subscribe to, and legal will start the email process. The form and processing campaigns are in a separate area of marketo than the email sends.
Emails are sent to update a specific group of people about a change to the products or services provided (ex. product updates, support portal changes, EOA). This section should be used for all customer communications to communicate product or security issues and risk.
For more significa in sequence by the head of the department that is leading the communication (e.g., Product, Engineering, Security), Vice President of Customer Success, Legal, or appropriate designates (if they are out on PTO or unavailable).
Communication checklist:
The following is the recommended format for ad hoc customer emails though tailor it if the communication objective or content requires this. This does not include marketing (e.g., email campaigns, blogs, etc.) or standard product or security notifications (e.g., release blogs, release notifications, etc.). Emails should be clear, crisp, and direct, providing links for details (e.g., details on the issue or risk, procedural details to action). To maximize reading comprehension, remove all extraneous words and language to maximize the probability the email will be read and acted upon.
The email should answer the following questions in the following order:
To request an email, follow directions on this page
Two examples are provided:
Subject: Important update information for customers using {GitLab Feature}
Hello {Customer name},
If you use {GitLab Feature}, or plan to migrate to it, this information may be relevant to you.
We recently identified {cases} where {GitLab Feature} can cause a {specific issue} that requires GitLab Support intervention to resolve.
We recommend the following actions to identify and resolve this issue:
- If you use {GitLab Feature}, please review the [scenarios] and avoid them.
- If you have not migrated to {GitLab Feature}, please know that we [provided additional support] to all affected releases.
We're working to reduce the conditions that can cause {specific issue} and will update the [{cases}] when we do so. If you are using {GitLab Feature} and require additional guidance, please contact your support representative or your CSM.
Kind regards,
{Sender}
The requestor (Security, CSM, etc.) will follow the process below to create the epic, which will have quick links to the appropriate issues to open.
### :exclamation: Action items for requestor to complete
*Note: this will automatically be a confidential epic.*
* [ ] Once created, associate this epic to parent epic (if exists)
* [ ] Create issues in section at bottom
* [ ] Ensure all issues are associated to this epic
### :star: Purpose
<!-- Requestor, please describe the purpose of the email communication in this section for context by all teams involved -->
### :link: Key links
* [Copy Document]() `to be added by requestor ` ([use this template](https://docs.google.com/document/d/1hv0XF7j6SibLgHgGFxxlrbPrufxbcXHrO8ZRG04nFjU/edit#))
* [Target List]() `to be added by requestor when final`
* [Email Program]() `to be added by MOps` [template](https://engage-ab.marketo.com/?munchkinId=194-VVC-221#/classic/EBP15318A1)
### :books: Issues for requestor to create (shortcuts below)
* [ ] [Request target list issue (internal link)](https://gitlab.com/gitlab-com/marketing/marketing-strategy-performance/-/issues/new?issuable_template=list-request)
* [ ] [Email request issue](https://gitlab.com/gitlab-com/marketing/marketing-operations/-/issues/new?issuable_template=request-operational-email) - requestor open, MOps DRI
- the email issue is blocked until requestor provides final copy
* [ ] If landing page required: [Landing Page request issue](https://gitlab.com/gitlab-com/marketing/marketing-operations/-/issues/new?issuable_template=marketo_landing_page_request) (optional, will increase scope and delay timeline) - requestor open, MOps DRI
* [ ] If form required: [Form request issue](https://gitlab.com/gitlab-com/marketing/marketing-operations/-/issues/new?issuable_template=form_request)
### :point_up: Reminders on action items & timeline
* Requestor is responsible for providing FINAL copy, including review by all reviewers, by date indicated in timeline
* Requestor is responsible for providing list of who must review and approve email
* Requestor is responsible for approving test email and providing send time and date
/confidential
/label ~"Customer Success" ~"CSM" ~"email-calendar" ~"operational-email"
/cc @amy.waller @bweatherford