Features

FeatureValueFeatureValue
Bidder CodesmaatoPrebid.org Memberyes
Prebid.js AdapteryesPrebid Server Adapteryes
Media Typesdisplay, video, nativeMulti Format Supportcheck with bidder
TCF-EU SupportyesIAB GVL ID82
GPP Supportsome (check with bidder)DSA Supportyes
USP/CCPA SupportyesCOPPA Supportyes
Supply Chain SupportyesDemand Chain Supportcheck with bidder
Safeframes OKcheck with bidderSupports Dealscheck with bidder
Floors Module SupportyesFirst Party Data Supportyes
Endpoint Compressioncheck with bidderORTB Blocking Supportcheck with bidder
User IDsallPrivacy Sandboxcheck with bidder
Prebid Server App Supportyes

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 [email protected] for more information.

Note

The Smaato adapter automatically converts bidfloors to USD currency as needed.

Bid Params

NameScopeDescriptionExampleType
publisherIdrequiredYour Smaato publisher ID'1100012345'string
adspaceIdrequiredYour Smaato adspace ID (non-adpod requests)'11002234'string
adbreakIdrequiredYour Smaato adbreak ID (adpod requests)'41002234'string
appoptionalMobile app parameters (see App Object)app: { ifa: '5670...' }object

📘

Note:

In case of AdPods, the Smaato adapter only reads the first imp[].skadn entry for each AdPod. There should be only one SKAdNetwork entry per AdPod.

App Object

Smaato supports prebid within a mobile app's WebView.

NameDescriptionExampleType
ifaAdvertising identifier (IDFA/AAID)'56700000-9cf0...'string
geoUser latitude & longitude{ lat: 33.3, lon: -88.8 }object

Example Ad Units

Example Banner Ad Unit

var adUnit = {
  code: "banner unit",
  mediaTypes: {
    banner: {
      sizes: [320, 50]
    }
  },
  bids: [{
    bidder: "smaato",
    params: {
      publisherId: "1100012345",
      adspaceId: "11002234"
    }
  }]
};

Example Video Ad Unit

var adUnit = {
  code: "video unit",
  mediaTypes: {
    video: {
      context: "instream",
      playerSize: [640, 480],
      mimes: ["video/mp4"],
      minduration: 5,
      maxduration: 30,
      startdelay: 0,
      linearity: 1,
      protocols: [7],
      skip: 1,
      skipmin: 5,
      api: [7],
      ext: { rewarded: 0 }
    }
  },
  bids: [{
    bidder: "smaato",
    params: {
      publisherId: "1100012345",
      adspaceId: "11002234"
    }
  }]
};

Example Native Ad Unit

var adUnit = {
  code: "native unit",
  mediaTypes: {
    native: {
      sendTargetingKeys: false,
      image: { required: true, sizes: [150, 50] },
      icon: { required: true, sizes: [50, 50] },
      title: { required: true, len: 80 },
      sponsoredBy: { required: true },
      body: { required: true },
      cta: { required: false },
      rating: { required: false }
    }
  },
  bids: [{
    bidder: "smaato",
    params: {
      publisherId: "1100012345",
      adspaceId: "11002234"
    }
  }]
};

Example AdPod (Long-Form) Video Ad Unit

var adUnit = {
  code: "adpod unit",
  mediaTypes: {
    video: {
      context: "adpod",
      playerSize: [640, 480],
      adPodDurationSec: 300,
      durationRangeSec: [15, 30],
      requireExactDuration: false,
      mimes: ["video/mp4"],
      startdelay: 0,
      linearity: 1,
      protocols: [7],
      skip: 1,
      skipmin: 5,
      api: [7]
    }
  },
  bids: [{
    bidder: "smaato",
    params: {
      publisherId: "1100042525",
      adbreakId: "400000000"
    }
  }]
};

First Party Data

Publishers should use the ortb2 method of setting First Party Data. The following fields are supported:

Supported Fields:

  • ortb2.site.keywords
  • ortb2.site.content
  • ortb2.user.keywords
  • ortb2.user.yob
  • ortb2.user.gender
  • ortb2.user.ext.eids
  • ortb2.device.geo
  • ortb2.device.ifa

The IAB standard taxonomies are not supported.

Example first party data that’s available to all bidders and all adunits

Example

pbjs.setConfig({
  ortb2: {
    site: {
      keywords: "kw1,kw2",
      content: {
        title: "title1",
        series: "series1"
      }
    },
    user: {
      keywords: "a,b",
      gender: "M",
      yob: 1984
    },
    device: {
      ifa: "identifier",
      geo: {
        lat: 53.5488,
        lon: 9.9872
      }
    }
  }
});

Test Parameters

Following example includes sample imp object with publisherId and adSlot which can be used to test Smaato Adapter:

"imp": [
  {
    "id": "1C86242D-9535-47D6-9576-7B1FE87F282C",
    "banner": {
      "format": [
        { "w": 300, "h": 50 },
        { "w": 300, "h": 250 }
      ]
    },
    "ext": {
      "smaato": {
        "publisherId": "1100042525",
        "adspaceId": "130563103"
      }
    }
  }
]


"Send All Bids Ad Server Keys"

These are the bidder-specific keys that would be targeted within GAM in a Send-All-Bids scenario. GAM truncates keys to 20 characters.

hb_pb_smaatohb_bidder_smaatohb_adid_smaato
hb_size_smaatohb_source_smaatohb_format_smaato
hb_cache_host_smaatohb_cache_id_smaatohb_uuid_smaato
hb_cache_path_smaatohb_deal_smaato