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).

Within Inventory sizes, select all sizes.

Select Allow same advertiser exception.

Within Type, select Price priority (1), in Start time select At once and in End time select Unlimited (2). Within Limit select None (3) and in Price enter the value 1000 (4).

Within Display creatives select As many as possible.

Within the targeting criteria, select Key-value (1) and then the key EPL_HB (2). Next, enter the values  eat*, slot* (3).

Save the new order, and click on Add creative.

Select Third-party.

In the New creative form enter the value EPL_HB in Name (1). For the field HTML Type select the value Standard (2) and in the Code snippet box (3) enter the code shown below. After you enter the code, you might have a warning alert indicating the tag is unknown (4). You may skip it.

<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>

In the Orientation box, select Any (1) and make sure the Render in SafeFrame checkbox is unchecked (2).

Finally, save and approve the new creative.