OpenX as an Audience Manager Destination

Last update: April 13, 2021

Set up OpenX as a destination and send Audience Manager segment data to that platform.

NOTE
For onsite ad server targeting only.

OpenX Destination Requirements

Standards for code placement, supported key-value formats, reports, and the type of segment data sent to OpenX.

Review the following before setting up OpenX as an Audience Manager destination:

  • DIL: Data Integration Library code should be deployed on your site. DIL helps eliminate the need to write special code for data collection, integration, reading cookie values, and recovering page data.
  • get_aamCookie Function: Code that captures the Audience Manager user ID and cookie data. Place this code on the top of the page or inside the <head> codeblock.
  • Send Delivery Logs to Audience Manager: If you want a segment delivery report (optional), provide Audience Manager with a daily log that contains impression-level delivery data. The data can be in a raw format, but each record must contain the Audience Manager UUID. Audience Manager can pick up or receive these via FTP.

Key-Value Data: Format Requirements

Audience Manager sends data in the form of key-value pairs. Create key-value pairs according to the following specifications:

  • Preface keys with c. (e.g., c.color or c.price).
  • Separate serialized values attached to a single key with a comma (e.g., c.color = red, green, blue).
  • Separate multiple key-value pairs with an ampersand (e.g., c.color=red & c.price = 100 & c.condition = new).
  • Key names should not contain special characters like accent and punctuation marks or other symbols.

Only Qualified Segments are Sent to OpenX

The amount data passed in to OpenX depends on how many segments a particular user qualifies for. For example, say you set up 100 Audience Manager segments. If a site visitor qualifies for five of them, then only those five segments get sent to OpenX (not all 100).

Create an OpenX Destination

Create a cookie destination for OpenX in Audience Manager.

In Audience Manager, a destination is any other system (ad server, DSP, ad network, etc.) that you want to share data with. Destination Builder provides the tools that let you create and manage these data delivery processes. Audience Manager destination features are located in Audience Data > Destinations. To get started, click Add New Destination and follow the steps below.

Step 1: Basic Information

To complete the Basic Information section:

  1. Name the destination.
  2. Select “Cookie” from the Type drop-down list.
  3. Click Next and move on to the Configuration and Segment Mappings sections.

Step 2: Configuration Information

To complete the Configuration section:

  1. Cookie Name: Provide a short, descriptive name for your cookie.
  2. Cookie Domain: Leave blank to set a cookie in the domain of the user’s current page. If you want to specify a domain, prefix the name with a period like this, .mydomain.com.
  3. Choose a key option in the Data Format section.
  4. If your keys use data with serialized values, select the Serialize control and specify the serial delimiter (the character that separates the serialized values).
  5. Click Save and expand the Segment Mappings section.