Becoming a Site Optimization Partner

The Oracle Data Cloud platform is the most interconnected media-independent data management, data exchange, and analytics system in the industry. As experts in big data ingestion, analysis and portability, we help the online advertising ecosystem connect all data assets (with external data) and put them to use everywhere they need to be.

The platform can seamlessly integrate with site optimization vendors to dynamically render page content in real time for the very first event.

By working with Oracle Data Cloud as a site optimization vendor, you become a vital part of the our data activation system by providing another asset that some of the world’s premier publishers, marketers, and advertising companies rely on for intelligent marketing. Partners are listed as technology app partners who leverage Oracle Data Cloud data to inform solutions beyond ad targeting.

The Oracle Data Cloud optimization vendor integration provides the following benefits for your data and targeting needs:

  • Data is available on each page view, which enables targeting on the first, and every page view.
  • Integration does not interfere with existing implementations on the page.
  • Integration allows flexible targeting of low-level categories and pre-built custom audiences.

Workflow with code examples

Some basic steps must take place before the site optimization integration can be completed.

  1. Create a user account
    1. Request partner seat: Your Oracle Data Cloud account manager creates a user account and partner seat.
    2. Pull tag from UI: Once familiar with the platform UI, you will be able to use it to generate a JSON response tag. The JSON response tag is what most site optimization integrations will use to return data back to the SSO vendor.
  2. Configure your account to work with the partner DMP
  3. Configure data access: The DMP partner will use their Oracle Data Cloud account to create audience segments from their DMP. Once created, these segments can then be shared to your company seat for audience targeting.
  4. Data mapping: Steps must be taken to ensure the proper segment mapping. The platform includes audience and taxonomy APIs for this purpose. Your Oracle Data Cloud account manager will have to create a separate web services account and credentials for API access.

Integration

Step
1 2 3 4 5
SSO Vendor Implements Code Adjusts to consume JSON and verify access and optimization of the page based on data ingestion
Partner Creates and delivers audience
Oracle Data Cloud Generates campaign for audience data delivery Configures campaign for SSO integration Verifies campaign is functioning properly and verify JSON response

To implement the code:

  1. Place the JSON response tag: The JS tag should be placed in the <HEAD> before all site optimization vendor code. This ensures that platform data collection is initiated and available prior to any site optimization rendering and decision-making. This single line of code makes a call to tags.bluekai.com and returns a bk_results JSON object to the first-party DOM.
  2. Place the JSON collection code: This is the site optimization partner code that accesses the bk_results object. This code should be located directly on the page and must be called after the JSON response tag.

    Standard SSO code integration:

    <head> <script type="text/javascript" src="https://stags.bluekai.com/site/<site>?ret=js"></script> |SSO_collection_code| |existing_head_code|</head>

    Some site optimization vendors may opt to place the JSON response tag from their own coded solution. This is an acceptable practice, but when placed in this fashion the JSON response tag must be called serially and ahead of the site optimization collection code. Failing to do so may not result in actionable data on the first page view.

  3. Place site optimization conditioning code: Some vendors may require optional code to format their optimization once they've ingested the bk_results JSON response. In most cases, this code should be placed at the end of the section <BODY>, of the page. Please have the partner refer to the vendor for this type of integration.

    Some site optimization vendors are able to store Oracle Data Cloud platform data from subsequent user visits. These vendors may opt to use server data transfer (SDT) delivery and not use the tags.bluekai.com script call on some pages. Vendors using the SDT delivery method will not have user data on the first page view and until an ID swap has taken place.

  4. Create and deliver audiences targeting the appropriate users by using the standard platform UI. Site optimization data delivery should be configured to return data on every page view (instead of the default once per 30 day cadence). Your account manager will help you configure this backend setting.
  5. Site optimization data configuration: When the JS tag is called, the platform immediately returns data to the page as an invisible bk_results object. This object is accessible by using JavaScript and can be used instantly in the same page view by the site optimization code. The data will be returned in the following JSON format:

    var bk_results = { "campaigns": [ { "campaign": campaign_ID, "timestamp": Unix_timestamp, "categories": [ { "categoryID": category_ID, "timestamp": Unix_timestamp } ] } ]};

  6. Verify data delivery: After allowing 30 to 60 minutes for propagation, you can verify data delivery by checking the page DOM for the JavaScript variable bk_results. Properly configured data delivery in the tags.bluekai.com response on every request.

    Most of the coding is complete and real-time data should be flowing for site-side optimization.

  7. Consume and optimize: Make any final adjustments to the JSON consumer code to ensure that data is properly ingested. Verify that the optimized pages are working properly.