Help Center

| Submit or View Help Requests | Developer Docs |

View desktop instructions
View mobile app instructions
Create Dynamic HTML Content Ads can host ads that are generated from an HTML file, as well as ads with dynamic content such as search widgets, embedded forms, and banners with product-browsing capability.

If you host your HTML content ad on, you can change the code at any time without needing any third-party programs. Note that 2 items must be added to your HTML file before you can upload it to

  • An absolute link, aka a landing page, served securely with HTTPS.

  • Any dynamic URL tokens you want to be tracked whenever the ad is clicked.

Create an HTML content ad

  1. From the left navigation bar, select engage-icon__v69b8313.svg [Engage] → ContentAds.

  2. In the top-right corner, select Create Ad caret-down-solid.svg [Drop-down menu] → Article.

  3. Enter the Name of the ad.

  4. Under Content, enter the HTML/CSS/JS code for your ad.

    • You can also upload an HTML file by selecting toggle-on-solid.svg [Toggle on] Upload FilesChoose Files.

    • Want to use dynamic content in your ad? See the Dynamic token reference and Dynamic content ad example below.

  5. Under Ad Unit Size, select angle-down-solid.svg [Drop-down menu] and choose the appropriate display size.

  6. Optionally, enter a Description of the email ad.

  7. Enter the Landing Page to which the email ad should redirect.

    • You can set up a custom landing page by selecting Custom from the angle-down-solid.svg [Drop-down menu].

    • If the image ad is hosted on a mobile app, toggle-on-solid.svg [Toggle on] Mobile Fallback, then enter the app store link.

  8. toggle-on-solid.svg [Toggle on] Add metadata to this ad.

    • From the angle-down-solid.svg [Drop-down menu], select the field and enter the value of the query parameters you want to pass.

      • You can add more parameters by selecting plus-circle-solid__1_.svg [Add Item].

      • Metadata added to your ads will be appended to the end of the ad's tracking links.

      • If you select the Custom parameter you can set both the parameter name and value.

  9. From the angle-down-solid.svg [Drop-down menu] select the Deal list this ad should be.

    • Optionally, select Add new deal to add a new deal to this ad.

  10. Add Labels to the ad so your partners can more easily find it.

  11. toggle-on-solid.svg [Toggle on] Available Dates to set start and end date for this ad.

    • Select square-regular.svg [Unchecked box] to change landing page on expiration.

  12. toggle-on-solid.svg [Toggle on] Restrict Partner Access to set which partners can use this ad. Search for the partners you want this ad to be usable for from the Search partners field.

  13. Adding Promotional Themes can help you organize ads by what time of the year the ad is for, and partners can also find these ads more conveniently for their marketing efforts.

    • toggle-on-solid.svg [Toggle on] Seasonal and select which seasonal theme you want to add from the angle-down-solid.svg [Drop-down menu].

    • toggle-on-solid.svg [Toggle on] Top Seller to select the offer as Offer is a top selling item.

  14. Optionally, select Show Advanced Settings arrow-down-solid.svg expand and configure settings.

    Advanced Settings
    • Select in which Language you want to serve this ad from the angle-down-solid.svg [Drop-down menu].

    • toggle-on-solid.svg [Toggle on] [Tracking Code] if you want to limit partners to only having iFrame tracking codes for this ad.

    • Select square-regular.svg [Unchecked box] to Setup a third-party impression pixel for this ad if you want to record how users interact with your ad.

  15. Save if you want partners to begin using the ad as soon as you finish creating it.

    • Optional, select square-regular.svg [Unchecked box] and Save as a draft.

    • Optionally, select the angle-down-solid.svg [Drop-down menu] if you want to Save and create another or Save and create another with same settings.

    Dynamic token reference




    Populates the tracking link URL with the partner ID value assigned to the partner.


    Populates the tracking link URL with the ad ID value assigned to the ad.


    Populates the tracking link URL with the program (or campaign) ID value assigned to your program.


    Populates with the partner’s SubId1 value—a query string parameter that partners can append to their assigned tracking links. Partners typically use them in their reporting.


    Populates with the partner’s SubId2 value—a query string parameter that partners can append to their assigned tracking links. Partners typically use them in their reporting.


    Populates with the partner’s SubId3 value—a query string parameter that partners can append to their assigned tracking links. Partners typically use them in their reporting.


    Populates with the partner’s SharedId value—a query string parameter that partners can append to their assigned tracking links, which is passed to you and available in various reports.


    Populates the tracking link URL with the tracking domain for your program.


    Populates with a generated timestamp in Unix epoch format of when the ad is retrieved by the partner.


    Populates the tracking link URL with a randomly generated integer when the ad is retrieved by the partner.

    Dynamic content ad example

    In the Example code provided below, we have:

    • An HTML form with a textbox entry and "Submit" button

    • Embedded CSS to style the form independently of other content

    • A <div> container for the widget

    • JavaScript function that dynamically creates an tracking link and appends query string parameters

    • A <noscript> tag for the system to accept the script when it doesn’t have an outgoing link (Without this tag, we’d encounter an error when trying to upload this creative.)

    In practice, many of these elements can be hosted or embedded on your website— supports external HTML, CSS, and JavaScript files for dynamic content.

    <style type="text/css">  
    {    font-family:"Verdana";
         border:1px solid #BBBDBF;
         box-shadow:5px 5px 2px rgba(0,0,0,0.1);   }   
         border:1px solid #3B91CF;
         cursor:pointer;   }   
        #submitbutton:hover {    
         color:#fff;  }
         #searchbox {
          margin:10px 10px 10px 0px;   }
    <div id='search-widget-container'>
    <img src="" width="150px">  
    <form><input name='searchTerm' 
       placeholder='Search The Website'>
        <input onClick="searchFunction()" 
    <script type="text/javascript">
    function searchFunction() {  
    // Get the user-submitted value from the search box 
    var searchTerm = document.getElementById("searchBox").value;  
    var landingPage = "http://{domain}/c/{irpid}/{iradid}/{ircid}?p.searchTerm=";
    // Append the searchTerm to the end of the landingPage
    var completeURL = landingPage.concat(searchTerm);
    // Send the customer to the complete final URL
    window.location.href = completeURL;   } 
    <a href=””>No script link</a>

Troubleshoot validation errors

You may see the following error messages when creating your content ad. Here's what you can do to solve them:

Validation error


“No replaceable links present” cannot detect any replaceable links in the Content field—all links provided should use http (not https). Your links will later be automatically converted to https tracking links.

“Ad name cannot be empty”

You must provide a name for your content ad. Input an appropriate name in the Name field.

"URL on anchor is not absolute"

The link you provided in the Content field isn't absolute. Absolute links use the entire path name, starting with http://. You may also want to check for syntax issues with the link you provided, such as spaces before or after the href= tag.

Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.