help center

| Submit or View Help Requests | Developer Docs |

Create Ads That Have Dynamic Tokens Using Flexi Ads

Flexi ads are advanced link/ad types that are highly customizable. For example, you might allow a partner to completely customize a product storefront with custom colors, sizes, number of products displayed, category of products displayed, and more. You can also provide a dynamic banner ad link builder with many options for the partner to customize the look and feel of the ad. Or you can even offer an API that partners can query. Ads that offer many customization options are often referred to as widgets.

Hosting ad code

Advertisers will need to host and generate the ad code on their website for flexi ads to work.

Flexi Ads are hosted widgets or pages that will live on your website, and usually should have a specific URL where a partner can go to enter in their customization settings and grab the ad code. This is different from other ad types since partners will retrieve the ad from your own site, rather than the platform.

Since the ad code is generated outside the platform, you will need a way to grab the partner ID and any sub-ID values and embed them in the flexi ad tracking code. There are 2 ways you can do so:

  • Have the partner enter them manually. This is not ideal, because the partner could enter incorrect information.

  • can pass the partner's ID to the advertiser website URL query string, allowing the advertiser to populate IDs within the ad.

Step 1: Create a flexi ad

To create a flexi ad, navigate to Content → Ads and select Create Ad → Flexi Ad in the top right corner.

  1. Enter the Name of the ad.

  2. Toggle whether you want the flexi ad to display full screen. If toggled on, this flexi ad will take up an entire web page on your site.

  3. Optionally, add a Preview Image. This will only appear in the platform.

  4. Enter the Widget URL. This is the URL where this flexi ad will be hosted on your site.

    • Ensure you add any click URL tokens to the source URL (as query string parameters) that you need for your tracking integration. As an example, here's how to format the {click_url} token: click_url={click_url}




      An encoded version of the click event's referring domain.


      An unencoded version of the click event's referring domain.


      A legacy token.


      The Partner Id for the partner that drove the click event.


      A custom parameter that can assist partners with their reporting.


      A custom parameter that can assist partners with their reporting.


      A custom parameter that can assist partners with their reporting.


      A custom parameter that can assist both yourself and partners with reporting.


      The Ad Id for the video ad. This can also be found on the Manage Ads screen.


      The Program Id (or Campaign Id) for the event.


      An encoded version of the click event's referring domain. This version will append any deeplinked parameters.

  5. If applicable, select the IAB ad unit size.

    • If you're creating a custom-sized flexi ad, enter the pixel width and height next to Non IAB Ad Unit Size.

  6. Enter a Description of the flexi ad.

  7. Enter the ad's Landing Page.

  8. Optionally, toggle on, then add, Metadata.

  9. Select the Deal with which this ad should be grouped.

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

  11. If you want to restrict when the ad is active, set the Available Dates for this ad.

  12. If you want to restrict which partners can use the ad, toggle on [Toggle on] Allow access to only specific partners. Search for the partners you want this ad to be usable for from the Search partners field.

Step 2: Add promotional themes

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.

  1. Toggle if you want to add Seasonal themes.

    • Select what seasonal theme you want to add from the drop-down menu.

  2. Toggle if you want to signal to partners that this ad is for a Top-Selling item.

If you want to add advanced settings to this ad, continue to the next section. Otherwise, select Save as a draft or just Save.

Step 3: Toggle advanced settings
  1. Select Show advanced settings .

  2. Select in which language you want to serve this ad from the drop-down menu.

  3. Toggle whether you want to limit partners to only using iFrame tracking code for the ad. They will not be able to use html tracking code if this is toggled on.

  4. Toggle whether you want to allow partners to change the landing page of the ad to a deeplinked web page.

Step 4: Save the ad
  1. If you want to save the ad but do not want it to be live for partners to use, select [Unchecked box] Save as a draft.

  2. If you want partners to begin using the ad as soon as you finish creating it, select Save.

  3. Select [Drop-down menu]if you want to create another banner ad.

    • Select Save and create another ad to create a new banner ad.

    • Select Save and create another with same settings to create a duplicate ad. Select this option if you want to create another ad with some small changes to the ad you just made.

Step 5: Build the Tracking Link Widget

The advertiser must create a widget or script that lives at a particular URL on the advertiser web servers.

Assuming this URL accepts the click URL and the impression URL via parameters:{click_url}&Impression_URL={irimpurl}

The widget code can use these values to create the partner-parsed widget.

See the example link below, where the {click_url} and {irimpurl} should be replaced with the values generated from the example URL.

<a href="{click_url}" target="_blank">link Link Link</a><img src="{irimpurl}" width="1" height="1">

The partner would then get a URL with their tracking values and be able to link directly to the widget, or serve the widget in an iframe.

Did you find it helpful? Yes No

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