Unique delivery
There are times when you want to use the same zone multiple times in the same page. In such a set up, you can enable Unique Delivery to make sure that an ad shows up only once in the page.
How Unique Delivery works
Unique Delivery is toggled within a zone's properties. When it's enabled, each campaign assigned to a zone will be selected to serve only once per page. Because Unique Delivery limits campaigns and not ad items, we highly recommend that you have at least as many assigned campaigns as there are instances of the zone when enabling this feature.
For example, if you want to enable Unique Delivery on a zone that appears three times in one page, it's better to have at least three campaigns assigned to that zone. Otherwise, any instances of the zone that cannot be filled will be left blank (these will not be counted as an impression).
When a page with multiple instances of the same zone is loaded, AdButler assigns an ID to each instance. AdButler will then serve an ad to the instances one at a time, using the placement schedules to decide which ad gets served first.
Usually, the first instance of the zone will also be the first to be served. However, if you're using asynchronous JavaScript zone tags, the order that the instances will be served may not necessarily match how they're laid out on the page.
How to enable Unique Delivery
- Go to the section of the relevant zone (Your AdButler > Publishers > Your Publisher > Your Zone).
- Click Edit Zone Properties in the right menu. The Edit Zone window will appear.
- Click the switch under Unique Delivery to make it turn green.
- Click Save Changes.
How to enable Unique Delivery for iFrame (HTML Only)
iFrame tags without JavaScript do not support automatic unique delivery. To achieve unique delivery, specific parameters must be manually added to the tag. These parameters are:
pid= (Page ID): This represents a unique identifier for each page where the ad is served. Ensure that each page has its own unique pid value to differentiate it from other pages.
place= (Placement Index): This value starts at 0 for the first occurrence of a zone on the page. For each subsequent instance of that zone on the same page, increment the place value by 1. This works similarly to how unique delivery is handled in email ad placements.
Example: If you are placing an ad zone twice on a page, the first iFrame tag should have place=0 and the second tag should have place=1, ensuring unique delivery across both placements.
<!-- 300x250 [iframe-no-js] -->
<iframe src="https://servedbyadbutler.com/adserve/;ID=XXXXXX;size=300x250;setID=XXXXXX;type=iframe;place=0;pid=1234" width="300" height="250" marginwidth="0" marginheight="0" hspace="0" vspace="0" frameborder="0" scrolling="no">
</iframe>