For Marketing Cloud marketers. Add the Jacquard code snippet and variables to emails and push messages.
Placeholders: example values (for example names in code) and values in angle brackets are account-specific. Your Jacquard contact provides them.
Existing customers: don’t change existing messages. Use this guide for new touchpoints only.
Message setup
For the team that builds Marketing Cloud emails and push messages.
1. Jacquard | Before you start
1.1 Prerequisites
Technical setup complete, including the snippet for this touchpoint.
Touchpoint created (or imported) and content approved in Jacquard.
1.2 Get the details
From the touchpoint’s Connect tab: snippet key and variable names.
2. Marketing Cloud | Emails
2.1 Add the snippet
In a code block at the top of the email body:
%%=ContentBlockByKey("snippet-key")=%%2.2 Replace copy with variables
In each Jacquard-controlled part, for example:
%%=v(@jq_subject_line)=%%Use the exact names from the Connect tab.
Every selected part needs its variable. Deselect parts you don’t want Jacquard to control.
2.3 Subject line and preheader
Add the variables to these fields. The snippet must be at the top of the body for them to resolve.
2.4 Personalisation
If Jacquard content uses attributes such as first name, they must exist in your sendable data extension.
2.5 Save
Save in Content Builder.
3. Marketing Cloud | Push messages
Skip if Jacquard only optimises email.
3.1 Add the snippet
At the start of the MobilePush message field:
%%=ContentBlockByKey("snippet-key")=%%3.2 Replace copy with variables
For example %%=v(@jq_push_title)=%%.
3.3 Test
Send to a test device. Check nothing is truncated.
4. Marketing Cloud and Jacquard | Test and go live
4.1 Preview and test
Use Preview and Test with a test subscriber. All Jacquard-controlled parts should show Jacquard copy.
4.2 Journeys
Running journeys need a new version to pick up the change.
4.3 Activate in Jacquard
Approve the experiment plan and activate the touchpoint.
4.4 Send
Activate the journey or schedule the send.
Large sends: Each message calls Jacquard as it’s built. For sends of several million, agree throttling or batching with Jacquard first.
Reference
Troubleshooting
Blank part or old copy
Snippet must be at the top with the exact key. Variable names must match the Connect tab.
Blank subject line
Move the snippet above all other body content.
Journey shows old content
Publish a new journey version.
Can’t find the snippets
Ask your admin to share the Jacquard folder with your Business Unit.