The line item delivery allows to serve E-Planning SSP ads through a line item configured in Ad Manager. This is used in two scenarios:

• E-Planning SSP in AMP sites
• Manual sync of E-Planning Header Bidder auctions

Content

How to Use the Line Item Delivery

E-Planning SSP in AMP sites

AMP sites (Accelerated Mobile Pages) cannot execute an external Javascript code. In order to fulfill implementation, you must create a line item in Ad Manager to serve the ad as described in the AMP sites doc.

Manual Sync of E-Planning Header Bidder Auctions

E-Planning Header Bidder ads can be delivered though a line item in Ad Manager. This way, the ads will only be displayed if they meet the requirements for this line item to be delivered, permitting to manage specific priorities within Ad Manager. This is how it all works in this modality:

1. During the site load, Ad Manager is temporarily disabled and all slots are auctioned off in E-Planning.
2. After bidding, a key-value is added to the slots with a winning bid, which indicates there is an ad to display.
3. Ad Manager reactivates and defines the ad to display in each slot.
4. In the slots where no key-value was defined, Ad Manager proceeds as if no slot had been bid on.
5. In the slots with a defined key-value, the line item will be delivered based on the priorities settings in the account.
6. If the line item is displayed, then E-Planning Header Bidder knows that it can be delivered in the bid slot. Consequently, E-Planning displays the ad and pays the publisher the corresponding impression.
7. If the line item is not displayed, Ad Manager proceeds as if it had not been bid on.

Implementation

Follow the steps below to implement a line item:

1. Create a key-value in Ad Manager to indicate your purchase intention
2. Create the line item in Ad Manager
3. If your intention is to use the manual bidding sync, then contact our Tech Support Team to activate it.

Creation of a Key-Value

In order to create a key-value in Ad Manager, click on Inventory and then on Key-values.

Click on New key.

Enter the value EPL_HB in the fields Name (1) and Display Name (2). Select the option Users will enter targeting values when creating line items or verifying the inventory (3). Then click on Save (4) to apply the changes.

Creation of a Line Item

In order to create a line item in Ad Manager, click on Delivery (1) and then select Orders (2). Next, click on New order (3).

Complete the General settings and click on Ad Line Item

Click on Select Display Ad

Within Line item type, select Price priority

Within Expected creatives, add all sizes.

On Additional settings, turn on Same advertiser exception 

On Delivery Settings, in Start time select Immediately (1), in End time select Unlimited (2), within Limit select None (3) and in Rate enter the value 500 (4).

On Adjust Delivery, within  Deliver Impressions (1) select As fast as possible and Within Display creatives (2) select As many as possible.

On add targeting, within the targeting criteria, select Custom targeting(1) and then the key EPL_HB (2). Next, enter the values  eat*, slot* (3).

Save the new order, select the Creatives tab (1), and click on Add creative (2).

Select Third-party.

On settings, select 1x1 on Target adunt size (1) and Within Code type (2) select Standard. Next, paste the HB CALLBACK TAG (described below the picture) in the code area (3). Finaly, uncheck Serve Into a Safeframe (4) and save

This is the HB CALLBACK TAG to be implement

<script type="text/javascript">
    (function(c){
    	function fs(e,s,u) {Object.keys(s).forEach(function(i){(u?e[u]:e)[i]=s[i]}); return e};
    	function mki(p, e, s) {return p.appendChild(fs(fs(document.createElement("iframe"), e, "style"),{scrolling:"no",src:s}))};
        function m(p) {return (new RegExp(["Xg==","IFxTKw=="].map(atob).join(p))).test(c)};
        if(m("slot")) top.hbepl.deferedRender(c);
        if(m("eat")) mki(document.body, {position:"absolute", top:"0px", left:"0px", width:"100%", height:"100%",margin:"0px",border:"none"}, decodeURIComponent(c.substring(4)));
    })("%%PATTERN:EPL_HB%%");
</script>

To end, In the Lineitem creative association settings, check Override settings and select all sizes on Size overrides