Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Smaato bid adapter: Optional bidder params to support in-app webview use cases #2347

Merged
merged 1 commit into from
Sep 29, 2020
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 27 additions & 2 deletions dev-docs/bidders/smaato.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,27 +2,49 @@
layout: bidder
title: Smaato
description: Prebid Smaato Bidder Adaptor
hide: true
biddercode: smaato
gdpr_supported: true
tcf2_supported: true
usp_supported: true
coppa_supported: true
media_types: banner, video
pbjs: true
pbs: true
---

### Table of Contents

- [Bid Params](#smaato-bid-params)
- [App Object](#smaato-app-object)
- [First Party Data](#smaato-first-party)

### Registration

The Smaato adapter requires setup and approval from the Smaato team, even for existing Smaato publishers. Please reach out to your account team or prebid@smaato.com for more information.

<a name="smaato-bid-params" />

### Bid Params

{: .table .table-bordered .table-striped }
| Name | Scope | Description | Example | Type |
|------------|----------|----------------------|------------|----------|
| `publisherId` | required | Your Smaato publisher id | `'1100012345'` | `string` |
| `adspaceId` | required | Your Smaato adspace id | `'11002234'` | `string` |
| `app` | optional | Object containing mobile app parameters. See the [App Object](#smaato-app-object) for details.| `app : { ifa: '56700000-9cf0-22bd-b23e-46b96e40003a'}` | `object` |

<a name="smaato-app-object" />

#### App Object

Smaato supports using prebid within a mobile app's webview.

{: .table .table-bordered .table-striped }
| Name | Description | Example | Type |
|-------------------|---------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------|------------------|
| `ifa` | String that contains the advertising identifier of the user (e.g. idfa or aaid). | `'56700000-9cf0-22bd-b23e-46b96e40003a'` | `string` |
| `geo` | Object that contains the latitude (`lat`) and longitude (`lon`) of the user. | `{ lat: 33.3, lon: -88.8 }` | `object` |


### Example Banner Ad Unit

Expand Down Expand Up @@ -74,6 +96,9 @@ var adUnit = {
}]
};
```
<a name="smaato-first-party" />

### First Party Data

The Smaato adapter supports passing through first party data configured in your prebid integration.

Expand All @@ -98,7 +123,7 @@ Following example includes sample `imp` object with publisherId and adSlot which
```
"imp":[
{
"id":1C86242D-9535-47D6-9576-7B1FE87F282C,
"id":"1C86242D-9535-47D6-9576-7B1FE87F282C",
"banner":{
"format":[
{
Expand Down