Investigate Triplelift SSP

[aram356]

Description

Understand how to configure prebid server with Triplelift adapter

Done when

• Document parameters required by Prebid Server
• Does prebid server reply with bid from this adapter

Affected area

Ad serving (Equativ)

Additional context

No response

[prk-Jr]

Investigation Complete: Triplelift SSP Integration

Parameters Required by Prebid Server

Source: https://docs.prebid.org/dev-docs/bidders/triplelift.html

Parameter	Type	Required	Description
inventoryCode	string	Yes	Triplelift-provided inventory identifier
floor	float	No	Bid floor value

Supports display and video. For video, requires video.placement (1 = instream, 3/4/5 = outstream) and video.playerSize.

Privacy: TCF-EU (GVL ID 28), CCPA, COPPA, GPP. User IDs: Criteo, identityLink, unifiedId, pubCommonId.

No auth credentials needed in PBS config. The adapter is built into Prebid Server (Go) out of the box. PBS activation requires setup — contact prebid@triplelift.com.

Does Prebid Server Reply with Bids?

Yes — confirmed with a real bid.

Tested by sending an enriched request directly to the PBS instance using a real inventoryCode (HIDDEN) sourced from Prospect A's client-side Prebid.js config, along with real user EIDs and device context.

PBS routed to Triplelift's endpoint (tlx.3lift.com) and returned a real bid at $2.135 CPM from albertsons.com (728x90 banner) in 247ms. The key factors for getting a real bid were: valid inventoryCode, real user EIDs (Criteo, Trade Desk), realistic device context, and a residential IP.

Placeholder Request (204 No Bid)

With a placeholder inventoryCode: "test_code", PBS still routes correctly (38ms response) but returns 204 — expected since Triplelift can't match the inventory.

Open Question: Local Testing via Viceroy

The auction returns "status":"error" when running locally via fastly compute serve (Viceroy) — this affects all bidders, not just Triplelift. The root cause is that Viceroy doesn't support dynamic backends and [local_server.backends] in fastly.toml is empty. Direct curl to PBS confirms whether the adapter works independently of Viceroy.

Client-Side Requirements

For publishers using Triplelift, the following are needed on the page:

• Prebid.js v7.1.0+ required
• storageAllowed: true in Prebid.js bidder settings (for user syncing)
• DMP tag on page for audience targeting
• GAM targeting keys: tlnir (native in-read), tl_hb_bid (header bidding)

Trusted Server Changes

Config-only — add "triplelift" to the bidders list in trusted-server.toml. No code changes required. The inventoryCode is passed through from publisher JS as an opaque JSON param.

bidders = ["kargo", "rubicon", "appnexus", "openx", "triplelift"]

Publisher JS config:

bids: [{
  bidder: 'trustedServer',
  params: {
    bidderParams: {
      triplelift: { inventoryCode: "publisher_inventory_code" }
    }
  }
}]

[aram356]

@prk-Jr to test with live Prebid Server when available
@ChristianPavilonis to share document on updating Prebid Server config

[aram356]

@prk-Jr Please deploy to Prospect A staging with new config.

[prk-Jr]

Both adapters are being called by our PBS instance and responding with 204 (no bids). Server-side PBS bidding is a separate product from client-side and requires a one-time business approval before they will return any bids. I believe this is the reason we're not getting bids back — not a code or configuration issue on our end.

• Criteo: https://docs.prebid.org/dev-docs/bidders/criteo.html — "Prebid-Server activation requires business approval before beginning. Please reach out to your account manager for more details"
• TripleLift: https://docs.prebid.org/dev-docs/bidders/triplelift.html — "The TripleLift Prebid Server bidding adapter and user sync endpoint require setup before beginning. Please contact us at prebid@triplelift.com"

[aram356]

Waiting for response from Prospect A