Partager via


Mediated Bid service

Note

Mediation is only available to Microsoft Monetize Ad Server customers.

Once a Network has been created via the Microsoft Monetize UI or Mediated Network Service, Mediated Bids must be set up via the Microsoft Monetize UI or the Mediated Bid Service detailed below to define:

  • Which publisher bid requests to Microsoft Monetize are relevant to the Network
  • Which Ad tags to use to call the Network

Each Bid includes a publisher-defined CPM, the amount the Network partner is likely to pay for the inventory. For more information about how mediation works, see Selling Your Inventory through Mediation.

Setup is also required in each Network’s platform, as covered in Integrating for Mediation. Microsoft Monetize reports include Mediated Networks as Advertisers and Bids as Line Items (both filters and dimensions).

REST API

HTTP Method Endpoint Description
GET https://api.appnexus.com/mediated-bid?member_id=MEMBER_ID View all of a member's bids.
GET https://api.appnexus.com/mediated-bid?id=BID_ID View a specific bid.
POST https://api.appnexus.com/mediated-bid?member_id=MEMBER_ID Create a new bid.
PUT https://api.appnexus.com/mediated-bid?member_id=MEMBER_ID Modify a bid.
DELETE http://api.apnexus.com/mediated-bid?id=BID_ID Delete a bid.

JSON fields

Field Type Description
id int The system-generated unique ID for this bid.
type string The type of bid. Always "mobile".
Required On: POST only; not applicable in PUT
name string The user-supplied name of the bid.

Required On: POST
active Boolean Controls whether the bid requests demand from the partner.

Default: true
Required On: PUT
member_id int The unique ID number of the member associated with this bid.
line_item_id int The unique ID of the line item associated with this bid.
campaign_id int The unique ID of the campaign associated with this bid.
creative_id int The unique ID of the creative associated with this bid.
profile_id int The unique ID of the targeting profile associated with this bid.
last_modified date time Read-only. The date and time that this bid object was last modified.
mediated_network object Information about the mediated network to which this bid is associated. For field definitions, see the Mediated Network Service.
mediated_network_id int The unique ID of the mediated network to which this bid is associated. For field definitions, see the Mediated Network Service.

Required On: POST
campaign object Information about the campaign to which this bid is associated. For field definitions, see the Campaign Service.
line-item object Information about the line item to which this bid is associated. For field definitions, see the Line Item Service.

Required On: POST
profile object Information about the profile to which this bid is associated. For field definitions, see the Profile Service.
creative object Information about the creative associated with this bid. For field definitions, see the Creative Service.

Required On: POST
label string The user-supplied label attached to this bid. This is an arbitrary string with no purpose other than sorting in the UI.

Examples

View all of a member's bids

$ curl -b cookies 'https://api.appnexus.com/mediated-bid?member_id=4371'

{
    "response":{
        "status":"OK",
        "count":8,
        "start_element":0,
        "num_elements":100,
        "mediated-bids":[
            {
                "id":891,
                "type":"mobile",
                "name":"test",
                "active":true,
                "member_id":4371,
                "line_item_id":186586,
                "campaign_id":421866,
                "creative_id":838628,
                "profile_id":358973,
                "suggested_bid_price": 25.4,
                "suggested_bid_price_confidence": 0.6,
               Â "last_modified":"2014-05-12 23:18:37",
                "mediated_network":{
                    "id":455,
                    "advertiser_id":111308,
                    "name":"inMobi",
                    "creative_custom_request_partner_id":41,
                    "active":true
                },
                "campaign":{
                    "id":421866,
                    "state":"active",
                    "parent_inactive":false,
                    "code":null,
                    "advertiser_id":111308,
                    "line_item_id":186586,
                    "creative_id":838628,
                    "pixel_id":null,
                    "short_name":null,
                    "name":"",
                    "profile_id":358973,
                    "start_date":"2014-05-12 00:00:00",
                    "end_date":null,
                    "timezone":"EST5EDT",
                    "priority":5,
                    "cadence_modifier_enabled":false,
                    "cpc_goal":null,
                    "cpm_bid_type":"margin",
                    "base_bid":null,
                    "min_bid":null,
                    "max_bid":null,
                    "bid_margin":0,
                    "roadblock_creatives":false,
                    "roadblock_type":"no_roadblock",
                    "inventory_type":"direct",
                    "last_modified":"2014-05-12 20:17:03",
                    "max_learn_bid":null,
                    "cadence_type":"advertiser",
                    "member_id":4371,
                    "click_url":null,
                    "require_cookie_for_tracking":true,
                    "allow_unverified_ecp":false,
                    "defer_to_li_prediction":false,
                    "ecp_learn_divisor":null,
                    "projected_learn_events":null,
                    "confidence_threshold":null,
                    "learn_threshold":3,
                    "cpc_payout":null,
                    "comments":null,
                    "optimization_lever_mode":"automatic",
                    "optimization_version":"v7",
                    "learn_override_type":null,
                    "base_cpm_bid_value":null,
                    "impression_limit":40000,
                    "bid_multiplier":1,
                    "is_malicious":false,
                    "remaining_days":null,
                    "total_days":null,
                    "supply_type":"mobile_app",
                    "creatives":[
                        {
                            "id":838628,
                            "mapping_state":"active",
                            "code":null,
                            "name":null,
                            "width":468,
                            "height":60,
                            "state":"active",
                            "audit_status":"no_audit",
                            "is_expired":false,
                            "is_prohibited":false,
                            "is_self_audited":true,
                            "format":"raw-js",
                            "pop_window_maximize":null
                        }
                    ],
                    "pixels":null,
                    "optimization_lookback":null,
                    "campaign_modifiers":null,
                    "labels":null,
                    "broker_fees":null,
                    "valuation":null,
                    "lifetime_budget":null,
                    "lifetime_budget_imps":null,
                    "daily_budget":null,
                    "daily_budget_imps":null,
                    "enable_pacing":null,
                    "lifetime_pacing":null,
                    "lifetime_pacing_span":null,
                    "allow_safety_pacing":null
                },
                "line-item":{
                    "id":186586,
                    "code":null,
                    "name":"test",
                    "advertiser_id":111308,
                    "state":"active",
                    "start_date":null,
                    "end_date":null,
                    "timezone":"EST5EDT",
                    "discrepancy_pct":0,
                    "publishers_allowed":"all",
                    "revenue_value":2,
                    "revenue_type":"cpm",
                    "goal_type":"none",
                    "goal_value":null,
                    "last_modified":"2014-05-12 23:18:37",
                    "click_url":null,
                    "currency":"USD",
                    "require_cookie_for_tracking":true,
                    "profile_id":null,
                    "member_id":4371,
                    "comments":null,
                    "is_malicious":false,
                    "remaining_days":null,
                    "total_days":null,
                    "manage_creative":false,
                    "advertiser":{
                        "id":111308,
                        "name":"inMobi"
                    },
                    "flat_fee":null,
                    "labels":null,
                    "broker_fees":null,
                    "pixels":null,
                    "insertion_orders":null,
                    "goal_pixels":null,
                    "imptrackers":null,
                    "clicktrackers":null,
                    "campaigns":[
                        {
                            "id":421866,
                            "name":"",
                            "inventory_type":"direct",
                            "state":"active",
                            "cpm_bid_type":"margin"
                        }
                    ],
                    "valuation":null,
                    "creatives":null,
                    "lifetime_budget":null,
                    "lifetime_budget_imps":null,
                    "daily_budget":null,
                    "daily_budget_imps":null,
                    "enable_pacing":null,
                    "lifetime_pacing":null,
                    "lifetime_pacing_span":null,
                    "allow_safety_pacing":null
                },
                "profile":{
                    "id":358973,
                    "code":null,
                    "description":null,
                    "country_action":"exclude",
                    "region_action":"exclude",
                    "city_action":"exclude",
                    "browser_action":"exclude",
                    "use_inventory_attribute_targets":false,
                    "last_modified":"2014-05-12 20:17:03",
                    "daypart_timezone":null,
                    "dma_action":"exclude",
                    "domain_action":"exclude",
                    "domain_list_action":"exclude",
                    "inventory_action":"exclude",
                    "language_action":"exclude",
                    "segment_boolean_operator":"and",
                    "min_session_imps":null,
                    "session_freq_type":"platform",
                    "carrier_action":"exclude",
                    "supply_type_action":"include",
                    "device_type_action":"exclude",
                    "screen_size_action":"exclude",
                    "device_model_action":"exclude",
                    "location_target_radius":null,
                    "location_target_latitude":null,
                    "location_target_longitude":null,
                    "querystring_action":"exclude",
                    "querystring_boolean_operator":"and",
                    "is_expired":false,
                    "non_audited_url_action":"include",
                    "daypart_bitmap":null,
                    "advertiser_id":111308,
                    "publisher_id":null,
                    "max_session_imps":null,
                    "max_day_imps":null,
                    "max_lifetime_imps":null,
                    "max_page_imps":null,
                    "min_minutes_per_imp":null,
                    "venue_action":"exclude",
                    "operating_system_action":"exclude",
                    "require_cookie_for_freq_cap":true,
                    "trust":"seller",
                    "allow_unaudited":true,
                    "is_template":false,
                    "created_on":"2014-05-12 20:17:03",
                    "operating_system_family_action":"exclude",
                    "use_operating_system_extended_targeting":true,
                    "mobile_app_instance_action_include":false,
                    "mobile_app_instance_list_action_include":false,
                    "user_group_targets":null,
                    "country_targets":null,
                    "region_targets":null,
                    "city_targets":null,
                    "inv_class_targets":null,
                    "inventory_source_targets":null,
                    "inventory_attribute_targets":null,
                    "age_targets":null,
                    "daypart_targets":null,
                    "browser_targets":null,
                    "browser_family_targets":null,
                    "dma_targets":null,
                    "domain_targets":null,
                    "domain_list_targets":null,
                    "language_targets":null,
                    "size_targets":null,
                    "postal_code_targets":null,
                    "member_targets":null,
                    "segment_group_targets":null,
                    "carrier_targets":null,
                    "supply_type_targets":[
                        "mobile_app",
                        "mobile_web"
                    ],
                    "device_type_targets":null,
                    "screen_size_targets":null,
                    "device_model_targets":null,
                    "querystring_targets":null,
                    "gender_targets":null,
                    "intended_audience_targets":null,
                    "inventory_group_targets":null,
                    "inventory_network_resold_targets":null,
                    "ip_targets":null,
                    "operating_system_targets":null,
                    "operating_system_family_targets":null,
                    "position_targets":null,
                    "site_targets":null,
                    "venue_targets":null,
                    "operating_system_extended_targets":null,
                    "mobile_app_instance_targets":null,
                    "mobile_app_instance_list_targets":null,
                    "content_category_targets":null,
                    "deal_targets":null,
                    "placement_targets":[
                        {
                            "id":1424815,
                            "action":"include",
                            "name":"Test Placement",
                            "deleted":false,
                            "site_id":281085,
                            "site_name":"Test App",
                            "publisher_id":147771,
                            "publisher_name":"Publisher A"
                        }
                    ],
                    "platform_content_category_targets":null,
                    "platform_placement_targets":null,
                    "platform_publisher_targets":null,
                    "publisher_targets":null,
                    "segment_targets":null,
                    "exelate_targets":null,
                    "ip_range_list_targets":null
                },
                "creative":{
                    "name":null,
                    "brand_id":184949,
                    "media_url":null,
                    "id":838628,
                    "code":null,
                    "code2":null,
                    "member_id":4371,
                    "state":"active",
                    "click_track_result":"not_tested",
                    "advertiser_id":111308,
                    "publisher_id":null,
                    "format":"raw-js",
                    "width":468,
                    "height":60,
                    "click_url":null,
                    "flash_click_variable":null,
                    "no_iframes":false,
                    "content":"document.write(\"\");",
                    "original_content":"no-tag",
                    "file_name":null,
                    "track_clicks":true,
                    "audit_status":"no_audit",
                    "macros":null,
                    "profile_id":null,
                    "audit_feedback":null,
                    "is_prohibited":false,
                    "is_suspicious":false,
                    "created_on":"2014-05-12 20:17:03",
                    "flash_backup_url":null,
                    "last_modified":"2014-05-12 20:17:03",
                    "is_control":false,
                    "allow_audit":false,
                    "is_expired":false,
                    "creative_upload_status":null,
                    "backup_upload_status":null,
                    "use_dynamic_click_url":false,
                    "media_subtypes":[
                        "banner"
                    ],
                    "size_in_bytes":0,
                    "google_audit_status":"no_audit",
                    "google_audit_feedback":null,
                    "msft_audit_status":"no_audit",
                    "msft_audit_feedback":null,
                    "msft_external_audit_status":"no_audit",
                    "msft_external_audit_feedback":null,
                    "is_self_audited":true,
                    "no_adservers":false,
                    "text_title":null,
                    "text_description":null,
                    "text_display_url":null,
                    "click_action":"click-to-web",
                    "click_target":null,
                    "ssl_status":"disabled",
                    "allow_ssl_audit":false,
                    "media_url_secure":null,
                    "content_secure":null,
                    "original_content_secure":null,
                    "flash_backup_url_secure":null,
                    "is_hosted":false,
                    "content_source":"mediation",
                    "landing_page_url":null,
                    "thirdparty_creative_id":null,
                    "thirdparty_campaign_id":null,
                    "facebook_audit_status":null,
                    "facebook_audit_feedback":null,
                    "custom_request_template":{
                        "id":"1",
                        "timeout_ms":"200",
                        "last_modified":"2014-05-12 20:17:03"
                    },
                    "language":{
                        "id":1,
                        "name":"English"
                    },
                    "pop_values":null,
                    "brand":{
                        "id":184949,
                        "name":"InMobi",
                        "category_id":53
                    },
                    "template":{
                        "id":5,
                        "name":"Standard",
                        "media_subtype_id":1,
                        "format_id":5
                    },
                    "thirdparty_page":null,
                    "custom_macros":[
                        {
                            "code":"MK_SITEID",
                            "value":"sdfd"
                        }
                    ],
                    "segments":null,
                    "folder":null,
                    "line_items":null,
                    "competitive_brands":null,
                    "competitive_categories":null,
                    "pixels":null,
                    "mobile":null,
                    "sla":null,
                    "sla_eta":null,
                    "currency":"USD"
                }
            },
            {
                "id":893,
                "type":"mobile",
                "name":"test a",
                "active":true,
                "member_id":4371,
                "line_item_id":186590,
                "campaign_id":421869,
                "creative_id":838631,
                "profile_id":358980,
                "suggested_bid_price": null,
                "suggested_bid_price_confidence": null,
               Â "last_modified":"2014-05-12 23:18:37",
                "mediated_network":{
                    "id":456,
                    "advertiser_id":111309,
                    "name":"Jumptap",
                    "creative_custom_request_partner_id":42,
                    "active":true
                },
                "campaign":{
                    "id":421869,
                    "state":"active",
                    "parent_inactive":false,
                    "code":null,
                    "advertiser_id":111309,
                    "line_item_id":186590,
                    "creative_id":838631,
                    "pixel_id":null,
                    "short_name":null,
                    "name":"",
                    "profile_id":358980,
                    "start_date":"2014-05-12 00:00:00",
                    "end_date":null,
                    "timezone":"EST5EDT",
                    "priority":5,
                    "cadence_modifier_enabled":false,
                    "cpc_goal":null,
                    "cpm_bid_type":"margin",
                    "base_bid":null,
                    "min_bid":null,
                    "max_bid":null,
                    "bid_margin":0,
                    "roadblock_creatives":false,
                    "roadblock_type":"no_roadblock",
                    "inventory_type":"direct",
                    "last_modified":"2014-05-12 21:19:59",
                    "max_learn_bid":null,
                    "cadence_type":"advertiser",
                    "member_id":4371,
                    "click_url":null,
                    "require_cookie_for_tracking":true,
                    "allow_unverified_ecp":false,
                    "defer_to_li_prediction":false,
                    "ecp_learn_divisor":null,
                    "projected_learn_events":null,
                    "confidence_threshold":null,
                    "learn_threshold":3,
                    "cpc_payout":null,
                    "comments":null,
                    "optimization_lever_mode":"automatic",
                    "optimization_version":"v7",
                    "learn_override_type":null,
                    "base_cpm_bid_value":null,
                    "impression_limit":40000,
                    "bid_multiplier":1,
                    "is_malicious":false,
                    "remaining_days":null,
                    "total_days":null,
                    "supply_type":"mobile_app",
                    "creatives":[
                        {
                            "id":838631,
                            "mapping_state":"active",
                            "code":null,
                            "name":null,
                            "width":468,
                            "height":60,
                            "state":"active",
                            "audit_status":"no_audit",
                            "is_expired":false,
                            "is_prohibited":false,
                            "is_self_audited":true,
                            "format":"raw-js",
                            "pop_window_maximize":null
                        }
                    ],
                    "pixels":null,
                    "optimization_lookback":null,
                    "campaign_modifiers":null,
                    "labels":null,
                    "broker_fees":null,
                    "valuation":null,
                    "lifetime_budget":null,
                    "lifetime_budget_imps":null,
                    "daily_budget":null,
                    "daily_budget_imps":null,
                    "enable_pacing":null,
                    "lifetime_pacing":null,
                    "lifetime_pacing_span":null,
                    "allow_safety_pacing":null
                },
                "line-item":{
                    "id":186590,
                    "code":null,
                    "name":"test a",
                    "advertiser_id":111309,
                    "state":"active",
                    "start_date":null,
                    "end_date":null,
                    "timezone":"EST5EDT",
                    "discrepancy_pct":0,
                    "publishers_allowed":"all",
                    "revenue_value":1.5,
                    "revenue_type":"cpm",
                    "goal_type":"none",
                    "goal_value":null,
                    "last_modified":"2014-05-12 23:18:37",
                    "click_url":null,
                    "currency":"USD",
                    "require_cookie_for_tracking":true,
                    "profile_id":null,
                    "member_id":4371,
                    "comments":null,
                    "is_malicious":false,
                    "remaining_days":null,
                    "total_days":null,
                    "manage_creative":false,
                    "advertiser":{
                        "id":111309,
                        "name":"Jumptap"
                    },
                    "flat_fee":null,
                    "labels":null,
                    "broker_fees":null,
                    "pixels":null,
                    "insertion_orders":null,
                    "goal_pixels":null,
                    "imptrackers":null,
                    "clicktrackers":null,
                    "campaigns":[
                        {
                            "id":421869,
                            "name":"",
                            "inventory_type":"direct",
                            "state":"active",
                            "cpm_bid_type":"margin"
                        }
                    ],
                    "valuation":null,
                    "creatives":null,
                    "lifetime_budget":null,
                    "lifetime_budget_imps":null,
                    "daily_budget":null,
                    "daily_budget_imps":null,
                    "enable_pacing":null,
                    "lifetime_pacing":null,
                    "lifetime_pacing_span":null,
                    "allow_safety_pacing":null
                },
                "profile":{
                    "id":358980,
                    "code":null,
                    "description":null,
                    "country_action":"exclude",
                    "region_action":"exclude",
                    "city_action":"exclude",
                    "browser_action":"exclude",
                    "use_inventory_attribute_targets":false,
                    "last_modified":"2014-05-12 21:19:59",
                    "daypart_timezone":null,
                    "dma_action":"exclude",
                    "domain_action":"exclude",
                    "domain_list_action":"exclude",
                    "inventory_action":"exclude",
                    "language_action":"exclude",
                    "segment_boolean_operator":"and",
                    "min_session_imps":null,
                    "session_freq_type":"platform",
                    "carrier_action":"exclude",
                    "supply_type_action":"include",
                    "device_type_action":"exclude",
                    "screen_size_action":"exclude",
                    "device_model_action":"exclude",
                    "location_target_radius":null,
                    "location_target_latitude":null,
                    "location_target_longitude":null,
                    "querystring_action":"exclude",
                    "querystring_boolean_operator":"and",
                    "is_expired":false,
                    "non_audited_url_action":"include",
                    "daypart_bitmap":null,
                    "advertiser_id":111309,
                    "publisher_id":null,
                    "max_session_imps":null,
                    "max_day_imps":null,
                    "max_lifetime_imps":null,
                    "max_page_imps":null,
                    "min_minutes_per_imp":null,
                    "venue_action":"exclude",
                    "operating_system_action":"exclude",
                    "require_cookie_for_freq_cap":true,
                    "trust":"seller",
                    "allow_unaudited":true,
                    "is_template":false,
                    "created_on":"2014-05-12 21:19:59",
                    "operating_system_family_action":"exclude",
                    "use_operating_system_extended_targeting":true,
                    "mobile_app_instance_action_include":false,
                    "mobile_app_instance_list_action_include":false,
                    "user_group_targets":null,
                    "country_targets":null,
                    "region_targets":null,
                    "city_targets":null,
                    "inv_class_targets":null,
                    "inventory_source_targets":null,
                    "inventory_attribute_targets":null,
                    "age_targets":null,
                    "daypart_targets":null,
                    "browser_targets":null,
                    "browser_family_targets":null,
                    "dma_targets":null,
                    "domain_targets":null,
                    "domain_list_targets":null,
                    "language_targets":null,
                    "size_targets":null,
                    "zip_targets":null,
                    "member_targets":null,
                    "segment_group_targets":null,
                    "carrier_targets":null,
                    "supply_type_targets":[
                        "mobile_app",
                        "mobile_web"
                    ],
                    "device_type_targets":null,
                    "screen_size_targets":null,
                    "device_model_targets":null,
                    "querystring_targets":null,
                    "gender_targets":null,
                    "intended_audience_targets":null,
                    "inventory_group_targets":null,
                    "inventory_network_resold_targets":null,
                    "ip_targets":null,
                    "operating_system_targets":null,
                    "operating_system_family_targets":null,
                    "position_targets":null,
                    "site_targets":null,
                    "venue_targets":null,
                    "operating_system_extended_targets":null,
                    "mobile_app_instance_targets":null,
                    "mobile_app_instance_list_targets":null,
                    "content_category_targets":null,
                    "deal_targets":null,
                    "placement_targets":[
                        {
                            "id":1424815,
                            "action":"include",
                            "name":"Test Placement",
                            "deleted":false,
                            "site_id":281085,
                            "site_name":"Test App",
                            "publisher_id":147771,
                            "publisher_name":"Publisher A"
                        }
                    ],
                    "platform_content_category_targets":null,
                    "platform_placement_targets":null,
                    "platform_publisher_targets":null,
                    "publisher_targets":null,
                    "segment_targets":null,
                    "exelate_targets":null,
                    "ip_range_list_targets":null
                },
                "creative":{
                    "name":null,
                    "brand_id":184951,
                    "media_url":null,
                    "id":838631,
                    "code":null,
                    "code2":null,
                    "member_id":4371,
                    "state":"active",
                    "click_track_result":"not_tested",
                    "advertiser_id":111309,
                    "publisher_id":null,
                    "format":"raw-js",
                    "width":468,
                    "height":60,
                    "click_url":null,
                    "flash_click_variable":null,
                    "no_iframes":false,
                    "content":"document.write(\"\");",
                    "original_content":"no-tag",
                    "file_name":null,
                    "track_clicks":true,
                    "audit_status":"no_audit",
                    "macros":null,
                    "profile_id":null,
                    "audit_feedback":null,
                    "is_prohibited":false,
                    "is_suspicious":false,
                    "created_on":"2014-05-12 21:19:59",
                    "flash_backup_url":null,
                    "last_modified":"2014-05-12 21:19:59",
                    "is_control":false,
                    "allow_audit":false,
                    "is_expired":false,
                    "creative_upload_status":null,
                    "backup_upload_status":null,
                    "use_dynamic_click_url":false,
                    "media_subtypes":[
                        "banner"
                    ],
                    "size_in_bytes":0,
                    "google_audit_status":"no_audit",
                    "google_audit_feedback":null,
                    "msft_audit_status":"no_audit",
                    "msft_audit_feedback":null,
                    "msft_external_audit_status":"no_audit",
                    "msft_external_audit_feedback":null,
                    "is_self_audited":true,
                    "no_adservers":false,
                    "text_title":null,
                    "text_description":null,
                    "text_display_url":null,
                    "click_action":"click-to-web",
                    "click_target":null,
                    "ssl_status":"disabled",
                    "allow_ssl_audit":false,
                    "media_url_secure":null,
                    "content_secure":null,
                    "original_content_secure":null,
                    "flash_backup_url_secure":null,
                    "is_hosted":false,
                    "content_source":"mediation",
                    "landing_page_url":null,
                    "thirdparty_creative_id":null,
                    "thirdparty_campaign_id":null,
                    "facebook_audit_status":null,
                    "facebook_audit_feedback":null,
                    "custom_request_template":{
                        "id":"4",
                        "timeout_ms":"200",
                        "last_modified":"2014-05-12 21:19:59"
                    },
                    "language":{
                        "id":1,
                        "name":"English"
                    },
                    "pop_values":null,
                    "brand":{
                        "id":184951,
                        "name":"Jumptap",
                        "category_id":53
                    },
                    "template":{
                        "id":5,
                        "name":"Standard",
                        "media_subtype_id":1,
                        "format_id":5
                    },
                    "thirdparty_page":null,
                    "custom_macros":[
                        {
                            "code":"PUB",
                            "value":"sdf"
                        },
                        {
                            "code":"SITE",
                            "value":"sf"
                        },
                        {
                            "code":"SPOT",
                            "value":"sdf"
                        }
                    ],
                    "segments":null,
                    "folder":null,
                    "line_items":null,
                    "competitive_brands":null,
                    "competitive_categories":null,
                    "pixels":null,
                    "mobile":null,
                    "sla":null,
                    "sla_eta":null,
                    "currency":"USD"
                }
            },
            {
                "id":894,
                "type":"mobile",
                "name":"Anybody home?",
                "active":true,
                "member_id":4371,
                "line_item_id":186595,
                "campaign_id":421875,
                "creative_id":838641,
                "profile_id":358987,
                "suggested_bid_price": null,
                "suggested_bid_price_confidence": null,
               Â "last_modified":"2014-05-22 18:03:53",
                "mediated_network":{
                    "id":457,
                    "advertiser_id":111313,
                    "name":"Apple iAd",
                    "creative_custom_request_partner_id":34,
                    "active":true
                },
                "campaign":{
                    "id":421875,
                    "state":"active",
                    "parent_inactive":false,
                    "code":null,
                    "advertiser_id":111313,
                    "line_item_id":186595,
                    "creative_id":838641,
                    "pixel_id":null,
                    "short_name":null,
                    "name":"",
                    "profile_id":358987,
                    "start_date":"2014-05-12 00:00:00",
                    "end_date":null,
                    "timezone":"EST5EDT",
                    "priority":5,
                    "cadence_modifier_enabled":false,
                    "cpc_goal":null,
                    "cpm_bid_type":"margin",
                    "base_bid":null,
                    "min_bid":null,
                    "max_bid":null,
                    "bid_margin":0,
                    "roadblock_creatives":false,
                    "roadblock_type":"no_roadblock",
                    "inventory_type":"direct",
                    "last_modified":"2014-05-22 18:03:53",
                    "max_learn_bid":null,
                    "cadence_type":"advertiser",
                    "member_id":4371,
                    "click_url":null,
                    "require_cookie_for_tracking":true,
                    "allow_unverified_ecp":false,
                    "defer_to_li_prediction":false,
                    "ecp_learn_divisor":null,
                    "projected_learn_events":null,
                    "confidence_threshold":null,
                    "learn_threshold":3,
                    "cpc_payout":null,
                    "comments":null,
                    "optimization_lever_mode":"automatic",
                    "optimization_version":"v7",
                    "learn_override_type":null,
                    "base_cpm_bid_value":null,
                    "impression_limit":40000,
                    "bid_multiplier":1,
                    "is_malicious":false,
                    "remaining_days":null,
                    "total_days":null,
                    "supply_type":"mobile_app",
                    "creatives":[
                        {
                            "id":838641,
                            "mapping_state":"active",
                            "code":null,
                            "name":null,
                            "width":320,
                            "height":50,
                            "state":"active",
                            "audit_status":"no_audit",
                            "is_expired":false,
                            "is_prohibited":false,
                            "is_self_audited":true,
                            "format":"raw-js",
                            "pop_window_maximize":null
                        }
                    ],
                    "pixels":null,
                    "optimization_lookback":null,
                    "campaign_modifiers":null,
                    "labels":null,
                    "broker_fees":null,
                    "valuation":null,
                    "lifetime_budget":null,
                    "lifetime_budget_imps":null,
                    "daily_budget":null,
                    "daily_budget_imps":null,
                    "enable_pacing":null,
                    "lifetime_pacing":null,
                    "lifetime_pacing_span":null,
                    "allow_safety_pacing":null
                },
                "line-item":{
                    "id":186595,
                    "code":null,
                    "name":"Anybody home?",
                    "advertiser_id":111313,
                    "state":"active",
                    "start_date":null,
                    "end_date":null,
                    "timezone":"EST5EDT",
                    "discrepancy_pct":0,
                    "publishers_allowed":"all",
                    "revenue_value":1,
                    "revenue_type":"cpm",
                    "goal_type":"none",
                    "goal_value":null,
                    "last_modified":"2014-05-22 18:03:53",
                    "click_url":null,
                    "currency":"USD",
                    "require_cookie_for_tracking":true,
                    "profile_id":null,
                    "member_id":4371,
                    "comments":null,
                    "is_malicious":false,
                    "remaining_days":null,
                    "total_days":null,
                    "manage_creative":false,
                    "advertiser":{
                        "id":111313,
                        "name":"Apple iAd"
                    },
                    "flat_fee":null,
                    "labels":null,
                    "broker_fees":null,
                    "pixels":null,
                    "insertion_orders":null,
                    "goal_pixels":null,
                    "imptrackers":null,
                    "clicktrackers":null,
                    "campaigns":[
                        {
                            "id":421875,
                            "name":"",
                            "inventory_type":"direct",
                            "state":"active",
                            "cpm_bid_type":"margin"
                        }
                    ],
                    "valuation":null,
                    "creatives":null,
                    "lifetime_budget":null,
                    "lifetime_budget_imps":null,
                    "daily_budget":null,
                    "daily_budget_imps":null,
                    "enable_pacing":null,
                    "lifetime_pacing":null,
                    "lifetime_pacing_span":null,
                    "allow_safety_pacing":null
                },
                "profile":{
                    "id":358987,
                    "code":null,
                    "description":null,
                    "country_action":"exclude",
                    "region_action":"exclude",
                    "city_action":"exclude",
                    "browser_action":"exclude",
                    "use_inventory_attribute_targets":false,
                    "last_modified":"2014-05-22 18:03:53",
                    "daypart_timezone":null,
                    "dma_action":"exclude",
                    "domain_action":"exclude",
                    "domain_list_action":"exclude",
                    "inventory_action":"exclude",
                    "language_action":"exclude",
                    "segment_boolean_operator":"and",
                    "min_session_imps":null,
                    "session_freq_type":"platform",
                    "carrier_action":"exclude",
                    "supply_type_action":"include",
                    "device_type_action":"exclude",
                    "screen_size_action":"exclude",
                    "device_model_action":"exclude",
                    "location_target_radius":null,
                    "location_target_latitude":null,
                    "location_target_longitude":null,
                    "querystring_action":"exclude",
                    "querystring_boolean_operator":"and",
                    "is_expired":false,
                    "non_audited_url_action":"include",
                    "daypart_bitmap":null,
                    "advertiser_id":111313,
                    "publisher_id":null,
                    "max_session_imps":null,
                    "max_day_imps":null,
                    "max_lifetime_imps":1,
                    "max_page_imps":null,
                    "min_minutes_per_imp":null,
                    "venue_action":"exclude",
                    "operating_system_action":"exclude",
                    "require_cookie_for_freq_cap":false,
                    "trust":"seller",
                    "allow_unaudited":true,
                    "is_template":false,
                    "created_on":"2014-05-22 18:03:53",
                    "operating_system_family_action":"exclude",
                    "use_operating_system_extended_targeting":true,
                    "mobile_app_instance_action_include":false,
                    "mobile_app_instance_list_action_include":false,
                    "user_group_targets":null,
                    "country_targets":null,
                    "region_targets":null,
                    "city_targets":null,
                    "inv_class_targets":null,
                    "inventory_source_targets":null,
                    "inventory_attribute_targets":null,
                    "age_targets":null,
                    "daypart_targets":null,
                    "browser_targets":null,
                    "browser_family_targets":null,
                    "dma_targets":null,
                    "domain_targets":null,
                    "domain_list_targets":null,
                    "language_targets":null,
                    "size_targets":null,
                    "zip_targets":null,
                    "member_targets":null,
                    "segment_group_targets":null,
                    "carrier_targets":null,
                    "supply_type_targets":[
                        "mobile_app",
                        "mobile_web"
                    ],
                    "device_type_targets":null,
                    "screen_size_targets":null,
                    "device_model_targets":null,
                    "querystring_targets":null,
                    "gender_targets":null,
                    "intended_audience_targets":null,
                    "inventory_group_targets":null,
                    "inventory_network_resold_targets":null,
                    "ip_targets":null,
                    "operating_system_targets":null,
                    "operating_system_family_targets":null,
                    "position_targets":null,
                    "site_targets":null,
                    "venue_targets":null,
                    "operating_system_extended_targets":null,
                    "mobile_app_instance_targets":null,
                    "mobile_app_instance_list_targets":null,
                    "content_category_targets":null,
                    "deal_targets":null,
                    "placement_targets":[
                        {
                            "id":1424815,
                            "action":"include",
                            "name":"Test Placement",
                            "deleted":false,
                            "site_id":281085,
                            "site_name":"Test App",
                            "publisher_id":147771,
                            "publisher_name":"Publisher A"
                        }
                    ],
                    "platform_content_category_targets":null,
                    "platform_placement_targets":null,
                    "platform_publisher_targets":null,
                    "publisher_targets":null,
                    "segment_targets":null,
                    "exelate_targets":null,
                    "ip_range_list_targets":null
                },
                "creative":{
                    "name":null,
                    "brand_id":184948,
                    "media_url":null,
                    "id":838641,
                    "code":null,
                    "code2":null,
                    "member_id":4371,
                    "state":"active",
                    "click_track_result":"not_tested",
                    "advertiser_id":111313,
                    "publisher_id":null,
                    "format":"raw-js",
                    "width":320,
                    "height":50,
                    "click_url":null,
                    "flash_click_variable":null,
                    "no_iframes":false,
                    "content":"document.write(\"\");",
                    "original_content":"no-tag",
                    "file_name":null,
                    "track_clicks":true,
                    "audit_status":"no_audit",
                    "macros":null,
                    "profile_id":null,
                    "audit_feedback":null,
                    "is_prohibited":false,
                    "is_suspicious":false,
                    "created_on":"2014-05-12 21:42:01",
                    "flash_backup_url":null,
                    "last_modified":"2014-05-22 18:03:53",
                    "is_control":false,
                    "allow_audit":false,
                    "is_expired":false,
                    "creative_upload_status":null,
                    "backup_upload_status":null,
                    "use_dynamic_click_url":false,
                    "media_subtypes":[
                        "banner"
                    ],
                    "size_in_bytes":0,
                    "google_audit_status":"no_audit",
                    "google_audit_feedback":null,
                    "msft_audit_status":"no_audit",
                    "msft_audit_feedback":null,
                    "msft_external_audit_status":"no_audit",
                    "msft_external_audit_feedback":null,
                    "is_self_audited":true,
                    "no_adservers":false,
                    "text_title":null,
                    "text_description":null,
                    "text_display_url":null,
                    "click_action":"click-to-web",
                    "click_target":null,
                    "ssl_status":"disabled",
                    "allow_ssl_audit":false,
                    "media_url_secure":null,
                    "content_secure":null,
                    "original_content_secure":null,
                    "flash_backup_url_secure":null,
                    "is_hosted":false,
                    "content_source":"mediation",
                    "landing_page_url":null,
                    "thirdparty_creative_id":null,
                    "thirdparty_campaign_id":null,
                    "facebook_audit_status":null,
                    "facebook_audit_feedback":null,
                    "custom_request_template":{
                        "id":"25",
                        "timeout_ms":"0",
                        "last_modified":"2014-05-12 21:42:01"
                    },
                    "language":{
                        "id":1,
                        "name":"English"
                    },
                    "pop_values":null,
                    "brand":{
                        "id":184948,
                        "name":"iAds",
                        "category_id":53
                    },
                    "template":{
                        "id":5,
                        "name":"Standard",
                        "media_subtype_id":1,
                        "format_id":5
                    },
                    "thirdparty_page":null,
                    "custom_macros":null,
                    "segments":null,
                    "folder":null,
                    "line_items":null,
                    "competitive_brands":null,
                    "competitive_categories":null,
                    "pixels":null,
                    "mobile":null,
                    "sla":null,
                    "sla_eta":null,
                    "currency":"USD"
                }
            }
        ]
    }
}

Create a bid

$ cat add-mediated-bid.json

{
    "mediated-bid": {
        "campaign": {},
        "creative": {
            "brand_id": 1,
            "click_url": "http://www.example.org/click",
            "content": "content is usually the third party tag",
            "custom_macros": [
                {
                    "code": "PUB",
                    "value": "sdf"
                }, 
                {
                    "code": "SITE",
                    "value": "sf"
                }, 
                {
                    "code": "SPOT",
                    "value": "sdf"
                }
            ], 
            "custom_request_template": {
                "id": "4",
                "timeout_ms": "200"
            }, 
            "height": 250,
            "media_url": "http://ad.doubleclick.net/ad/N4677.Yahoo/B2353613.54;sz=300x250;ord=timestamp?", 
            "template": {
                "id": 5
            }, 
            "width": 300
        }, 
        "line-item": {
          "name":"9D1aJ56930T43141SFt"
        },
        "mediated_network_id": 319,
        "name": "9D1aJ56930T43141SFt",
        "profile": {},
        "type": "mobile"
    }
}

$ curl -b cookies -X POST -d @add-mediated-bid.json 'https://api.appnexus.com/mediated-bid?member_id=4209&advertiser_id=110466' 

{
    "response":{
        "status":"OK",
        "count":1,
        "id":953,
        "start_element":0,
        "num_elements":100,
        "mediated-bid":{
            "id":953,
            "type":"mobile",
            "name":"9D1aJ56930T43141SFt",
            "active":false,
            "member_id":4209,
            "line_item_id":188540,
            "campaign_id":425871,
            "creative_id":843561,
            "profile_id":363989,
            "last_modified":"2014-06-10 13:56:29",
            "mediated_network":{
                "id":319,
                "advertiser_id":110466,
                "name":"Integration Test TEST1398193369027",
                "creative_custom_request_partner_id":1,
                "active":false
            },
            "campaign":{
                "id":425871,
                "state":"active",
                "parent_inactive":true,
                "code":null,
                "advertiser_id":110466,
                "line_item_id":188540,
                "creative_id":843561,
                "pixel_id":null,
                "short_name":null,
                "name":"",
                "profile_id":363989,
                "start_date":null,
                "end_date":null,
                "timezone":"EST5EDT",
                "priority":5,
                "cadence_modifier_enabled":false,
                "cpc_goal":null,
                "cpm_bid_type":"margin",
                "base_bid":null,
                "min_bid":null,
                "max_bid":null,
                "bid_margin":0,
                "roadblock_creatives":false,
                "roadblock_type":"no_roadblock",
                "inventory_type":"direct",
                "last_modified":"2014-06-10 13:56:29",
                "max_learn_bid":null,
                "cadence_type":"advertiser",
                "member_id":4209,
                "click_url":null,
                "require_cookie_for_tracking":true,
                "allow_unverified_ecp":false,
                "defer_to_li_prediction":false,
                "ecp_learn_divisor":null,
                "projected_learn_events":null,
                "confidence_threshold":null,
                "learn_threshold":3,
                "cpc_payout":null,
                "comments":null,
                "optimization_lever_mode":"automatic",
                "optimization_version":"v7",
                "learn_override_type":null,
                "base_cpm_bid_value":null,
                "impression_limit":40000,
                "bid_multiplier":1,
                "is_malicious":false,
                "remaining_days":null,
                "total_days":null,
                "supply_type":"mobile_app",
                "creatives":[
                    {
                        "id":843561,
                        "mapping_state":"active",
                        "code":null,
                        "name":null,
                        "width":300,
                        "height":250,
                        "state":"active",
                        "audit_status":"no_audit",
                        "is_expired":false,
                        "is_prohibited":false,
                        "is_self_audited":true,
                        "format":"raw-js",
                        "pop_window_maximize":null
                    }
                ],
                "pixels":null,
                "optimization_lookback":null,
                "campaign_modifiers":null,
                "labels":null,
                "broker_fees":null,
                "valuation":null,
                "lifetime_budget":null,
                "lifetime_budget_imps":null,
                "daily_budget":null,
                "daily_budget_imps":null,
                "enable_pacing":null,
                "lifetime_pacing":null,
                "lifetime_pacing_span":null,
                "allow_safety_pacing":null
            },
            "line-item":{
                "id":188540,
                "code":null,
                "name":null,
                "advertiser_id":110466,
                "state":"inactive",
                "start_date":null,
                "end_date":null,
                "timezone":"EST5EDT",
                "discrepancy_pct":0,
                "publishers_allowed":"all",
                "revenue_value":0,
                "revenue_type":"cpm",
                "goal_type":"none",
                "goal_value":null,
                "last_modified":"2014-06-10 13:56:29",
                "click_url":null,
                "currency":"USD",
                "require_cookie_for_tracking":true,
                "profile_id":null,
                "member_id":4209,
                "comments":null,
                "is_malicious":false,
                "remaining_days":null,
                "total_days":null,
                "manage_creative":false,
                "advertiser":{
                    "id":110466,
                    "name":"Integration Test TEST1398193369027"
                },
                "flat_fee":null,
                "labels":null,
                "broker_fees":null,
                "pixels":null,
                "insertion_orders":null,
                "goal_pixels":null,
                "imptrackers":null,
                "clicktrackers":null,
                "campaigns":[
                    {
                        "id":425871,
                        "name":"",
                        "inventory_type":"direct",
                        "state":"parent_inactive",
                        "cpm_bid_type":"margin"
                    }
                ],
                "valuation":null,
                "creatives":null,
                "lifetime_budget":null,
                "lifetime_budget_imps":null,
                "daily_budget":null,
                "daily_budget_imps":null,
                "enable_pacing":null,
                "lifetime_pacing":null,
                "lifetime_pacing_span":null,
                "allow_safety_pacing":null
            },
            "profile":{
                "id":363989,
                "code":null,
                "description":null,
                "country_action":"exclude",
                "region_action":"exclude",
                "city_action":"exclude",
                "browser_action":"exclude",
                "use_inventory_attribute_targets":false,
                "last_modified":"2014-06-10 13:56:29",
                "daypart_timezone":null,
                "dma_action":"exclude",
                "domain_action":"exclude",
                "domain_list_action":"exclude",
                "inventory_action":"exclude",
                "language_action":"exclude",
                "segment_boolean_operator":"and",
                "min_session_imps":null,
                "session_freq_type":"platform",
                "carrier_action":"exclude",
                "supply_type_action":"include",
                "device_type_action":"exclude",
                "screen_size_action":"exclude",
                "device_model_action":"exclude",
                "location_target_radius":null,
                "location_target_latitude":null,
                "location_target_longitude":null,
                "querystring_action":"exclude",
                "querystring_boolean_operator":"and",
                "is_expired":false,
                "non_audited_url_action":"include",
                "daypart_bitmap":null,
                "advertiser_id":110466,
                "publisher_id":null,
                "max_session_imps":null,
                "max_day_imps":null,
                "max_lifetime_imps":null,
                "max_page_imps":null,
                "min_minutes_per_imp":null,
                "venue_action":"exclude",
                "operating_system_action":"exclude",
                "require_cookie_for_freq_cap":false,
                "trust":"seller",
                "allow_unaudited":true,
                "is_template":false,
                "created_on":"2014-06-10 13:56:29",
                "operating_system_family_action":"exclude",
                "use_operating_system_extended_targeting":false,
                "mobile_app_instance_action_include":false,
                "mobile_app_instance_list_action_include":false,
                "user_group_targets":null,
                "country_targets":null,
                "region_targets":null,
                "city_targets":null,
                "inv_class_targets":null,
                "inventory_source_targets":null,
                "inventory_attribute_targets":null,
                "age_targets":null,
                "daypart_targets":null,
                "browser_targets":null,
                "browser_family_targets":null,
                "dma_targets":null,
                "domain_targets":null,
                "domain_list_targets":null,
                "language_targets":null,
                "size_targets":null,
                "zip_targets":null,
                "member_targets":null,
                "segment_group_targets":null,
                "carrier_targets":null,
                "supply_type_targets":[
                    "mobile_app",
                    "mobile_web"
                ],
                "device_type_targets":null,
                "screen_size_targets":null,
                "device_model_targets":null,
                "querystring_targets":null,
                "gender_targets":null,
                "intended_audience_targets":null,
                "inventory_group_targets":null,
                "inventory_network_resold_targets":null,
                "ip_targets":null,
                "operating_system_targets":null,
                "operating_system_family_targets":null,
                "position_targets":null,
                "site_targets":null,
                "venue_targets":null,
                "operating_system_extended_targets":null,
                "mobile_app_instance_targets":null,
                "mobile_app_instance_list_targets":null,
                "content_category_targets":null,
                "deal_targets":null,
                "placement_targets":null,
                "platform_content_category_targets":null,
                "platform_placement_targets":null,
                "platform_publisher_targets":null,
                "publisher_targets":null,
                "segment_targets":null,
                "exelate_targets":null,
                "ip_range_list_targets":null
            },
            "creative":{
                "name":null,
                "brand_id":1,
                "media_url":"http:\/\/ad.doubleclick.net\/ad\/N4677.Yahoo\/B2353613.54;sz=300x250;ord=timestamp?",
                "id":843561,
                "code":null,
                "code2":null,
                "member_id":4209,
                "state":"active",
                "click_track_result":"not_tested",
                "advertiser_id":110466,
                "publisher_id":null,
                "format":"raw-js",
                "width":300,
                "height":250,
                "click_url":"http:\/\/www.example.org\/click",
                "flash_click_variable":null,
                "no_iframes":true,
                "content":"document.write(\"\");",
                "original_content":"no-tag",
                "file_name":null,
                "track_clicks":true,
                "audit_status":"no_audit",
                "macros":null,
                "profile_id":null,
                "audit_feedback":null,
                "is_prohibited":false,
                "is_suspicious":false,
                "created_on":"2014-06-10 13:56:29",
                "flash_backup_url":null,
                "last_modified":"2014-06-10 13:56:29",
                "is_control":false,
                "allow_audit":false,
                "is_expired":false,
                "creative_upload_status":null,
                "backup_upload_status":null,
                "use_dynamic_click_url":false,
                "media_subtypes":[
                    "banner"
                ],
                "size_in_bytes":0,
                "google_audit_status":"no_audit",
                "google_audit_feedback":null,
                "msft_audit_status":"no_audit",
                "msft_audit_feedback":null,
                "msft_external_audit_status":"no_audit",
                "msft_external_audit_feedback":null,
                "is_self_audited":true,
                "no_adservers":false,
                "text_title":null,
                "text_description":null,
                "text_display_url":null,
                "click_action":"click-to-web",
                "click_target":"http:\/\/www.example.org\/click",
                "ssl_status":"disabled",
                "allow_ssl_audit":false,
                "media_url_secure":null,
                "content_secure":null,
                "original_content_secure":null,
                "flash_backup_url_secure":null,
                "is_hosted":false,
                "content_source":"mediation",
                "lifetime_budget_imps":null,
                "daily_budget_imps":null,
                "enable_pacing":null,
                "allow_safety_pacing":null,
                "lifetime_budget":null,
                "daily_budget":null,
                "landing_page_url":null,
                "thirdparty_creative_id":null,
                "thirdparty_campaign_id":null,
                "facebook_audit_status":null,
                "facebook_audit_feedback":null,
                "custom_request_template":{
                    "id":"4",
                    "timeout_ms":"200",
                    "last_modified":"2014-06-10 13:56:29"
                },
                "language":{
                    "id":1,
                    "name":"English"
                },
                "pop_values":null,
                "brand":{
                    "id":1,
                    "name":"Unknown",
                    "category_id":8
                },
                "template":{
                    "id":5,
                    "name":"Standard",
                    "media_subtype_id":1,
                    "format_id":5
                },
                "thirdparty_page":null,
                "custom_macros":[
                    {
                        "code":"PUB",
                        "value":"sdf"
                    },
                    {
                        "code":"SITE",
                        "value":"sf"
                    },
                    {
                        "code":"SPOT",
                        "value":"sdf"
                    }
                ],
                "segments":null,
                "folder":null,
                "campaigns":[
                    {
                        "id":425871,
                        "campaign_id":425871,
                        "creative_id":843561,
                        "name":"",
                        "state":"parent_inactive",
                        "code":null
                    }
                ],
                "line_items":null,
                "competitive_brands":null,
                "competitive_categories":null,
                "pixels":null,
                "mobile":null,
                "sla":null,
                "sla_eta":null,
                "currency":"USD"
            }
        }
    }
}

Update a bid

$ cat edit-mediated-bid.json

{
  "mediated-bid": 
  {
    "id": 953,
    "active": false
  }
}

$ curl -b cookies -X PUT -d @edit-mediated-bid.json 'https://api.appnexus.com/mediated-bid?member_id=4209&advertiser_id=110466'

{
    "response":{
        "status":"OK",
        "count":1,
        "id":953,
        "start_element":0,
        "num_elements":100,
        "mediated-bid":{
            "id":953,
            "type":"mobile",
            "name":"9D1aJ56930T43141SFt",
            "active":false,
            "member_id":4209,
            "line_item_id":188540,
            "campaign_id":425871,
            "creative_id":843561,
            "profile_id":363989,
            "suggested_bid_price": 25.4,
             "suggested_bid_price_confidence": 0.6,
             "last_modified":"2014-06-10 14:11:41",
            "mediated_network":{
                "id":319,
                "advertiser_id":110466,
                "name":"Integration Test TEST1398193369027",
                "creative_custom_request_partner_id":1,
                "active":false
            },
            "campaign":{
                "id":425871,
                "state":"active",
                "parent_inactive":true,
                "code":null,
                "advertiser_id":110466,
                "line_item_id":188540,
                "creative_id":843561,
                "pixel_id":null,
                "short_name":null,
                "name":"",
                "profile_id":363989,
                "start_date":null,
                "end_date":null,
                "timezone":"EST5EDT",
                "priority":5,
                "cadence_modifier_enabled":false,
                "cpc_goal":null,
                "cpm_bid_type":"margin",
                "base_bid":null,
                "min_bid":null,
                "max_bid":null,
                "bid_margin":0,
                "roadblock_creatives":false,
                "roadblock_type":"no_roadblock",
                "inventory_type":"direct",
                "last_modified":"2014-06-10 13:56:29",
                "max_learn_bid":null,
                "cadence_type":"advertiser",
                "member_id":4209,
                "click_url":null,
                "require_cookie_for_tracking":true,
                "allow_unverified_ecp":false,
                "defer_to_li_prediction":false,
                "ecp_learn_divisor":null,
                "projected_learn_events":null,
                "confidence_threshold":null,
                "learn_threshold":3,
                "cpc_payout":null,
                "comments":null,
                "optimization_lever_mode":"automatic",
                "optimization_version":"v7",
                "learn_override_type":null,
                "base_cpm_bid_value":null,
                "impression_limit":40000,
                "bid_multiplier":1,
                "is_malicious":false,
                "remaining_days":null,
                "total_days":null,
                "supply_type":"mobile_app",
                "creatives":[
                    {
                        "id":843561,
                        "mapping_state":"active",
                        "code":null,
                        "name":null,
                        "width":300,
                        "height":250,
                        "state":"active",
                        "audit_status":"no_audit",
                        "is_expired":false,
                        "is_prohibited":false,
                        "is_self_audited":true,
                        "format":"raw-js",
                        "pop_window_maximize":null
                    }
                ],
                "pixels":null,
                "optimization_lookback":null,
                "campaign_modifiers":null,
                "labels":null,
                "broker_fees":null,
                "valuation":null,
                "lifetime_budget":null,
                "lifetime_budget_imps":null,
                "daily_budget":null,
                "daily_budget_imps":null,
                "enable_pacing":null,
                "lifetime_pacing":null,
                "lifetime_pacing_span":null,
                "allow_safety_pacing":null
            },
            "line-item":{
                "id":188540,
                "code":null,
                "name":null,
                "advertiser_id":110466,
                "state":"inactive",
                "start_date":null,
                "end_date":null,
                "timezone":"EST5EDT",
                "discrepancy_pct":0,
                "publishers_allowed":"all",
                "revenue_value":0,
                "revenue_type":"cpm",
                "goal_type":"none",
                "goal_value":null,
                "last_modified":"2014-06-10 14:11:41",
                "click_url":null,
                "currency":"USD",
                "require_cookie_for_tracking":true,
                "profile_id":null,
                "member_id":4209,
                "comments":null,
                "is_malicious":false,
                "remaining_days":null,
                "total_days":null,
                "manage_creative":false,
                "advertiser":{
                    "id":110466,
                    "name":"Integration Test TEST1398193369027"
                },
                "flat_fee":null,
                "labels":null,
                "broker_fees":null,
                "pixels":null,
                "insertion_orders":null,
                "goal_pixels":null,
                "imptrackers":null,
                "clicktrackers":null,
                "campaigns":[
                    {
                        "id":425871,
                        "name":"",
                        "inventory_type":"direct",
                        "state":"parent_inactive",
                        "cpm_bid_type":"margin"
                    }
                ],
                "valuation":null,
                "creatives":null,
                "lifetime_budget":null,
                "lifetime_budget_imps":null,
                "daily_budget":null,
                "daily_budget_imps":null,
                "enable_pacing":null,
                "lifetime_pacing":null,
                "lifetime_pacing_span":null,
                "allow_safety_pacing":null
            },
            "profile":{
                "id":363989,
                "code":null,
                "description":null,
                "country_action":"exclude",
                "region_action":"exclude",
                "city_action":"exclude",
                "browser_action":"exclude",
                "use_inventory_attribute_targets":false,
                "last_modified":"2014-06-10 13:56:29",
                "daypart_timezone":null,
                "dma_action":"exclude",
                "domain_action":"exclude",
                "domain_list_action":"exclude",
                "inventory_action":"exclude",
                "language_action":"exclude",
                "segment_boolean_operator":"and",
                "min_session_imps":null,
                "session_freq_type":"platform",
                "carrier_action":"exclude",
                "supply_type_action":"include",
                "device_type_action":"exclude",
                "screen_size_action":"exclude",
                "device_model_action":"exclude",
                "location_target_radius":null,
                "location_target_latitude":null,
                "location_target_longitude":null,
                "querystring_action":"exclude",
                "querystring_boolean_operator":"and",
                "is_expired":false,
                "non_audited_url_action":"include",
                "daypart_bitmap":null,
                "advertiser_id":110466,
                "publisher_id":null,
                "max_session_imps":null,
                "max_day_imps":null,
                "max_lifetime_imps":null,
                "max_page_imps":null,
                "min_minutes_per_imp":null,
                "venue_action":"exclude",
                "operating_system_action":"exclude",
                "require_cookie_for_freq_cap":false,
                "trust":"seller",
                "allow_unaudited":true,
                "is_template":false,
                "created_on":"2014-06-10 13:56:29",
                "operating_system_family_action":"exclude",
                "use_operating_system_extended_targeting":false,
                "mobile_app_instance_action_include":false,
                "mobile_app_instance_list_action_include":false,
                "user_group_targets":null,
                "country_targets":null,
                "region_targets":null,
                "city_targets":null,
                "inv_class_targets":null,
                "inventory_source_targets":null,
                "inventory_attribute_targets":null,
                "age_targets":null,
                "daypart_targets":null,
                "browser_targets":null,
                "browser_family_targets":null,
                "dma_targets":null,
                "domain_targets":null,
                "domain_list_targets":null,
                "language_targets":null,
                "size_targets":null,
                "zip_targets":null,
                "member_targets":null,
                "segment_group_targets":null,
                "carrier_targets":null,
                "supply_type_targets":[
                    "mobile_app",
                    "mobile_web"
                ],
                "device_type_targets":null,
                "screen_size_targets":null,
                "device_model_targets":null,
                "querystring_targets":null,
                "gender_targets":null,
                "intended_audience_targets":null,
                "inventory_group_targets":null,
                "inventory_network_resold_targets":null,
                "ip_targets":null,
                "operating_system_targets":null,
                "operating_system_family_targets":null,
                "position_targets":null,
                "site_targets":null,
                "venue_targets":null,
                "operating_system_extended_targets":null,
                "mobile_app_instance_targets":null,
                "mobile_app_instance_list_targets":null,
                "content_category_targets":null,
                "deal_targets":null,
                "placement_targets":null,
                "platform_content_category_targets":null,
                "platform_placement_targets":null,
                "platform_publisher_targets":null,
                "publisher_targets":null,
                "segment_targets":null,
                "exelate_targets":null,
                "ip_range_list_targets":null
            },
            "creative":{
                "name":null,
                "brand_id":1,
                "media_url":"http:\/\/ad.doubleclick.net\/ad\/N4677.Yahoo\/B2353613.54;sz=300x250;ord=timestamp?",
                "id":843561,
                "code":null,
                "code2":null,
                "member_id":4209,
                "state":"active",
                "click_track_result":"not_tested",
                "advertiser_id":110466,
                "publisher_id":null,
                "format":"raw-js",
                "width":300,
                "height":250,
                "click_url":"http:\/\/www.example.org\/click",
                "flash_click_variable":null,
                "no_iframes":true,
                "content":"document.write(\"\");",
                "original_content":"no-tag",
                "file_name":null,
                "track_clicks":true,
                "audit_status":"no_audit",
                "macros":null,
                "profile_id":null,
                "audit_feedback":null,
                "is_prohibited":false,
                "is_suspicious":false,
                "created_on":"2014-06-10 13:56:29",
                "flash_backup_url":null,
                "last_modified":"2014-06-10 13:56:29",
                "is_control":false,
                "allow_audit":false,
                "is_expired":false,
                "creative_upload_status":null,
                "backup_upload_status":null,
                "use_dynamic_click_url":false,
                "media_subtypes":[
                    "banner"
                ],
                "size_in_bytes":0,
                "google_audit_status":"no_audit",
                "google_audit_feedback":null,
                "msft_audit_status":"no_audit",
                "msft_audit_feedback":null,
                "msft_external_audit_status":"no_audit",
                "msft_external_audit_feedback":null,
                "is_self_audited":true,
                "no_adservers":false,
                "text_title":null,
                "text_description":null,
                "text_display_url":null,
                "click_action":"click-to-web",
                "click_target":"http:\/\/www.example.org\/click",
                "ssl_status":"disabled",
                "allow_ssl_audit":false,
                "media_url_secure":null,
                "content_secure":null,
                "original_content_secure":null,
                "flash_backup_url_secure":null,
                "is_hosted":false,
                "content_source":"mediation",
                "lifetime_budget_imps":null,
                "daily_budget_imps":null,
                "enable_pacing":null,
                "allow_safety_pacing":null,
                "lifetime_budget":null,
                "daily_budget":null,
                "landing_page_url":null,
                "thirdparty_creative_id":null,
                "thirdparty_campaign_id":null,
                "facebook_audit_status":null,
                "facebook_audit_feedback":null,
                "custom_request_template":{
                    "id":"4",
                    "timeout_ms":"200",
                    "last_modified":"2014-06-10 13:56:29"
                },
                "language":{
                    "id":1,
                    "name":"English"
                },
                "pop_values":null,
                "brand":{
                    "id":1,
                    "name":"Unknown",
                    "category_id":8
                },
                "template":{
                    "id":5,
                    "name":"Standard",
                    "media_subtype_id":1,
                    "format_id":5
                },
                "thirdparty_page":null,
                "custom_macros":[
                    {
                        "code":"PUB",
                        "value":"sdf"
                    },
                    {
                        "code":"SITE",
                        "value":"sf"
                    },
                    {
                        "code":"SPOT",
                        "value":"sdf"
                    }
                ],
                "segments":null,
                "folder":null,
                "campaigns":[
                    {
                        "id":425871,
                        "campaign_id":425871,
                        "creative_id":843561,
                        "name":"",
                        "state":"parent_inactive",
                        "code":null
                    }
                ],
                "line_items":null,
                "competitive_brands":null,
                "competitive_categories":null,
                "pixels":null,
                "mobile":null,
                "sla":null,
                "sla_eta":null,
                "currency":"USD"
            }
        }
    }
}

Delete a bid

$ curl -b cookies -X DELETE 'https://api.appnexus.com/mediated-bid?member_id=4371&advertiser_id=111313&id=891' 

{
    "response":{
        "status":"OK",
        "count":1,
        "start_element":null,
        "num_elements":null
    }
}

Bids and campaign priorities

Mediated Bids have priority 5 in the auction, which is required for mediation to function. Any line items of lower priority will not compete unless the Networks do not return ads.

Back-end objects associated with Bids, such as augmented line items and campaigns, should not be modified directly. Use the Microsoft Monetize mediation Bids tab, or the Mediated Bid Service, detailed on this page, to manage bids. Changing the priority of the objects will break mediation.

When using the API, confirm the following:

  • Do not update advertisers, augmented line items, campaigns, or creatives with the words "Mediated" or "Mediation" in their names.
  • Creative used for mediation has the is_mediation flag set to true.
  • Before updating a line item or campaign, check its creatives array to confirm if one of the creatives is a mediation creative. If it's a mediation creative, do not update the line item or campaign.