RevMail - Documentation

A guide to setting up RevMail units for email campaigns

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 are unique identifiers used to differentiate each of your email recipients. They can be any unique alpha numeric string of your choosing, just as long as each string is unique to each recipient. You can use your email provider's personalization tags/variables to automatically populate these unique values upon delivery. While there are many different tags/variables that can be used to accomplish this, one common example would be to use your email provider's Subscriber ID tag/variable. Below you can find detailed examples based on the email provider you're using.
  • Please note that the "key" values expire 24 hours after your email campaign is delivered. Therefore if you're sending out more than 1 email to the same recipients within a 24 hour period, you will need to add a second tag/variable to differentiate each recipient AND email. For example, rather than using only a Subscriber ID tag/variable, you would add in another such as Email ID so that the value assigned to each recipient is also unique to each email.

 

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 ad panels 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
  • If your "total" value is set to "1", offset will have no affect

 

That covers everything required to get your RevMail units up and running.  You should now have everything needed to start displaying ads within your email campaigns. 

______________________________________________________________________________________