Integrating EmailPerks
MomentScience EmailPerks allows you to seamlessly embed personalized offers directly into your transactional emails. With just a simple HTML tag, you can deliver targeted promotions that enhance customer engagement and drive conversions. This guide walks you through setting up the EmailPerks tag, customizing its appearance to match your email layout, and aligning it with your brand identity.
Before you begin, ensure you have the following:
- MomentScience Account: You’ll need an active MomentScience account to access your unique API key. If you don’t have an account yet, contact us to get started.
Follow these steps to embed the MomentScience EmailPerks tag into your transactional emails
Copy and paste the following general HTML tag template into your email:
Field | Description | Example Value |
|---|---|---|
{PARTNER-API-KEY} | Your API Key. Learn how to obtain an API Key | 4b87b13cced4e97f9 |
{RECIPIENT_EMAIL} | The recipient’s email, provided by your email service provider (ESP) | |
{PLACEMENT_ID} | A unique identifier for the offer placement in your email. | orderconf-bottom |
{WIDTH} | Width of the Offer in pixels (must match predefined options) | 600 |
{HEIGHT} | Height of the Offer in pixels (must match predefined options) | 300 |
{TAGS_SEPARATED_BY_SEMICOLONS} | Tags for Offer targeting or reporting, separated by semicolons (optional)
| firstpurchase;loyaltymember |
{CACHE_BUSTER} | A required dynamic value that prevents email clients from caching the offer. More details on this are provided below. | 1700000000 |
You can modify the tag using inline styles or CSS while adhering to the following predefined dimensions:
Width (px) | Height (px) | Aspect Ratio |
|---|---|---|
600 | 460 | 1:1.3 |
600 | 300 | 1:2 |
600 | 150 | 1:4 |
If you change the container size, maintain the aspect ratio. For example, if the container width is 300px, the corresponding heights should be 230px, 150px, or 75px.
Example of a fully populated tag
Example of a fully populated EmailPerks tag that includes targeting/reporting tags
When specifying targeting tags, ensure to include the trailing forward slash (/) at the end of both the img src and a href attributes to ensure proper functionality.
To display a specific offer using an EmailPerks tag, include oid:[OFFER_ID] as one of the targeting tags, replacing [OFFER_ID] with the unique Offer ID found in the MomentScience dashboard.
In the example above, additional tags such as firstpurchaseand loyaltymemberare included alongside the oid:[OFFER_ID] tag.
Ensure the offer has a creative available for the specified width and height. If no creative is available, the tag will not display anything.
Each offer has a unique ID, which can be found in the MomentScience dashboard.
- Locate the Offer ID listed beneath the offer title.
For more details on how to retrieve Offer IDs, refer to the demo below.
Email clients often cache images, which can result in outdated offers being displayed. To ensure fresh content is loaded every time an email is opened, you must include a cache-busting parameter (cb=) in both the <a> and <img> tags.
- Avoid Caching Issues: Without cache busting, the email client may display an older version of the ad, preventing accurate testing.
- Verify Changes: Ensures that any updates made to the Offer or its parameters are reflected immediately when the email is opened.
To implement cache busting, append a unique cb= value to the end of both the <a> and <img> tags. This value should be dynamic and change with each email send or test. Here’s how to do it:
- Add cb= to the<a> Tag:
- Append ?cb=[UNIQUE_VALUE] to the hrefattribute.
- Add cb=to the <img>Tag:
- Append ?cb=[UNIQUE_VALUE] to the srcattribute.
- Replace [UNIQUE_VALUE]:
- Use a unique identifier for each email or test. This could be:
- A timestamp (e.g., cb=20240929).
- A random number (e.g., cb=12345).
- A dynamic value generated by your email service provider (ESP).
- Ensure the cb= parameter is added to both the <a> and <img> tags. Omitting it from either tag may result in caching issues.
- Always use a unique value for cb= to ensure the email client fetches the latest version of the offer.
EmailPerks makes it easy to add targeted offers to transactional emails using a simple HTML tag. By following this guide, you can customize your offers, ensure correct display sizes, and implement cache busting for fresh content. With the right targeting and tracking setup, EmailPerks helps drive engagement and revenue from every email you send.
📢 If you're running into any issues while going through the integration process, feel free to contact us at [email protected]