Marketing email promotions #14051

dblatcher · 2025-06-06T16:03:49Z

What does this change?

Add a new block element "MarketingEmailSignupBlockElement" that can be added to an article as part of the enhancement function to include a promotion for a marketing email.
creates a component MarketingEmailSignUpWrapper to represent the element - mostly using the same sub-components at the existing EmailSignUpWrapper - but rendering a link to the mma /email-prefs page instead of a sign-up form.
adds an "emailType" prop to the sign-up subcomponents to allow for the variations in behaviour and presentation between MarketingEmailSignUpWrapper and EmailSignUpWrapper
extends the enhanceNewsletterSignup function to check for tags corresponding to marketing emails and insert a "MarketingEmailSignupBlockElement"
defines a list of MarketingConsentEmail representing those hard-coded into the identity repo

This PR would currently have no user-facing effects as non of the defined MarketingConsentEmail have the "promotionTagId" property.

Why?

There's a long-standing request from the Guardian jobs team in-article promotions for the Guardian Job marketing email, that would work in substantially the same way as the existing sign-up blocks for editorial newsletters ie:

The promotion is added to an article using a tag (in the case of editorial newsletters, tags with an id starting "campaign/email" are used)
If the article is supposed to promote the email, a sign-up block is placed in the article body

This PR provides a mechanism to allowing that - when a tag is created to promote a marketing email, its Id can be added to the object describing the email in DCR.

Future work

get design, compliance, marketing input on the new element - it is currently modelled on the editorial newsletter block, but there may be a desire for something more distinct
PR in frontend to support the new form of sign-up request to the API
add the tag ids to the list of MarketingConsentEmails when a pattern/convention is agreed (these are likely to be campaign tags of some sort rather than existing keyword or sectioning tags)

Screenshots

Before	After

…ent function, if article has a magic tag

… version of the email signup wrapper

…nto dblatcher-jobs-email-promotion

github-actions · 2025-06-06T16:08:59Z

Size Change: +144 B (+0.01%)

Total Size: 1.04 MB

ℹ️ View Unchanged

Filename	Size	Change
`dotcom-rendering/dist/1160.client.web.********************.js`	3.56 kB	0 B
`dotcom-rendering/dist/137.client.web.********************.js`	3.8 kB	0 B
`dotcom-rendering/dist/1521.client.web.********************.js`	2.87 kB	0 B
`dotcom-rendering/dist/1931.client.web.********************.js`	2.83 kB	0 B
`dotcom-rendering/dist/2003.client.web.********************.js`	2.62 kB	0 B
`dotcom-rendering/dist/21.client.web.********************.js`	3.77 kB	0 B
`dotcom-rendering/dist/2102.client.web.********************.js`	10.7 kB	+69 B (+0.65%)
`dotcom-rendering/dist/2244.client.web.********************.js`	3.56 kB	0 B
`dotcom-rendering/dist/233.client.web.********************.js`	3.18 kB	0 B
`dotcom-rendering/dist/2373.client.web.********************.js`	4.44 kB	0 B
`dotcom-rendering/dist/2400.client.web.********************.js`	2.11 kB	0 B
`dotcom-rendering/dist/2523.client.web.********************.js`	3.9 kB	0 B
`dotcom-rendering/dist/2620.client.web.********************.js`	2.54 kB	0 B
`dotcom-rendering/dist/2629.client.web.********************.js`	5.82 kB	0 B
`dotcom-rendering/dist/2909.client.web.********************.js`	18.1 kB	0 B
`dotcom-rendering/dist/3342.client.web.********************.js`	3.67 kB	0 B
`dotcom-rendering/dist/3944.client.web.********************.js`	2.51 kB	0 B
`dotcom-rendering/dist/3979.client.web.********************.js`	4.18 kB	0 B
`dotcom-rendering/dist/4079.client.web.********************.js`	11.8 kB	0 B
`dotcom-rendering/dist/420.client.web.********************.js`	4.35 kB	0 B
`dotcom-rendering/dist/4312.client.web.********************.js`	3.07 kB	0 B
`dotcom-rendering/dist/4324.client.web.********************.js`	5.77 kB	0 B
`dotcom-rendering/dist/4501.client.web.********************.js`	4.29 kB	0 B
`dotcom-rendering/dist/4524.client.web.********************.js`	3.62 kB	0 B
`dotcom-rendering/dist/4754.client.web.********************.js`	7.66 kB	0 B
`dotcom-rendering/dist/5117.client.web.********************.js`	49.9 kB	0 B
`dotcom-rendering/dist/5128.client.web.********************.js`	19.7 kB	0 B
`dotcom-rendering/dist/5462.client.web.********************.js`	157 B	0 B
`dotcom-rendering/dist/5525.client.web.********************.js`	20.5 kB	0 B
`dotcom-rendering/dist/5549.client.web.********************.js`	3.9 kB	0 B
`dotcom-rendering/dist/5837.client.web.********************.js`	2.68 kB	0 B
`dotcom-rendering/dist/5895.client.web.********************.js`	22.8 kB	0 B
`dotcom-rendering/dist/5901.client.web.********************.js`	4.13 kB	0 B
`dotcom-rendering/dist/5980.client.web.********************.js`	5.43 kB	0 B
`dotcom-rendering/dist/6085.client.web.********************.js`	530 B	0 B
`dotcom-rendering/dist/6232.client.web.********************.js`	620 B	0 B
`dotcom-rendering/dist/6255.client.web.********************.js`	11.9 kB	0 B
`dotcom-rendering/dist/6316.client.web.********************.js`	5.04 kB	0 B
`dotcom-rendering/dist/6317.client.web.********************.js`	4.09 kB	0 B
`dotcom-rendering/dist/6369.client.web.********************.js`	4.78 kB	0 B
`dotcom-rendering/dist/6501.client.web.********************.js`	65.6 kB	0 B
`dotcom-rendering/dist/6504.client.web.********************.js`	3.29 kB	0 B
`dotcom-rendering/dist/6683.client.web.********************.js`	2.87 kB	0 B
`dotcom-rendering/dist/6694.client.web.********************.js`	2.77 kB	0 B
`dotcom-rendering/dist/6721.client.web.********************.js`	3.2 kB	0 B
`dotcom-rendering/dist/6843.client.web.********************.js`	3.67 kB	0 B
`dotcom-rendering/dist/7008.client.web.********************.js`	4.67 kB	0 B
`dotcom-rendering/dist/7028.client.web.********************.js`	3.17 kB	0 B
`dotcom-rendering/dist/7116.client.web.********************.js`	23.2 kB	0 B
`dotcom-rendering/dist/728.client.web.********************.js`	3.6 kB	0 B
`dotcom-rendering/dist/739.client.web.********************.js`	528 B	0 B
`dotcom-rendering/dist/7540.client.web.********************.js`	2.86 kB	0 B
`dotcom-rendering/dist/7678.client.web.********************.js`	3.78 kB	0 B
`dotcom-rendering/dist/7819.client.web.********************.js`	3.87 kB	0 B
`dotcom-rendering/dist/7829.client.web.********************.js`	3.27 kB	0 B
`dotcom-rendering/dist/7979.client.web.********************.js`	2.75 kB	0 B
`dotcom-rendering/dist/7986.client.web.********************.js`	3.04 kB	0 B
`dotcom-rendering/dist/8110.client.web.********************.js`	3.49 kB	0 B
`dotcom-rendering/dist/8143.client.web.********************.js`	16.5 kB	0 B
`dotcom-rendering/dist/8361.client.web.********************.js`	3.45 kB	0 B
`dotcom-rendering/dist/8389.client.web.********************.js`	2.63 kB	0 B
`dotcom-rendering/dist/8393.client.web.********************.js`	3.27 kB	0 B
`dotcom-rendering/dist/8406.client.web.********************.js`	438 B	0 B
`dotcom-rendering/dist/8569.client.web.********************.js`	5.04 kB	0 B
`dotcom-rendering/dist/8742.client.web.********************.js`	4.86 kB	0 B
`dotcom-rendering/dist/8938.client.web.********************.js`	4.5 kB	0 B
`dotcom-rendering/dist/9051.client.web.********************.js`	3.4 kB	0 B
`dotcom-rendering/dist/9226.client.web.********************.js`	7.93 kB	0 B
`dotcom-rendering/dist/939.client.web.********************.js`	4.46 kB	0 B
`dotcom-rendering/dist/9465.client.web.********************.js`	5.64 kB	0 B
`dotcom-rendering/dist/9599.client.web.********************.js`	3.85 kB	0 B
`dotcom-rendering/dist/9999.client.web.********************.js`	5.39 kB	0 B
`dotcom-rendering/dist/Accessibility-importable.client.web.********************.js`	8.43 kB	0 B
`dotcom-rendering/dist/AdBlockAsk-importable.client.web.********************.js`	2.99 kB	0 B
`dotcom-rendering/dist/AdPortals-importable.client.web.********************.js`	4.78 kB	0 B
`dotcom-rendering/dist/AlreadyVisited-importable.client.web.********************.js`	424 B	0 B
`dotcom-rendering/dist/AppsEpic-importable.client.web.********************.js`	3.64 kB	0 B
`dotcom-rendering/dist/AppsFooter-importable.client.web.********************.js`	2.71 kB	0 B
`dotcom-rendering/dist/AppsLightboxImage-importable.client.web.********************.js`	2.69 kB	0 B
`dotcom-rendering/dist/AppsLightboxImageStore-importable.client.web.********************.js`	2.63 kB	0 B
`dotcom-rendering/dist/AudioAtomWrapper-importable.client.web.********************.js`	2.76 kB	0 B
`dotcom-rendering/dist/AudioPlayerWrapper-importable.client.web.********************.js`	6.61 kB	0 B
`dotcom-rendering/dist/AustralianTerritorySwitcher-importable.client.web.********************.js`	4.6 kB	0 B
`dotcom-rendering/dist/Branding-importable.client.web.********************.js`	2.87 kB	0 B
`dotcom-rendering/dist/braze-web-sdk-core.client.web.********************.js`	67.7 kB	0 B
`dotcom-rendering/dist/BrazeMessaging-importable.client.web.********************.js`	1.68 kB	0 B
`dotcom-rendering/dist/CalloutBlockComponent-importable.client.web.********************.js`	6.73 kB	0 B
`dotcom-rendering/dist/CalloutEmbedBlockComponent-importable.client.web.********************.js`	5.77 kB	0 B
`dotcom-rendering/dist/CardCommentCount-importable.client.web.********************.js`	2.67 kB	0 B
`dotcom-rendering/dist/Carousel-importable.client.web.********************.js`	6.67 kB	0 B
`dotcom-rendering/dist/CarouselForNewsletters-importable.client.web.********************.js`	4.57 kB	0 B
`dotcom-rendering/dist/ChartAtom-importable.client.web.********************.js`	540 B	0 B
`dotcom-rendering/dist/CommentCount-importable.client.web.********************.js`	2.28 kB	0 B
`dotcom-rendering/dist/CrosswordComponent-importable.client.web.********************.js`	2.87 kB	0 B
`dotcom-rendering/dist/DiscussionApps-importable.client.web.********************.js`	1.99 kB	0 B
`dotcom-rendering/dist/DiscussionMeta-importable.client.web.********************.js`	2.39 kB	0 B
`dotcom-rendering/dist/DiscussionWeb-importable.client.web.********************.js`	1.69 kB	0 B
`dotcom-rendering/dist/DocumentBlockComponent-importable.client.web.********************.js`	2.85 kB	0 B
`dotcom-rendering/dist/Dropdown-importable.client.web.********************.js`	1.72 kB	0 B
`dotcom-rendering/dist/EditionSwitcherBanner-importable.client.web.********************.js`	4.42 kB	0 B
`dotcom-rendering/dist/EmbedBlockComponent-importable.client.web.********************.js`	3.97 kB	0 B
`dotcom-rendering/dist/EnhancePinnedPost-importable.client.web.********************.js`	2.02 kB	0 B
`dotcom-rendering/dist/FetchOnwardsData-importable.client.web.********************.js`	1.67 kB	0 B
`dotcom-rendering/dist/FilterKeyEventsToggle-importable.client.web.********************.js`	3.71 kB	0 B
`dotcom-rendering/dist/FocusStyles-importable.client.web.********************.js`	619 B	0 B
`dotcom-rendering/dist/FollowWrapper-importable.client.web.********************.js`	2.51 kB	0 B
`dotcom-rendering/dist/FootballMatchesPageWrapper-importable.client.web.********************.js`	7.33 kB	0 B
`dotcom-rendering/dist/FootballTablesCompetitionSelect-importable.client.web.********************.js`	3.27 kB	0 B
`dotcom-rendering/dist/FooterLabel-importable.client.web.********************.js`	364 B	0 B
`dotcom-rendering/dist/FooterReaderRevenueLinks-importable.client.web.********************.js`	3.41 kB	0 B
`dotcom-rendering/dist/frameworks.client.web.********************.js`	20.9 kB	0 B
`dotcom-rendering/dist/FrontSubNav-importable.client.web.********************.js`	7.47 kB	0 B
`dotcom-rendering/dist/GetCricketScoreboard-importable.client.web.********************.js`	6.24 kB	0 B
`dotcom-rendering/dist/GetMatchNav-importable.client.web.********************.js`	12 kB	0 B
`dotcom-rendering/dist/GetMatchStats-importable.client.web.********************.js`	8.06 kB	0 B
`dotcom-rendering/dist/GetMatchTabs-importable.client.web.********************.js`	2.57 kB	0 B
`dotcom-rendering/dist/guardian-braze-components-banner.client.web.********************.js`	15.8 kB	0 B
`dotcom-rendering/dist/guardian-braze-components-end-of-article.client.web.********************.js`	10.2 kB	0 B
`dotcom-rendering/dist/GuideAtomWrapper-importable.client.web.********************.js`	779 B	0 B
`dotcom-rendering/dist/index.client.web.********************.js`	46.5 kB	+3 B (+0.01%)
`dotcom-rendering/dist/InstagramBlockComponent-importable.client.web.********************.js`	2.9 kB	0 B
`dotcom-rendering/dist/InteractiveAtomMessenger-importable.client.web.********************.js`	851 B	0 B
`dotcom-rendering/dist/InteractiveBlockComponent-importable.client.web.********************.js`	8.79 kB	0 B
`dotcom-rendering/dist/InteractiveContentsBlockComponent-importable.client.web.********************.js`	3.79 kB	0 B
`dotcom-rendering/dist/InteractivesNativePlatformWrapper-importable.client.web.********************.js`	3.18 kB	0 B
`dotcom-rendering/dist/KeyEventsCarousel-importable.client.web.********************.js`	5.72 kB	0 B
`dotcom-rendering/dist/KnowledgeQuizAtom-importable.client.web.********************.js`	3.23 kB	0 B
`dotcom-rendering/dist/LatestLinks-importable.client.web.********************.js`	7.8 kB	0 B
`dotcom-rendering/dist/LightboxHash-importable.client.web.********************.js`	435 B	0 B
`dotcom-rendering/dist/LightboxLayout-importable.client.web.********************.js`	6.58 kB	0 B
`dotcom-rendering/dist/LiveBlogEpic-importable.client.web.********************.js`	3.59 kB	0 B
`dotcom-rendering/dist/LiveblogGutterAskWrapper-importable.client.web.********************.js`	2.51 kB	0 B
`dotcom-rendering/dist/LiveblogNotifications-importable.client.web.********************.js`	4.87 kB	0 B
`dotcom-rendering/dist/Liveness-importable.client.web.********************.js`	4.71 kB	0 B
`dotcom-rendering/dist/LoopVideo-importable.client.web.********************.js`	3.74 kB	0 B
`dotcom-rendering/dist/ManyNewsletterSignUp-importable.client.web.********************.js`	7.71 kB	+72 B (+0.94%)
`dotcom-rendering/dist/MapEmbedBlockComponent-importable.client.web.********************.js`	6.03 kB	0 B
`dotcom-rendering/dist/Metrics-importable.client.web.********************.js`	2.7 kB	0 B
`dotcom-rendering/dist/MostViewedFooter-importable.client.web.********************.js`	3.85 kB	0 B
`dotcom-rendering/dist/MostViewedFooterData-importable.client.web.********************.js`	5.95 kB	0 B
`dotcom-rendering/dist/MostViewedRightWithAd-importable.client.web.********************.js`	5.24 kB	0 B
`dotcom-rendering/dist/OnwardsUpper-importable.client.web.********************.js`	5.06 kB	0 B
`dotcom-rendering/dist/PersonalityQuizAtom-importable.client.web.********************.js`	3.36 kB	0 B
`dotcom-rendering/dist/ProfileAtom-importable.client.web.********************.js`	540 B	0 B
`dotcom-rendering/dist/ProfileAtomWrapper-importable.client.web.********************.js`	801 B	0 B
`dotcom-rendering/dist/PulsingDot-importable.client.web.********************.js`	752 B	0 B
`dotcom-rendering/dist/QandaAtom-importable.client.web.********************.js`	538 B	0 B
`dotcom-rendering/dist/ReaderRevenueDev-importable.client.web.********************.js`	470 B	0 B
`dotcom-rendering/dist/readerRevenueDevUtils.client.web.********************.js`	1.7 kB	0 B
`dotcom-rendering/dist/RelativeTime-importable.client.web.********************.js`	2.54 kB	0 B
`dotcom-rendering/dist/RichLinkComponent-importable.client.web.********************.js`	6.14 kB	0 B
`dotcom-rendering/dist/ScrollableFeature-importable.client.web.********************.js`	6.74 kB	0 B
`dotcom-rendering/dist/ScrollableHighlights-importable.client.web.********************.js`	7.2 kB	0 B
`dotcom-rendering/dist/ScrollableMedium-importable.client.web.********************.js`	2.08 kB	0 B
`dotcom-rendering/dist/ScrollableSmall-importable.client.web.********************.js`	2.15 kB	0 B
`dotcom-rendering/dist/SecureSignup-importable.client.web.********************.js`	4.22 kB	0 B
`dotcom-rendering/dist/SendTargetingParams-importable.client.web.********************.js`	2.24 kB	0 B
`dotcom-rendering/dist/sentry.client.web.********************.js`	803 B	0 B
`dotcom-rendering/dist/SetABTests-importable.client.web.********************.js`	3.93 kB	0 B
`dotcom-rendering/dist/SetAdTargeting-importable.client.web.********************.js`	485 B	0 B
`dotcom-rendering/dist/ShareButton-importable.client.web.********************.js`	2.17 kB	0 B
`dotcom-rendering/dist/shimport.client.web.********************.js`	2.8 kB	0 B
`dotcom-rendering/dist/ShowHideContainers-importable.client.web.********************.js`	877 B	0 B
`dotcom-rendering/dist/ShowMore-importable.client.web.********************.js`	918 B	0 B
`dotcom-rendering/dist/SignInGateMain.client.web.********************.js`	1.11 kB	0 B
`dotcom-rendering/dist/SignInGateMainCheckoutComplete.client.web.********************.js`	2.6 kB	0 B
`dotcom-rendering/dist/SignInGateSelector-importable.client.web.********************.js`	5.01 kB	0 B
`dotcom-rendering/dist/SlideshowCarousel-importable.client.web.********************.js`	4.52 kB	0 B
`dotcom-rendering/dist/SlotBodyEnd-importable.client.web.********************.js`	4.91 kB	0 B
`dotcom-rendering/dist/SpotifyBlockComponent-importable.client.web.********************.js`	5.78 kB	0 B
`dotcom-rendering/dist/StickyBottomBanner-importable.client.web.********************.js`	6.13 kB	0 B
`dotcom-rendering/dist/SubNav-importable.client.web.********************.js`	2.42 kB	0 B
`dotcom-rendering/dist/TableOfContents-importable.client.web.********************.js`	3.66 kB	0 B
`dotcom-rendering/dist/TimelineAtom-importable.client.web.********************.js`	1.23 kB	0 B
`dotcom-rendering/dist/Titlepiece-importable.client.web.********************.js`	13.6 kB	0 B
`dotcom-rendering/dist/TopBar-importable.client.web.********************.js`	8.82 kB	0 B
`dotcom-rendering/dist/TopBarSupport-importable.client.web.********************.js`	2.5 kB	0 B
`dotcom-rendering/dist/TweetBlockComponent-importable.client.web.********************.js`	1.13 kB	0 B
`dotcom-rendering/dist/UnsafeEmbedBlockComponent-importable.client.web.********************.js`	2.91 kB	0 B
`dotcom-rendering/dist/VideoFacebookBlockComponent-importable.client.web.********************.js`	6.05 kB	0 B
`dotcom-rendering/dist/VineBlockComponent-importable.client.web.********************.js`	3.33 kB	0 B
`dotcom-rendering/dist/YoutubeBlockComponent-importable.client.web.********************.js`	843 B	0 B

_{compressed-size-action}

…form

…nto dblatcher-jobs-email-promotion

github-actions · 2025-06-09T13:56:54Z

Deploy build 43195 of `Mobile::mobile-apps-rendering` to CODE

All deployment options

From guardian/actions-riff-raff.

dblatcher added 7 commits June 6, 2025 10:20

insert a placeholder consent email element using the newletter placem…

731d865

…ent function, if article has a magic tag

sign up block elements take a emailType prop. Can render a marketting…

a99f88e

… version of the email signup wrapper

add stories

d111b3c

move the list of marketing emails and find by tags function

a010f2e

Merge branch 'main' of https://github.com/guardian/dotcom-rendering i…

150bc90

…nto dblatcher-jobs-email-promotion

update schemas and tests

73a3e61

lint

91df232

dblatcher added the run_chromatic Runs chromatic when label is applied label Jun 6, 2025

github-actions bot added dotcom-rendering and removed run_chromatic Runs chromatic when label is applied labels Jun 6, 2025

dblatcher added 3 commits June 9, 2025 14:31

marking email wrapper uses a link button to mma instead of a sign-up …

8769353

…form

Merge branch 'main' of https://github.com/guardian/dotcom-rendering i…

03e12c4

…nto dblatcher-jobs-email-promotion

provide mma url

5029156

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

Marketing email promotions #14051

Marketing email promotions #14051

Uh oh!

dblatcher commented Jun 6, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Jun 6, 2025 •

edited

Loading

Uh oh!

github-actions bot commented Jun 9, 2025

Uh oh!

Uh oh!

Marketing email promotions #14051

Are you sure you want to change the base?

Marketing email promotions #14051

Uh oh!

Conversation

dblatcher commented Jun 6, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

What does this change?

Why?

Future work

Screenshots

Uh oh!

github-actions bot commented Jun 6, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

github-actions bot commented Jun 9, 2025

Deploy build 43195 of Mobile::mobile-apps-rendering to CODE

Uh oh!

Uh oh!

dblatcher commented Jun 6, 2025 •

edited

Loading

github-actions bot commented Jun 6, 2025 •

edited

Loading

Deploy build 43195 of `Mobile::mobile-apps-rendering` to CODE