Skip to content

Commit

Permalink
Dailymotion Bid Adapter: Add support for user sync and new fields
Browse files Browse the repository at this point in the history
  • Loading branch information
Kevin Siow authored and kvnsw committed May 29, 2024
1 parent c6b3d16 commit 879d277
Showing 1 changed file with 44 additions and 1 deletion.
45 changes: 44 additions & 1 deletion dev-docs/bidders/dailymotion.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,28 @@ const adUnits = [

`apiKey` is your publisher API key. For testing purpose, you can use "dailymotion-testing".

## User Sync

To enable user synchronization, add the following code. Dailymotion highly recommends using iframes and/or pixels for user syncing. This feature enhances DSP user match rates, resulting in higher bid rates and bid prices. Ensure that `pbjs.setConfig()` is called only once.

```javascript
pbjs.setConfig({
userSync: {
syncEnabled: true,
filterSettings: {
iframe: {
bidders: '*', // Or add dailymotion to your list included bidders
filter: 'include'
},
image: {
bidders: '*', // Or add dailymotion to your list of included bidders
filter: 'include'
},
},
},
});
```

# Test Parameters

By setting the following bid parameters, you'll get a constant response to any request, to validate your adapter integration:
Expand Down Expand Up @@ -131,6 +153,10 @@ const adUnits = [
tags: 'tag_1,tag_2,tag_3',
title: 'test video',
topics: 'topic_1, topic_2',
isCreatedForKids: false,
videoViewsInSession: 1,
autoplay: false,
playerVolume: 8
}
}
}],
Expand All @@ -139,6 +165,12 @@ const adUnits = [
video: {
api: [2, 7],
context: 'instream',
mimes: ['video/mp4'],
minduration: 5,
maxduration: 30,
playbackmethod: [3],
plcmt: 1,
protocols: [7, 8, 11, 12, 13, 14]
startdelay: 0,
w: 1280,
h: 720,
Expand All @@ -162,8 +194,15 @@ Each of the following video metadata fields can be added in bids.params.video.
* `title` - Video title
* `topics` - Main topics for the video, comma separated
* `xid` - Dailymotion video identifier (only applicable if using the Dailymotion player)
* `isCreatedForKids` - [The content is created for children as primary audience](https://faq.dailymotion.com/hc/en-us/articles/360020920159-Content-created-for-kids)

The following contextual informations can also be added in bids.params.video.

* `videoViewsInSession` - Number of videos viewed within the current user session
* `autoplay` - Playback was launched without user interaction
* `playerVolume` - Player volume between 0 (muted, 0%) and 10 (100%)

If you already specify [First-Party data](https://docs.prebid.org/features/firstPartyData.html) through the `ortb2` object when calling [`pbjs.requestBids(requestObj)`](https://docs.prebid.org/dev-docs/publisher-api-reference/requestBids.html), we will fallback to those values when possible. See the mapping below.
If you already specify [First-Party data](https://docs.prebid.org/features/firstPartyData.html) through the `ortb2` object when calling [`pbjs.requestBids(requestObj)`](https://docs.prebid.org/dev-docs/publisher-api-reference/requestBids.html), we will collect the following values and fallback to bids.params.video values when applicable. See the mapping below.

| From ortb2 | Metadata fields |
|---------------------------------------------------------------------------------|-----------------|
Expand All @@ -174,3 +213,7 @@ If you already specify [First-Party data](https://docs.prebid.org/features/first
| `ortb2.site.content.livestream` | `livestream` |
| `ortb2.site.content.keywords` | `tags` |
| `ortb2.site.content.title` | `title` |
| `ortb2.app.bundle` | N/A |
| `ortb2.app.storeurl` | N/A |
| `ortb2.device.lmt` | N/A |
| `ortb2.device.ifa` | N/A |

0 comments on commit 879d277

Please sign in to comment.