Mozilla Account Email Metrics
Table of Contents
Introduction
Users must provide an email address when they sign up for a Mozilla Account. Emails are sent to users to confirm authentication, alert them to new sign-ins, and to complete password resets. Users can also opt-in to marketing emails, however metrics for those are not covered in this article.
Events that we track relating to email:
- When the email is sent.
- If the email bounces.
- If the email contains a verification/confirmation link, whether the user clicked on it.
Metrics relating to emails also contain the following properties:
- The email service of the recipient
- The
email_template- the template of the email that was sent (we currently only track this for sending events, not click events). This is more specific than the email_type, which is broader grouping of many email templates into related categories, see chart below.
Email Templates and Email Types
Only emails sent by the FxA auth server are represented in the tables below. TBD on marketing emails.
Mozilla Accounts
email_template | email_type | Description & Notes |
|---|---|---|
postAddTwoStepAuthenticationEmail | 2fa | Sent to users after they successfully add 2 factor authentication to their account (TOTP) |
postRemoveTwoStepAuthenticationEmail | 2fa | Sent to users after they successfully REMOVE 2 factor authentication from their account (TOTP) |
postConsumeRecoveryCodeEmail | 2fa | Sent to users after they successfully use a recovery code to login to their account after not being able to use their second factor. |
postNewRecoveryCodesEmail | 2fa | Sent to users after they successfully generate a new set of 2FA recovery codes (replacing their old ones, if they existed). |
lowRecoveryCodesEmail | 2fa | Send when a user has 2 or fewer recovery codes remaining. |
passwordResetAccountRecoveryEmail | account_recovery | After a user resets their password using a recovery key, they receive this email telling them to generate a new recovery key. |
postAddAccountRecoveryEmail | account_recovery | Sent to users after they successfully add account recovery capabilities to their account (i.e. after generating recovery codes). |
postRemoveAccountRecoveryEmail | account_recovery | Sent to users after they successfully REMOVE account recovery capabilities from their account. |
postChangePrimaryEmail | change_email | Sent to users after they successfully change their primary email address (is sent to their new email). |
passwordChangedEmail | change_password | Sent to users after they change their password via FxA settings (NOT during password reset; they must be logged in to do this). |
passwordChangeRequiredEmail | change_password | Sent when an account's devices are disconnected and a password change is required due to suspicious activity. |
cadReminderFirstEmail | connect_another_device | Sent 8 hours after a user clicks "send me a reminder" on the connect another device page. |
cadReminderSecondEmail | connect_another_device | Sent 72 hours after a user clicks "send me a reminder" on the connect another device page. |
newDeviceLoginEmail | login | Sent to existing accounts after they have logged into a device that FxA has not previously recognized. |
verifyLoginCodeEmail | login | Sent to existing accounts when they try to login to sync, containing a code (rather than a link) the user must enter into the login form. Note that currently the use of confirmation codes is limited to some login contexts only - they are never used for registration. |
verifyLoginEmail | login | Sent to existing accounts when they try to login to sync. User must click the verification link before the logged-in device can begin syncing. |
postAddLinkedAccountEmail | login | Sent after a Firefox account is linked to a 3rd party account (e.g. an Apple account) |
postVerifyEmail | registration | Sent after users confirm their email. Contains instructions for how to connect another device to sync. |
verifyEmail | registration | Sent to users setting up a new NON-sync account. Contains a verification link (user must click it for their account to become functional). |
verificationReminderFirstEmail | registration | If a users does not verify their account within 24 hours, they receive this email with an additional verification link. |
verificationReminderSecondEmail | registration | If a users does not verify their account within 5 days, they receive this email with an additional verification link. |
verifyShortCodeEmail | registration | Sent to users to verify their account via code after signing up. |
passwordResetEmail | reset_password | Sent to users after they reset their password (without using a recovery key). |
recoveryEmail | reset_password | After a user opts to reset their password (during login, because they clicked "forgot password"), they receive this email with a link to reset their password (without using a recovery key). |
postVerifySecondaryEmail | secondary_email | Sent to users after they successfully verified a secondary email address (sent to the secondary email address). |
postRemoveSecondaryEmail | secondary_email | Sent to users after they successfully remove a secondary email address (sent to the secondary email address). |
verifySecondaryCodeEmail | secondary_email | Sent to verify the addition of a secondary email via code. |
unblockCodeEmail | unblock | Sent to verify or unblock an account via code that has reached the login attempt rate limit. |
verifyPrimaryEmail | verify | Sent to users with an unverified primary email, meaning an unverified account, when they attempt an action requiring a verified account. |
Subscription Platform
The email_type is still being determined for Subscription Platform emails.
email_template | email_type | Description & Notes |
|---|---|---|
downloadSubscription | Sent to users after they successfully add a subscription | |
subscriptionAccountDeletion | Sent when a user with an active subscription deletes their Firefox account | |
subscriptionAccountFinishSetup | Sent to a user after they purchased the product through the password-less flow without an existing Firefox account | |
subscriptionAccountReminderFirst | Sent to a user to remind them to finish setting up a Firefox account after they signed up through the password-less flow without an existing account | |
subscriptionAccountReminderSecond | Sent as a final reminder to a user to remind them to finish setting up a Firefox account as they signed up through the password-less flow without an existing account | |
subscriptionCancellation | Sent when a user cancels their subscription | |
subscriptionDowngrade | Sent when a user downgrades their subscription | |
subscriptionFailedPaymentsCancellation | Sent when failed payments result in cancellation of user subscription | |
subscriptionFirstInvoice | Sent to inform a user that their first payment is currently being processed | |
subscriptionFirstInvoiceDiscount | Sent to inform a user that their first payment, with a discount coupon, is currently being processed | |
subscriptionPaymentExpired | Sent whenever a user has a single subscription and their card will expire at the end of the month, triggered by a Stripe webhook | |
subscriptionPaymentFailed | Sent when there is a problem with the latest payment | |
subscriptionPaymentProviderCancelled | Sent when a problem is detected with the payment method | |
subscriptionReactivation | Sent when a user reactivates their subscription | |
subscriptionRenewalReminder | Sent to remind a user of an upcoming automatic subscription renewal X days out from charge (X being what is set in the Stripe dashboard) | |
subscriptionSubsequentInvoice | Sent when the latest subscription payment is received | |
subscriptionSubsequentInvoiceDiscount | Sent when the latest subscription payment is received (coupon) | |
subscriptionUpgrade | Sent when a user upgrades their subscription | |
subscriptionsPaymentExpired | Sent whenever a user has multiple subscriptions and their card will expire at the end of the month | |
subscriptionsPaymentProviderCancelled | Sent when a user has multiple subscriptions and a problem has been detected with payment method |