diff --git a/dev-docs/bidders/taboola.md b/dev-docs/bidders/taboola.md new file mode 100644 index 0000000000..92269a7d69 --- /dev/null +++ b/dev-docs/bidders/taboola.md @@ -0,0 +1,59 @@ +--- +layout: bidder +title: Taboola +description: Prebid Taboola Bidder Adapter +pbjs: true +biddercode: taboola +gdpr_supported: true +usp_supported: true +coppa_supported: true +schain_supported: false +media_types: banner +gvl_id: 42 +prebid_member: true +floors_supported: true +safeframes_ok: true +--- + +### Note +- Supports `display` format. +- Uses `OpenRTB` standard. + +### Registration + +The Taboola Adapter requires setup before beginning. Please contact us at prebid@taboola.com. + +### Bid Params + +{: .table .table-bordered .table-striped } + +| Name | Scope | Description | Example | Type | +|----------------|----------|---------------------------------------------------------|----------------------------|--------------| +| `tagId` | required | Tag ID / Placement Name
(as provided by Taboola) | `'Below The Article'` | `String` | +| `publisherId` | required | Alphabetic Publisher ID
(as provided by Taboola) | `'acme-publishing'` | `String` | +| `bcat` | optional | List of blocked advertiser categories (IAB) | `['IAB1-1']` | `Array` | +| `badv` | optional | Blocked Advertiser Domains | `'example.com'` | `String Url` | +| `bidfloor` | optional | CPM bid floor | `0.25` | `Integer` | + + +### Example Ad Unit +```javascript + var adUnits = [{ + code: 'your-unit-container-id', + mediaTypes: { + banner: { + sizes: [[300, 250], [300,600]] + } + }, + bids: [{ + bidder: 'taboola', + params: { + tagId: 'Placement Name', + publisherId: 'your-publisher-id', + bidfloor: 0.25, // Optional - default is null + bcat: ['IAB1-1'], // Optional - default is [] + badv: ['example.com'] // Optional - default is [] + } + }] +}]; +```