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

Dailymotion Bid Adapter: Add support for user sync and new fields #5356

Merged
merged 4 commits into from
Jun 16, 2024
Merged
Changes from 2 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
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 |
Loading