With Meson, Mediation-as-a-Service technology, you can access the full unfiltered stream of mediation events, in much the same way you would if you were building a mediation from scratch.
The following streams are available for publishers to access and also share with partners post-authorization.
Feed | Type | Description |
---|---|---|
Bid Stream | Batch | Everything the SDK sends to the Ad Server. |
Bid Landscape | Batch | Batch impression-level auction insights. Provide information on participants with an ad, and pricing at an impression level. |
Impression Stream | Streaming | Stream impression-level ad revenue in real-time. Provide accuracy of revenue per impression based on the type of integration with each network; Real-Time Bid, Predicted Bid, or Fixed Bid. |
Click Stream | Batch | Batch impression-level engagement insights. Provide information on creative, advertiser, networks, and engagement at an impression level. |
Once you activate any one of the feeds, we will generate the following access credentials:
Credential | Description |
---|---|
Access Key ID | This is the unique identifier to access the S3 bucket over API. |
Secret Access Key | This is the password/secret to access the S3 bucket over API. |
S3 bucket | The S3 bucket has all the feeds generated for your account. |
All feeds of type batch are available in an S3 bucket, that is exclusively created per account once you activate a feed. Each feed is stored in a separate folder within the S3 bucket. The below folder structure explains how you can access data from your S3 bucket.
<bucket>.s3.amazonaws.com/appId=<appId>/<hour>/<feed-type>/
Use the API Key and Secret Key for authentication.
See below AWS documentation for authentication and download objects from S3.
The impression stream alone can be streamed to an endpoint you provide using the post method. The response will be in JSON format.
Impression Stream Sample JSON:
[
{
"request_ts":1637318643616,
"request_id":"A4A695ED-33F6-4BF3-9AE9-7F2BCC7EF562",
"request_info":{
"inventory":{
"ad_unit_id":"2a1a90d6-4508-465c-82e1-74d7063521a4",
"ad_unit_name":"AdMob Rewarded",
"ad_unit_type_id":3,
"ad_unit_type_name":"Rewarded",
"app_id":"125c5e7f-28ec-4815-954b-0e08501a36e5",
"app_name":"iOS Prime Test App",
"publisher_id":"c4af7c43-c1c2-4363-9821-2f1cb6da9987",
"bundle_id":"ai.meson.MesonTestApp",
"ux_template_name":"Default Rewarded Video UX Template",
"block_setting_name":"mesonTestApp_block_setting"
},
"country_code":"IND",
"country_name":"India",
"carrier":"Bharti Airtel Limited",
"handset_manufacturer":"Apple",
"handset_model":"iPhone",
"operating_system":"iOS",
"operating_system_version":"1.0",
"integration_version":"p-i-1.0.0-beta1",
"device_type":"Feature Phone",
"test_request":false,
"app_version":"1.0.0",
"lmt":0,
"att":"3",
"targeting_group":{
"id":"3c3d362e-364a-4bfd-bfac-8a42be0cb555",
"name":"Rest of the World",
"rank":1,
"segment_id":"segmentId",
"segment_name":"segmentName"
},
"gdpr_consent":"N/A",
"has_advertising_id":true,
"has_location":false,
"user":{
"has_age":true,
"has_gender":true,
"normalizedUserIds":{
"ifa":"123E4567-E89B-12D3-A456-426614174000",
"ppid":"ppid"
}
},
"experiment":{
"id":"3c3d362e-364a-4bfd-bfac-8a42be0cb555",
"variant_tag":"3c3d362e-364a-4bfd-bfac-8a42be0cb555"
},
"wrap_request":false,
"drop_reasons":"",
"drop_reason_descriptor":""
},
"network_info":{
"network_id":"bfa0a72c-e466-4376-a655-bb8d7d68b75b",
"network_name":"Admob",
"line_item_id":"e57c3a58-2128-4340-b596-26f379430bee",
"impression_id":"e57c3a58-2128-4340-b596-26f379430bee",
"line_item_name":"LI_RW_Admob_0.01",
"creative_info":{
"creative_id":"CR_ID",
"adomain":"ADV_DOMAIN"
},
"pricing_info":{
"bid":0.01,
"bid_bucket":"[-]"
},
"network_type":"Passive",
"network_integration_type":"SDK",
"line_item_type":"Standard",
"tier":{
"id":"1d8c5aac-0837-4d7a-a238-698fcdc7a031",
"strategy":"Backfill"
},
"bid_floor":0.01,
"render_latency":10,
"drop_reason":"",
"drop_reason_descriptor":""
}
}
]