diff --git a/dev-docs/analytics/eightPod.md b/dev-docs/analytics/eightPod.md deleted file mode 100644 index f53db035a6..0000000000 --- a/dev-docs/analytics/eightPod.md +++ /dev/null @@ -1,15 +0,0 @@ ---- -layout: analytics -title: 8pod -description: 8pod Analytics Adapter -modulecode: eightPodAnalyticsAdapter -tcfeu_supported: false -usp_supported: false -coppa_supported: false -prebid_member: false -gvl_id: none -enable_download: false ---- - -### Disclosure -The adapter subscribe on events from 8pod's ad unit when the bidWon event for each ad slot and then send internal event to our tracker once in 10 sec. diff --git a/dev-docs/analytics/eightpod.md b/dev-docs/analytics/eightpod.md new file mode 100644 index 0000000000..214e5aa29e --- /dev/null +++ b/dev-docs/analytics/eightpod.md @@ -0,0 +1,25 @@ +--- +layout: analytics +title: 8pod +description: 8pod Analytics Adapter +modulecode: eightpodAnalyticsAdapter +tcfeu_supported: false +usp_supported: false +coppa_supported: false +prebid_member: false +gvl_id: none +enable_download: false +--- + +## Configuration + +```javascript +pbjs.enableAnalytics({ + provider: 'eightpod' +}); +``` + +Use the lowercase provider code `eightpod` to match adapter registration. + +### Disclosure +The adapter subscribes to events from 8pod's ad unit when the bidWon event fires for each ad slot and sends supported ad unit events to Tealium from the rendered ad frame. diff --git a/dev-docs/bidders/eightPod.md b/dev-docs/bidders/eightPod.md deleted file mode 100644 index e9fcf8cf17..0000000000 --- a/dev-docs/bidders/eightPod.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -layout: bidder -title: 8pod -description: Prebid EightPod Bidder Adaptor -biddercode: eightPod -tcfeu_supported: false -gvl_id: none -usp_supported: false -coppa_supported: false -gpp_sids: none -schain_supported: false -dchain_supported: false -userId: none -media_types: banner, video -deals_supported: false -userIds: check with bidder -floors_supported: false -fpd_supported: true -pbjs: true -pbs: false -prebid_member: false -sidebarType: 1 -safeframes_ok: false -multiformat_supported: will-not-bid -privacy_sandbox: no -ortb_blocking_supported: false ---- - -### Registration - -The EightPod adapter requires setup before beginning. Please contact us at - -### Bid Params - -| Name | Scope | Description | Example | Type | -|---------------|----------|-------------------------------------------------------------------------------------------------------------|----------------------------|----------| -| `placementId` | required | The unique identifier of the ad placement. Could be obtained from the 8pod UI or from your account manager. | "placementId-438753744289" | `string` | -| `publisherId` | optional | The unique identifier of the publisher. | "publisherId-438753744289" | `string` | - -### First Party Data - -We accept all standard OpenRTB 2.6 fields for following object: - -`ortb2.site` -`ortb2.user` -`ortb2.device` -`ortb2.user.data.*` -`ortb2.site.content.data` - -Note that all fields are optional. For contextual data (e.g. categories), standard IAB taxonomies are supported. -Also, note that any 1st party data circulation should be agreed in advance. diff --git a/dev-docs/bidders/eightpod.md b/dev-docs/bidders/eightpod.md new file mode 100644 index 0000000000..c6bb36fd0e --- /dev/null +++ b/dev-docs/bidders/eightpod.md @@ -0,0 +1,79 @@ +--- +layout: bidder +title: 8pod +description: Prebid EightPod Bidder Adaptor +biddercode: eightpod +filename: eightpodBidAdapter +tcfeu_supported: true +gvl_id: 1497 +usp_supported: true +coppa_supported: true +gpp_sids: tcfeu, tcfca, usnat, usstate_all, usp +schain_supported: false +dchain_supported: false +userIds: unifiedId, id5Id, identityLink, uid2 +media_types: banner +deals_supported: true +floors_supported: false +fpd_supported: true +pbjs: true +pbs: false +prebid_member: false +sidebarType: 1 +safeframes_ok: false +multiformat_supported: will-not-bid +privacy_sandbox: no +ortb_blocking_supported: false +--- + +## Registration + +The EightPod adapter requires setup before beginning. Please contact us at + +## Privacy Regulation Support + +The EightPod adapter passes through GDPR (TCF), US Privacy (CCPA/USP), GPP, and COPPA consent signals in OpenRTB bid requests: + +| Regulation | OpenRTB fields | +| --- | --- | +| GDPR (TCF EU) | `user.ext.consent`, `regs.ext.gdpr` | +| US Privacy (CCPA/USP) | `regs.ext.us_privacy` | +| GPP | `regs.gpp`, `regs.gpp_sid`, `regs.ext.gpp`, `regs.ext.gpp_sid` | +| COPPA | `regs.coppa` | + +The adapter is registered with IAB Global Vendor List ID **1497**. + +Bid responses populate `meta.advertiserDomains` from OpenRTB `adomain` and set `meta.mediaType` to `banner`. + +The adapter relies on Prebid's OpenRTB conversion for User ID module values and preserves identifiers in `user.ext.eids`. Publishers should use User ID modules or `ortb2.user.ext.eids` for identity signals. + +The `userIds` metadata above indicates supported Prebid User ID modules, including UID2. Their identifiers are expected to flow through OpenRTB `user.ext.eids`; they are not copied into `user.id`. + +## User Identifier Disclosure + +The adapter does not create or persist any browser storage values. When available, it reads the Tealium `utag_main_v_id` cookie and sends it in the OpenRTB extended identifiers field as `user.ext.eids` with source `8podx.com`. For backward compatibility, the same value is also sent as `user.ext.eightPodVisitorId`; publishers may override this value with `params.eightPodVisitorId`. This identifier is used only as an EightPod/Tealium visitor reference for bidder-side matching and reporting. The adapter does not set the cookie, and its lifetime is controlled by the Tealium configuration. + +Prebid User ID module values remain the preferred source for OpenRTB `user.ext.eids`. + +## Bid Params + +OpenRTB first-party data should be supplied through `ortb2` / `ortb2Imp`. The adapter preserves Prebid User ID module identifiers in `user.ext.eids`. + +| Name | Scope | Description | Example | Type | +| --- | --- | --- | --- | --- | +| `placementId` | optional | The unique identifier of the ad placement. When provided, sent as OpenRTB `imp.tagid`; also sent as legacy `ext.adSlotPlacementId` for compatibility. Could be obtained from the 8pod UI or from your account manager. | "placementId-438753744289" | `string` | +| `publisherId` | optional, legacy override | Overrides OpenRTB `site.publisher.id` when provided. Prefer `ortb2.site.publisher.id`. | "publisherId-438753744289" | `string` | +| `dealId` | optional | PMP deal ID sent as `imp.pmp.deals[].id` when provided. | "deal-123" | `string` | +| `trace` | optional | Enables trace mode by adding `?trace=true` to the bidder endpoint for debugging. | true | `boolean` or `string` | +| `userId` | optional, legacy override | Overrides OpenRTB `user.id` when provided. Prefer User ID modules or `ortb2.user.ext.eids`. | "user-123" | `string` | +| `eightPodVisitorId` | optional | Publisher-provided EightPod/Tealium visitor reference sent as OpenRTB `user.ext.eids` and legacy `user.ext.eightPodVisitorId`. Overrides the `utag_main_v_id` cookie value when provided. | "visitor-123" | `string` | +| `country` | optional, legacy override | Overrides OpenRTB `device.geo.country` and `user.geo.country` when provided. Prefer `ortb2.device.geo.country` / `ortb2.user.geo.country`. | "AUS" | `string` | +| `language` | optional, legacy override | Overrides OpenRTB `device.language` when provided. Prefer `ortb2.device.language`. | "en" | `string` | +| `publishercat` | optional, legacy override | Comma-separated override for OpenRTB `site.publisher.cat`. Prefer `ortb2.site.publisher.cat`. | "IAB1,IAB2" | `string` | +| `sitecat` | optional, legacy override | Comma-separated override for OpenRTB `site.cat`. Prefer `ortb2.site.cat`. | "IAB3" | `string` | +| `pagecat` | optional, legacy override | Comma-separated override for OpenRTB `site.pagecat`. Prefer `ortb2.site.pagecat`. | "IAB4" | `string` | +| `sectioncat` | optional, legacy override | Comma-separated override for OpenRTB `site.sectioncat`. Prefer `ortb2.site.sectioncat`. | "IAB5" | `string` | +| `yob` | optional, legacy override | Overrides OpenRTB `user.yob` when provided. Prefer `ortb2.user.yob`. | 1990 | `number` or `string` | +| `gender` | optional, legacy override | Overrides OpenRTB `user.gender` when provided. Prefer `ortb2.user.gender`. | "M" | `string` | +| `city` | optional, legacy override | Overrides OpenRTB `user.geo.city` when provided. Prefer `ortb2.user.geo.city`. | "Sydney" | `string` | +| `region` | optional, legacy override | Overrides OpenRTB `user.geo.region` when provided. Prefer `ortb2.user.geo.region`. | "NSW" | `string` |