Review your technical integration

📌 Review your integration by playing commands in your Chrome-based browser console.

A. About this documentation page

This page is here to help you validate your integration by yourself for the required steps. But your Solution Engineer / CSM will be there anyway to ensure all is properly configured.

Note

The command inputs must be played in a Chromium-based browser.

By default, we use pbjs wrapper as an example for the command inputs. Replace it with your own wrapper. If you don’t know its name, you can find it with this command: window._pbjsGlobals.

B. Check the required Prebid modules

1. Adagio bidder adapter

Note

Step failed? Review the integration documentation: Adagio bidder adapter module

Console input command:

window.ADAGIO

Expected console output:

// Should not be 'undefined'
{pageviewId: '4682f2c2-4d09-44ba-8766-5bf4e1ec35ec', adUnits: {…}, pbjsAdUnits: Array(3), queue: Array(0), versions: {…}, …}

2. RTD module and Adagio RTD provider

Note

Step failed? Review the integration documentation: RTD module and Adagio RTD Provider

Console input command:

window.ADAGIO.hasRtd

Expected console output:

// If false, means your missing rtd module, or adagio provider, or both
true

C. Check the required wrapper configuration

1. Adagio required bidder parameters

Note

Step failed? Review the integration documentation: Adagio bidder parameters

Console input command:

pbjs.getEvents().filter((e) => e.eventType === "bidRequested").filter(e => e?.args?.bidderCode.toLowerCase().includes('adagio')).map(e => e?.args?.bids).flat()

Expected console output:

// Go deep in the bids array to review Adagio setup
params: {
  organizationId: "XXXX",  // Required
  site: "my-site",         // Required
},

...
ortb2Imp: {
  ext: {
    data: {
      divId: "div-gpt-ad-1460505748561-0", // Required
      placement: "my-adg-placement",       // Required
    }
  }
},

2. RTD Module and Adagio RTD Provider (since Prebid 9)

Note

Step failed? Review the integration documentation: Adagio RTD provider parameters

Console input command:

pbjs.getConfig('realTimeData')

Expected console output:

dataProviders: [
  {
    name: "adagio",
    params: {
      organizationId: "XXXX", // Your organizationId
      site: "my-site" // Your website name as declared on the Adagio platform
    }
  }
]

3. Users sync

Note

Step failed? Review the integration documentation: Iframe sync

Console input command:

pbjs.getConfig('userSync')

Expected console output:

// We require to be in 'iframe' as 'include'
// filterSettings.all also works
{
  filterSettings: {
    iframe: {
      bidders: ["adagio"],
      filter: "include"
    }
  }
}

4. Device Access

Note

Step failed? Review the integration documentation: Device access

Console input command:

pbjs.getConfig('deviceAccess')

Expected console output:

// Should not be 'false' or 'undefined'
true