Skip to content

Commit b4ac1e4

Browse files
eyvazahmadzadaeyvazahmadzada
authored
Merge branch '0_29' into AGT-457-private-silo-for-module
2 parents 6f01fc5 + 5c89927 commit b4ac1e4

41 files changed

Lines changed: 1180 additions & 173 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎_data/sidebar.yml‎

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -675,6 +675,14 @@
675675
sectionTitle:
676676
subgroup: 0
677677

678+
- sbSecId: 2
679+
title: Prebid Mobile 3.0
680+
link: /prebid-mobile/updates-3.0/sdk-key-features.html
681+
isHeader: 0
682+
isSectionHeader: 0
683+
sectionTitle:
684+
subgroup: 0
685+
678686
- sbSecId: 2
679687
title: Prebid AMP
680688
link: /dev-docs/show-prebid-ads-on-amp-pages.html
@@ -831,6 +839,14 @@
831839
sectionTitle:
832840
subgroup: 2
833841

842+
- sbSecId: 2
843+
title: Prebid Mobile 3.0 API Changes
844+
link: /prebid-mobile/updates-3.0/ios/api-changes.html
845+
isHeader: 0
846+
isSectionHeader: 0
847+
sectionTitle:
848+
subgroup: 2
849+
834850
- sbSecId: 2
835851
title: API Reference
836852
link: /prebid-mobile-ios/index.html
@@ -928,6 +944,14 @@
928944
sectionTitle:
929945
subgroup: 3
930946

947+
- sbSecId: 2
948+
title: Prebid Mobile 3.0 API Changes
949+
link: /prebid-mobile/updates-3.0/android/api-changes.html
950+
isHeader: 0
951+
isSectionHeader: 0
952+
sectionTitle:
953+
subgroup: 3
954+
931955
- sbSecId: 2
932956
title: API Reference
933957
link: /prebid-mobile-android/index.html

‎_includes/mobile/adunit-config-android.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -30,12 +30,24 @@ adUnit.setImpOrtbConfig("")
3030
#### setAutoRefreshPeriodMillis
3131
{:.no_toc}
3232

33+
{: .alert.alert-warning :}
34+
Starting from PrebidMobile `3.0.0` the `setAutoRefreshPeriodMillis` method is removed. Use the `setAutoRefreshInterval` method instead.
35+
3336
If set on a given Prebid Mobile ad unit, the `fetchDemand` function will be called every `periodMillis` until `stopAutoRefresh` is called. Each call to `fetchDemand` will invoke the `onComplete` function. This refresh only pertains to Prebid Mobile and not to any ad server refresh processes. It is suggested that the adServers refresh be turned off.
3437

3538
**Parameters**
3639

3740
- `periodMillis`: Integer defining the refresh time in milliseconds.
3841

42+
#### setAutoRefreshInterval
43+
{:.no_toc}
44+
45+
If set on a given Prebid Mobile ad unit, the `fetchDemand` function will be called every `periodMillis` until `stopAutoRefresh` is called. Each call to `fetchDemand` will invoke the `onComplete` function. This refresh only pertains to Prebid Mobile and not to any ad server refresh processes. It is suggested that the adServers refresh be turned off.
46+
47+
**Parameters**
48+
49+
- `seconds`: Integer defining the refresh time in seconds.
50+
3951
#### startAutoRefresh
4052
{:.no_toc}
4153

‎_includes/mobile/adunit-config-ios.md‎

Lines changed: 59 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -90,4 +90,62 @@ let gamBanner = GAMBannerView(adSize: GADAdSizeFromCGSize(AD_SIZE))
9090
adUnit.activatePrebidAdViewImpressionTracker(adView: gamBanner)
9191
```
9292

93-
**NOTE**: The SDK support only `seatbid[].bid[].burl` as impression tracking URL for now.
93+
**NOTE**: The SDK support only `seatbid[].bid[].burl` as impression tracking URL for now.
94+
95+
### SKAdNetwork
96+
97+
The SDK supports two SKAdNetwork methods for ad networks to deliver ads in a bidding-only scenario, specifically for **banner** and **native** ad formats:
98+
99+
- View-through ads
100+
- StoreKit-rendered ads
101+
102+
Both methods are automatically enabled for the **native** ad format, with no additional configuration required. The support of view-through ads is also automatically enabled for the **banner** ad format. However, in order to activate StoreKit-rendered ads flow, you must call a method appropriate to the case:
103+
104+
`BannerAdUnit`:
105+
106+
```swift
107+
let gamBanner = GAMBannerView(adSize: GADAdSizeFromCGSize(AD_SIZE))
108+
adUnit.activatePrebidSKAdNetworkStoreKitAdsFlow(adView: gamBanner)
109+
```
110+
111+
`InterstitialAdUnit`:
112+
113+
```swift
114+
adUnit.activatePrebidSKAdNetworkStoreKitAdsFlow()
115+
```
116+
117+
`PrebidAdUnit`:
118+
119+
```swift
120+
let adUnit = PrebidAdUnit(configId: CONFIG_ID)
121+
122+
// Use this method for intersitials
123+
adUnit.activatePrebidInterstitialSKAdNetworkStoreKitAdsFlow()
124+
125+
// Use this method for banners
126+
let gamBanner = GAMBannerView(adSize: GADAdSizeFromCGSize(AD_SIZE))
127+
adUnit.activatePrebidBannerSKAdNetworkStoreKitAdsFlow(adView: gamBanner)
128+
```
129+
130+
#### SKOverlay
131+
132+
The SDK also provides support of SKOverlay for interstitials. In order to activate it, set `supportSKOverlay` to `true`:
133+
134+
```swift
135+
adUnit.supportSKOverlay = true
136+
```
137+
138+
You should also call the method below when you are about to show the ad:
139+
140+
```swift
141+
// Present SKOverlay if available
142+
adUnit.activateSKOverlayIfAvailable()
143+
// Present the interstitial
144+
gamInterstitial.present(from: controller)
145+
```
146+
147+
In order to dismiss SKOverlay, use the method below:
148+
149+
```swift
150+
adUnit.dismissSKOverlayIfAvailable()
151+
```

‎_includes/mobile/intro-admob.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -50,11 +50,11 @@ This information may be useful when comparing data across various reporting syst
5050
| Scenario | Tracked? |
5151
| --- | --- |
5252
| Fires Prebid win event | yes |
53-
| Fires Prebid imp event | no |
54-
| Fires OpenRTB burl | no (1) |
55-
| Fires OpenRTB nurl | no (1) |
53+
| Fires Prebid imp event | yes |
54+
| Fires OpenRTB burl | yes (1) |
55+
| Fires OpenRTB nurl | yes (1) |
5656
| Fires OpenMeasurement events | yes |
5757

5858
Notes:
5959

60-
1. OpenRTB burl and nurl will be utilized in a future release.
60+
1. OpenRTB `burl` and `nurl` are utilized in a PrebidMobile SDK v3.0.0.

‎_includes/mobile/intro-applovin.md‎

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -50,11 +50,11 @@ This information may be useful when comparing data across various reporting syst
5050
| Scenario | Tracked? |
5151
| --- | --- |
5252
| Fires Prebid win event | yes |
53-
| Fires Prebid imp event | no |
54-
| Fires OpenRTB burl | no (1) |
55-
| Fires OpenRTB nurl | no (1) |
53+
| Fires Prebid imp event | yes |
54+
| Fires OpenRTB burl | yes (1) |
55+
| Fires OpenRTB nurl | yes (1) |
5656
| Fires OpenMeasurement events | yes |
5757

5858
Notes:
5959

60-
1. OpenRTB burl and nurl will be utilized in a future release.
60+
1. OpenRTB `burl` and `nurl` are utilized in a PrebidMobile SDK v3.0.0.

‎_includes/mobile/intro-prebid-rendered.md‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -61,11 +61,11 @@ Here's how the ad bidding-auction-rendering process works in this integration sc
6161
1. Otherwise, it writes the creative into an iframe into an internal WebView, replaceing the GAMSDK's WebView.
6262
1. Injects mraid.js into the webview to listen for events from MRAID: change size, etc.
6363
1. Sends data to the creative (e.g. 'viewable') which may trigger impression tracking within the creative.
64-
1. It does not currently hit the billing or notice urls (burl or nurl).
64+
1. Starting from v3.0.0, the SDK hits the billing and notice urls (burl and nurl).
6565
1. If a video VastUrl creative is chosen (rewarded video only):
6666
1. The GMA SDK uses the platform video player which loads the special VAST file from the Prebid CDN.
6767
1. Prebid SDK watches VAST events for "<AdTitle>PrebidAppEvent</AdTitle>". When it sees this, it takes over the rendering:
68-
1. PBSDK fires the PBS win event.
68+
1. PBSDK fires the PBS win event. Starting from v3.0.0, the SDK also hits the billing and notice urls (burl and nurl).
6969
1. If the response indicates a 3rd party rendering SDK, PBSDK will call it.
7070
1. Otherwise:
7171
1. PDBSK renders with the platform-standard VAST player.
@@ -77,7 +77,7 @@ Here's how the ad bidding-auction-rendering process works in this integration sc
7777
1. The GMA SDK delegates the rendering of native to the App and PBSDK when a special signal is specified.
7878
1. The app code gets the native assets from PBSDK. The app is coded to render the ad.
7979
1. PBSDK fires the eventtrackers when appropriate.
80-
1. The PBS win event is fired.
80+
1. The PBS win event is fired. Starting from v3.0.0, the SDK also hits the billing and notice urls (burl and nurl).
8181
1. Open Measurement events are handled directly by the Prebid SDK.
8282
1. If a 3rd party rendering SDK is used to render, then it will handle Open Measurement.
8383

@@ -118,11 +118,11 @@ This information may be useful when comparing data across various reporting syst
118118
| --- | --- | --- | --- |
119119
| Rendering Method | js in iframe fires an event | GMA SDK player | App code with data from PBSDK |
120120
| Fires Prebid win event | always | never | always |
121-
| Fires Prebid imp event | never | VAST impression tag | never |
122-
| Fires OpenRTB burl | never | n/a | never |
123-
| Fires OpenRTB nurl | never | n/a | never |
121+
| Fires Prebid imp event | always | VAST impression tag | never |
122+
| Fires OpenRTB burl | always (1) | n/a | never |
123+
| Fires OpenRTB nurl | always (1) | n/a | never |
124124
| Fires OpenMeasurement events | PBSDK | n/a | PBSDK |
125125

126126
Notes:
127127

128-
- OpenRTB burl and nurl will be utilized in a future release.
128+
1. OpenRTB `burl` and `nurl` are utilized in a PrebidMobile SDK v3.0.0.

‎_includes/mobile/video-params.md‎

Lines changed: 37 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,11 @@ The [OpenRTB 2.6](https://iabtechlab.com/wp-content/uploads/2022/04/OpenRTB-2-6_
1717
Notes:
1818
- `PrebidAdUnit`, `VideoInterstitialAdUnit` and `RewardedVideoAdUnit` will default to placement=5 if no placement value is supplied.
1919

20-
#### plcmnt
20+
{: .alert.alert-warning :}
21+
Starting from PrebidMobile `3.0.0` the class `VideoInterstitialAdUnit` is removed.
22+
23+
#### plcmt
24+
2125
{:.no_toc}
2226

2327
The [OpenRTB v2.6-202303](https://github.com/InteractiveAdvertisingBureau/AdCOM/blob/main/AdCOM%20v1.0%20FINAL.md#list--plcmt-subtypes---video-) Placement Type for the auction can be expressed as an integer or you can use an enum for easier readability.
@@ -28,7 +32,10 @@ The [OpenRTB v2.6-202303](https://github.com/InteractiveAdvertisingBureau/AdCOM/
2832
- `4` or `NoContent` or `Standalone` : Video ads that are played without streaming video content. This can be in placements like slideshows, native feeds, in-content or sticky/floating.
2933

3034
Notes:
31-
- `PrebidAdUnit`, `VideoInterstitialAdUnit` and `RewardedVideoAdUnit` will default to plcmnt=3 if no placement value is supplied.
35+
- `PrebidAdUnit`, `VideoInterstitialAdUnit` and `RewardedVideoAdUnit` will default to plcmt=3 if no placement value is supplied.
36+
37+
{: .alert.alert-warning :}
38+
Starting from PrebidMobile `3.0.0` the class `VideoInterstitialAdUnit` is removed.
3239

3340
#### api
3441
{:.no_toc}
@@ -93,3 +100,31 @@ Array of OpenRTB 2.6 playback methods. If none are specified, any method may be
93100
- `6` or `Signals.Protocols.VAST_3_0_Wrapper` : VAST 3.0 Wrapper
94101
- `7` or `Signals.Protocols.VAST_4_0` : VAST 4.0
95102
- `8` or `Signals.Protocols.VAST_4_0_Wrapper` : VAST 4.0 Wrapper
103+
104+
#### battr
105+
{:.no_toc}
106+
107+
Array or enum of OpenRTB 2.6 blocked creative attributes. Values can be one of:
108+
109+
- `1` or `Signals.CreativeAttribute.AudioAd_Autoplay` : Audio Ad (Autoplay)
110+
- `2` or `Signals.CreativeAttribute.AudioAd_UserInitiated` : Audio Ad (User Initiated)
111+
- `3` or `Signals.CreativeAttribute.Expandable_Automatic` : Expandable (Automatic)
112+
- `4` or `Signals.CreativeAttribute.Expandable_Click` : Expandable (User Initiated - Click)
113+
- `5` or `Signals.CreativeAttribute.Expandable_Rollover` : Expandable (User Initiated - Rollover)
114+
- `6` or `Signals.CreativeAttribute.InBanner_Autoplay` : In-Banner Video Ad (Autoplay)
115+
- `7` or `Signals.CreativeAttribute.InBanner_UserInitiated` : In-Banner Video Ad (User Initiated)
116+
- `8` or `Signals.CreativeAttribute.Pop` : Pop (e.g., Over, Under, or Upon Exit)
117+
- `9` or `Signals.CreativeAttribute.Provocative` or `Signals.CreativeAttribute.SuggestiveImagery` : Provocative or Suggestive Imagery
118+
- `10` or `Signals.CreativeAttribute.Shaky`, `Signals.CreativeAttribute.Flashing`, `Signals.CreativeAttribute.Flickering`, `Signals.CreativeAttribute.ExtremeAnimation` or `Signals.CreativeAttribute.Smileys` : Shaky, Flashing, Flickering, Extreme Animation, Smileys
119+
- `11` or `Signals.CreativeAttribute.Surveys` : Surveys
120+
- `12` or `Signals.CreativeAttribute.TextOnly` : Text Only
121+
- `13` or `Signals.CreativeAttribute.UserInteractive` : User Interactive (e.g., Embedded Games)
122+
- `14` or `Signals.CreativeAttribute.WindowsDialog` or `Signals.CreativeAttribute.AlertStyle` : Windows Dialog or Alert Style
123+
- `15` or `Signals.CreativeAttribute.AudioButton` : Has Audio On/Off Button
124+
- `16` or `Signals.CreativeAttribute.SkipButton` : Ad Provides Skip Button (e.g. VPAID-rendered skip button on pre-roll video)
125+
- `17` or `Signals.CreativeAttribute.AdobeFlash` : Adobe Flash
126+
127+
#### isSkippable
128+
{:.no_toc}
129+
130+
Boolean representing the OpenRTB 2.6 video ad skippability.

‎assets/images/prebid-mobile/mobile-details-gam-prebid-rendered.png‎

-3.68 KB
Loading

‎dev-docs/bidders/adipolo.md‎

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
layout: bidder
3+
title: adipolo
4+
description: adipolo Bidder Adapter
5+
biddercode: adipolo
6+
media_types: banner, video
7+
coppa_supported: true
8+
tcfeu_supported: false
9+
usp_supported: true
10+
prebid_member: false
11+
pbjs: true
12+
pbs: false
13+
schain_supported: true
14+
floors_supported: true
15+
multiformat_supported: will-bid-on-any
16+
sidebarType: 1
17+
safeframes_ok: true
18+
dchain_supported: false
19+
deals_supported: true
20+
fpd_supported: false
21+
ortb_blocking_supported: true
22+
privacy_sandbox: no
23+
---
24+
25+
### Prebid.js Bid params
26+
27+
{: .table .table-bordered .table-striped }
28+
| Name | Scope | Description | Example | Type |
29+
|-------------|----------|-----------------------------|---------------|-----------|
30+
| `pid` | required | Placement ID | `test-banner` | `string` |
31+
| `env` | optional | Environment name | `adipolo` | `string` |
32+
| `ext` | optional | Specific integration config | `{}` | `object` |

0 commit comments

Comments
 (0)