*BETA* RevMail - Documentation

A guide to setting up RevMail units for email campaigns

⚠️ These units are currently undergoing beta testing. If you haven't opted into one our beta testing groups, please refer to our HTML Ad units documentation

The RevMail unit code consists of 2 URLs - a click URL (preceded by "a href=") & an image URL (preceded by "img src=").

Sample RevMail Code Template:

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=1&offset=0">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=1&offset=0"/>
 </a>
</div>


Setting your code up is just a matter of replacing the italicized placeholder values of the 4 required parameters (in bold) based on your configuration preferences.



The 4 Required Parameters & what to input for their values:

 

id - your widget ID, provided by your account rep.

ℹ️ EXAMPLE

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=1&offset=0">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=1&offset=0"/>
 </a>
</div>
  • Needs to be included within both click & image URLs

 

key - a unique identifier (UUID) for stats accuracy

ℹ️ EXAMPLE

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key={user_id}{campaign_id}&total=1&offset=0">
<img src="https://revmail.revcontent.com/?id=1234&key={user_id}{campaign_id}&total=1&offset=0"/>
 </a>
</div>
  • Needs to be included within both click & image URLs
  • "Key" values can be any unique identifiers of your choosing. They just need to be unique to each user and campaign. While there are many ways to accomplish this, the list of links below provides examples of how unique values can be automatically populated using the most common email service provider's pre-defined tags/variables. Click on your provider for a specific example.

 

total - the total number of ads you'll be displaying within the newsletter. Used to prevent duplicate content from appearing when displaying multiple ad panels within the same email. Defaults to "1" when nothing is specified

ℹ️ EXAMPLE (if you were displaying 2 ads within the same email)

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=2&offset=0">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=2&offset=0"/>
 </a>
</div>

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=2&offset=1">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=2&offset=1"/>
 </a>
</div>
  • Needs to be included within both click & image URLs

 

offset - the index used to identify each individual ad placement. Used to prevent duplicate content from appearing when displaying multiple ad panels within the same email. Defaults to "0" when nothing is specified

ℹ️ EXAMPLE (if you were displaying 3 ad panels within the same email)

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=3&offset=0">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=3&offset=0"/>
 </a>
</div>

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=3&offset=1">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=3&offset=1"/>
 </a>
</div>

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=3&offset=2">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=3&offset=2"/>
 </a>
</div>
  • Needs to be included within both click & image URLs
  • ✴️ The index starts at "0". So your highest "offset" value will always be one less than your "total" value

 

That covers everything required to get your RevMail units up and running. For additional customization options feel free to continue on to our optional parameters section. Otherwise you should now have everything needed to start displaying ads within your email campaigns. 

______________________________________________________________________________________

Optional Parameters:

 

size -  your preferred unit dimensions.

ℹ️ EXAMPLE

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=1&offset=0">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=1&offset=0&size=300x250"/>
 </a>
</div>
  • Only needs to be included within the image URL
  • Supported IAB sizing options: 250x250, 240x400, 336x280, 720x300, 300x600, 970x250, 970x550, 400x100, 400x150, 570x150, 600x250, 600x300 

 

sub_ids - Sub ID tracking is a useful tool that can be customized to achieve your reporting needs. Some of the ways Publishers successfully utilize Sub ID tracking include tracking revenue by article, traffic source, social influencer, or to evaluate performance on different page variations.

ℹ️ EXAMPLE

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=1&offset=0&sub_ids=[key_01:value_01,key_02:value_02]">
 <img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=1&offset=0&sub_ids=[key_01:value_01,key_02:value_02]"/>
 </a>
</div>
  • Needs to be included within both click & image URLs

 

headline_color - allows you to specify a custom headline text color.

ℹ️ EXAMPLE

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=1&offset=0">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=1&offset=0&headline_color=0000FF"/>
 </a>
</div>
  • Only needs to be included within the image URL
  • Can be any hex color value without a hash

 

headline_size - allows you to specify a headline font size. Please note this parameter will not work when specifying IAB sizes

ℹ️ EXAMPLE

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=1&offset=0">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=1&offset=0&headline_size=18"/>
 </a>
</div>
  • Only needs to be included within the image URL
  • Can be any numerical pixel value

 

provider_color - allows you to specify a custom provider text color.

ℹ️ EXAMPLE

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=1&offset=0">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=1&offset=0&provider_color=0000FF"/>
 </a>
</div>
  • Only needs to be included within the image URL
  • Can be any hex color value without a hash

 

button_color - allows you to specify a custom button color. Please note that only layout 1 populates a button.

ℹ️ EXAMPLE

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=1&offset=0">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=1&offset=0&button_color=0000FF"/>
 </a>
</div>
  • Only needs to be included within the image URL
  • Can be any hex color value without a hash

 

hide_button - allows you to hide the "Learn More" button. Please note that only layout 1 populates a button. Buttons are automatically hidden on layouts 2 and 3.

ℹ️ EXAMPLE

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=1&offset=0">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=1&offset=0&hide_button=true"/>
 </a>
</div>
  • Only needs to be included within the image URL

 

hide_provider - allows you to hide the name of the content provider
Only needs to be included within the image URL

ℹ️ EXAMPLE

<div>
<a href="https://revmail.revcontent.com/click/?id=1234&key=abc123&total=1&offset=0">
<img src="https://revmail.revcontent.com/?id=1234&key=abc123&total=1&offset=0&hide_provider=true"/>
 </a>
</div>
  • Only needs to be included within the image URL