Change of Prebid Server to Prebid Server Premium

From Documentation
Revision as of 09:51, 22 March 2022 by Tlohmann (talk | contribs)
Jump to navigation Jump to search

Introduction and background

Until now, iq digital has used Xandr's Prebid Server software to process headerbidding bids from Xandr in AMP. Xandr has created an improved version, Prebid Server Premium, to which all publishers must switch by March 31, 2022 if they want to continue using Prebid Server (Premium). The ad tags hardly change in the process. Only one word in each ad tag must be replaced by the string "psp". An adjustment of the ad tags is mandatory, otherwise errors may occur on the client side after March 31, 2022 and there may also be a loss of revenue if the header bidding provider Xandr is no longer available.

The change to Prebid Server Premium also has the advantage that the software is more modern and it will be easier to add new headerbidding partners in the future without the publisher having to manually add them to their site (as was previously the case). This will also enable us to reduce the number of headerbidding requests in an AMP page in the future, when partners can be configured within the Prebid Server Premium environment and no longer use their own configuration in the amp-rtc config.

ToDo

Here's what to do on publisher side for customization:

Previous

Example amp-ad tag for an iqadtile3 (explanation: XXXXXX are values that can be different depending on the publisher):

<!-- iqadtile3 -->
<amp-ad data-block-on-consent="_till_accepted" width="320" height="320"
    type="doubleclick"
    data-slot="/183/XXXXXX"
    rtc-config='{
        "vendors": {
			"yieldlab": {"ADSLOT_ID": "XXXXXX"},
		    "aps": {"PUB_ID": "3711","PARAMS":{"amp":"1"}},
        	"prebidappnexus": {"PLACEMENT_ID": "XXXXXX"},
            "criteo": {"ZONE_ID": "1298400", "LINE_ITEM_RANGES": "0..20:0.01;20..60:0.05;60..420:1.00","PUBLISHER_SUB_ID":"XXXXXX"}
         }, "timeoutMillis": 999}'
    json='{"targeting":{"kw":["nospa","enozqi","digtransform","XXXXXX","iqadtile3"],"tile":["3"],"doc":["artikel"],"iqadtype":["amp"]}}'
    data-multi-size="320x53,320x80,320x106,320x160,320x50,300x50,300x75,300x100,300x150,300x250"
    data-multi-size-validation="false"
	data-loading-strategy="1.25">
</amp-ad>

In the AMP rtc-config, there is a separate configuration for each headerbidding partner used by iq digital. As seen in the example above, these are Yieldlab, Amazon, Xandr (formerly Appnexus) and Criteo. The change to Prebid Server Premium only affects the configuration of Xandr. The corresponding line is already highlighted in the example above.

In this line, the word prebidappnexus must be supplemented by the string "psp" to prebidappnexuspsp. The value of "PLACEMENT_ID" remains the same.

After

<!-- iqadtile3 -->
<amp-ad data-block-on-consent="_till_accepted" width="320" height="320"
    type="doubleclick"
    data-slot="/183/XXXXXX"
    rtc-config='{
        "vendors": {
			"yieldlab": {"ADSLOT_ID": "XXXXXX"},
		    "aps": {"PUB_ID": "3711","PARAMS":{"amp":"1"}},
        	"prebidappnexuspsp": {"PLACEMENT_ID": "XXXXXX"},
            "criteo": {"ZONE_ID": "1298400", "LINE_ITEM_RANGES": "0..20:0.01;20..60:0.05;60..420:1.00","PUBLISHER_SUB_ID":"XXXXXX"}
         }, "timeoutMillis": 999}'
    json='{"targeting":{"kw":["nospa","enozqi","digtransform","XXXXXX","iqadtile3"],"tile":["3"],"doc":["artikel"],"iqadtype":["amp"]}}'
    data-multi-size="320x53,320x80,320x106,320x160,320x50,300x50,300x75,300x100,300x150,300x250"
    data-multi-size-validation="false"
	data-loading-strategy="1.25">
</amp-ad>

In summary

The rest of the adtag remains unchanged, as it has already been obstructed for each position. So it is completely sufficient to perform a search&replace action with the search term prebidappnexus and the replacement text prebidappnexuspsp!