{ "basePath": "/api/v2.0", "definitions": { "ad_server": { "example": { "entity_type": "ad_server", "id": 9, "name": "TerminalOne" }, "title": "Ad Server", "type": "object", "x-stoplight": { "id": "ad_server", "name": "ad_server", "public": true }, "properties": { "entity_type": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "version": { "type": "integer" } } }, "advertiser": { "example": { "accountable_and_addressable": false, "ad_server_id": 9, "agency_id": 122077, "allow_x_strat_optimization": false, "created_on": "2019-05-23T18:10:41+0000", "data_sharing_enabled": false, "dmp_enabled": "inherits", "domain": "https://www.roygbivintl.com/", "entity_type": "advertiser", "external_id": "Account #45612", "frequency_interval": "not-applicable", "frequency_type": "no-limit", "id": 225595, "minimize_multi_ads": false, "name": "Roy G Biv Intl.", "status": true, "updated_on": "2019-05-23T18:10:41+0000", "version": 0, "vertical_id": 5 }, "title": "Advertiser", "type": "object", "x-stoplight": { "id": "advertiser", "name": "Advertiser", "public": true }, "properties": { "accountable_and_addressable": { "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "ad_server_fee": { "description": "Fee charged by ad serving vendor", "type": "integer" }, "ad_server_id": { "description": "Enter ID for third-party adserver - refer to the \"Ad Servers\" page", "type": "integer" }, "agency_id": { "description": "T1 Agency ID to which an advertiser belongs (see \"API for Agencies\")", "type": "integer" }, "allow_x_strat_optimization": { "description": " \t\n\nThis option is only available if Cross-Advertiser Pacing has been enabled for the Agency. Cross-Advertiser pacing allows winning bids to be decided based on price AND pacing level. If two bids from participating Advertisers are competitive and the lower bid is from an under-pacing campaign, then the lower bid may win. If this field is set to No, this Advertiser will compete solely on bid price.", "type": "boolean" }, "billing_contact_id": { "description": "T1 id for person serving as billing contact. If desired, get list of valid names and IDs by making GET \"$API_BASE/contacts\" call.", "type": "integer" }, "created_on": { "type": "string" }, "dmp_enabled": { "type": "string" }, "domain": { "description": "The URL domain of the advertiser—for example, http://www.advertiser.com", "type": "string" }, "external_id": { "type": "string", "description": "External ID name of the advertiser", "maxLength": 255 }, "frequency_amount": { "description": "Maximum frequency of impressions per user within interval set on frequency_interval\n\nrequired if `frequency_typeis even or asap`.", "type": "integer" }, "frequency_interval": { "type": "string", "description": "Interval applicable for frequency_amount.\n\nRequired if `frequency_typeis even or asap`.", "enum": [ "hour", "day", "week", "month", "not-applicable", "campaign" ] }, "frequency_type": { "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "minimize_multi_ads": { "description": "Minimize occurrences of multiple ads appearing on the same page", "type": "boolean" }, "name": { "description": "Name for the Advertiser. 64 characters maximum allowed.", "type": "string" }, "status": { "description": "Status of advertiser (defaults to off if unspecified)", "type": "boolean" }, "updated_on": { "type": "string" }, "vertical_id": { "description": "\nVertical IDs are listed at https://api.mediamath.com/api/v2.0/verticals?sort_by=id and on 12/20/2019 are:\n\n1 'Air Travel'\n2 'Autos'\n3 'Business Services'\n4 'Electronics'\n5 'Clothing & Accessories'\n6 'Computer (Hardware & Software)'\n7 'Credit Cards'\n8 'Dating'\n9 'Employment'\n10 'Pharmaceuticals (Rx & OTC)'\n11 'Education'\n12 'Entertainment'\n13 'Food & Beverages'\n14 'Pets'\n15 'Toys'\n16 'Home & Garden'\n17 'Insurance'\n18 'Internet Services'\n19 'Personal Care'\n20 'Personal Finance'\n21 'Real Estate'\n22 'Sporting Goods'\n23 'Telecommunications'\n24 'Hotels'\n25 'Media'\n26 'Non-Profit'\n27 'Gambling'\n28 'Consumer Goods'\n29 'Government'\n30 'Alcohol'\n31 'Adult'\n32 'Tobacco'\n33 'Religion and Spirituality'\n34 'Weight Loss'", "type": "integer" }, "ad_server_password": { "type": "string" }, "ad_server_username": { "type": "string" }, "ads_txt_verified": { "type": "string", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ] }, "data_sharing_enabled": { "type": "boolean" }, "id": { "type": "integer" }, "political": { "type": "boolean" }, "sales_contact_id": { "type": "integer" }, "version": { "type": "integer" } }, "required": [ "ad_server_id", "agency_id", "domain", "name", "vertical_id" ] }, "agency": { "example": { "allow_x_adv_optimization": false, "allow_x_adv_pixels": false, "created_on": "2016-03-19T16:12:12+0000", "dmp_enabled": "inherits", "entity_type": "agency", "id": 113388, "name": "test_py_postgres", "organization_id": 100048, "status": false, "updated_on": "2016-03-19T16:12:12+0000", "version": 0 }, "title": "Agency", "type": "object", "x-stoplight": { "id": "agency", "name": "Agency", "public": true }, "description": "Agency", "properties": { "ads_txt_verified": { "default": "AUTHORIZED_ONLY", "description": "* ANY: can bid on all inventory where seller is listed in publishers ads.txt OR where publisher does not have ads.txt OR we have not checked publishers ads.txt\n* AUTHORIZED_ONLY: can only bid on inventory where seller is listed in publishers ads.txt\n* AUTHORIZED_DIRECT_ONLY: can only bid on inventory where seller is listed in publishers ads.txt as a DIRECT seller", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ], "type": "string" }, "allow_x_adv_optimization": { "default": false, "description": "This option is only available if Cross-Advertiser Pacing has been enabled for the Agency. Cross-Advertiser pacing allows winning bids to be decided based on price AND pacing level. If two bids from participating Advertisers are competitive and the lower bid is from an under-pacing campaign, then the lower bid may win. If this field is set to No, this Advertiser will compete solely on bid price.\n\n", "type": "boolean" }, "allow_x_adv_pixels": { "default": false, "description": "This field enables the Data Co-op functionality across all the Advertisers under this organization. Cross-Advertiser Pixel Targeting allows Advertisers to target other Advertiser Event Pixels within their Agency and any other similarly enabled Agency under the same Organization.\n\n", "type": "boolean" }, "billing_contact_id": { "type": "integer" }, "created_on": { "type": "string" }, "dmp_enabled": { "type": "string", "enum": [ "disabled", "enabled", "inherits" ] }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "logo": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "type": "integer" }, "sales_contact_id": { "type": "integer" }, "status": { "type": "boolean" }, "traffic_contact_id": { "type": "integer" }, "updated_on": { "type": "string" }, "version": { "type": "integer" }, "eligible_for_data_sharing": { "type": "boolean" } } }, "atomic-creative": { "example": { "ad_format": "DISPLAY", "ad_server_type": "DART", "advertiser_id": 150577, "approval_status": "PENDING", "built": false, "built_by_user_id": 9160, "created_on": "2016-11-22T14:20:17+0000", "creative_import_file_id": 76091, "entity_type": "atomic_creative", "expansion_direction": "NONRESTRICTED", "expansion_trigger": "MOUSEOVER", "external_identifier": "140191381", "file_type": "unknown", "has_sound": false, "height": 250, "id": 3260345, "is_https": true, "is_mraid": false, "is_multi_creative": false, "last_modified": "2016-11-22T14:21:47+0000", "media_type": "DISPLAY", "name": "DesCK_Algo 1: HHE Retargeting Gift Card_LF_Stan_Disp_DS_Retarget_Geo_65_300x250_300x250_PD_dCPM_NA_NA_HTML5_11/14/16_12/31/16", "rich_media": false, "sizmek_creative_status": "NOT_USED", "sizmek_tag_status": "NOT_USED", "status": false, "t1as": false, "tag": "\n \n", "tag_type": "SCRIPT", "tpas_ad_tag_name": "DesCK_Algo 1: HHE Retargeting Gift Card_LF_Stan_Disp_DS_Retarget_Geo_65_300x250_300x250_PD_dCPM_NA_NA_HTML5_11/14/16_12/31/16", "updated_on": "2016-11-22T14:21:47+0000", "version": 1, "width": 300 }, "properties": { "ad_format": { "default": "DISPLAY", "description": "Advertising format in which creative will appear. ", "enum": [ "DISPLAY", "EXPANDABLE", "MOBILE" ], "type": "string" }, "ad_server_type": { "description": "The primary Third Party Ad Server involved with serving the creative. To obtain the most up-to-date list of Ad Servers, see \"API for Ad Servers\".", "enum": [ "ATLAS", "DART", "EYEWONDER", "MEDIAMIND", "MEDIAPLEX", "POINTROLL", "YIELD_MANAGER", "TERMINALONE", "MEDIAFORGE", "OTHER" ], "type": "string" }, "advertiser_id": { "description": "ID of TerminalOne Advertiser to which the creative belongs. See \"API for Ad Servers\".", "type": "integer" }, "approval_status": { "enum": [ "PENDING", "APPROVED", "REJECTED" ], "type": "string" }, "built": { "default": false, "type": "boolean" }, "built_by_user_id": { "description": "Id number for the user who made the creative.", "type": "integer" }, "click_through_url": { "description": "T1AS creatives: destination URL to which the user is directed after clicking an ad.", "maxLength": 2048, "type": "string" }, "click_url": { "description": "T1 user-declared URL describing where the end user is redirected after clicking an ad, after all redirects.", "maxLength": 2048, "type": "string" }, "concept_id": { "description": "ID of TerminalOne Concept ID which the creative belongs; see above.", "type": "integer" }, "created_on": { "type": "string" }, "creative_import_file_id": { "description": "ID of the file where creative ad tag source came from during the Bulk 3PAS upload.", "type": "integer" }, "edited_tag": { "description": "Default or user-modified source HTML for T1AS creative.", "type": "string" }, "entity_type": { "type": "string" }, "expand": { "description": "Direction in which an EXPANDABLE creative expands.", "enum": [ "L", "R", "U", "D", "LD", "RD", "LU", "RU" ], "type": "string" }, "expansion_direction": { "default": "NONRESTRICTED", "description": "Determines whether an 'EXPANDABLE' format ad is restricted with respect to its movement on a page and, if so, which directions are permissible.Defaults to: 'NONRESTRICTED'.", "type": "string" }, "expansion_trigger": { "description": "Action which causes an ad to expand. Defaults to: 'MOUSEOVER'", "enum": [ "AUTOMATIC", "MOUSEOVER", "CLICK" ], "type": "string" }, "external_identifier": { "type": "string" }, "file_type": { "description": "Specify the file type", "enum": [ "gif", "html5", "jpg", "png", "swf", "tif", "tiff", "unknown", "vast", "zip" ], "type": "string" }, "has_sound": { "description": "Set to 'on' if the creative uses sound. This will restrict the creative from running on certain publishers, as enforced by each supply source. Defaults to: 'off'", "type": "boolean" }, "height": { "type": "integer" }, "id": { "type": "integer" }, "is_https": { "type": "boolean" }, "is_mraid": { "type": "boolean" }, "is_multi_creative": { "description": "Set to 'on' if the creatives serving through the ad tag vary significantly (e.g different offers or products or drastically different treatments) in order to reduce the weight given to the Creative in algorithmic optimization (when applied). Best practice is to separate creative with significant differences to allow full visibility to the optimization algorithm. Defaults to 'off'.", "type": "boolean" }, "last_modified": { "type": "string" }, "media_type": { "default": "DISPLAY", "description": "Media Type of the creative. ", "enum": [ "DISPLAY", "VIDEO", "MOBILE" ], "type": "string" }, "name": { "type": "string" }, "rich_media": { "default": false, "type": "boolean" }, "status": { "type": "boolean" }, "t1as": { "description": "If 'on', creative is served by MediaMath's TerminalOne Ad Server.If 'off', creative is a 3PAS creative.", "type": "boolean" }, "tag": { "description": "The actual 3PAS ad tag HTML used in order serve the ad. The appropriate T1 Macros necessary must be incorporated.", "type": "string" }, "tag_type": { "description": "Specify the implementation tag type into this field", "enum": [ "IFRAME_SCRIPT_NOSCRIPT", "IFRAME_SCRIPT", "IFRAME_NOSCRIPT", "IFRAME_IMG", "SCRIPT_NOSCRIPT", "SCRIPT", "NOSCRIPT", "IFRAME", "IMG" ], "type": "string" }, "tpas_ad_tag_name": { "description": "Descriptive name of the placement from the 3PAS.", "maxLength": 255, "type": "string" }, "updated_on": { "type": "string" }, "version": { "description": "Used to protect against simultaneous updates. Refer to \"Optimistc Locking\" in the API overview for more information.", "type": "integer" }, "width": { "type": "integer" } }, "required": [ "ad_server_type", "advertiser_id", "external_identifier", "file_type", "height", "width", "tag", "tag_type", "tpas_ad_tag_name" ], "title": "Atomic Creative", "type": "object", "x-stoplight": { "id": "atomic-creative", "name": "Atomic Creative", "public": true } }, "audience-segment": { "example": { "audience_segment_id": 1505371, "created_on": "2017-01-24T21:56:26+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 2053020, "name": "Strategy Audience Segments #2053020", "restriction": "INCLUDE", "strategy_id": 1068421, "updated_on": "2017-01-24T21:56:26+0000", "version": 0 }, "properties": { "audience_vendor_id": { "type": "integer" }, "buyable": { "type": "boolean" }, "child_count": { "description": "The number of audience segments that have this segment as a direct parent.", "type": "integer" }, "created_on": { "type": "string" }, "entity_type": { "type": "string" }, "full_path": { "type": "string" }, "id": { "type": "integer" }, "meta": { "type": "object" }, "name": { "type": "string" }, "updated_on": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "entity_type", "name" ], "title": "Audience Segment", "type": "object", "x-stoplight": { "id": "audience-segment", "name": "Audience Segment", "public": true } }, "budget-flight": { "example": { "campaign_id": 301839, "created_on": "2016-10-20T16:32:37+0000", "currency_code": "EUR", "end_date": "2016-11-20T04:59:00+0000", "entity_type": "budget_flight", "id": 283192, "is_relevant": true, "name": "Budget Flights #283192", "start_date": "2016-10-27T04:00:00+0000", "total_budget": [ { "currency_code": "EUR", "value": 1200 } ], "updated_on": "2016-10-20T16:32:37+0000", "version": 0, "zone_name": "America/New_York" }, "title": "Budget Flight", "type": "object", "x-stoplight": { "id": "budget-flight", "name": "Budget Flight", "public": true }, "properties": { "campaign_id": { "type": "integer" }, "created_on": { "type": "string" }, "currency_code": { "type": "string", "description": "Currency setting for budget flight. All budget flights under a campaign inherit the campaign's selected currency. Once the campaign starts, it cannot be switched to another currency (existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).\n\n", "minLength": 3, "maxLength": 3 }, "end_date": { "type": "string" }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "is_relevant": { "type": "boolean", "description": "Which flight is the \"relevant\" one (0=not relevant, 1=relevant)\n\nScenarios:\n1) All budget flights are in the past: The very last budget flight for the campaign\n2) An existing budget flight has start <= now() <= end:\tSimply the flight where start <= now() <= end for the campaign\n3) now() is currently in a gap between two existing budget flights: The very next upcoming budget flight for the campaign\n4) All budget flights are in the future: The very next upcoming budget flight for the campaign" }, "name": { "type": "string" }, "start_date": { "type": "string" }, "total_budget": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string", "minLength": 3, "maxLength": 3 }, "value": { "type": "integer" } } } }, "updated_on": { "type": "string" }, "version": { "type": "integer" }, "zone_name": { "type": "string", "description": "Indicate the time zone for reporting for the campaign. All budget flights under a campaign inherit the campaign's selected zone_name.\n\n", "maxLength": 64 } } }, "bulk-editing-actions-add": { "example": { "collection": "aliqua", "id": 34510090 }, "properties": { "collection": { "type": "string" }, "id": { "type": "integer" } }, "title": "Bulk Editing Actions Add", "type": "object", "x-stoplight": { "id": "bulk-editing-actions-add", "name": "Bulk Editing Actions Add", "public": true } }, "bulk-editing-actions-overwrite": { "properties": { "collection": { "type": "string" }, "exclude": { "type": "boolean" }, "id": { "type": "integer" } }, "title": "Bulk Editing Actions Overwrite", "type": "object", "x-stoplight": { "id": "bulk-editing-actions-overwrite", "name": "Bulk Editing Actions Overwrite", "public": true } }, "bulk-editing-actions-post-data": { "example": [ { "add": { "collection": "concepts", "id": 100001 }, "collection": "strategies", "tag": "concepts" }, { "add": { "collection": "concepts", "id": 100002 }, "collection": "strategies", "tag": "concepts" }, { "collection": "strategies", "overwrite": { "collection": "target_values", "exclude": false, "id": 100001 }, "tag": "location" }, { "collection": "strategies", "overwrite": { "collection": "target_values", "exclude": false, "id": 100003 }, "tag": "location" }, { "collection": "strategies", "overwrite": { "collection": "target_values", "exclude": true, "id": 100002 }, "tag": "location" }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100001 }, "tag": "location" }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100002 }, "tag": "location" }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100003 }, "tag": "location" }, { "collection": "strategies", "tag": "details" } ], "items": { "properties": { "collection": { "type": "string" }, "overwrite": { "properties": { "collection": { "type": "string" }, "exclude": { "type": "boolean" }, "id": { "type": "integer" } }, "type": "object" }, "remove": { "properties": { "collection": { "type": "string" }, "id": { "type": "integer" } }, "type": "object" }, "tag": { "type": "string" } }, "type": "object" }, "title": "Bulk Editing Actions Post Data", "type": "array", "x-stoplight": { "id": "bulk-editing-actions-post-data", "name": "Bulk Editing Actions Post Data", "public": true } }, "bulk-editing-actions-remove": { "properties": { "collection": { "type": "string" }, "id": { "type": "integer" } }, "title": "Bulk Editing Actions Remove", "type": "object", "x-stoplight": { "id": "bulk-editing-actions-remove", "name": "Bulk Editing Actions Remove", "public": true } }, "bulk-editing-actions-update": { "example": { "pixel_target_exrp_targeting_operator": "AND" }, "title": "Bulk Editing Actions Update", "type": "object", "x-stoplight": { "id": "bulk-editing-actions-update", "name": "Bulk Editing Actions Update", "public": true }, "properties": { "audience_segment_exclude_op": { "default": "OR", "description": "Exclude associated audience segment from targeting", "enum": [ "AND", "OR" ], "type": "string" }, "audience_segment_include_op": { "default": "OR", "description": "Include associated audience segment in targeting", "enum": [ "AND", "OR" ], "type": "string" }, "bid_aggressiveness": { "default": 50, "description": "Apply a multiplier for the bid amount determined by the algorithm", "maximum": 100, "minimum": 0, "type": "integer" }, "bid_price_is_media_only": { "default": 1, "description": "Informs T1 that value entered on the strategygoal_valuemax_bidshould be the amount forthe \"media only\" (bid_price_is_media_only=1)or \"total spend\" (bid_price_is_media_only=0)", "type": [ "boolean", "number" ] }, "budget": { "description": "Allocated budget for strategy", "type": [ "array", "number" ], "items": {} }, "campaign_id": { "description": "Specify parent campaign of strategy", "type": "integer" }, "end_date": { "description": "Date which strategy will end", "type": "string" }, "frequency_amount": { "description": "Maximum frequency of impressions per user within interval set onfrequency_interval", "type": "integer" }, "frequency_interval": { "description": "Interval applicable for frequency_amount", "type": "string" }, "frequency_optimization": { "type": "boolean" }, "frequency_type": { "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap", "enum": [ "even", "asap", "no-limit" ], "type": "string" }, "goal_type": { "description": "Goal type which campaign performance will be measured", "type": "string" }, "goal_value": { "description": "Target goal value for campaign", "type": [ "array", "integer" ], "items": {} }, "impression_pacing_interval": { "default": "day", "description": "Period of time over which impression pacing is to be distributed", "enum": [ "hour", "day" ], "type": "string" }, "impression_pacing_type": { "description": "Type of impression pacing applied to strategy.", "enum": [ "even", "asap", "no-limit" ], "type": "string" }, "max_bid": { "description": "Max bid price which strategy should place", "type": [ "array", "integer" ], "items": {} }, "media_type": { "description": "Whether the strategy is a display or video strategy.", "enum": [ "DISPLAY", "VIDEO" ], "type": "string" }, "min_bid": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } } } }, "name": { "description": "Descriptive name of strategy", "maxLength": 64, "type": "string" }, "pacing_amount": { "description": "Specify max amount strategy can spend within pacing_interval", "type": [ "array", "integer" ], "items": {} }, "pacing_interval": { "description": "Specify distribution of spend across thepacing_interval", "enum": [ "hour", "day" ], "type": "string" }, "pacing_type": { "description": "Specify distribution of spend across the pacing_interval", "enum": [ "even", "asap" ], "type": "string" }, "pixel_target_expr": { "description": "Specify pixel targeting for the strategy. Poll must be run to obtain available Pixel IDs. To configure Pixel-Targeting, pixels must have previously been generated. See \"API for Event Pixels and Data Pixels\" for more information on creating and obtaining information on Pixels.\n\n\n( [pixel_id] INCL_COND [pixel_id] ) AND NOT ( [pixel_id EXCL_COND[pixel_id] )1024 characters maximum*note* Although theINCL_CONDandEXCL_CONDis not required to be consistent, the conditional logic between all pixels to be included or excluded must be the same.", "maxLength": 1024, "type": "string" }, "run_on_all_exchanges": { "type": "boolean" }, "run_on_all_pmp": { "type": "boolean" }, "run_on_display": { "type": "boolean" }, "run_on_mobile": { "type": "boolean" }, "run_on_streaming": { "type": "boolean" }, "site_restriction_transparent_urls": { "type": "boolean" }, "site_selectiveness": { "type": "string", "default": "REDUCED", "description": "REDUCED is currently the only available option", "enum": [ "REDUCED" ] }, "start_date": { "type": "string" }, "status": { "type": "boolean" }, "supply_type": { "description": "Specify whether impressions will be bought and decisioned by the TerminalOne platform. Use 'RTB' for normal strategies that are bought/decisioned in T1. Use 'RMX_API' to use a tag to track media not purchased through TerminalOne.", "enum": [ "RTB", "RMX_API" ], "type": "string" }, "targeting_segment_exclude_op": { "type": "string" }, "targeting_segment_include_op": { "type": "string" }, "type": { "description": "Specify the type of strategy (re-marketing (REM), goal-based optimization (GBO), audience (AUD))", "enum": [ "REM", "GBO", "AUD" ], "type": "string" }, "use_campaign_end": { "type": "boolean" }, "use_campaign_start": { "type": "boolean" }, "use_mm_freq": { "description": "\t\nUnused legacy frequency cap setting. Must be set to 'off'. To control frequency capping at the campaign level, set the strategy-level frequency_type attribute to 'no-limit' and set a frequency cap on the campaign entity.", "type": "boolean" }, "use_optimization": { "description": "Enable's T1 optimization algorithm \n(defaults to 'off' if unspecified)", "type": "boolean" }, "version": { "description": "\t\nUsed to protect against simultaneous updates. Refer to \"Optimistic Locking\" in the API overview for more information.", "type": "integer" }, "zone_name": { "type": "string" } } }, "bulk-editor-targeting-post-data": { "example": { "all": false, "collection": "strategies", "entities": [ 1, 2, 3 ], "overwrite_existing_targets": false, "parent_collection": "campaigns", "parent_id": 1, "skip_entities": [] }, "properties": { "all": { "type": "boolean" }, "collection": { "type": "string" }, "entities": { "items": { "type": "integer" }, "type": "array" }, "overwrite_existing_targets": { "type": "boolean" }, "parent_collection": { "type": "string" }, "parent_id": { "type": "integer" }, "skip_entities": { "items": { "type": "object" }, "type": "array" } }, "title": "Bulk Editor Targeting Post Data", "type": "object", "x-stoplight": { "id": "bulk-editor-targeting-post-data", "name": "Bulk Editor Targeting Post Data", "public": true } }, "campaign": { "example": { "ad_server_id": 6, "advertiser_id": 122631, "agency_fee_pct": 0, "bid_min_devices": 1, "connected_id_type": "DETERMINISTIC_ONLY", "conversion_type": "variable", "conversion_variable_minutes": 1, "created_on": "2016-10-19T03:21:53+0000", "currency_code": "USD", "custom_attribution_source": "3rd Party Attribution", "dcs_data_is_campaign_level": false, "device_graph_only": false, "end_date": "2016-11-07T23:59:00+0000", "entity_type": "campaign", "frequency_amount": 2, "frequency_interval": "not-applicable", "frequency_optimization": false, "frequency_type": "no-limit", "goal_type": "spend", "goal_value": "2.5", "has_custom_attribution": false, "id": 300982, "impression_cap_amount": 5000, "impression_cap_automatic": false, "impression_cap_type": "asap", "initial_start_date": "2016-10-19T09:00:00+0000", "io_name": "", "io_reference_num": "", "margin_pct": 0, "minimize_multi_ads": false, "name": "MobileAds Test (Round 4)", "override_suspicious_traffic_filter": false, "pv_pct": 100, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "source_campaign_id": 395863, "spend_cap_amount": 5, "spend_cap_automatic": false, "spend_cap_type": "asap", "start_date": "2016-10-19T09:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": 40, "updated_on": "2016-11-01T07:18:56+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 5, "zone_name": "Etc/GMT" }, "title": "Create Campaign", "type": "object", "x-stoplight": { "id": "campaign", "name": "Create Campaign", "public": true }, "properties": { "accountable_and_addressable": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "ad_server_fee": { "description": "Fee charged by ad serving vendor", "type": "integer" }, "ad_server_id": { "description": "The ID for a third-party ad server", "type": "integer" }, "ad_server_password": { "type": "string", "description": "Ad server password, must be equal to or less than 64" }, "ad_server_username": { "type": "string", "description": "Ad server username, must be equal to or less than 64" }, "ads_txt_verified": { "type": "string", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ] }, "advertiser_id": { "default": 512321, "description": "T1 Advertiser ID to which a campaign belongs", "type": "integer" }, "agency_fee_pct": { "type": "number", "description": "The Agency Fee Percentage (for example: 0.45)" }, "bid_min_devices": { "default": 1, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "maximum": 5, "minimum": 1, "type": "integer" }, "connected_id_type": { "enum": [ "DETERMINISTIC_FIRST", "DETERMINISTIC_ONLY" ], "type": "string" }, "conversion_type": { "description": "Definition for conversions per user.\n\nevery: Attribute all Merit Events\n\nvariable: Attribute one Merit Event per X minutes - set inconversion_variable_minutes\n\none: Attribute one Merit Event per user (if converstion_type = one, then conversion_variable_minutes (integer) is required).\n\nrequired if `goal_type in ('cpa', 'roi')`\n", "enum": [ "every", "one", "variable" ], "type": "string" }, "conversion_variable_minutes": { "description": "Attribute one Merit Event per X minutes\n\nrequired if `goal_type in ('cpa', 'cpc', 'roi') && conversion_type=one`", "type": "integer" }, "cost_passthrough_cpm_enabled": { "type": "boolean" }, "cost_passthrough_cpm_value": { "type": "number" }, "cost_passthrough_percent_enabled": { "type": "boolean" }, "cost_passthrough_percent_value": { "type": "number" }, "created_on": { "type": "string" }, "currency_code": { "default": "USD", "description": "Currency setting for campaign. All strategies under this value inherit the selected currency. Once the campaign launches, it cannot be switched to another currency (aka existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).", "type": "string" }, "custom_attribution_source": { "type": "string" }, "dcs_data_is_campaign_level": { "type": "boolean" }, "device_graph_only": { "type": "boolean" }, "eligible_for_data_sharing": { "type": "boolean" }, "end_date": { "description": "Last date of campaign in GMT", "type": "string" }, "frequency_amount": { "description": "required if `frequency_type=even||asap`", "type": "integer" }, "frequency_interval": { "description": "required if `frequency_type=even||asap`\n", "type": "string" }, "frequency_optimization": { "description": "", "type": "boolean" }, "frequency_type": { "default": "no-limit", "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "goal_alert": { "type": "number", "description": "Goal Alert Min:0 Max:100, can be decimal", "format": "float", "minimum": 0, "maximum": 100 }, "goal_category": { "type": "string", "description": "goal_category must be one of the following: 'audience', 'engagement', 'response'", "enum": [ "audience", "engagement", "response" ] }, "goal_type": { "type": "string", "description": "Goal type which campaign performance will be measured", "enum": [ "cpa", "cpc", "ctr", "reach", "roi", "spend", "vcr", "vcpm", "viewability_rate" ] }, "goal_value": { "description": "Target goal value for campaign respective to the `goal_type` selection.\n\nrequired if `goal_type` in ('cpa','cpc','reach','roi', 'vcr', 'ctr')`\n\nIf `goal_type` is 'vcr' or 'ctr' or 'viewability_rat', `goal_value` is a percentage.\n\nGoal Value max=\"9999999.9999\" min=\"0.01\", unless goal_value is a percentage in which case max=100.00", "type": "string" }, "has_custom_attribution": { "description": "", "type": "boolean" }, "id": { "description": "", "type": "integer" }, "impression_cap_amount": { "description": "Sets the amount of the available impression budget across the remaining number of days across all their strategies.", "type": "integer" }, "impression_cap_automatic": { "description": "", "type": "boolean" }, "impression_cap_type": { "default": "no-limit", "description": "Type of cap applied to impression budgets.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "initial_start_date": { "type": "string" }, "io_name": { "type": "string", "description": "Descriptive name of insertion order", "maxLength": 256 }, "io_reference_num": { "type": [ "integer", "string" ], "description": "Reference number of insertion order", "maxLength": 32 }, "is_programmatic_guaranteed": { "description": "Sets the campaign as a Programmatic Guaranteed campaign. Once set for a campaign, it cannot be changed", "type": "boolean" }, "margin_pct": { "description": "Margin percentage to be applied on campaign spend", "type": "integer" }, "merit_pixel_id": { "description": "Specify Merit Pixel that represents conversion or engagement on CPA or CPE type campaigns\n\nREQUIRED if `goal_type in ('cpa','roi')`\n\nTHIS FIELD IS OBSOLETE", "type": "integer" }, "minimize_multi_ads": { "default": 0, "description": "Enabling this field will cause T1 to avoid bidding on more than one ad opportunity on a single page view across. Warning: enabling this setting may limit pacing and reduce the available inventory for the campaigns by not bidding on impression opportunities where the URL is not transparent.", "type": "boolean" }, "name": { "description": "Descriptive name of the campaign", "type": "string" }, "override_suspicious_traffic_filter": { "default": 0, "description": "Enabling this setting allows you to set a campaign-specific level of suspicious traffic filtering using the 'suspicious_traffic_filter_level' property. This will override the T1 default (or organization-level, if configured) suspicious traffic filtering level.", "type": "boolean" }, "pacing_alert": { "description": "", "type": "number" }, "pc_window_minutes": { "description": "Post-click window for attribution. Not to be confused with pv_window_minutes.\n\noptional if `goal_type in ('cpa','roi')`\n", "type": "integer" }, "pv_pct": { "description": "Percentage of post-view windows to be used for attribution\n\noptional if `goal_type in ('cpa','roi')`", "type": "integer" }, "pv_window_minutes": { "description": "Post-view window for attribution \n\nrequired if `goal_type in ('cpa','roi')`", "type": "integer" }, "restrict_targeting_to_deterministic_id": { "type": "boolean" }, "restrict_targeting_to_same_device_id": { "type": "boolean" }, "service_type": { "description": "Indicate whether campaign will be self-service or managed (managed campaigns will incur manage service fee)", "enum": [ "MANAGED", "SELF" ], "type": "string" }, "source_campaign_id": { "type": "integer" }, "spend_cap_amount": { "description": "only required if`spend_cap_enabled`is true", "type": "integer" }, "spend_cap_automatic": { "description": "Automatically sets the available spend budget across all strategies through the end date of the campaign.", "type": "boolean" }, "spend_cap_type": { "description": "Type of cap applied to spend budgets.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "start_date": { "description": "Date on which the campaign will start (GMT)", "type": "string" }, "status": { "default": false, "description": "Status of the campaign", "type": "boolean" }, "suspicious_traffic_filter_level": { "description": "A value between 0 and 100 that determines the sensitivity of T1 suspicious traffic filtering capabilities.If the value = 0, all fraud and suspicious traffic filtering is turned off.It will not take effect if 'override_suspicious_traffic_filter_level' is not set.\n\n", "maximum": 100, "minimum": 0, "type": "integer" }, "total_budget": { "description": "Allocated budget for the campaign", "type": "integer" }, "total_impression_budget": { "description": "", "type": "integer" }, "updated_on": { "type": "string" }, "use_default_ad_server": { "type": "boolean" }, "use_mm_freq": { "type": "boolean" }, "version": { "type": "integer", "description": "This number increments upon updating. Do not define it upon creation." }, "zone_name": { "type": "string", "default": "America/New_York", "description": "Indicate the time zone for reporting for the campaign. Default is America/New_York", "maxLength": 64 } }, "required": [ "ad_server_id", "advertiser_id", "end_date", "goal_type", "goal_value", "impression_cap_automatic", "name", "service_type", "start_date", "total_budget" ] }, "campaign-custom-brain-selection": { "example": { "active": false, "campaign_id": -13129825, "child_count": -35599919, "entity_type": "dolore ea deserunt", "full_path": "do", "id": 46512678, "is_retired": true, "load_count": -99526154, "name": "commodo Lorem reprehenderit qui", "owner_name": "sunt laboris veniam amet", "parent_audience_segment_id": 60078089, "refer_url": "adipisicing consectetur", "retail_cpm": [ { "currency_code": "cupidatat fugiat aute qui", "value": -47610824 } ], "selection_id": 72439766, "selection_name": "dolore ", "selection_type": "Data Pixel", "uniques": -73623784, "version": -21888191, "wholesale_cpm": [ { "value": -23482783 } ] }, "properties": { "active": { "type": "boolean" }, "campaign_id": { "type": "integer" }, "child_count": { "description": "Only returned in selection_type 'Audience Target", "type": "integer" }, "entity_type": { "type": "string" }, "full_path": { "description": "Only returned in selection_type 'Audience Target", "type": "string" }, "id": { "type": "integer" }, "is_retired": { "description": "Only returned in selection_type 'Audience Target", "type": "boolean" }, "load_count": { "type": "integer" }, "name": { "type": "string" }, "owner_name": { "type": "string" }, "parent_audience_segment_id": { "description": "Only returned in selection_type 'Audience Target", "type": "integer" }, "refer_url": { "type": "string" }, "retail_cpm": { "description": "Only returned in selection_type 'Audience Target", "items": { "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } }, "required": [ "currency_code", "value" ], "type": "object" }, "type": "array" }, "selection_id": { "type": "integer" }, "selection_name": { "type": "string" }, "selection_type": { "enum": [ "Event Pixel", "Dynamic", "Audience Target", "Data Pixel" ], "type": "string" }, "uniques": { "type": "integer" }, "version": { "type": "integer" }, "wholesale_cpm": { "description": "Only returned in selection_type 'Audience Target", "items": { "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } }, "type": "object" }, "type": "array" } }, "title": "Campaign Custom Brain Selection", "type": "object", "x-stoplight": { "id": "campaign-custom-brain-selection", "name": "Campaign Custom Brain Selection", "public": true } }, "contextual-targeting-segment": { "example": { "audience_segment_id": 1505371, "created_on": "2017-01-24T21:56:26+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 2053020, "name": "Strategy Audience Segments #2053020", "restriction": "INCLUDE", "strategy_id": 1068421, "updated_on": "2017-01-24T21:56:26+0000", "version": 0 }, "properties": { "buyable": { "type": "boolean" }, "child_count": { "description": "The number of audience segments that have this segment as a direct parent.", "type": "integer" }, "created_on": { "type": "string" }, "entity_type": { "type": "string" }, "full_path": { "type": "string" }, "id": { "type": "integer" }, "meta": { "type": "object" }, "name": { "type": "string" }, "parent_targeting_segment_id": { "type": "integer" }, "retail_cpm": { "properties": { "currency_code": { "type": "string" }, "value": { "type": "number" } }, "type": "object" }, "targeting_vendor_id": { "type": "integer" }, "updated_on": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "entity_type", "name" ], "title": "Contextual Targeting Segment", "type": "object", "x-stoplight": { "id": "contextual-targeting-segment", "name": "Contextual Targeting Segment", "public": true } }, "contracts-input": { "example": { "adaptive_segment_cpm": [ { "currency_code": "USD", "value": 0 } ], "contract_number": 103074, "currency_code": "USD", "effective_end_date": "2017-09-01T00:00:00+0000", "effective_start_date": "2016-09-01T00:00:00+0000", "entity_type": "contract", "evidon_privacy_cost_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "exclude_agency_margin": false, "external_media_tracking_cpm": [ { "currency_code": "USD", "value": 0.005 } ], "fbx_dynamic_cpm": [ { "currency_code": "USD", "value": 0.3 } ], "managed_service_fee_pct": 0, "managed_service_fee_unit": "PCT_TOTAL_COST", "name": "Contracts #3385", "optimization_fee_pct": 0, "optimization_fee_unit": "PCT_TOTAL_COST", "organization_id": 100048, "peer39_channel_fee_cpm": [ { "currency_code": "USD", "value": 0.1 } ], "peer39_custom_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ], "peer39_quality_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "peer39_safety_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "platform_access_fee_pct": 0, "platform_access_fee_unit": "PCT_TOTAL_COST", "platform_monthly_min": 0, "pmp_optimization_off_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_off_unit": "CPM", "pmp_optimization_on_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_on_unit": "CPM", "profit_share_fee_pct": 0, "spend_cap": 15000, "t1_as_fee_cpm": [ { "currency_code": "USD", "value": 0.02 } ], "t1_html5_fee_cpm": [ { "currency_code": "USD", "value": 0.08 } ], "t1_vads_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ] }, "title": "Contracts Input", "type": "object", "x-stoplight": { "id": "contracts-input", "name": "Contracts Input", "public": true }, "properties": { "adaptive_segment_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "audience_verification_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "connected_id_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "contract_number": { "type": "integer" }, "country_tax_withholding_fee_pct": { "type": "integer" }, "country_tax_withholding_fee_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "created_on": { "format": "date-time", "type": "string" }, "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "effective_end_date": { "type": "string" }, "effective_start_date": { "type": "string" }, "entity_type": { "type": "string", "description": "Should be set to \"contract\"" }, "evidon_privacy_cost_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "exclude_agency_margin": { "type": "boolean" }, "external_media_tracking_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "fbx_dynamic_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "financing_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "id": { "type": "integer" }, "managed_sevrice_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "managed_service_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied to impressions on campaigns where the campaign is set to be \"Managed By\" Managed Service." }, "managed_service_fee_unit": { "type": "string", "description": "This fee is applied to impressions on campaigns where the campaign is set to be \"Managed By\" Managed Service.\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "media_enablement_fee_pct": { "type": [ "integer", "number" ], "description": "" }, "media_enablement_fee_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "name": { "type": "string" }, "optimization_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied to impressions on campaigns where a strategy has optimization
turned on AND the campaign IS NOT \"Managed Service\"." }, "optimization_fee_unit": { "type": "string", "description": "This fee is applied to impressions on campaigns where a strategy has optimization
turned on AND the campaign IS NOT \"Managed Service\".\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "organization_id": { "type": "integer" }, "partnership_rebate_fee_pct": { "type": "integer" }, "partnership_rebate_fee_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "peer39_channel_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_custom_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_quality_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_safety_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "platform_access_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied for use of T1 on all inventory with exception of User-Sourced PMP." }, "platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all inventory with exception of User-Sourced PMP.\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "platform_monthly_min": { "type": "integer" }, "pmp_optimization_off_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "pmp_optimization_off_fee_pct": { "type": "number" }, "pmp_optimization_off_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "pmp_optimization_on_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "pmp_optimization_on_fee_pct": { "type": "integer" }, "pmp_optimization_on_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "profit_share_fee_pct": { "type": "integer" }, "programmatic_guaranteed_platform_access_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals." }, "programmatic_guaranteed_platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals.\n\nAcceptable values are: CPM, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "source_platform_access_fee_pct": { "type": "integer" }, "source_platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals.\n\nAcceptable values are: CPM, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "spend_cap": { "type": "integer" }, "standard_segment_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_as_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_html5_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_vads_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "updated_on": { "format": "date-time", "type": "string" }, "value": { "type": "integer" }, "version": { "type": "integer" }, "viewability_display_all_imps": { "type": "number" }, "viewability_display_sample": { "type": "number" }, "viewability_video_all_imps": { "type": "number" }, "viewability_video_sample": { "type": "number" } } }, "contracts-output": { "example": { "data": { "adaptive_segment_cpm": [ {} ], "contract_number": -34492430, "currency_code": "Lorem cupidatat qui ullamco", "effective_end_date": "2017-09-01T00:00:00+0000", "effective_start_date": "2016-09-01T00:00:00+0000", "entity_type": "sit labore et Ut adipisicing", "evidon_privacy_cost_cpm": [ {}, {}, {}, { "currency_code": "do aute cillum deserunt qui", "value": -54392635 } ], "exclude_agency_margin": false, "external_media_tracking_cpm": [ {}, {} ], "fbx_dynamic_cpm": [ {}, {}, { "value": -47958450 }, {}, {} ], "managed_service_fee_pct": 63292875, "managed_service_fee_unit": "anim sint", "name": "irure reprehenderit Excepteur laboris", "optimization_fee_pct": -85118338, "optimization_fee_unit": "dolore ipsum pariatur", "organization_id": -9920526, "peer39_channel_fee_cpm": [ {}, { "value": -46124930 }, { "currency_code": "laborum", "value": 24673781 }, {} ], "peer39_custom_fee_cpm": [ {}, { "currency_code": "non deserunt cupidatat anim" }, {} ], "peer39_quality_fee_cpm": [ { "value": -85179 }, { "value": -10240689 }, { "value": -4954655 }, { "value": -84377398 } ], "peer39_safety_fee_cpm": [ {}, {}, {}, {} ], "platform_access_fee_pct": -71104119, "platform_access_fee_unit": "reprehenderit laborum dolor mollit ullamco", "platform_monthly_min": -73493003, "pmp_optimization_off_fee_cpm": [ { "currency_code": "ut sint ut occaecat" }, { "currency_code": "Excepteur ut tempor", "value": 99751657 } ], "pmp_optimization_off_unit": "sed esse nulla", "pmp_optimization_on_fee_cpm": [ { "currency_code": "ex deserunt p", "value": 38523577 }, { "value": -85647761 }, { "currency_code": "labore commodo consectetur consequat", "value": -49826722 }, {} ], "pmp_optimization_on_unit": "Ut", "profit_share_fee_pct": 41207491, "spend_cap": -12156130, "t1_as_fee_cpm": [ {}, { "value": 99250012 }, {} ], "t1_html5_fee_cpm": [ { "currency_code": "velit" }, {}, {}, {} ], "t1_vads_fee_cpm": [ { "value": -835869 }, {}, { "value": -398843 }, {}, { "currency_code": "sint ex aliqua irure exercitation" } ] }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "called_on": "laborum voluptate dolore", "count": 27422536, "etag": "enim id Excepteur magna", "offset": -47785040, "status": "amet", "total_count": -77774937 } }, "title": "Contracts Output", "type": "object", "x-stoplight": { "id": "contracts-output", "name": "Contracts Output", "public": true }, "properties": { "data": { "example": { "adaptive_segment_cpm": [ { "currency_code": "USD", "value": 0 } ], "contract_number": 103074, "currency_code": "USD", "effective_end_date": "2017-09-01T00:00:00+0000", "effective_start_date": "2016-09-01T00:00:00+0000", "entity_type": "contract", "evidon_privacy_cost_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "exclude_agency_margin": false, "external_media_tracking_cpm": [ { "currency_code": "USD", "value": 0.005 } ], "fbx_dynamic_cpm": [ { "currency_code": "USD", "value": 0.3 } ], "managed_service_fee_pct": 0, "managed_service_fee_unit": "PCT_TOTAL_COST", "name": "Contracts #3385", "optimization_fee_pct": 0, "optimization_fee_unit": "PCT_TOTAL_COST", "organization_id": 100048, "peer39_channel_fee_cpm": [ { "currency_code": "USD", "value": 0.1 } ], "peer39_custom_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ], "peer39_quality_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "peer39_safety_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "platform_access_fee_pct": 0, "platform_access_fee_unit": "PCT_TOTAL_COST", "platform_monthly_min": 0, "pmp_optimization_off_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_off_unit": "CPM", "pmp_optimization_on_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_on_unit": "CPM", "profit_share_fee_pct": 0, "spend_cap": 15000, "t1_as_fee_cpm": [ { "currency_code": "USD", "value": 0.02 } ], "t1_html5_fee_cpm": [ { "currency_code": "USD", "value": 0.08 } ], "t1_vads_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ] }, "title": "Contracts Input", "type": "object", "x-stoplight": { "id": "contracts-input", "name": "Contracts Input", "public": true }, "properties": { "adaptive_segment_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "audience_verification_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "connected_id_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "contract_number": { "type": "integer" }, "country_tax_withholding_fee_pct": { "type": "integer" }, "country_tax_withholding_fee_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "created_on": { "format": "date-time", "type": "string" }, "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "effective_end_date": { "type": "string" }, "effective_start_date": { "type": "string" }, "entity_type": { "type": "string", "description": "Should be set to \"contract\"" }, "evidon_privacy_cost_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "exclude_agency_margin": { "type": "boolean" }, "external_media_tracking_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "fbx_dynamic_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "financing_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "id": { "type": "integer" }, "managed_sevrice_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "managed_service_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied to impressions on campaigns where the campaign is set to be \"Managed By\" Managed Service." }, "managed_service_fee_unit": { "type": "string", "description": "This fee is applied to impressions on campaigns where the campaign is set to be \"Managed By\" Managed Service.\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "media_enablement_fee_pct": { "type": [ "integer", "number" ], "description": "" }, "media_enablement_fee_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "name": { "type": "string" }, "optimization_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied to impressions on campaigns where a strategy has optimization
turned on AND the campaign IS NOT \"Managed Service\"." }, "optimization_fee_unit": { "type": "string", "description": "This fee is applied to impressions on campaigns where a strategy has optimization
turned on AND the campaign IS NOT \"Managed Service\".\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "organization_id": { "type": "integer" }, "partnership_rebate_fee_pct": { "type": "integer" }, "partnership_rebate_fee_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "peer39_channel_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_custom_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_quality_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_safety_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "platform_access_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied for use of T1 on all inventory with exception of User-Sourced PMP." }, "platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all inventory with exception of User-Sourced PMP.\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "platform_monthly_min": { "type": "integer" }, "pmp_optimization_off_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "pmp_optimization_off_fee_pct": { "type": "number" }, "pmp_optimization_off_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "pmp_optimization_on_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "pmp_optimization_on_fee_pct": { "type": "integer" }, "pmp_optimization_on_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "profit_share_fee_pct": { "type": "integer" }, "programmatic_guaranteed_platform_access_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals." }, "programmatic_guaranteed_platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals.\n\nAcceptable values are: CPM, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "source_platform_access_fee_pct": { "type": "integer" }, "source_platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals.\n\nAcceptable values are: CPM, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "spend_cap": { "type": "integer" }, "standard_segment_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_as_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_html5_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_vads_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "updated_on": { "format": "date-time", "type": "string" }, "value": { "type": "integer" }, "version": { "type": "integer" }, "viewability_display_all_imps": { "type": "number" }, "viewability_display_sample": { "type": "number" }, "viewability_video_all_imps": { "type": "number" }, "viewability_video_sample": { "type": "number" } } }, "uuid": { "type": "string" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } } }, "creative-approval": { "example": { "approval_status": "APPROVED", "atomic_creative_id": 3262059, "created_on": "2016-11-21T11:00:00+0000", "deal_status": "APPROVED", "deal_status_rejected_reason": "", "entity_type": "creative_approval", "external_identifier": "", "id": 57385131, "name": "Creative Approvals #57385131", "rejected_reason": "", "supply_source_id": 4, "updated_on": "2016-11-22T18:27:29+0000", "version": 0 }, "properties": { "approval_status": { "type": "string" }, "atomic_creative_id": { "type": "integer" }, "created_on": { "type": "string" }, "deal_status": { "type": "string" }, "deal_status_rejected_reason": { "type": "string" }, "entity_type": { "type": "string" }, "external_identifier": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "rejected_reason": { "type": "string" }, "supply_source_id": { "type": "integer" }, "updated_on": { "type": "string" }, "version": { "type": "integer" } }, "title": "Creative Approval", "type": "object", "x-stoplight": { "id": "creative-approval", "name": "Creative Approval", "public": true } }, "data-pixel": { "example": { "agency_id": 114180, "cost_cpm": 0, "created_on": "2016-12-23T16:40:57+0000", "eligible": true, "entity_type": "pixel_bundle", "external_identifier": "1187267801", "id": 1028881, "keywords": "", "name": "eap_auto_7531482511256", "pixel_type": "data", "pricing": "CPM", "provider_id": 1575, "rmx_conversion_minutes": 1, "rmx_conversion_type": "one", "rmx_friendly": false, "rmx_merit": false, "status": true, "tag_type": "image", "tags": "\n", "updated_on": "2016-12-23T16:40:57+0000", "version": 1 }, "properties": { "agency_id": { "type": "integer" }, "cost_cpm": { "description": "required if pricing='CPM' AND cost_pct_cpm=null", "type": "integer" }, "cost_cpts": { "description": "required if pricing='CPTS'", "type": "integer" }, "cost_pct_cpm": { "description": "required if pricing='CPM' AND cost_cpm=null", "type": "integer" }, "created_on": { "type": "string" }, "eligible": { "description": "Indicator eligibility of pixel for targeting", "type": "boolean" }, "entity_type": { "type": "string" }, "external_identifier": { "type": "string" }, "id": { "type": "integer" }, "keywords": { "type": "string" }, "name": { "type": "string" }, "pixel_type": { "type": "string" }, "pricing": { "description": "Pricing model for the data provider. CPM is recommended. CPTS is not recommended and planned for deprecation.", "type": "string" }, "provider_id": { "description": "Data Provider Id", "type": "integer" }, "rmx_conversion_minutes": { "type": "integer" }, "rmx_conversion_type": { "type": "string" }, "rmx_friendly": { "type": "boolean" }, "rmx_merit": { "type": "boolean" }, "status": { "type": "boolean" }, "tag_type": { "type": "string" }, "tags": { "type": "string" }, "updated_on": { "type": "string" }, "version": { "type": "integer" } }, "title": "Data Pixel", "type": "object", "x-stoplight": { "id": "data-pixel", "name": "Data Pixel", "public": true } }, "day-part": { "example": { "created_on": "2017-01-24T20:40:37+0000", "days": "MTRFSU", "end_hour": 23, "entity_type": "strategy_day_part", "id": 1505666, "name": "Day Parts #1505666", "start_hour": 0, "status": false, "strategy_id": 1068421, "updated_on": "2017-01-24T20:40:37+0000", "user_time": true, "version": 0 }, "properties": { "created_on": { "type": "string" }, "days": { "type": "string" }, "end_hour": { "type": "integer" }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "start_hour": { "type": "integer" }, "status": { "type": "boolean" }, "strategy_id": { "type": "integer" }, "updated_on": { "type": "string" }, "user_time": { "type": "boolean" }, "version": { "type": "integer" } }, "required": [ "end_hour", "start_hour", "strategy_id" ], "title": "Day Part", "type": "object", "x-stoplight": { "id": "day-part", "name": "Day Part", "public": true } }, "deal-targeting": { "properties": { "all_pmp": { "type": "boolean" }, "deal.x.id": { "type": "integer" } }, "title": "Deal Targeting", "type": "object", "x-stoplight": { "id": "deal-targeting", "name": "Deal Targeting", "public": true } }, "deals": { "properties": { "": { "type": "string" }, "advertiser_id": { "type": "integer" }, "bill_type": { "enum": [ "EXCHANGE", "PUBLISHER", "NONE" ], "type": "string" }, "created_on": { "type": "string" }, "currency_code": { "maxLength": 3, "type": "string" }, "deal_identifier": { "maxLength": 256, "type": "string" }, "deal_source": { "enum": [ "USER", "INTERNAL" ], "type": "string" }, "description": { "maxLength": 4096, "type": "string" }, "end_datetime": { "type": "string" }, "id": { "type": "integer" }, "media_type": { "enum": [ "DISPLAY", "VIDEO" ], "type": "string" }, "name": { "maxLength": 256, "type": "string" }, "partner_sourced": { "type": "boolean" }, "price": { "type": "number" }, "price_method": { "enum": [ "CPM" ], "type": "string" }, "price_type": { "enum": [ "FIXED", "FLOOR" ], "type": "string" }, "publisher_id": { "type": "integer" }, "start_datetime": { "type": "string" }, "status": { "type": "boolean" }, "supply_source_id": { "type": "integer" }, "updated_on": { "type": "string" }, "version": { "type": "integer" }, "zone_name": { "maxLength": 64, "type": "string" } }, "required": [ "name", "publisher_id", "supply_source_id", "start_datetime", "end_datetime", "status", "created_on", "updated_on", "zone_name", "price_type", "price_method", "deal_source", "deal_identifier", "media_type", "currency_code", "bill_type", "version" ], "title": "Deals", "type": "object", "x-stoplight": { "id": "deals", "name": "Deals", "public": true } }, "error-response": { "properties": { "errors": { "items": { "properties": { "code": { "type": "string" }, "field": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "title": "Errors", "type": "array", "x-stoplight": { "id": "errors", "name": "Errors", "public": true } }, "meta": { "properties": { "status": { "enum": [ "error" ], "type": "string" } }, "required": [ "status" ], "title": "Meta (Error)", "type": "object", "x-stoplight": { "id": "meta-error", "name": "Meta (Error)", "public": true } } }, "title": "Error Response", "type": "object", "x-stoplight": { "id": "error-response", "name": "Error Response", "public": true } }, "errors": { "items": { "properties": { "code": { "type": "string" }, "field": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" }, "title": "Errors", "type": "array", "x-stoplight": { "id": "errors", "name": "Errors", "public": true } }, "event-pixel": { "example": { "advertiser_id": 109139, "created_on": "2016-10-17T22:23:30+0000", "eligible": true, "entity_type": "pixel_bundle", "external_identifier": "1187321288", "id": 1082368, "keywords": "", "name": "Example - Homepage", "pixel_type": "event", "pricing": "CPM", "rmx_conversion_minutes": 1, "rmx_conversion_type": "one", "rmx_friendly": false, "rmx_merit": false, "status": true, "tag_type": "js", "tags": "", "updated_on": "2016-10-17T22:23:30+0000", "version": 1 }, "properties": { "advertiser_id": { "type": "integer" }, "agency_id": { "type": "integer" }, "cost_cpm": { "type": "integer" }, "created_on": { "type": "string" }, "currency": { "description": "If set, the currency code for revenue events will be read from the specified URL parameter. Refer to Event Pixels on the T1 knowledge base for more information.\nEither currency or currency_fixed must be set.If set, you must set revenue value currency and revenue parameters must be different.", "enum": [ "S1", "S2", "V1", "V2" ], "type": "string" }, "currency_fixed": { "default": "USD", "description": "Fixed currency. Set using ISO 4217 currency code.\nhttps://en.wikipedia.org/wiki/ISO_4217", "type": "string" }, "eligible": { "description": "Indicator eligibility of pixel for targeting", "type": "boolean" }, "entity_type": { "type": "string" }, "external_identifier": { "type": "string" }, "id": { "type": "integer" }, "keywords": { "description": "Optional keyword tag that can be applied to the pixel", "maxLength": 64, "type": "string" }, "name": { "type": "string" }, "pixel_type": { "default": "event", "enum": [ "event" ], "type": "string" }, "pricing": { "default": "CPM", "description": "Pricing model for the data provider\nCPM is recommended. CPTS is not recommended and planned for deprecation.", "enum": [ "CPM" ], "type": "string" }, "provider_id": { "type": "integer" }, "revenue": { "description": "Identifies the pixel URL parameter in which the revenue value will be passed. Refer to Event Pixels on the T1 knowledge base for more information.", "enum": [ "S1", "S2", "V1", "V2" ], "type": "string" }, "rmx_conversion_minutes": { "type": "integer" }, "rmx_conversion_type": { "type": "string" }, "rmx_friendly": { "type": "boolean" }, "rmx_merit": { "type": "boolean" }, "status": { "default": true, "description": "Indicates whether a pixel should appear in API calls to the $APIBASE/pixel_bundles endpoint.", "type": "boolean" }, "tag_type": { "description": "Tag type to determine pixel code output", "enum": [ "image", "js", "dfa", "uat", "iframe" ], "type": "string" }, "tags": { "type": "string" }, "updated_on": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "advertiser_id", "name", "pixel_type", "tag_type" ], "title": "Event Pixel", "type": "object", "x-stoplight": { "id": "event-pixel", "name": "Event Pixel", "public": true } }, "input-concept": { "properties": { "advertiser_id": { "type": "integer" }, "name": { "type": "string" }, "status": { "type": "boolean" } }, "required": [ "advertiser_id", "name" ], "title": "Input Concept", "type": "object", "x-stoplight": { "id": "input-concept", "name": "Input Concept", "public": true } }, "input-site-placement": { "example": { "audience_segment_exclude_op": "OR", "audience_segment_include_op": "AND", "bid_aggressiveness": 13, "bid_price_is_media_only": false, "budget": [ { "currency_code": "USD", "value": 1.43 } ], "campaign_id": 1234566, "created_on": "2016-05-04T15:44:54+0000", "currency_code": "USD", "effective_goal_value": [ { "currency_code": "USD", "value": "93.0000" } ], "end_date": "2016-05-06T13:44:49+0000", "entity_type": "strategy", "frequency_amount": 3, "frequency_interval": "month", "frequency_type": "even", "goal_type": "reach", "goal_value": [ { "currency_code": "USD", "value": 93 } ], "id": 1234567, "max_bid": [ { "currency_code": "USD", "value": 1.12 } ], "media_type": "video", "name": "strategy with audience segments", "pacing_amount": [ { "currency_code": "USD", "value": 1.93 } ], "pacing_interval": "hour", "pacing_type": "even", "run_on_all_exchanges": true, "run_on_all_pmp": false, "run_on_display": true, "run_on_mobile": true, "run_on_streaming": false, "site_restriction_transparent_urls": true, "site_selectiveness": "REDUCED", "start_date": "2016-05-05T13:44:49+0000", "status": false, "strategy_audience_segments": [ { "audience_segment_id": 1405158, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g2", "id": 1132602, "name": "Strategy Audience Segments #1132602", "rel": "strategy_audience_segments", "restriction": "EXCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 }, { "audience_segment_id": 1358322, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 1132601, "name": "Strategy Audience Segments #1132601", "rel": "strategy_audience_segments", "restriction": "INCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 }, { "audience_segment_id": 1460324, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 1132600, "name": "Strategy Audience Segments #1132600", "rel": "strategy_audience_segments", "restriction": "INCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 } ], "supply_type": "RTB", "targeting_segment_exclude_op": "OR", "targeting_segment_include_op": "OR", "type": "REM", "updated_on": "2016-05-04T15:44:54+0000", "use_campaign_end": false, "use_campaign_start": false, "use_mm_freq": false, "use_optimization": true, "version": 2, "zone_name": "Europe/Paris" }, "properties": { "bill_media_to_client": { "type": "boolean" }, "deal_source": { "enum": [ "USER", "INTERNAL" ], "type": "string" }, "display_text": { "maxLength": 255, "type": "string" }, "media_type": { "enum": [ "display", "video", "mobile" ], "type": "string" }, "name": { "maxLength": 64, "type": "string" }, "pmp_type": { "enum": [ "DIRECT", "PREMIUM" ], "type": "string" }, "publisher_site_id": { "type": "integer" } }, "title": "Input Site Placement", "type": "object", "x-stoplight": { "id": "input-site-placement", "name": "Input Site Placement", "public": true } }, "input-strategy": { "example": { "bid_price_is_media_only": "0", "budget": "aliqua", "campaign_id": 47950687, "created_on": "2775-05-26T07:55:00.500Z", "currency_code": "exercitation cupidatat magna", "description": "Lorem nisi ", "end_date": "3180-07-29T14:37:26.540Z", "frequency_amount": 97568828, "frequency_interval": "month", "frequency_optimization": "off", "frequency_type": "asap", "goal_type": "cpc", "goal_value": 89456794, "impression_pacing_amount": 77467298, "impression_pacing_interval": "hour", "impression_pacing_type": "asap", "max_bid": 17632443, "max_bid_wm": "elit nulla et", "media_type": "DISPLAY", "min_bid": 20534822, "name": "ex minim eiusmod", "pacing_amount": 46580404, "pacing_interval": "hour", "pacing_type": "asap", "pixel_target_expr": "velit", "roi_target": 45897957, "run_on_all_exchanges": "1", "run_on_all_pmp": "0", "run_on_display": "0", "run_on_mobile": "1", "run_on_streaming": "on", "site_restriction_transparent_urls": "off", "site_selectiveness": "ALL", "start_date": "3201-02-02T11:35:20.790Z", "status": true, "supply_type": "T1_RMX", "targeting_segment_exclude_op": "qui magna cupidatat", "targeting_segment_include_op": "fugiat mollit", "type": "AUD", "updated_on": "2775-05-26T07:55:00.500Z", "use_campaign_end": "off", "use_campaign_start": "off", "use_mm_freq": "off", "use_optimization": "off", "version": 21990818, "zone_name": "nisi veniam pariatur sint" }, "title": "Input Strategy", "type": "object", "x-stoplight": { "id": "input-strategy", "name": "Input Strategy", "public": true }, "properties": { "audience_segment_exclude_op": { "default": "OR", "description": "Exclude associated audience segment from targeting", "enum": [ "AND", "OR" ], "type": "string" }, "audience_segment_include_op": { "default": "OR", "description": "Include associated audience segment in targeting", "enum": [ "AND", "OR" ], "type": "string" }, "bid_aggressiveness": { "default": 50, "description": "Only relevant for strategies with goal_type=’reach’. Reflects the target win rate for bid opportunities that match the strategy’s targeting, e.g. setting bid_aggressiveness to 65% instructs T1 to bid at a level for each impression such that it will win ~65% of the time", "maximum": 100, "minimum": 0, "type": "integer" }, "bid_min_devices": { "type": "integer", "minimum": 1, "maximum": 5 }, "bid_price_is_media_only": { "description": "Informs T1 that value entered on the strategygoal_valuemax_bidshould be the amount forthe \"media only\" (bid_price_is_media_only=1)or \"total spend\" (bid_price_is_media_only=0)\ndefault: 1", "enum": [ "on", "off", "1", "0", "true", "false" ], "type": [ "string", "boolean" ] }, "budget": { "type": "string" }, "campaign_id": { "description": "Specify parent campaign of strategy", "minimum": 0, "type": "integer" }, "created_on": { "format": "date-time", "type": "string" }, "currency_code": { "description": "Currency code for this strategy. Read-only; inherited from the parent campaign.", "type": "string" }, "description": { "maxLength": 1024, "type": "string" }, "device_graph_only": { "type": "boolean" }, "effective_device_graph_only": { "type": "integer", "minimum": 0, "maximum": 1 }, "end_date": { "description": "Date which strategy will end.\n\nrequired if `use_campaign_end='off'`\n\nMust not be set if `use_campaign_end is on`\n", "format": "date-time", "type": "string" }, "exchange_type_for_run_on_all": { "type": "string", "description": "", "enum": [ "ALL_ELIGIBLE", "SELECTED_ONLY", "SOURCE" ] }, "feature_compatibility": { "type": "string", "maxLength": 1024 }, "frequency_amount": { "description": "Maximum frequency of impressions per user within interval set on frequency_interval.\n\nrequired if `frequency_type='even'||'asap'`", "minimum": 0, "type": "integer" }, "frequency_interval": { "description": "Interval applicable for frequency_amount.\n\nrequired if `frequency_type='even'||'asap'`\n", "enum": [ "day", "month", "week", "hour" ], "type": "string" }, "frequency_optimization": { "description": "Indicates whether the strategy should use a T1 Optimized Frequency Cap. Setting this field to \"Off\" means the user will dictate the flat bid price for each impression.", "enum": [ "on", "off", "1", "0" ], "type": "string" }, "frequency_type": { "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap", "enum": [ "even", "asap", "no-limit" ], "type": "string" }, "goal_type": { "description": "The type of bid price optimization (if any) that the strategy will use when buying impressions, as well as the performance metric against which performance will be measured. Allowed values: cpa, cpc, ctr, reach, roi, spend, vcr, viewability_rate, vcpm. See table in Campaigns that shows which strategy goal types are allowed for each campaign goal type.", "enum": [ "cpa", "cpc", "ctr", "reach", "roi", "spend", "vcr", "viewability_rate", "vcpm" ], "type": "string" }, "goal_value": { "description": "Target goal value for strategy respective to the goal_type selection.\n\nrequired if `goal_type in ('cpa','cpc','reach','roi', 'vcr', 'ctr')`\n\nIf goal type is `vcr` or `ctr`, goal_value is a percentage.", "minimum": 0, "type": "number" }, "impression_pacing_amount": { "minimum": 0, "type": "integer" }, "impression_pacing_interval": { "default": "day", "description": "Period of time over which impression pacing is to be distributed", "enum": [ "day", "month", "week", "hour" ], "type": "string" }, "impression_pacing_type": { "description": "Type of impression pacing applied to strategy.", "enum": [ "even", "asap", "no-limit" ], "type": "string" }, "max_bid": { "minimum": 0, "type": "number" }, "max_bid_wm": { "type": "string" }, "media_type": { "description": "Whether the strategy is a display or video strategy", "enum": [ "DISPLAY", "VIDEO" ], "type": "string" }, "min_bid": { "minimum": 0, "type": "number" }, "name": { "description": "Descriptive name of strategy", "maxLength": 128, "type": "string" }, "pacing_amount": { "minimum": 0, "type": "integer" }, "pacing_interval": { "description": "Specify distribution of spend across the pacing_interval", "enum": [ "hour", "day" ], "type": "string" }, "pacing_type": { "description": "Specify distribution of spend across the pacing_interval", "enum": [ "even", "asap" ], "type": "string" }, "pixel_target_expr": { "description": "Specify pixel targeting for the strategy. Poll must be run to obtain available Pixel IDs. To configure Pixel-Targeting, pixels must have previously been generated. See \"API for Event Pixels and Data Pixels\" for more information on creating and obtaining information on Pixels.\n\n( [pixel_id] INCL_COND [pixel_id] ) AND NOT ( [pixel_id EXCL_COND[pixel_id] )1024 characters maximumnote Although theINCL_CONDandEXCL_CONDis not required to be consistent, the conditional logic between all pixels to be included or excluded must be the same.\nmaxLength: 1024", "type": "string" }, "rmx_strategy": { "type": "object", "properties": { "budget_type": { "type": "string", "enum": [ "DOLLARS", "IMPRESSIONS" ] }, "created_on": { "type": "string", "format": "date-time" }, "dynamic_pricing_option": { "type": "string", "enum": [ "AVERAGE", "STANDARD", "WIN", "SPEND" ] }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "learning_budget_pacing": { "type": "string", "enum": [ "ASAP", "EVEN", "HOURLY", "DAILY", "MONTHLY" ] }, "learning_slider": { "type": "integer" }, "name": { "type": "string" }, "pacing": { "type": "string", "enum": [ "asap", "deliver_overall_budget_evenly", "deliver_remaining_budget_evenly", "hourly_asap", "hourly_even", "daily_asap", "daily_even", "monthly_asap", "monthly_even" ] }, "price": { "type": "number" }, "pricing_type": { "type": "string", "enum": [ "CPA", "CPC", "CPM", "DYNAMIC" ] }, "rel": { "type": "string" }, "rmx_push_entity_id": { "type": "integer" }, "rmx_push_status": { "type": "string", "enum": [ "NEW", "UPDATED", "IN_PROGRESS", "PUSH_OK", "PUSH_FAILED" ] }, "roi_cpc_target_ctr": { "type": "string" }, "roi_cpc_target_ctr_type": { "type": "string", "enum": [ "DOLLARS", "PERCENT" ] }, "roi_modifier": { "type": "number" }, "roi_target_pixels": { "type": "array", "items": { "type": "object", "properties": { "created_on": { "type": "string", "format": "date-time" }, "entity_type": { "type": "string", "enum": [ "rmx_strategy_roi_target_pixel" ] }, "id": { "type": "integer" }, "name": { "type": "string" }, "pixel_bundle_id": { "type": "integer" }, "price": { "type": "number" }, "rel": { "type": "string" }, "rmx_pixel_type": { "type": "string", "enum": [ "CLICK", "IMPRESSION", "SEGMENT" ] }, "rmx_strategy_id": { "type": "integer" }, "status": { "type": "boolean" }, "updated_on": { "type": "string", "format": "date-time" }, "version": { "type": "integer" } } } }, "roi_targets": { "type": "string", "enum": [ "NONE", "CPA", "CPC" ] }, "status": { "type": "boolean" }, "strategy_id": { "type": "integer" }, "updated_on": { "type": "string", "format": "date-time" }, "version": { "type": "integer" } } }, "roi_target": { "description": "Desired ROI target declared as a multiple of total_spend.\n\nrequired `if goal_type='roi'`", "minimum": 0, "type": "integer" }, "run_on_all_exchanges": { "enum": [ "on", "off", "1", "0" ], "type": "string" }, "run_on_all_pmp": { "enum": [ "on", "off", "1", "0" ], "type": "string" }, "run_on_display": { "enum": [ "on", "off", "1", "0" ], "type": "string" }, "run_on_mobile": { "enum": [ "on", "off", "1", "0" ], "type": "string" }, "run_on_only_fraud_filtered_exchanges": { "type": "boolean" }, "run_on_streaming": { "enum": [ "on", "off", "1", "0" ], "type": "string" }, "site_restriction_transparent_urls": { "enum": [ "on", "off", "1", "0" ], "type": "string" }, "site_selectiveness": { "type": "string", "default": "REDUCED", "description": "REDUCED is currently the only available option" }, "start_date": { "description": "required if `use_campaign_start='off'` and`can not be updated if strategy has already started`\n\nMust not be set if `use_campaign_start is on`", "format": "date-time", "type": "string" }, "status": { "type": "boolean" }, "supply_type": { "description": "Specify whether impressions will be bought and decisioned by the TerminalOne platform. Use 'RTB' for normal strategies that are bought/decisioned in T1. Use 'RMX_API' to use a tag to track media not purchased through TerminalOne.", "enum": [ "RTB", "RMX_API", "T1_RMX", "MKT" ], "type": "string" }, "targeting_segment_exclude_op": { "type": "string" }, "targeting_segment_include_op": { "type": "string" }, "type": { "description": "Specify the type of strategy (re-marketing (REM), goal-based optimization (GBO), audience (AUD))", "enum": [ "REM", "GBO", "AUD" ], "type": "string" }, "updated_on": { "format": "date-time", "type": "string" }, "use_campaign_end": { "enum": [ "on", "off", "1", "0" ], "type": "string" }, "use_campaign_start": { "enum": [ "on", "off", "1", "0" ], "type": "string" }, "use_mm_freq": { "description": "Unused legacy frequency cap setting. Must be set to 'off'. To control frequency capping at the campaign level, set the strategy-level frequency_type attribute to 'no-limit' and set a frequency cap on the campaign entity.", "enum": [ "on", "off", "1", "0" ], "type": "string" }, "use_optimization": { "description": "Enable's T1 optimization algorithm (defaults to 'off' if unspecified).\n\nrequired if `goal_type!='spend'`", "enum": [ "on", "off", "1", "0" ], "type": "string" }, "version": { "minimum": 0, "type": "integer" }, "zone_name": { "type": "string" } }, "required": [ "campaign_id", "frequency_type", "goal_type", "goal_value", "name", "pacing_amount", "type" ] }, "input-supply-source": { "example": { "audience_segment_exclude_op": "OR", "audience_segment_include_op": "AND", "bid_aggressiveness": 13, "bid_price_is_media_only": false, "budget": [ { "currency_code": "USD", "value": 1.43 } ], "campaign_id": 1234566, "created_on": "2016-05-04T15:44:54+0000", "currency_code": "USD", "effective_goal_value": [ { "currency_code": "USD", "value": "93.0000" } ], "end_date": "2016-05-06T13:44:49+0000", "entity_type": "strategy", "frequency_amount": 3, "frequency_interval": "month", "frequency_type": "even", "goal_type": "reach", "goal_value": [ { "currency_code": "USD", "value": 93 } ], "id": 1234567, "max_bid": [ { "currency_code": "USD", "value": 1.12 } ], "media_type": "VIDEO", "name": "strategy with audience segments", "pacing_amount": [ { "currency_code": "USD", "value": 1.93 } ], "pacing_interval": "hour", "pacing_type": "even", "run_on_all_exchanges": true, "run_on_all_pmp": false, "run_on_display": true, "run_on_mobile": true, "run_on_streaming": false, "site_restriction_transparent_urls": true, "site_selectiveness": "REDUCED", "start_date": "2016-05-05T13:44:49+0000", "status": false, "strategy_audience_segments": [ { "audience_segment_id": 1358322, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 1132601, "name": "Strategy Audience Segments #1132601", "rel": "strategy_audience_segments", "restriction": "INCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 }, { "audience_segment_id": 1405158, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g2", "id": 1132602, "name": "Strategy Audience Segments #1132602", "rel": "strategy_audience_segments", "restriction": "EXCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 }, { "audience_segment_id": 1460324, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 1132600, "name": "Strategy Audience Segments #1132600", "rel": "strategy_audience_segments", "restriction": "INCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 } ], "supply_type": "RTB", "targeting_segment_exclude_op": "OR", "targeting_segment_include_op": "OR", "type": "REM", "updated_on": "2016-05-04T15:44:54+0000", "use_campaign_end": false, "use_campaign_start": false, "use_mm_freq": false, "use_optimization": true, "version": 2, "zone_name": "Europe/Paris" }, "properties": { "accountable_and_addressable": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "attribution_group": { "type": "string" }, "bidder_exchange_identifier": { "type": "integer" }, "code": { "type": "string" }, "distribute": { "type": "boolean" }, "entity_type": { "type": "string" }, "fraud_filter": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "has_connected_tv": { "type": "boolean" }, "has_desktop_video": { "type": "boolean" }, "has_display": { "type": "boolean" }, "has_mobile_display": { "type": "boolean" }, "has_mobile_video": { "type": "boolean" }, "has_video": { "type": "boolean" }, "is_proservice": { "type": "boolean" }, "mm_safe": { "type": "boolean" }, "name": { "type": "string" }, "pmp_enabled": { "type": "boolean" }, "rel": { "type": "string" }, "requires_creative_audit": { "type": "boolean" }, "rtb_enabled": { "type": "boolean" }, "rtb_type": { "type": "string" }, "seat_enabled": { "type": "boolean" }, "status": { "type": "boolean" }, "supply_type": { "type": "string" }, "use_pool": { "type": "boolean" } }, "title": "Input Supply Source", "type": "object", "x-stoplight": { "id": "input-supply-source", "name": "Input Supply Source", "public": true } }, "input_vendor_contract": { "example": { "campaign_id": 22035223, "price": 13971235, "rate_card_type": "CPM", "use_mm_contract": false, "vendor_id": 95836163 }, "properties": { "campaign_id": { "description": "Once set, this field can not be changed.", "type": "integer" }, "price": { "type": "number" }, "rate_card_type": { "enum": [ "CPM", "FIXED" ], "type": "string" }, "use_mm_contract": { "type": "boolean" }, "vendor_id": { "type": "integer" } }, "required": [ "vendor_id", "campaign_id", "use_mm_contract" ], "title": "Input Vendor Contract", "type": "object", "x-stoplight": { "id": "input_vendor_contract", "name": "Input Vendor Contract", "public": true } }, "meta-error": { "properties": { "status": { "enum": [ "error" ], "type": "string" } }, "required": [ "status" ], "title": "Meta (Error)", "type": "object", "x-stoplight": { "id": "meta-error", "name": "Meta (Error)", "public": true } }, "multiResponse": { "example": { "data": [ { "address_1": "occaecat nisi adipisicing labore aliqua", "address_2": "non dolor", "adx_seat_account_id": 98907429, "allow_byo_price": true, "allow_x_agency_pixels": false, "city": "id", "currency_code": "enim mollit exercitation", "entity_type": "ut elit", "mm_contact_name": "dolore eiusmod laboris eu", "phone": "Ut minim nisi et adipisicing", "state": "Lorem cupidatat dolore n", "status": true, "use_evidon_optout": true, "zip": "aliqua" }, { "allow_x_agency_pixels": false, "contact_name": "Ut fugiat dolor", "state": "proident adipisicing est aliqua in" }, { "city": "voluptate ullamco" }, { "contact_name": "qui ex sunt ut", "state": "ut minim", "zip": "et adipisicing est ea dolore" } ], "meta": { "called_on": "", "count": -72242440, "etag": "elit veniam occaecat", "offset": 44614629, "status": "nostrud", "total_count": 65377386 } }, "properties": { "data": { "items": { "example": { "address_1": "1440 Broadway", "address_2": "4WTC", "adx_seat_account_id": 95819908, "allow_byo_price": true, "allow_x_agency_pixels": true, "billing_country_code": "US", "city": "New York", "contact_name": "Ian Hummel", "country": "US", "created_on": "2010-10-19T16:58:05+0000", "currency_code": "USD", "dmp_enabled": "enabled", "entity_type": "organization", "id": 100048, "mm_contact_name": "Ian Hummel", "name": "ACME Org", "opt_out_connected_id": true, "opt_out_connected_id_mathid": false, "org_type": [ "buyer" ], "override_suspicious_traffic_filter": false, "phone": "(347) 420-0116", "restrict_targeting_to_deterministic_id": true, "restrict_targeting_to_same_device_id": true, "service_provider_ccpa": true, "state": "NY", "status": true, "suspicious_traffic_filter_level": 25, "terminated": false, "updated_on": "2016-11-03T19:39:12+0000", "use_evidon_optout": true, "version": 126, "zip": "10018" }, "title": "Organization", "type": "object", "x-stoplight": { "id": "organization", "name": "Organization", "public": true }, "properties": { "accountable_and_addressable": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "address_1": { "type": "string" }, "address_2": { "type": "string" }, "adx_seat_account_id": { "description": "Passed to ADX upon creative registration so ADX knows which seat we're registering under.", "type": "integer" }, "allow_byo_price": { "type": "boolean" }, "allow_x_agency_pixels": { "description": "This field enables the Data Co-op functionality across all the Advertisers under this organization. Cross-Advertiser Pixel Targeting allows Advertisers to target other Advertiser Event Pixels within their Agency and any other similarly enabled Agency under the same Organization.", "type": "boolean" }, "billing_country_code": { "description": "Country code that is used for billing purposes", "type": "string" }, "city": { "type": "string" }, "connected_id_type": { "type": "string", "enum": [ "DETERMINISTIC_FIRST", "DETERMINISTIC_ONLY" ] }, "contact_name": { "description": "This is the primary contact at the organization regarding contract issues.", "type": "string" }, "country": { "type": "string" }, "created_on": { "type": "string" }, "currency_code": { "description": "Currency code for the campaign budget and spend, as well as billing", "type": "string" }, "dmp_enabled": { "type": "string" }, "eligibile_for_data_sharing": { "type": "boolean" }, "entity_type": { "type": "string" }, "facebook": { "type": "string" }, "holding_org_id": { "type": "integer" }, "id": { "type": "integer" }, "linkedin": { "type": "string" }, "mm_contact_name": { "description": "This is the name of the primary internal MediaMath contact of the Organization.", "type": "string" }, "name": { "description": "The Name of the organization with whom the contract is held. This can be an agency holding company, agency, advertiser, network, or other media or data buying entity.", "type": "string" }, "opt_out_connected_id": { "type": "boolean" }, "opt_out_connected_id_mathid": { "type": "boolean" }, "org_type": { "type": "array", "items": { "type": "string" } }, "override_suspicious_traffic_filter": { "description": "Set flag to 'on’ to be able to override default org wide suspicious traffic filter level ", "type": "boolean" }, "phone": { "type": "string" }, "restrict_targeting_to_deterministic_id": { "type": "boolean", "default": true, "description": "This is a deprecated field, which now only allows the value 'true'." }, "restrict_targeting_to_same_device_id": { "type": "boolean" }, "state": { "type": "string" }, "service_provider_ccpa": { "type": "boolean", "description": "Represents whether a service provider agreement was signed by the organization owner in accordance with CCPA" }, "status": { "description": "of organization (defaults to off if unspecified)", "type": "boolean" }, "suspicious_traffic_filter_level": { "description": "Specify an organization-wide level of suspicious traffic filtering to use. See the Knowledge Base for additional details about this feature. This setting will only take affect if the organization's override_suspicious_traffic_filter property is set to 'on'.\n\nIf override_suspicious_traffic_filter is enabled and suspicious_traffic_filter_level is set to 0, all fraud and suspicious ", "type": "integer" }, "terminated": { "type": "boolean" }, "updated_on": { "type": "string" }, "use_evidon_optout": { "description": "Set flag to 'on’ to show an opt out button on the organization's ads (additional CPM fee will apply when on) ", "type": "boolean" }, "version": { "type": "integer" }, "zip": { "type": "string" } } }, "type": "array" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } }, "title": "multiResponse", "type": "object", "x-stoplight": { "id": "multiResponse", "name": "multiResponse", "public": true } }, "organization": { "example": { "address_1": "1440 Broadway", "address_2": "4WTC", "adx_seat_account_id": 95819908, "allow_byo_price": true, "allow_x_agency_pixels": true, "billing_country_code": "US", "city": "New York", "contact_name": "Ian Hummel", "country": "US", "created_on": "2010-10-19T16:58:05+0000", "currency_code": "USD", "dmp_enabled": "enabled", "entity_type": "organization", "id": 100048, "mm_contact_name": "Ian Hummel", "name": "ACME Org", "opt_out_connected_id": true, "opt_out_connected_id_mathid": false, "org_type": [ "buyer" ], "override_suspicious_traffic_filter": false, "phone": "(347) 420-0116", "restrict_targeting_to_deterministic_id": true, "restrict_targeting_to_same_device_id": true, "service_provider_ccpa": true, "state": "NY", "status": true, "suspicious_traffic_filter_level": 25, "terminated": false, "updated_on": "2016-11-03T19:39:12+0000", "use_evidon_optout": true, "version": 126, "zip": "10018" }, "title": "Organization", "type": "object", "x-stoplight": { "id": "organization", "name": "Organization", "public": true }, "properties": { "accountable_and_addressable": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "address_1": { "type": "string" }, "address_2": { "type": "string" }, "adx_seat_account_id": { "description": "Passed to ADX upon creative registration so ADX knows which seat we're registering under.", "type": "integer" }, "allow_byo_price": { "type": "boolean" }, "allow_x_agency_pixels": { "description": "This field enables the Data Co-op functionality across all the Advertisers under this organization. Cross-Advertiser Pixel Targeting allows Advertisers to target other Advertiser Event Pixels within their Agency and any other similarly enabled Agency under the same Organization.", "type": "boolean" }, "billing_country_code": { "description": "Country code that is used for billing purposes", "type": "string" }, "city": { "type": "string" }, "connected_id_type": { "type": "string", "enum": [ "DETERMINISTIC_FIRST", "DETERMINISTIC_ONLY" ] }, "contact_name": { "description": "This is the primary contact at the organization regarding contract issues.", "type": "string" }, "country": { "type": "string" }, "created_on": { "type": "string" }, "currency_code": { "description": "Currency code for the campaign budget and spend, as well as billing", "type": "string" }, "dmp_enabled": { "type": "string" }, "eligibile_for_data_sharing": { "type": "boolean" }, "entity_type": { "type": "string" }, "facebook": { "type": "string" }, "holding_org_id": { "type": "integer" }, "id": { "type": "integer" }, "linkedin": { "type": "string" }, "mm_contact_name": { "description": "This is the name of the primary internal MediaMath contact of the Organization.", "type": "string" }, "name": { "description": "The Name of the organization with whom the contract is held. This can be an agency holding company, agency, advertiser, network, or other media or data buying entity.", "type": "string" }, "opt_out_connected_id": { "type": "boolean" }, "opt_out_connected_id_mathid": { "type": "boolean" }, "org_type": { "type": "array", "items": { "type": "string" } }, "override_suspicious_traffic_filter": { "description": "Set flag to 'on’ to be able to override default org wide suspicious traffic filter level ", "type": "boolean" }, "phone": { "type": "string" }, "restrict_targeting_to_deterministic_id": { "type": "boolean", "default": true, "description": "This is a deprecated field, which now only allows the value 'true'." }, "restrict_targeting_to_same_device_id": { "type": "boolean" }, "state": { "type": "string" }, "service_provider_ccpa": { "type": "boolean", "description": "Represents whether a service provider agreement was signed by the organization owner in accordance with CCPA" }, "status": { "description": "of organization (defaults to off if unspecified)", "type": "boolean" }, "suspicious_traffic_filter_level": { "description": "Specify an organization-wide level of suspicious traffic filtering to use. See the Knowledge Base for additional details about this feature. This setting will only take affect if the organization's override_suspicious_traffic_filter property is set to 'on'.\n\nIf override_suspicious_traffic_filter is enabled and suspicious_traffic_filter_level is set to 0, all fraud and suspicious ", "type": "integer" }, "terminated": { "type": "boolean" }, "updated_on": { "type": "string" }, "use_evidon_optout": { "description": "Set flag to 'on’ to show an opt out button on the organization's ads (additional CPM fee will apply when on) ", "type": "boolean" }, "version": { "type": "integer" }, "zip": { "type": "string" } } }, "output-common-meta": { "example": { "meta": { "called_on": "2017-06-02T23:36:05+0000", "count": 2, "etag": "5e446abf85396cc1e516a67b2ecd637ee8f8ac34", "offset": 0, "status": "ok", "total_count": 0 } }, "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "Output Common Meta", "type": "object", "x-stoplight": { "id": "output-common-meta", "name": "Output Common Meta", "public": true } }, "output-concept": { "allOf": [ { "properties": { "advertiser_id": { "type": "integer" }, "name": { "type": "string" }, "status": { "type": "boolean" } }, "required": [ "advertiser_id", "name" ], "title": "Input Concept", "type": "object", "x-stoplight": { "id": "input-concept", "name": "Input Concept", "public": true } }, { "example": { "created_on": "4838-01-01T02:34:39.905Z", "id": 1, "updated_on": "3214-02-18T04:49:20.878Z", "version": 46559379 }, "properties": { "created_on": { "format": "date-time", "type": "string" }, "id": { "minimum": 0, "type": "integer" }, "updated_on": { "format": "date-time", "type": "string" }, "version": { "type": "integer" } }, "title": "Output Common", "type": "object", "x-stoplight": { "id": "output_common", "name": "Output Common", "public": true } } ], "title": "Output Concept", "type": "object", "x-stoplight": { "id": "output-concept", "name": "Output Concept", "public": true } }, "output-site-placement": { "allOf": [ { "example": { "audience_segment_exclude_op": "OR", "audience_segment_include_op": "AND", "bid_aggressiveness": 13, "bid_price_is_media_only": false, "budget": [ { "currency_code": "USD", "value": 1.43 } ], "campaign_id": 1234566, "created_on": "2016-05-04T15:44:54+0000", "currency_code": "USD", "effective_goal_value": [ { "currency_code": "USD", "value": "93.0000" } ], "end_date": "2016-05-06T13:44:49+0000", "entity_type": "strategy", "frequency_amount": 3, "frequency_interval": "month", "frequency_type": "even", "goal_type": "reach", "goal_value": [ { "currency_code": "USD", "value": 93 } ], "id": 1234567, "max_bid": [ { "currency_code": "USD", "value": 1.12 } ], "media_type": "video", "name": "strategy with audience segments", "pacing_amount": [ { "currency_code": "USD", "value": 1.93 } ], "pacing_interval": "hour", "pacing_type": "even", "run_on_all_exchanges": true, "run_on_all_pmp": false, "run_on_display": true, "run_on_mobile": true, "run_on_streaming": false, "site_restriction_transparent_urls": true, "site_selectiveness": "REDUCED", "start_date": "2016-05-05T13:44:49+0000", "status": false, "strategy_audience_segments": [ { "audience_segment_id": 1405158, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g2", "id": 1132602, "name": "Strategy Audience Segments #1132602", "rel": "strategy_audience_segments", "restriction": "EXCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 }, { "audience_segment_id": 1358322, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 1132601, "name": "Strategy Audience Segments #1132601", "rel": "strategy_audience_segments", "restriction": "INCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 }, { "audience_segment_id": 1460324, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 1132600, "name": "Strategy Audience Segments #1132600", "rel": "strategy_audience_segments", "restriction": "INCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 } ], "supply_type": "RTB", "targeting_segment_exclude_op": "OR", "targeting_segment_include_op": "OR", "type": "REM", "updated_on": "2016-05-04T15:44:54+0000", "use_campaign_end": false, "use_campaign_start": false, "use_mm_freq": false, "use_optimization": true, "version": 2, "zone_name": "Europe/Paris" }, "properties": { "bill_media_to_client": { "type": "boolean" }, "deal_source": { "enum": [ "USER", "INTERNAL" ], "type": "string" }, "display_text": { "maxLength": 255, "type": "string" }, "media_type": { "enum": [ "display", "video", "mobile" ], "type": "string" }, "name": { "maxLength": 64, "type": "string" }, "pmp_type": { "enum": [ "DIRECT", "PREMIUM" ], "type": "string" }, "publisher_site_id": { "type": "integer" } }, "title": "Input Site Placement", "type": "object", "x-stoplight": { "id": "input-site-placement", "name": "Input Site Placement", "public": true } }, { "example": { "created_on": "4838-01-01T02:34:39.905Z", "id": 1, "updated_on": "3214-02-18T04:49:20.878Z", "version": 46559379 }, "properties": { "created_on": { "format": "date-time", "type": "string" }, "id": { "minimum": 0, "type": "integer" }, "updated_on": { "format": "date-time", "type": "string" }, "version": { "type": "integer" } }, "title": "Output Common", "type": "object", "x-stoplight": { "id": "output_common", "name": "Output Common", "public": true } } ], "title": "Output Site Placement", "x-stoplight": { "id": "output-site-placement", "name": "Output Site Placement", "public": true } }, "output-strategy": { "example": { "audience_segment_exclude_op": "OR", "audience_segment_include_op": "OR", "bid_aggressiveness": 50, "bid_price_is_media_only": true, "budget": [ { "currency_code": "USD", "value": 1095.43 } ], "campaign_id": 342332, "created_on": "2017-03-05T16:23:46+0000", "currency_code": "USD", "effective_goal_value": [ { "currency_code": "USD", "value": "85.0000" } ], "end_date": "2017-11-01T03:59:59+0000", "entity_type": "strategy", "frequency_amount": 15, "frequency_interval": "day", "frequency_optimization": false, "frequency_type": "even", "goal_type": "cpa", "goal_value": [ { "currency_code": "USD", "value": 85 } ], "id": 2059202, "impression_pacing_interval": "day", "impression_pacing_type": "no-limit", "max_bid": [ { "currency_code": "USD", "value": 1.19 } ], "media_type": "DISPLAY", "min_bid": [ { "currency_code": "USD", "value": 0 } ], "name": "Q7HGQ1YS000_ZIPs", "pacing_amount": [ { "currency_code": "USD", "value": 0.01 } ], "pacing_interval": "hour", "pacing_type": "even", "pixel_target_expr": "NOT ( [1141991] )", "run_on_all_exchanges": false, "run_on_all_pmp": false, "run_on_display": true, "run_on_mobile": true, "run_on_streaming": false, "site_restriction_transparent_urls": false, "site_selectiveness": "REDUCED", "status": true, "supply_type": "RTB", "targeting_segment_exclude_op": "OR", "targeting_segment_include_op": "OR", "type": "GBO", "updated_on": "2017-10-18T12:44:52+0000", "use_campaign_end": false, "use_campaign_start": true, "use_mm_freq": false, "use_optimization": true, "version": 995, "zone_name": "America/New_York" }, "title": "Output Strategy", "type": "object", "x-stoplight": { "id": "output-strategy", "name": "Output Strategy", "public": true }, "properties": { "audience_segment_exclude_op": { "type": "string", "enum": [ "AND", "OR" ], "description": "Exclude associated audience segment from targeting" }, "audience_segment_include_op": { "type": "string", "enum": [ "AND", "OR" ], "description": "Include associated audience segment in targeting" }, "bid_aggressiveness": { "type": "integer", "description": "Only relevant for strategies with goal_type=’reach’. Reflects the target win rate for bid opportunities that match the strategy’s targeting, e.g. setting bid_aggressiveness to 65% instructs T1 to bid at a level for each impression such that it will win ~65% of the time" }, "bid_min_devices": { "type": "integer", "minimum": 1, "maximum": 5 }, "bid_price_is_media_only": { "type": "boolean", "description": "Informs T1 that value entered on the strategygoal_valuemax_bidshould be the amount forthe \"media only\" (bid_price_is_media_only=1)or \"total spend\" (bid_price_is_media_only=0)\ndefault: 1" }, "budget": { "type": "array", "description": "Currency code for this strategy. Read-only; inherited from the parent campaign.", "items": { "type": "object", "properties": { "currency_code": { "type": "string", "description": "Currency code for this strategy. Read-only; inherited from the parent campaign." }, "value": { "type": "number" } } } }, "campaign_id": { "type": "integer", "description": "Specify parent campaign of strategy" }, "created_on": { "type": "string" }, "currency_code": { "type": "string", "description": "ISO 4217 3-letter currency code" }, "device_graph_only": { "type": "boolean" }, "effective_device_graph_only": { "type": "integer", "minimum": 0, "maximum": 1 }, "effective_goal_value": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "string" } } } }, "end_date": { "type": "string" }, "entity_type": { "type": "string" }, "exchange_type_for_run_on_all": { "type": "string", "description": "", "enum": [ "ALL_ELIGIBLE", "SELECTED_ONLY", "SOURCE" ] }, "feature_compatibility": { "type": "string", "maxLength": 1024 }, "frequency_amount": { "type": "integer", "description": "Maximum frequency of impressions per user within interval set on frequency_interval.\n\nrequired if `frequency_type='even'||'asap'`" }, "frequency_interval": { "type": "string", "description": "Interval applicable for frequency_amount.\n\nrequired if `frequency_type='even'||'asap'`\n", "enum": [ "day", "hour", "week", "month", "campaign", "not-applicable" ] }, "frequency_optimization": { "type": "boolean", "description": "Indicates whether the strategy should use a T1 Optimized Frequency Cap. Setting this field to \"Off\" means the user will dictate the flat bid price for each impression." }, "frequency_type": { "type": "string", "enum": [ "even", "asap", "no-limit" ] }, "goal_type": { "type": "string", "description": "The type of bid price optimization (if any) that the strategy will use when buying impressions, as well as the performance metric against which performance will be measured. Allowed values: roi, cpa, cpc, ctr, vcr, viewability_rate, vcpm, reach, spend. See table in Campaigns that shows which strategy goal types are allowed for each campaign goal type.", "enum": [ "roi", "cpa", "cpc", "ctr", "vcr", "viewability_rate", "vcpm", "reach", "spend" ] }, "goal_value": { "type": "array", "description": "Target goal value for strategy respective to the goal_type selection.\n\nrequired if `goal_type in ('cpa','cpc','reach','roi', 'vcr', 'ctr')`\n\nIf goal type is `vcr` or `ctr`, goal_value is a percentage.", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } } } }, "id": { "type": "integer" }, "impression_pacing_interval": { "type": "string", "description": "Period of time over which impression pacing is to be distributed", "enum": [ "day", "hour", "week", "month", "campaign", "not-applicable" ] }, "impression_pacing_type": { "type": "string", "description": "Type of impression pacing applied to strategy.", "enum": [ "even", "asap", "no-limit" ] }, "max_bid": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "number" } } } }, "media_type": { "type": "string", "description": "Whether the strategy is a display or video strategy", "enum": [ "VIDEO", "DISPLAY" ] }, "min_bid": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } } } }, "name": { "type": "string", "description": "Descriptive name of strategy" }, "pacing_amount": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "number" } } } }, "pacing_interval": { "type": "string", "description": "Specify distribution of spend across the pacing_interval" }, "pacing_type": { "type": "string", "description": "Specify distribution of spend across the pacing_interval" }, "pixel_target_expr": { "type": "string", "description": "Specify pixel targeting for the strategy. Poll must be run to obtain available Pixel IDs. To configure Pixel-Targeting, pixels must have previously been generated. See \"API for Event Pixels and Data Pixels\" for more information on creating and obtaining information on Pixels.\n\n( [pixel_id] INCL_COND [pixel_id] ) AND NOT ( [pixel_id EXCL_COND[pixel_id] )1024 characters maximumnote Although theINCL_CONDandEXCL_CONDis not required to be consistent, the conditional logic between all pixels to be included or excluded must be the same.\nmaxLength: 1024" }, "rmx_strategy": { "type": "object", "properties": { "budget_type": { "type": "string", "enum": [ "DOLLARS", "IMPRESSIONS" ] }, "created_on": { "type": "string", "format": "date-time" }, "dynamic_pricing_option": { "type": "string", "enum": [ "AVERAGE", "STANDARD", "WIN", "SPEND" ] }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "learning_budget_pacing": { "type": "string", "enum": [ "ASAP", "EVEN", "HOURLY", "DAILY", "MONTHLY" ] }, "learning_slider": { "type": "integer" }, "name": { "type": "string" }, "pacing": { "type": "string", "enum": [ "asap", "deliver_overall_budget_evenly", "deliver_remaining_budget_evenly", "hourly_asap", "hourly_even", "daily_asap", "daily_even", "monthly_asap", "monthly_even" ] }, "price": { "type": "number" }, "pricing_type": { "type": "string", "enum": [ "CPA", "CPC", "CPM", "DYNAMIC" ] }, "rel": { "type": "string" }, "rmx_push_entity_id": { "type": "integer" }, "rmx_push_status": { "type": "string", "enum": [ "NEW", "UPDATED", "IN_PROGRESS", "PUSH_OK", "PUSH_FAILED" ] }, "roi_cpc_target_ctr": { "type": "string" }, "roi_cpc_target_ctr_type": { "type": "string", "enum": [ "DOLLARS", "PERCENT" ] }, "roi_modifier": { "type": "number" }, "roi_target_pixels": { "type": "array", "items": { "type": "object", "properties": { "created_on": { "type": "string", "format": "date-time" }, "entity_type": { "type": "string", "enum": [ "rmx_strategy_roi_target_pixel" ] }, "id": { "type": "integer" }, "name": { "type": "string" }, "pixel_bundle_id": { "type": "integer" }, "price": { "type": "number" }, "rel": { "type": "string" }, "rmx_pixel_type": { "type": "string", "enum": [ "CLICK", "IMPRESSION", "SEGMENT" ] }, "rmx_strategy_id": { "type": "integer" }, "status": { "type": "boolean" }, "updated_on": { "type": "string", "format": "date-time" }, "version": { "type": "integer" } } } }, "roi_targets": { "type": "string", "enum": [ "NONE", "CPA", "CPC" ] }, "status": { "type": "boolean" }, "strategy_id": { "type": "integer" }, "updated_on": { "type": "string", "format": "date-time" }, "version": { "type": "integer" } } }, "run_on_all_exchanges": { "type": "boolean" }, "run_on_all_pmp": { "type": "boolean" }, "run_on_display": { "type": "boolean" }, "run_on_mobile": { "type": "boolean" }, "run_on_only_fraud_filtered_exchanges": { "type": "boolean" }, "run_on_streaming": { "type": "boolean" }, "site_restriction_transparent_urls": { "type": "boolean" }, "site_selectiveness": { "type": "string", "description": "REDUCED is currently the only available option", "enum": [ "REDUCED" ] }, "start_date": { "type": "string" }, "status": { "type": "boolean" }, "supply_type": { "type": "string", "description": "Specify whether impressions will be bought and decisioned by the TerminalOne platform. Use 'RTB' for normal strategies that are bought/decisioned in T1. Use 'RMX_API' to use a tag to track media not purchased through TerminalOne.", "enum": [ "MKT", "RTB", "T1_RMX", "RMX_API" ] }, "targeting_segment_exclude_op": { "type": "string" }, "targeting_segment_include_op": { "type": "string" }, "type": { "type": "string", "description": "Specify the type of strategy (re-marketing (REM), goal-based optimization (GBO), audience (AUD))", "enum": [ "REM", "GBO", "AUD" ] }, "updated_on": { "type": "string" }, "use_campaign_end": { "type": "boolean" }, "use_campaign_start": { "type": "boolean" }, "use_mm_freq": { "type": "boolean", "description": "Unused legacy frequency cap setting. Must be set to 'off'. To control frequency capping at the campaign level, set the strategy-level frequency_type attribute to 'no-limit' and set a frequency cap on the campaign entity." }, "use_optimization": { "type": "boolean", "description": "Enable's T1 optimization algorithm (defaults to 'off' if unspecified).\n\nrequired if `goal_type!='spend'`" }, "version": { "type": "integer" }, "zone_name": { "type": "string" } } }, "output-strategy-domain-restriction": { "example": { "created_at": "est ullamco minim veniam pariatur", "domain": "dolor aliqua officia", "entity_type": "labore", "id": 1259174, "name": "mollit ipsum dolor minim", "rel": "consectetur in qui", "restriction": "EXCLUDE", "strategy_id": 10057258, "target_type": "dolor aliquip sunt ea Lorem", "updated_on": "cupidatat nostrud officia", "version": 31898334 }, "properties": { "created_at": { "type": "string" }, "domain": { "type": "string" }, "entity_type": { "type": "string" }, "id": { "minimum": 0, "type": "integer" }, "name": { "type": "string" }, "rel": { "type": "string" }, "restriction": { "enum": [ "INCLUDE", "EXCLUDE" ], "type": "string" }, "strategy_id": { "minimum": 0, "type": "integer" }, "target_type": { "type": "string" }, "updated_on": { "type": "string" }, "version": { "minimum": 0, "type": "integer" } }, "title": "Output Strategy Domain Restriction", "type": "object", "x-stoplight": { "id": "output-strategy-domain-restriction", "name": "Output Strategy Domain Restriction", "public": true } }, "output-strategy-site-list": { "example": { "assigned": false, "campaign_assigned": false, "created_on": "2017-05-07T14:24:52+0000", "entity_type": "site_lists_for_strategy", "filename": "ArtemisAlliance_MQB_Impact_below10.csv", "id": 103095, "name": "ArtemisAlliance_MQB_Impact_below10", "organization_id": 101017, "restriction": "EXCLUDE", "sites_count": 855, "sites_count_domain": 855, "status": true, "strategy_assigned": false, "strategy_id": 2316681, "updated_on": "2017-05-07T14:24:52+0000", "version": 0 }, "properties": { "assigned": { "type": "boolean" }, "campaign_assigned": { "type": "boolean" }, "created_on": { "type": "string" }, "entity_type": { "type": "string" }, "filename": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "organization_id": { "type": "integer" }, "restriction": { "type": "string" }, "sites_count": { "type": "integer" }, "sites_count_domain": { "type": "integer" }, "status": { "type": "boolean" }, "strategy_assigned": { "type": "boolean" }, "strategy_id": { "type": "integer" }, "updated_on": { "type": "string" }, "version": { "type": "integer" } }, "title": "Output Strategy Site List", "type": "object", "x-stoplight": { "id": "output-strategy-site-list", "name": "Output Strategy Site List", "public": true } }, "output-strategy-site-lists": { "properties": { "data": { "items": { "example": { "assigned": false, "campaign_assigned": false, "created_on": "2017-05-07T14:24:52+0000", "entity_type": "site_lists_for_strategy", "filename": "ArtemisAlliance_MQB_Impact_below10.csv", "id": 103095, "name": "ArtemisAlliance_MQB_Impact_below10", "organization_id": 101017, "restriction": "EXCLUDE", "sites_count": 855, "sites_count_domain": 855, "status": true, "strategy_assigned": false, "strategy_id": 2316681, "updated_on": "2017-05-07T14:24:52+0000", "version": 0 }, "properties": { "assigned": { "type": "boolean" }, "campaign_assigned": { "type": "boolean" }, "created_on": { "type": "string" }, "entity_type": { "type": "string" }, "filename": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "organization_id": { "type": "integer" }, "restriction": { "type": "string" }, "sites_count": { "type": "integer" }, "sites_count_domain": { "type": "integer" }, "status": { "type": "boolean" }, "strategy_assigned": { "type": "boolean" }, "strategy_id": { "type": "integer" }, "updated_on": { "type": "string" }, "version": { "type": "integer" } }, "title": "Output Strategy Site List", "type": "object", "x-stoplight": { "id": "output-strategy-site-list", "name": "Output Strategy Site List", "public": true } }, "type": "array" }, "uuid": { "type": "string" }, "meta": { "example": { "meta": { "called_on": "2017-06-02T23:36:05+0000", "count": 2, "etag": "5e446abf85396cc1e516a67b2ecd637ee8f8ac34", "offset": 0, "status": "ok", "total_count": 0 } }, "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "Output Common Meta", "type": "object", "x-stoplight": { "id": "output-common-meta", "name": "Output Common Meta", "public": true } } }, "title": "Output Strategy Site Lists", "type": "object", "x-stoplight": { "id": "output-strategy-site-lists", "name": "Output Strategy Site Lists", "public": true } }, "output-strategy-supplies": { "example": { "budget": [ { "currency_code": "BBD", "value": 45211449 }, { "currency_code": "MYR", "value": 35095015 } ], "campaign_id": 57944009, "effective_goal_value": [ {}, { "currency_code": "ut" } ], "frequency_amount": -67621845, "frequency_interval": "est eu non Duis", "frequency_type": "exercitation", "goal_type": "ctr", "goal_value": [ { "value": 30107357 }, {}, {}, { "currency_code": "adipisicing dolor pariatur elit" } ], "id": "in sed adipisicing officia sunt", "impression_pacing_interval": "sint deserunt fugiat", "max_bid": 31218606, "min_bid": 76144435, "name": "eu", "pacing_amount": [ { "currency_code": "USD", "value": 62837980 }, { "currency_code": "CDF", "value": 57022846 }, { "currency_code": "GNF", "value": 74611370 } ], "pacing_interval": "laborum ex reprehenderit fugiat ipsum", "run_on_display": true, "site_selectiveness": "dolore", "start_date": "qui fugiat officia occaecat", "targeting_segment_include_op": "occaecat incididunt", "type": "qui est culpa", "version": 7965970, "zone_name": "non dolore do" }, "title": "Output Strategy Supplies", "type": "object", "x-stoplight": { "id": "output-strategy-supplies", "name": "Output Strategy Supplies", "public": true }, "properties": { "data": { "allOf": [ { "example": { "audience_segment_exclude_op": "OR", "audience_segment_include_op": "OR", "bid_aggressiveness": 50, "bid_price_is_media_only": true, "budget": [ { "currency_code": "USD", "value": 1095.43 } ], "campaign_id": 342332, "created_on": "2017-03-05T16:23:46+0000", "currency_code": "USD", "effective_goal_value": [ { "currency_code": "USD", "value": "85.0000" } ], "end_date": "2017-11-01T03:59:59+0000", "entity_type": "strategy", "frequency_amount": 15, "frequency_interval": "day", "frequency_optimization": false, "frequency_type": "even", "goal_type": "cpa", "goal_value": [ { "currency_code": "USD", "value": 85 } ], "id": 2059202, "impression_pacing_interval": "day", "impression_pacing_type": "no-limit", "max_bid": [ { "currency_code": "USD", "value": 1.19 } ], "media_type": "DISPLAY", "min_bid": [ { "currency_code": "USD", "value": 0 } ], "name": "Q7HGQ1YS000_ZIPs", "pacing_amount": [ { "currency_code": "USD", "value": 0.01 } ], "pacing_interval": "hour", "pacing_type": "even", "pixel_target_expr": "NOT ( [1141991] )", "run_on_all_exchanges": false, "run_on_all_pmp": false, "run_on_display": true, "run_on_mobile": true, "run_on_streaming": false, "site_restriction_transparent_urls": false, "site_selectiveness": "REDUCED", "status": true, "supply_type": "RTB", "targeting_segment_exclude_op": "OR", "targeting_segment_include_op": "OR", "type": "GBO", "updated_on": "2017-10-18T12:44:52+0000", "use_campaign_end": false, "use_campaign_start": true, "use_mm_freq": false, "use_optimization": true, "version": 995, "zone_name": "America/New_York" }, "title": "Output Strategy", "type": "object", "x-stoplight": { "id": "output-strategy", "name": "Output Strategy", "public": true }, "properties": { "audience_segment_exclude_op": { "type": "string", "enum": [ "AND", "OR" ], "description": "Exclude associated audience segment from targeting" }, "audience_segment_include_op": { "type": "string", "enum": [ "AND", "OR" ], "description": "Include associated audience segment in targeting" }, "bid_aggressiveness": { "type": "integer", "description": "Only relevant for strategies with goal_type=’reach’. Reflects the target win rate for bid opportunities that match the strategy’s targeting, e.g. setting bid_aggressiveness to 65% instructs T1 to bid at a level for each impression such that it will win ~65% of the time" }, "bid_min_devices": { "type": "integer", "minimum": 1, "maximum": 5 }, "bid_price_is_media_only": { "type": "boolean", "description": "Informs T1 that value entered on the strategygoal_valuemax_bidshould be the amount forthe \"media only\" (bid_price_is_media_only=1)or \"total spend\" (bid_price_is_media_only=0)\ndefault: 1" }, "budget": { "type": "array", "description": "Currency code for this strategy. Read-only; inherited from the parent campaign.", "items": { "type": "object", "properties": { "currency_code": { "type": "string", "description": "Currency code for this strategy. Read-only; inherited from the parent campaign." }, "value": { "type": "number" } } } }, "campaign_id": { "type": "integer", "description": "Specify parent campaign of strategy" }, "created_on": { "type": "string" }, "currency_code": { "type": "string", "description": "ISO 4217 3-letter currency code" }, "device_graph_only": { "type": "boolean" }, "effective_device_graph_only": { "type": "integer", "minimum": 0, "maximum": 1 }, "effective_goal_value": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "string" } } } }, "end_date": { "type": "string" }, "entity_type": { "type": "string" }, "exchange_type_for_run_on_all": { "type": "string", "description": "", "enum": [ "ALL_ELIGIBLE", "SELECTED_ONLY", "SOURCE" ] }, "feature_compatibility": { "type": "string", "maxLength": 1024 }, "frequency_amount": { "type": "integer", "description": "Maximum frequency of impressions per user within interval set on frequency_interval.\n\nrequired if `frequency_type='even'||'asap'`" }, "frequency_interval": { "type": "string", "description": "Interval applicable for frequency_amount.\n\nrequired if `frequency_type='even'||'asap'`\n", "enum": [ "day", "hour", "week", "month", "campaign", "not-applicable" ] }, "frequency_optimization": { "type": "boolean", "description": "Indicates whether the strategy should use a T1 Optimized Frequency Cap. Setting this field to \"Off\" means the user will dictate the flat bid price for each impression." }, "frequency_type": { "type": "string", "enum": [ "even", "asap", "no-limit" ] }, "goal_type": { "type": "string", "description": "The type of bid price optimization (if any) that the strategy will use when buying impressions, as well as the performance metric against which performance will be measured. Allowed values: roi, cpa, cpc, ctr, vcr, viewability_rate, vcpm, reach, spend. See table in Campaigns that shows which strategy goal types are allowed for each campaign goal type.", "enum": [ "roi", "cpa", "cpc", "ctr", "vcr", "viewability_rate", "vcpm", "reach", "spend" ] }, "goal_value": { "type": "array", "description": "Target goal value for strategy respective to the goal_type selection.\n\nrequired if `goal_type in ('cpa','cpc','reach','roi', 'vcr', 'ctr')`\n\nIf goal type is `vcr` or `ctr`, goal_value is a percentage.", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } } } }, "id": { "type": "integer" }, "impression_pacing_interval": { "type": "string", "description": "Period of time over which impression pacing is to be distributed", "enum": [ "day", "hour", "week", "month", "campaign", "not-applicable" ] }, "impression_pacing_type": { "type": "string", "description": "Type of impression pacing applied to strategy.", "enum": [ "even", "asap", "no-limit" ] }, "max_bid": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "number" } } } }, "media_type": { "type": "string", "description": "Whether the strategy is a display or video strategy", "enum": [ "VIDEO", "DISPLAY" ] }, "min_bid": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } } } }, "name": { "type": "string", "description": "Descriptive name of strategy" }, "pacing_amount": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "number" } } } }, "pacing_interval": { "type": "string", "description": "Specify distribution of spend across the pacing_interval" }, "pacing_type": { "type": "string", "description": "Specify distribution of spend across the pacing_interval" }, "pixel_target_expr": { "type": "string", "description": "Specify pixel targeting for the strategy. Poll must be run to obtain available Pixel IDs. To configure Pixel-Targeting, pixels must have previously been generated. See \"API for Event Pixels and Data Pixels\" for more information on creating and obtaining information on Pixels.\n\n( [pixel_id] INCL_COND [pixel_id] ) AND NOT ( [pixel_id EXCL_COND[pixel_id] )1024 characters maximumnote Although theINCL_CONDandEXCL_CONDis not required to be consistent, the conditional logic between all pixels to be included or excluded must be the same.\nmaxLength: 1024" }, "rmx_strategy": { "type": "object", "properties": { "budget_type": { "type": "string", "enum": [ "DOLLARS", "IMPRESSIONS" ] }, "created_on": { "type": "string", "format": "date-time" }, "dynamic_pricing_option": { "type": "string", "enum": [ "AVERAGE", "STANDARD", "WIN", "SPEND" ] }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "learning_budget_pacing": { "type": "string", "enum": [ "ASAP", "EVEN", "HOURLY", "DAILY", "MONTHLY" ] }, "learning_slider": { "type": "integer" }, "name": { "type": "string" }, "pacing": { "type": "string", "enum": [ "asap", "deliver_overall_budget_evenly", "deliver_remaining_budget_evenly", "hourly_asap", "hourly_even", "daily_asap", "daily_even", "monthly_asap", "monthly_even" ] }, "price": { "type": "number" }, "pricing_type": { "type": "string", "enum": [ "CPA", "CPC", "CPM", "DYNAMIC" ] }, "rel": { "type": "string" }, "rmx_push_entity_id": { "type": "integer" }, "rmx_push_status": { "type": "string", "enum": [ "NEW", "UPDATED", "IN_PROGRESS", "PUSH_OK", "PUSH_FAILED" ] }, "roi_cpc_target_ctr": { "type": "string" }, "roi_cpc_target_ctr_type": { "type": "string", "enum": [ "DOLLARS", "PERCENT" ] }, "roi_modifier": { "type": "number" }, "roi_target_pixels": { "type": "array", "items": { "type": "object", "properties": { "created_on": { "type": "string", "format": "date-time" }, "entity_type": { "type": "string", "enum": [ "rmx_strategy_roi_target_pixel" ] }, "id": { "type": "integer" }, "name": { "type": "string" }, "pixel_bundle_id": { "type": "integer" }, "price": { "type": "number" }, "rel": { "type": "string" }, "rmx_pixel_type": { "type": "string", "enum": [ "CLICK", "IMPRESSION", "SEGMENT" ] }, "rmx_strategy_id": { "type": "integer" }, "status": { "type": "boolean" }, "updated_on": { "type": "string", "format": "date-time" }, "version": { "type": "integer" } } } }, "roi_targets": { "type": "string", "enum": [ "NONE", "CPA", "CPC" ] }, "status": { "type": "boolean" }, "strategy_id": { "type": "integer" }, "updated_on": { "type": "string", "format": "date-time" }, "version": { "type": "integer" } } }, "run_on_all_exchanges": { "type": "boolean" }, "run_on_all_pmp": { "type": "boolean" }, "run_on_display": { "type": "boolean" }, "run_on_mobile": { "type": "boolean" }, "run_on_only_fraud_filtered_exchanges": { "type": "boolean" }, "run_on_streaming": { "type": "boolean" }, "site_restriction_transparent_urls": { "type": "boolean" }, "site_selectiveness": { "type": "string", "description": "REDUCED is currently the only available option", "enum": [ "REDUCED" ] }, "start_date": { "type": "string" }, "status": { "type": "boolean" }, "supply_type": { "type": "string", "description": "Specify whether impressions will be bought and decisioned by the TerminalOne platform. Use 'RTB' for normal strategies that are bought/decisioned in T1. Use 'RMX_API' to use a tag to track media not purchased through TerminalOne.", "enum": [ "MKT", "RTB", "T1_RMX", "RMX_API" ] }, "targeting_segment_exclude_op": { "type": "string" }, "targeting_segment_include_op": { "type": "string" }, "type": { "type": "string", "description": "Specify the type of strategy (re-marketing (REM), goal-based optimization (GBO), audience (AUD))", "enum": [ "REM", "GBO", "AUD" ] }, "updated_on": { "type": "string" }, "use_campaign_end": { "type": "boolean" }, "use_campaign_start": { "type": "boolean" }, "use_mm_freq": { "type": "boolean", "description": "Unused legacy frequency cap setting. Must be set to 'off'. To control frequency capping at the campaign level, set the strategy-level frequency_type attribute to 'no-limit' and set a frequency cap on the campaign entity." }, "use_optimization": { "type": "boolean", "description": "Enable's T1 optimization algorithm (defaults to 'off' if unspecified).\n\nrequired if `goal_type!='spend'`" }, "version": { "type": "integer" }, "zone_name": { "type": "string" } } }, { "type": "object", "properties": { "site_placements": { "type": "array", "items": { "allOf": [ { "example": { "audience_segment_exclude_op": "OR", "audience_segment_include_op": "AND", "bid_aggressiveness": 13, "bid_price_is_media_only": false, "budget": [ { "currency_code": "USD", "value": 1.43 } ], "campaign_id": 1234566, "created_on": "2016-05-04T15:44:54+0000", "currency_code": "USD", "effective_goal_value": [ { "currency_code": "USD", "value": "93.0000" } ], "end_date": "2016-05-06T13:44:49+0000", "entity_type": "strategy", "frequency_amount": 3, "frequency_interval": "month", "frequency_type": "even", "goal_type": "reach", "goal_value": [ { "currency_code": "USD", "value": 93 } ], "id": 1234567, "max_bid": [ { "currency_code": "USD", "value": 1.12 } ], "media_type": "video", "name": "strategy with audience segments", "pacing_amount": [ { "currency_code": "USD", "value": 1.93 } ], "pacing_interval": "hour", "pacing_type": "even", "run_on_all_exchanges": true, "run_on_all_pmp": false, "run_on_display": true, "run_on_mobile": true, "run_on_streaming": false, "site_restriction_transparent_urls": true, "site_selectiveness": "REDUCED", "start_date": "2016-05-05T13:44:49+0000", "status": false, "strategy_audience_segments": [ { "audience_segment_id": 1405158, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g2", "id": 1132602, "name": "Strategy Audience Segments #1132602", "rel": "strategy_audience_segments", "restriction": "EXCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 }, { "audience_segment_id": 1358322, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 1132601, "name": "Strategy Audience Segments #1132601", "rel": "strategy_audience_segments", "restriction": "INCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 }, { "audience_segment_id": 1460324, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 1132600, "name": "Strategy Audience Segments #1132600", "rel": "strategy_audience_segments", "restriction": "INCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 } ], "supply_type": "RTB", "targeting_segment_exclude_op": "OR", "targeting_segment_include_op": "OR", "type": "REM", "updated_on": "2016-05-04T15:44:54+0000", "use_campaign_end": false, "use_campaign_start": false, "use_mm_freq": false, "use_optimization": true, "version": 2, "zone_name": "Europe/Paris" }, "properties": { "bill_media_to_client": { "type": "boolean" }, "deal_source": { "enum": [ "USER", "INTERNAL" ], "type": "string" }, "display_text": { "maxLength": 255, "type": "string" }, "media_type": { "enum": [ "display", "video", "mobile" ], "type": "string" }, "name": { "maxLength": 64, "type": "string" }, "pmp_type": { "enum": [ "DIRECT", "PREMIUM" ], "type": "string" }, "publisher_site_id": { "type": "integer" } }, "title": "Input Site Placement", "type": "object", "x-stoplight": { "id": "input-site-placement", "name": "Input Site Placement", "public": true } }, { "example": { "created_on": "4838-01-01T02:34:39.905Z", "id": 1, "updated_on": "3214-02-18T04:49:20.878Z", "version": 46559379 }, "properties": { "created_on": { "format": "date-time", "type": "string" }, "id": { "minimum": 0, "type": "integer" }, "updated_on": { "format": "date-time", "type": "string" }, "version": { "type": "integer" } }, "title": "Output Common", "type": "object", "x-stoplight": { "id": "output_common", "name": "Output Common", "public": true } } ], "title": "Output Site Placement", "x-stoplight": { "id": "output-site-placement", "name": "Output Site Placement", "public": true } } }, "supply_sources": { "type": "array", "items": { "allOf": [ { "example": { "created_on": "4838-01-01T02:34:39.905Z", "id": 1, "updated_on": "3214-02-18T04:49:20.878Z", "version": 46559379 }, "properties": { "created_on": { "format": "date-time", "type": "string" }, "id": { "minimum": 0, "type": "integer" }, "updated_on": { "format": "date-time", "type": "string" }, "version": { "type": "integer" } }, "title": "Output Common", "type": "object", "x-stoplight": { "id": "output_common", "name": "Output Common", "public": true } }, { "example": { "audience_segment_exclude_op": "OR", "audience_segment_include_op": "AND", "bid_aggressiveness": 13, "bid_price_is_media_only": false, "budget": [ { "currency_code": "USD", "value": 1.43 } ], "campaign_id": 1234566, "created_on": "2016-05-04T15:44:54+0000", "currency_code": "USD", "effective_goal_value": [ { "currency_code": "USD", "value": "93.0000" } ], "end_date": "2016-05-06T13:44:49+0000", "entity_type": "strategy", "frequency_amount": 3, "frequency_interval": "month", "frequency_type": "even", "goal_type": "reach", "goal_value": [ { "currency_code": "USD", "value": 93 } ], "id": 1234567, "max_bid": [ { "currency_code": "USD", "value": 1.12 } ], "media_type": "VIDEO", "name": "strategy with audience segments", "pacing_amount": [ { "currency_code": "USD", "value": 1.93 } ], "pacing_interval": "hour", "pacing_type": "even", "run_on_all_exchanges": true, "run_on_all_pmp": false, "run_on_display": true, "run_on_mobile": true, "run_on_streaming": false, "site_restriction_transparent_urls": true, "site_selectiveness": "REDUCED", "start_date": "2016-05-05T13:44:49+0000", "status": false, "strategy_audience_segments": [ { "audience_segment_id": 1358322, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 1132601, "name": "Strategy Audience Segments #1132601", "rel": "strategy_audience_segments", "restriction": "INCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 }, { "audience_segment_id": 1405158, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g2", "id": 1132602, "name": "Strategy Audience Segments #1132602", "rel": "strategy_audience_segments", "restriction": "EXCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 }, { "audience_segment_id": 1460324, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 1132600, "name": "Strategy Audience Segments #1132600", "rel": "strategy_audience_segments", "restriction": "INCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 } ], "supply_type": "RTB", "targeting_segment_exclude_op": "OR", "targeting_segment_include_op": "OR", "type": "REM", "updated_on": "2016-05-04T15:44:54+0000", "use_campaign_end": false, "use_campaign_start": false, "use_mm_freq": false, "use_optimization": true, "version": 2, "zone_name": "Europe/Paris" }, "properties": { "accountable_and_addressable": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "attribution_group": { "type": "string" }, "bidder_exchange_identifier": { "type": "integer" }, "code": { "type": "string" }, "distribute": { "type": "boolean" }, "entity_type": { "type": "string" }, "fraud_filter": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "has_connected_tv": { "type": "boolean" }, "has_desktop_video": { "type": "boolean" }, "has_display": { "type": "boolean" }, "has_mobile_display": { "type": "boolean" }, "has_mobile_video": { "type": "boolean" }, "has_video": { "type": "boolean" }, "is_proservice": { "type": "boolean" }, "mm_safe": { "type": "boolean" }, "name": { "type": "string" }, "pmp_enabled": { "type": "boolean" }, "rel": { "type": "string" }, "requires_creative_audit": { "type": "boolean" }, "rtb_enabled": { "type": "boolean" }, "rtb_type": { "type": "string" }, "seat_enabled": { "type": "boolean" }, "status": { "type": "boolean" }, "supply_type": { "type": "string" }, "use_pool": { "type": "boolean" } }, "title": "Input Supply Source", "type": "object", "x-stoplight": { "id": "input-supply-source", "name": "Input Supply Source", "public": true } } ], "title": "Output Supply Source", "x-stoplight": { "id": "output-supply-source", "name": "Output Supply Source", "public": true } } } } } ] }, "uuid": { "type": "string" }, "meta": { "example": { "meta": { "called_on": "2017-06-02T23:36:05+0000", "count": 2, "etag": "5e446abf85396cc1e516a67b2ecd637ee8f8ac34", "offset": 0, "status": "ok", "total_count": 0 } }, "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "Output Common Meta", "type": "object", "x-stoplight": { "id": "output-common-meta", "name": "Output Common Meta", "public": true } } } }, "output-strategy-target": { "example": { "active": true, "entity_type": "strategy_target", "exclude": false, "id": 2078859, "name": "Strategy Targets #2078859", "strategy_id": 969797, "target_dimension_id": 7, "target_op": "OR" }, "properties": { "active": { "type": "boolean" }, "entity_type": { "type": "string" }, "exclude": { "type": "boolean" }, "id": { "type": "integer" }, "name": { "type": "string" }, "strategy_id": { "type": "integer" }, "target_dimension_id": { "type": "integer" }, "target_op": { "type": "string" } }, "title": "Output Strategy Target", "type": "object", "x-stoplight": { "id": "output-strategy-target", "name": "Output Strategy Target", "public": true } }, "output-strategy-target-values": { "example": { "data": [ { "active": true, "entity_type": "strategy_target", "exclude": false, "id": 2078859, "name": "Strategy Targets #2078859", "strategy_id": 969797, "target_dimension": { "code": "REGN", "entity_type": "target_dimension", "id": 7, "name": "Geography", "rel": "target_dimension" }, "target_dimension_id": 7, "target_op": "OR", "target_values": [ { "code": "us", "entity_type": "target_value", "id": 251, "is_targetable": true, "name": "United States", "rel": "target_values", "target_dimension_id": 7, "value": 60231 }, { "code": "qa", "entity_type": "target_value", "id": 205, "is_targetable": true, "name": "Qatar", "rel": "target_values", "target_dimension_id": 7, "value": 60185 } ] }, { "active": true, "entity_type": "strategy_target", "exclude": true, "id": 2078860, "name": "Strategy Targets #2078860", "strategy_id": 969797, "target_dimension": { "code": "DVCE", "entity_type": "target_dimension", "id": 24, "name": "Device", "rel": "target_dimension" }, "target_dimension_id": 24, "target_op": "OR", "target_values": [ { "code": "Smartphone", "entity_type": "target_value", "id": 301524, "is_targetable": true, "name": "Smartphone", "rel": "target_values", "target_dimension_id": 24, "value": 41000 }, { "code": "Other", "entity_type": "target_value", "id": 301526, "is_targetable": true, "name": "Other Mobile Device", "rel": "target_values", "target_dimension_id": 24, "value": 44000 }, { "code": "Tablet", "entity_type": "target_value", "id": 301525, "is_targetable": true, "name": "Tablet", "rel": "target_values", "target_dimension_id": 24, "value": 42000 } ] } ], "meta": { "called_on": "2017-06-02T20:03:00+0000", "count": 2, "etag": "5e446abf85396cc1e516a67b2ecd637ee8f8ac34", "offset": 0, "status": "ok", "total_count": 0 } }, "properties": { "data": { "items": { "allOf": [ { "example": { "active": true, "entity_type": "strategy_target", "exclude": false, "id": 2078859, "name": "Strategy Targets #2078859", "strategy_id": 969797, "target_dimension_id": 7, "target_op": "OR" }, "properties": { "active": { "type": "boolean" }, "entity_type": { "type": "string" }, "exclude": { "type": "boolean" }, "id": { "type": "integer" }, "name": { "type": "string" }, "strategy_id": { "type": "integer" }, "target_dimension_id": { "type": "integer" }, "target_op": { "type": "string" } }, "title": "Output Strategy Target", "type": "object", "x-stoplight": { "id": "output-strategy-target", "name": "Output Strategy Target", "public": true } }, { "properties": { "target_dimension": { "example": { "code": "REGN", "entity_type": "target_dimension", "id": 7, "name": "Geography", "rel": "target_dimension" }, "properties": { "code": { "type": "string" }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "rel": { "type": "string" } }, "title": "Output Target Dimension", "type": "object", "x-stoplight": { "id": "output-target-dimension", "name": "Output Target Dimension", "public": true } } }, "type": "object" }, { "properties": { "target_values": { "items": { "example": { "code": "Smartphone", "entity_type": "target_value", "id": 301524, "is_targetable": true, "name": "Smartphone", "rel": "target_values", "target_dimension_id": 24, "value": 41000 }, "properties": { "code": { "type": "string" }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "is_targetable": { "type": "boolean" }, "name": { "type": "string" }, "rel": { "type": "string" }, "target_dimension_id": { "type": "integer" }, "value": { "type": "integer" } }, "title": "Output Target Value", "type": "object", "x-stoplight": { "id": "output-target-value", "name": "Output Target Value", "public": true } }, "type": "array" } }, "type": "object" } ] }, "type": "array" }, "meta": { "example": { "meta": { "called_on": "2017-06-02T23:36:05+0000", "count": 2, "etag": "5e446abf85396cc1e516a67b2ecd637ee8f8ac34", "offset": 0, "status": "ok", "total_count": 0 } }, "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "Output Common Meta", "type": "object", "x-stoplight": { "id": "output-common-meta", "name": "Output Common Meta", "public": true } } }, "title": "Output Strategy Target Values", "type": "object", "x-stoplight": { "id": "output-strategy-target-values", "name": "Output Strategy Target Values", "public": true }, "description": "Note: There should be a UUID in here before meta" }, "output-supply-source": { "allOf": [ { "example": { "created_on": "4838-01-01T02:34:39.905Z", "id": 1, "updated_on": "3214-02-18T04:49:20.878Z", "version": 46559379 }, "properties": { "created_on": { "format": "date-time", "type": "string" }, "id": { "minimum": 0, "type": "integer" }, "updated_on": { "format": "date-time", "type": "string" }, "version": { "type": "integer" } }, "title": "Output Common", "type": "object", "x-stoplight": { "id": "output_common", "name": "Output Common", "public": true } }, { "example": { "audience_segment_exclude_op": "OR", "audience_segment_include_op": "AND", "bid_aggressiveness": 13, "bid_price_is_media_only": false, "budget": [ { "currency_code": "USD", "value": 1.43 } ], "campaign_id": 1234566, "created_on": "2016-05-04T15:44:54+0000", "currency_code": "USD", "effective_goal_value": [ { "currency_code": "USD", "value": "93.0000" } ], "end_date": "2016-05-06T13:44:49+0000", "entity_type": "strategy", "frequency_amount": 3, "frequency_interval": "month", "frequency_type": "even", "goal_type": "reach", "goal_value": [ { "currency_code": "USD", "value": 93 } ], "id": 1234567, "max_bid": [ { "currency_code": "USD", "value": 1.12 } ], "media_type": "VIDEO", "name": "strategy with audience segments", "pacing_amount": [ { "currency_code": "USD", "value": 1.93 } ], "pacing_interval": "hour", "pacing_type": "even", "run_on_all_exchanges": true, "run_on_all_pmp": false, "run_on_display": true, "run_on_mobile": true, "run_on_streaming": false, "site_restriction_transparent_urls": true, "site_selectiveness": "REDUCED", "start_date": "2016-05-05T13:44:49+0000", "status": false, "strategy_audience_segments": [ { "audience_segment_id": 1358322, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 1132601, "name": "Strategy Audience Segments #1132601", "rel": "strategy_audience_segments", "restriction": "INCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 }, { "audience_segment_id": 1405158, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g2", "id": 1132602, "name": "Strategy Audience Segments #1132602", "rel": "strategy_audience_segments", "restriction": "EXCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 }, { "audience_segment_id": 1460324, "created_on": "2016-05-04T15:44:55+0000", "entity_type": "strategy_audience_segment", "group_identifier": "g1", "id": 1132600, "name": "Strategy Audience Segments #1132600", "rel": "strategy_audience_segments", "restriction": "INCLUDE", "strategy_id": 1234567, "updated_on": "2016-05-04T15:44:55+0000", "version": 0 } ], "supply_type": "RTB", "targeting_segment_exclude_op": "OR", "targeting_segment_include_op": "OR", "type": "REM", "updated_on": "2016-05-04T15:44:54+0000", "use_campaign_end": false, "use_campaign_start": false, "use_mm_freq": false, "use_optimization": true, "version": 2, "zone_name": "Europe/Paris" }, "properties": { "accountable_and_addressable": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "attribution_group": { "type": "string" }, "bidder_exchange_identifier": { "type": "integer" }, "code": { "type": "string" }, "distribute": { "type": "boolean" }, "entity_type": { "type": "string" }, "fraud_filter": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "has_connected_tv": { "type": "boolean" }, "has_desktop_video": { "type": "boolean" }, "has_display": { "type": "boolean" }, "has_mobile_display": { "type": "boolean" }, "has_mobile_video": { "type": "boolean" }, "has_video": { "type": "boolean" }, "is_proservice": { "type": "boolean" }, "mm_safe": { "type": "boolean" }, "name": { "type": "string" }, "pmp_enabled": { "type": "boolean" }, "rel": { "type": "string" }, "requires_creative_audit": { "type": "boolean" }, "rtb_enabled": { "type": "boolean" }, "rtb_type": { "type": "string" }, "seat_enabled": { "type": "boolean" }, "status": { "type": "boolean" }, "supply_type": { "type": "string" }, "use_pool": { "type": "boolean" } }, "title": "Input Supply Source", "type": "object", "x-stoplight": { "id": "input-supply-source", "name": "Input Supply Source", "public": true } } ], "title": "Output Supply Source", "x-stoplight": { "id": "output-supply-source", "name": "Output Supply Source", "public": true } }, "output-target-dimension": { "example": { "code": "REGN", "entity_type": "target_dimension", "id": 7, "name": "Geography", "rel": "target_dimension" }, "properties": { "code": { "type": "string" }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "rel": { "type": "string" } }, "title": "Output Target Dimension", "type": "object", "x-stoplight": { "id": "output-target-dimension", "name": "Output Target Dimension", "public": true } }, "output-target-value": { "example": { "code": "Smartphone", "entity_type": "target_value", "id": 301524, "is_targetable": true, "name": "Smartphone", "rel": "target_values", "target_dimension_id": 24, "value": 41000 }, "properties": { "code": { "type": "string" }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "is_targetable": { "type": "boolean" }, "name": { "type": "string" }, "rel": { "type": "string" }, "target_dimension_id": { "type": "integer" }, "value": { "type": "integer" } }, "title": "Output Target Value", "type": "object", "x-stoplight": { "id": "output-target-value", "name": "Output Target Value", "public": true } }, "output_common": { "example": { "created_on": "4838-01-01T02:34:39.905Z", "id": 1, "updated_on": "3214-02-18T04:49:20.878Z", "version": 46559379 }, "properties": { "created_on": { "format": "date-time", "type": "string" }, "id": { "minimum": 0, "type": "integer" }, "updated_on": { "format": "date-time", "type": "string" }, "version": { "type": "integer" } }, "title": "Output Common", "type": "object", "x-stoplight": { "id": "output_common", "name": "Output Common", "public": true } }, "output_vendor_contract": { "allOf": [ { "example": { "created_on": "4838-01-01T02:34:39.905Z", "id": 1, "updated_on": "3214-02-18T04:49:20.878Z", "version": 46559379 }, "properties": { "created_on": { "format": "date-time", "type": "string" }, "id": { "minimum": 0, "type": "integer" }, "updated_on": { "format": "date-time", "type": "string" }, "version": { "type": "integer" } }, "title": "Output Common", "type": "object", "x-stoplight": { "id": "output_common", "name": "Output Common", "public": true } }, { "example": { "campaign_id": 22035223, "price": 13971235, "rate_card_type": "CPM", "use_mm_contract": false, "vendor_id": 95836163 }, "properties": { "campaign_id": { "description": "Once set, this field can not be changed.", "type": "integer" }, "price": { "type": "number" }, "rate_card_type": { "enum": [ "CPM", "FIXED" ], "type": "string" }, "use_mm_contract": { "type": "boolean" }, "vendor_id": { "type": "integer" } }, "required": [ "vendor_id", "campaign_id", "use_mm_contract" ], "title": "Input Vendor Contract", "type": "object", "x-stoplight": { "id": "input_vendor_contract", "name": "Input Vendor Contract", "public": true } } ], "title": "Output Vendor Contract", "x-stoplight": { "id": "output_vendor_contract", "name": "Output Vendor Contract", "public": true } }, "pixel": { "example": { "advertiser_id": 109139, "created_on": "2016-10-17T22:23:30+0000", "eligible": true, "entity_type": "pixel_bundle", "external_identifier": "1187321288", "id": 1082368, "keywords": "", "name": "Example - Homepage", "pixel_type": "event", "pricing": "CPM", "rmx_conversion_minutes": 1, "rmx_conversion_type": "one", "rmx_friendly": false, "rmx_merit": false, "status": true, "tag_type": "js", "tags": "", "updated_on": "2016-10-17T22:23:30+0000", "version": 1 }, "properties": { "advertiser_id": { "type": "integer" }, "cost_cpm": { "type": "number" }, "cost_pct_cpm": { "type": "number" }, "created_on": { "type": "string" }, "currency": { "description": "If set, the currency code for revenue events will be read from the specified URL parameter. Refer to Event Pixels on the T1 knowledge base for more information.\nEither currency or currency_fixed must be set.If set, you must set revenue value currency and revenue parameters must be different.", "enum": [ "S1", "S2", "V1", "V2" ], "type": "string" }, "currency_fixed": { "default": "USD", "description": "Fixed currency. Set using ISO 4217 currency code.\nhttps://en.wikipedia.org/wiki/ISO_4217", "type": "string" }, "eligible": { "description": "Indicator eligibility of pixel for targeting", "type": "boolean" }, "entity_type": { "type": "string" }, "external_identifier": { "type": "string" }, "id": { "type": "integer" }, "keywords": { "description": "Optional keyword tag that can be applied to the pixel", "maxLength": 64, "type": "string" }, "name": { "type": "string" }, "pixel_type": { "default": "event", "enum": [ "data", "dynamic", "event", "segment" ], "type": "string" }, "pricing": { "default": "CPM", "description": "Pricing model for the data provider\nCPM is recommended. CPTS is not recommended and planned for deprecation.", "enum": [ "CPM" ], "type": "string" }, "revenue": { "description": "Identifies the pixel URL parameter in which the revenue value will be passed. Refer to Event Pixels on the T1 knowledge base for more information.", "enum": [ "S1", "S2", "V1", "V2" ], "type": "string" }, "rmx_conversion_minutes": { "type": "integer" }, "rmx_conversion_type": { "enum": [ "one" ], "type": "string" }, "rmx_friendly": { "type": "boolean" }, "rmx_merit": { "type": "boolean" }, "rmx_pc_window_minutes": { "type": "integer" }, "rmx_pv_window_minutes": { "type": "integer" }, "status": { "default": true, "description": "Indicates whether a pixel should appear in API calls to the $APIBASE/pixel_bundles endpoint.", "type": "boolean" }, "tag_type": { "description": "Tag type to determine pixel code output", "enum": [ "dfa", "iframe", "image", "js", "uat" ], "type": "string" }, "tags": { "type": "string" }, "updated_on": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "advertiser_id", "eligible", "name", "pixel_type", "tag_type" ], "title": "Pixel", "type": "object", "x-stoplight": { "id": "pixel", "name": "Pixel", "public": true } }, "read-singular-campaign": { "example": { "ad_server_id": 6, "advertiser_id": 122631, "agency_fee_pct": 0, "connected_id_type": "DETERMINISTIC_ONLY", "conversion_type": "variable", "conversion_variable_minutes": 1, "cost_passthrough_cpm_enabled": false, "cost_passthrough_percent_enabled": false, "created_on": "2016-10-19T03:21:53+0000", "currency_code": "USD", "dcs_data_is_campaign_level": false, "end_date": "2016-11-07T23:59:00+0000", "entity_type": "campaign", "frequency_interval": "not-applicable", "frequency_optimization": false, "frequency_type": "no-limit", "goal_type": "spend", "goal_value": [ { "currency_code": "USD", "value": 2.5 } ], "has_custom_attribution": false, "id": 300982, "impression_cap_amount": 5000, "impression_cap_automatic": false, "impression_cap_type": "asap", "initial_start_date": "2016-10-19T09:00:00+0000", "io_name": "", "io_reference_num": "", "is_programmatic_guaranteed": false, "margin_pct": 0, "minimize_multi_ads": false, "name": "MobileAds Test (Round 4)", "override_suspicious_traffic_filter": false, "pv_pct": 100, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "spend_cap_amount": [ { "currency_code": "USD", "value": 5 } ], "spend_cap_automatic": false, "spend_cap_type": "asap", "start_date": "2016-10-19T09:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": [ { "currency_code": "USD", "value": 40 } ], "updated_on": "2016-11-01T07:18:56+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 5, "zone_name": "Etc/GMT" }, "title": "Read Singular Campaign", "type": "object", "x-stoplight": { "id": "read-singular-campaign", "name": "Read Singular Campaign", "public": true }, "properties": { "ad_server_fee": { "description": "Fee charged by ad serving vendor", "type": "integer" }, "ad_server_id": { "description": "The ID for a third-party ad server", "type": "integer" }, "advertiser_id": { "default": 512312, "description": "T1 Advertiser ID to which a campaign belongs", "type": "integer" }, "agency_fee_pct": { "type": "integer" }, "conversion_type": { "description": "Definition for conversions per user.\n\nevery: Attribute all Merit Events\n\nvariable: Attribute one Merit Event per X minutes - set inconversion_variable_minutes\n\none: Attribute one Merit Event per user (if converstion_type = one, then conversion_variable_minutes (integer) is required).\n\nrequired if `goal_type in ('cpa', 'roi')`\n", "enum": [ "every", "one", "variable" ], "type": "string" }, "conversion_variable_minutes": { "description": "Attribute one Merit Event per X minutes\n\nrequired if `goal_type in ('cpa', 'cpc', 'roi') && conversion_type=one`", "type": "integer" }, "created_on": { "type": "string" }, "currency_code": { "default": "USD", "description": "Currency setting for campaign. All strategies under this value inherit the selected currency. Once the campaign launches, it cannot be switched to another currency (aka existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).", "type": "string" }, "dcs_data_is_campaign_level": { "type": "boolean" }, "end_date": { "description": "Last date of campaign in GMT", "type": "string" }, "entity_type": { "type": "string" }, "frequency_amount": { "description": "required if `frequency_type=even||asap`", "type": "integer" }, "frequency_interval": { "description": "required if `frequency_type=even||asap`\n", "type": "string" }, "frequency_optimization": { "type": "boolean" }, "frequency_type": { "default": "no-limit", "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap.", "enum": [ "even", "asap", "no-limit" ], "type": "string" }, "goal_type": { "type": "string", "description": "Goal type which campaign performance will be measured", "enum": [ "cpa", "cpc", "ctr", "reach", "roi", "spend", "vcpm", "vcr", "viewability_rate" ] }, "goal_value": { "description": "Target goal value for campaign respective to the goal_type selection.\n\nrequired if `goal_type in ('cpa','cpc','reach','roi')`", "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "number" } } } }, "has_custom_attribution": { "type": "boolean" }, "id": { "type": "integer" }, "impression_cap_amount": { "description": "Sets the amount of the available impression budget across the remaining number of days across all their strategies.", "type": "integer" }, "impression_cap_automatic": { "enum": [ "on", "off", true, false ], "type": [ "string", "boolean" ] }, "impression_cap_type": { "default": "no-limit", "description": "Type of cap applied to impression budgets.", "enum": [ "even", "asap", "no-limit" ], "type": "string" }, "initial_start_date": { "type": "string" }, "io_name": { "description": "Descriptive name of insertion order", "type": "string" }, "io_reference_num": { "description": "Reference number of insertion order", "type": [ "string", "integer" ] }, "margin_pct": { "description": "Margin percentage to be applied on campaign spend", "type": "integer" }, "merit_pixel_id": { "description": "Specify Merit Pixel that represents conversion or engagement on CPA or CPE type campaigns\n\nREQUIRED if `goal_type in ('cpa','roi')`", "type": "integer" }, "minimize_multi_ads": { "default": false, "description": "Enabling this field will cause T1 to avoid bidding on more than one ad opportunity on a single page view across. Warning: enabling this setting may limit pacing and reduce the available inventory for the campaigns by not bidding on impression opportunities where the URL is not transparent.", "type": "boolean" }, "name": { "description": "Descriptive name of the campaign", "type": "string" }, "override_suspicious_traffic_filter": { "default": false, "description": "Enabling this setting allows you to set a campaign-specific level of suspicious traffic filtering using the 'suspicious_traffic_filter_level' property. This will override the T1 default (or organization-level, if configured) suspicious traffic filtering level.", "type": "boolean" }, "pc_window_minutes": { "description": "Post-click window for attribution. Not to be confused with pv_window_minutes.\n\noptional if `goal_type in ('cpa','roi')`\n", "type": "integer" }, "pv_pct": { "description": "Percentage of post-view windows to be used for attribution\n\noptional if `goal_type in ('cpa','roi')`", "type": "integer" }, "pv_window_minutes": { "description": "Post-view window for attribution \n\nrequired if `goal_type in ('cpa','roi')`", "type": "integer" }, "restrict_targeting_to_deterministic_id": { "type": "boolean" }, "restrict_targeting_to_same_device_id": { "type": "boolean" }, "service_type": { "description": "Indicate whether campaign will be self-service or managed (managed campaigns will incur manage service fee)", "enum": [ "SELF", "MANAGED" ], "type": "string" }, "spend_cap_amount": { "description": "only required if`spend_cap_enabled`is true", "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } } } }, "spend_cap_automatic": { "description": "Automatically sets the available spend budget across all strategies through the end date of the campaign.", "type": "boolean" }, "spend_cap_type": { "description": "Type of cap applied to spend budgets.", "enum": [ "even", "asap", "no-limit" ], "type": "string" }, "start_date": { "description": "Date on which the campaign will start (GMT)", "type": "string" }, "status": { "default": false, "description": "Status of the campaign", "type": [ "boolean", "string" ] }, "suspicious_traffic_filter_level": { "description": "A value between 0 and 100 that determines the sensitivity of T1 suspicious traffic filtering capabilities.If the value = 0, all fraud and suspicious traffic filtering is turned off.It will not take effect if 'override_suspicious_traffic_filter_level' is not set.\n\n", "maximum": 100, "minimum": 0, "type": "integer" }, "total_budget": { "description": "Allocated budget for the campaign", "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } } } }, "updated_on": { "type": "string" }, "use_default_ad_server": { "type": "boolean" }, "use_mm_freq": { "type": "boolean" }, "version": { "type": "integer" }, "zone_name": { "default": "America/New_York", "description": "Indicate the time zone for reporting for the campaign", "type": "string" } }, "required": [ "ad_server_id", "advertiser_id", "end_date", "goal_type", "goal_value", "impression_cap_automatic", "name", "service_type", "start_date", "total_budget" ] }, "singleResponse": { "properties": { "data": { "example": { "address_1": "1440 Broadway", "address_2": "4WTC", "adx_seat_account_id": 95819908, "allow_byo_price": true, "allow_x_agency_pixels": true, "billing_country_code": "US", "city": "New York", "contact_name": "Ian Hummel", "country": "US", "created_on": "2010-10-19T16:58:05+0000", "currency_code": "USD", "dmp_enabled": "enabled", "entity_type": "organization", "id": 100048, "mm_contact_name": "Ian Hummel", "name": "ACME Org", "opt_out_connected_id": true, "opt_out_connected_id_mathid": false, "org_type": [ "buyer" ], "override_suspicious_traffic_filter": false, "phone": "(347) 420-0116", "restrict_targeting_to_deterministic_id": true, "restrict_targeting_to_same_device_id": true, "service_provider_ccpa": true, "state": "NY", "status": true, "suspicious_traffic_filter_level": 25, "terminated": false, "updated_on": "2016-11-03T19:39:12+0000", "use_evidon_optout": true, "version": 126, "zip": "10018" }, "title": "Organization", "type": "object", "x-stoplight": { "id": "organization", "name": "Organization", "public": true }, "properties": { "accountable_and_addressable": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "address_1": { "type": "string" }, "address_2": { "type": "string" }, "adx_seat_account_id": { "description": "Passed to ADX upon creative registration so ADX knows which seat we're registering under.", "type": "integer" }, "allow_byo_price": { "type": "boolean" }, "allow_x_agency_pixels": { "description": "This field enables the Data Co-op functionality across all the Advertisers under this organization. Cross-Advertiser Pixel Targeting allows Advertisers to target other Advertiser Event Pixels within their Agency and any other similarly enabled Agency under the same Organization.", "type": "boolean" }, "billing_country_code": { "description": "Country code that is used for billing purposes", "type": "string" }, "city": { "type": "string" }, "connected_id_type": { "type": "string", "enum": [ "DETERMINISTIC_FIRST", "DETERMINISTIC_ONLY" ] }, "contact_name": { "description": "This is the primary contact at the organization regarding contract issues.", "type": "string" }, "country": { "type": "string" }, "created_on": { "type": "string" }, "currency_code": { "description": "Currency code for the campaign budget and spend, as well as billing", "type": "string" }, "dmp_enabled": { "type": "string" }, "eligibile_for_data_sharing": { "type": "boolean" }, "entity_type": { "type": "string" }, "facebook": { "type": "string" }, "holding_org_id": { "type": "integer" }, "id": { "type": "integer" }, "linkedin": { "type": "string" }, "mm_contact_name": { "description": "This is the name of the primary internal MediaMath contact of the Organization.", "type": "string" }, "name": { "description": "The Name of the organization with whom the contract is held. This can be an agency holding company, agency, advertiser, network, or other media or data buying entity.", "type": "string" }, "opt_out_connected_id": { "type": "boolean" }, "opt_out_connected_id_mathid": { "type": "boolean" }, "org_type": { "type": "array", "items": { "type": "string" } }, "override_suspicious_traffic_filter": { "description": "Set flag to 'on’ to be able to override default org wide suspicious traffic filter level ", "type": "boolean" }, "phone": { "type": "string" }, "restrict_targeting_to_deterministic_id": { "type": "boolean", "default": true, "description": "This is a deprecated field, which now only allows the value 'true'." }, "restrict_targeting_to_same_device_id": { "type": "boolean" }, "state": { "type": "string" }, "service_provider_ccpa": { "type": "boolean", "description": "Represents whether a service provider agreement was signed by the organization owner in accordance with CCPA" }, "status": { "description": "of organization (defaults to off if unspecified)", "type": "boolean" }, "suspicious_traffic_filter_level": { "description": "Specify an organization-wide level of suspicious traffic filtering to use. See the Knowledge Base for additional details about this feature. This setting will only take affect if the organization's override_suspicious_traffic_filter property is set to 'on'.\n\nIf override_suspicious_traffic_filter is enabled and suspicious_traffic_filter_level is set to 0, all fraud and suspicious ", "type": "integer" }, "terminated": { "type": "boolean" }, "updated_on": { "type": "string" }, "use_evidon_optout": { "description": "Set flag to 'on’ to show an opt out button on the organization's ads (additional CPM fee will apply when on) ", "type": "boolean" }, "version": { "type": "integer" }, "zip": { "type": "string" } } }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } }, "title": "singleResponse", "type": "object", "x-stoplight": { "id": "singleResponse", "name": "singleResponse", "public": true } }, "site-list": { "example": { "created_on": "2016-03-17T17:17:28+0000", "entity_type": "site_list", "filename": "Book1.csv", "id": 69140, "name": "app_test", "organization_id": 100048, "restriction": "INCLUDE", "sites_count": 34, "sites_count_app": 34, "status": true, "updated_on": "2016-03-17T17:17:28+0000", "version": 0 }, "properties": { "created_on": { "type": "string" }, "entity_type": { "type": "string" }, "filename": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "organization_id": { "type": "integer" }, "restriction": { "type": "string" }, "sites_count": { "type": "integer" }, "sites_count_app": { "type": "integer" }, "status": { "type": "boolean" }, "updated_on": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "filename", "name", "organization_id", "status" ], "title": "Site List", "type": "object", "x-stoplight": { "id": "site-list", "name": "Site List", "public": true } }, "strategy-concept": { "example": { "concept_id": 1127836, "created_on": "2017-03-16T20:06:29+0000", "entity_type": "strategy_concept", "id": 4955635, "name": "Strategy Concepts #4955635", "status": true, "strategy_id": 2126063, "updated_on": "2017-03-16T20:06:29+0000", "version": 0, "weighting": "NONE" }, "title": "Strategy Concept", "type": "object", "x-stoplight": { "id": "strategy-concept", "name": "Strategy Concept", "public": true }, "properties": { "concept_id": { "minimum": 0, "type": "integer" }, "created_on": { "type": "string" }, "entity_type": { "type": "string" }, "id": { "minimum": 0, "type": "integer" }, "name": { "type": "string" }, "status": { "type": "boolean" }, "strategy_id": { "minimum": 0, "type": "integer" }, "updated_on": { "type": "string" }, "version": { "minimum": 0, "type": "integer" }, "weighting": { "type": "string" } } }, "t1-meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } }, "update-audience-targeting": { "title": "Update Audience Targeting", "type": "object", "x-stoplight": { "id": "update-audience-targeting", "name": "Update Audience Targeting", "public": true }, "properties": { "exclude_op": { "type": "string", "enum": [ "OR" ] }, "include_op": { "type": "string", "enum": [ "AND" ] }, "segments.x.group_identifier": { "description": "Usually automatically assigned, provides a mechanism for advanced grouping of related segments ", "maxLength": 18, "type": "string" }, "segments.x.id": { "description": "Add audience segment to strategy if positive id is supplied. Delete audience segment from strategy if negative.", "type": "integer" }, "segments.x.restriction": { "enum": [ "INCLUDE", "EXCLUDE" ], "type": "string" } }, "description": "When updating audience segment targeting, calls are made to:\n* .../api/v2.0/strategies/[strategy_id]/audience_segments\n\nWhile viewing expected audience sizing and cost calculations, calls are made to:\n* .../api/v2.0/strategies/[strategy_id]/audience_segments/size\n* .../api/v2.0/strategies/[strategy_id]/audience_segments/cpm\n" }, "update-budget-flight": { "properties": { "end_date": { "format": "date-time", "type": "string" }, "start_date": { "format": "date-time", "type": "string" }, "total_budget": { "type": "number" }, "total_impression_budget": { "type": "integer" }, "version": { "type": "integer" } }, "title": "Update Budget Flight", "type": "object", "x-stoplight": { "id": "update-budget-flight", "name": "Update Budget Flight", "public": true } }, "update-contextual-targeting": { "properties": { "exclude_op": { "enum": [ "AND", "OR" ], "type": "string" }, "include_op": { "enum": [ "AND", "OR" ], "type": "string" }, "segments.x.id": { "description": "Add contextual segment to strategy if positive id is supplied. Delete contextual segment from strategy if negative.", "type": "integer" }, "segments.x.operator": { "enum": [ "AND", "OR" ], "type": "string" }, "segments.x.restriction": { "enum": [ "INCLUDE", "EXCLUDE" ], "type": "string" }, "segments.x.user_cpm": { "type": "string" } }, "title": "Update Contextual Targeting", "type": "object", "x-stoplight": { "id": "update-contextual-targeting", "name": "Update Contextual Targeting", "public": true } }, "update-strategy-concepts": { "properties": { "concepts.[x].id": { "type": "integer" }, "concepts.[x].percent": { "maximum": 100, "minimum": 0, "type": "number" }, "concepts.[x].weighting": { "enum": [ "IMPRESSION", "BUDGET" ], "type": "string" } }, "required": [ "concepts.[x].id", "concepts.[x].percent", "concepts.[x].weighting" ], "title": "Update Strategy Concepts", "type": "object", "x-stoplight": { "id": "update-strategy-concepts", "name": "Update Strategy Concepts", "public": true } }, "update-vendor-contract": { "example": { "campaign_id": 22035223, "price": 13971235, "rate_card_type": "CPM", "use_mm_contract": false, "vendor_id": 95836163 }, "properties": { "campaign_id": { "description": "Once set, this field can not be changed.", "minimum": 0, "type": "integer" }, "price": { "type": "number" }, "rate_card_type": { "enum": [ "CPM", "FIXED" ], "type": "string" }, "use_mm_contract": { "type": "boolean" }, "vendor_id": { "minimum": 0, "type": "integer" }, "version": { "type": "integer" } }, "title": "Update Vendor Contract", "type": "object", "x-stoplight": { "id": "update-vendor-contract", "name": "Update Vendor Contract", "public": true } }, "atomic-creative2": { "type": "object", "title": "Atomic Creative2", "description": "Atomic Creative2", "properties": { "ad_format": { "type": "string", "enum": [ "DISPLAY", "EXPANDABLE", "MOBILE" ] }, "advertiser_id": { "type": "integer" }, "approval_status": { "type": "string", "enum": [ "PENDING", "APPROVED", "REJECTED" ] }, "built": { "type": "integer" }, "built_by_user_id": { "type": "integer" }, "concept_id": { "type": "integer" }, "created_on": { "type": "string", "format": "date-time" }, "expansion_direction": { "type": "string" }, "expansion_trigger": { "type": "string", "enum": [ "AUTOMATIC", "MOUSEOVER", "CLICK" ] }, "external_identifier": { "type": "string" }, "file_type": { "type": "string", "enum": [ "gif", "html5", "jpg", "png", "swf", "tif", "tiff", "unknown", "vast", "zip" ] }, "has_sound": { "type": "integer" }, "height": { "type": "integer" }, "id": { "type": "string" }, "is_https": { "type": "integer" }, "is_mraid": { "type": "integer" }, "is_multi_creative": { "type": "integer" }, "last_modified": { "type": "string", "format": "date-time" }, "last_payload_modified": { "type": "string", "format": "date-time" }, "media_type": { "type": "string", "enum": [ "DISPLAY", "VIDEO", "MOBILE" ] }, "name": { "type": "string" }, "rejected_reason": { "type": "string" }, "rich_media": { "type": "integer" }, "sizmek_creative_status": { "type": "string" }, "sizmek_tag_status": { "type": "string" }, "status": { "type": "integer" }, "t1as": { "type": "integer" }, "tag": { "type": "string" }, "tag_type": { "type": "string", "enum": [ "FRAME_SCRIPT", "SCRIPT_NOSCRIPT", "IFRAME_SCRIPT", "IFRAME_NOSCRIPT", "IFRAME_IMG", "SCRIPT", "NOSCRIPT", "IFRAME", "IMG" ] }, "tpas_ad_tag_name": { "type": "string" }, "updated_on": { "type": "string", "format": "date-time" }, "vast_version": { "type": "integer" }, "width": { "type": "integer" } } }, "settings": { "type": "object", "properties": {}, "title": "Settings Endpoint", "description": "The entities (creatives,organizations,advertisers,agencies,campaigns) have settings endpoints. \n\nA settings endpoint allows users to define arbitrary key-value pairs in order to change components of their configuration. Though arbitrary keys are allowed only defined values will create an effect. " }, "new-model": { "type": "object", "properties": {} }, "new-model-1": { "type": "object", "properties": {} }, "Meta-3": { "type": "object", "properties": { "called_on": { "type": "string" }, "etag": { "type": "string" }, "status": { "type": "string" } }, "title": "Meta-3" }, "Meta-7": { "type": "object", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "next_page": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } } }, "new-model-2": { "example": { "entity_type": "user", "id": 9, "name": "TerminalOne" }, "properties": { "access_internal_fees": { "type": "boolean" }, "active": { "type": "boolean" }, "created_on": { "format": "date-time", "type": "string" }, "creator_id": { "type": "integer" }, "edit_campaigns": { "type": "boolean" }, "edit_data_definition": { "type": "boolean" }, "edit_margins_and_performance": { "type": "boolean" }, "edit_segments": { "type": "boolean" }, "email": { "format": "email", "type": "string" }, "entity_type": { "enum": [ "user" ], "type": "string" }, "fax": { "type": "string" }, "first_name": { "type": "string" }, "id": { "type": "integer" }, "labs_enable_rmx": { "type": "boolean" }, "last_login_on": { "type": "string" }, "last_name": { "type": "string" }, "link_ldap": { "type": "boolean" }, "link_saml": { "type": "boolean" }, "mobile": { "type": "string" }, "name": { "type": "string" }, "password": { "type": "string" }, "password_reset_sent": { "format": "date-time", "type": "string" }, "password_reset_token": { "type": "string" }, "phone": { "type": "string" }, "role": { "enum": [ "ADMIN", "MANAGER", "REPORTER" ], "type": "string" }, "scope": { "enum": [ "GLOBAL", "SELECT" ], "type": "string" }, "sso_auth_sent": { "format": "date-time", "type": "string" }, "sso_auth_token": { "type": "string" }, "title": { "type": "string" }, "type": { "enum": [ "ADVERTISER", "AGENCY", "INTERNAL", "VPAN" ], "type": "string" }, "updated_on": { "format": "date-time", "type": "string" }, "username": { "type": "string" }, "version": { "type": "integer" }, "view_data_definition": { "type": "boolean" }, "view_dmp_reports": { "type": "boolean" }, "view_organizations": { "type": "boolean" }, "view_segments": { "type": "boolean" } }, "title": "User", "type": "object", "x-stoplight": { "id": "user", "name": "user", "public": true } }, "strategy": { "example": { "audience_segment_exclude_op": "OR", "audience_segment_include_op": "OR", "bid_aggressiveness": 50, "bid_price_is_media_only": true, "budget": [ { "currency_code": "USD", "value": 1095.43 } ], "campaign_id": 342332, "created_on": "2017-03-05T16:23:46+0000", "currency_code": "USD", "effective_goal_value": [ { "currency_code": "USD", "value": "85.0000" } ], "end_date": "2017-11-01T03:59:59+0000", "entity_type": "strategy", "frequency_amount": 15, "frequency_interval": "day", "frequency_optimization": false, "frequency_type": "even", "goal_type": "cpa", "goal_value": [ { "currency_code": "USD", "value": 85 } ], "id": 2059202, "impression_pacing_interval": "day", "impression_pacing_type": "no-limit", "max_bid": [ { "currency_code": "USD", "value": 1.19 } ], "media_type": "DISPLAY", "min_bid": [ { "currency_code": "USD", "value": 0 } ], "name": "Q7HGQ1YS000_ZIPs", "pacing_amount": [ { "currency_code": "USD", "value": 0.01 } ], "pacing_interval": "hour", "pacing_type": "even", "pixel_target_expr": "NOT ( [1141991] )", "run_on_all_exchanges": false, "run_on_all_pmp": false, "run_on_display": true, "run_on_mobile": true, "run_on_streaming": false, "site_restriction_transparent_urls": false, "site_selectiveness": "REDUCED", "status": true, "supply_type": "RTB", "targeting_segment_exclude_op": "OR", "targeting_segment_include_op": "OR", "type": "GBO", "updated_on": "2017-10-18T12:44:52+0000", "use_campaign_end": false, "use_campaign_start": true, "use_mm_freq": false, "use_optimization": true, "version": 995, "zone_name": "America/New_York" }, "title": "Strategy", "type": "object", "x-stoplight": { "id": "strategy", "name": "Strategy", "public": true }, "properties": { "ads_txt_verified": { "type": "string", "description": "Specify parent campaign of strategy", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ] }, "audience_segment_exclude_op": { "type": "string", "enum": [ "AND", "OR" ], "description": "Exclude associated audience segment from targeting" }, "audience_segment_include_op": { "type": "string", "enum": [ "AND", "OR" ], "description": "Include associated audience segment in targeting" }, "bid_aggressiveness": { "type": "integer", "description": "Only relevant for strategies with goal_type=’reach’. Reflects the target win rate for bid opportunities that match the strategy’s targeting, e.g. setting bid_aggressiveness to 65% instructs T1 to bid at a level for each impression such that it will win ~65% of the time" }, "bid_min_devices": { "type": "integer", "minimum": 1, "maximum": 5 }, "bid_price_is_media_only": { "type": "boolean", "description": "Informs T1 that value entered on the strategygoal_valuemax_bidshould be the amount forthe \"media only\" (bid_price_is_media_only=1)or \"total spend\" (bid_price_is_media_only=0)\ndefault: 1" }, "budget": { "type": "array", "description": "Currency code for this strategy. Read-only; inherited from the parent campaign.", "items": { "type": "object", "properties": { "currency_code": { "type": "string", "description": "Currency code for this strategy. Read-only; inherited from the parent campaign." }, "value": { "type": "number" } } } }, "campaign_id": { "type": "integer", "description": "Specify parent campaign of strategy" }, "cost_passthrough_cpm_enabled": { "type": "boolean" }, "cost_passthrough_cpm_value": { "type": "number" }, "cost_passthrough_percent_enabled": { "type": "boolean" }, "cost_passthrough_percent_value": { "type": "number" }, "created_on": { "type": "string" }, "currency_code": { "type": "string", "description": "ISO 4217 3-letter currency code" }, "description": { "type": "string" }, "device_graph_only": { "type": "boolean" }, "effective_ads_txt_verified": { "type": "string", "enum": [ "ANY", "AUTHORIZED_ONLY", "AUTHORIZED_DIRECT_ONLY" ] }, "effective_device_graph_only": { "type": "integer", "minimum": 0, "maximum": 1 }, "effective_goal_value": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "string" } } } }, "end_date": { "type": "string" }, "entity_type": { "type": "string" }, "exchange_type_for_run_on_all": { "type": "string", "description": "", "enum": [ "ALL_ELIGIBLE", "SELECTED_ONLY", "SOURCE" ] }, "feature_compatibility": { "type": "string", "maxLength": 1024 }, "frequency_amount": { "type": "integer", "description": "Maximum frequency of impressions per user within interval set on frequency_interval.\n\nrequired if `frequency_type='even'||'asap'`" }, "frequency_interval": { "type": "string", "description": "Interval applicable for frequency_amount.\n\nrequired if `frequency_type='even'||'asap'`\n", "enum": [ "day", "hour", "week", "month", "campaign", "not-applicable" ] }, "frequency_optimization": { "type": "boolean", "description": "Indicates whether the strategy should use a T1 Optimized Frequency Cap. Setting this field to \"Off\" means the user will dictate the flat bid price for each impression." }, "frequency_type": { "type": "string", "enum": [ "even", "asap", "no-limit" ] }, "goal_type": { "type": "string", "description": "The type of bid price optimization (if any) that the strategy will use when buying impressions, as well as the performance metric against which performance will be measured. Allowed values: roi, cpa, cpc, ctr, vcr, viewability_rate, vcpm, reach, spend. See table in Campaigns that shows which strategy goal types are allowed for each campaign goal type.", "enum": [ "roi", "cpa", "cpc", "ctr", "vcr", "viewability_rate", "vcpm", "reach", "spend" ] }, "goal_value": { "type": "array", "description": "Target goal value for strategy respective to the goal_type selection.\n\nrequired if `goal_type in ('cpa','cpc','reach','roi', 'vcr', 'ctr')`\n\nIf goal type is `vcr` or `ctr`, goal_value is a percentage.", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } } } }, "id": { "type": "integer" }, "impression_pacing_amount": { "type": "integer", "description": "Value related to the pacing interval over which impression pacing is to be distributed" }, "impression_pacing_interval": { "type": "string", "description": "Period of time over which impression pacing is to be distributed", "enum": [ "day", "hour", "week", "month", "campaign", "not-applicable" ] }, "impression_pacing_type": { "type": "string", "description": "Type of impression pacing applied to strategy.", "enum": [ "even", "asap", "no-limit" ] }, "max_bid": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "number" } } } }, "max_bid_wm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "number" } } } }, "media_type": { "type": "string", "description": "Whether the strategy is a display or video strategy", "enum": [ "VIDEO", "DISPLAY" ] }, "min_bid": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } } } }, "name": { "type": "string", "description": "Descriptive name of strategy" }, "pacing_amount": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "number" } } } }, "pacing_interval": { "type": "string", "description": "Specify distribution of spend across the pacing_interval" }, "pacing_optimization_amount": { "type": "number", "description": "Specify value related to pacing_interval optimization type" }, "pacing_optimization_type": { "type": "string", "description": "Specify type of spend across the pacing_interval optimization: impression or monterary" }, "pacing_type": { "type": "string", "description": "Specify distribution of spend across the pacing_interval" }, "pixel_target_expr": { "type": "string", "description": "Specify pixel targeting for the strategy. Poll must be run to obtain available Pixel IDs. To configure Pixel-Targeting, pixels must have previously been generated. See \"API for Event Pixels and Data Pixels\" for more information on creating and obtaining information on Pixels.\n\n( [pixel_id] INCL_COND [pixel_id] ) AND NOT ( [pixel_id EXCL_COND[pixel_id] )1024 characters maximumnote Although theINCL_CONDandEXCL_CONDis not required to be consistent, the conditional logic between all pixels to be included or excluded must be the same.\nmaxLength: 1024" }, "rmx_strategy": { "type": "object", "properties": { "budget": { "type": "number" }, "budget_type": { "type": "string", "enum": [ "DOLLARS", "IMPRESSIONS" ] }, "cpa_pixel_bundle_id": { "type": "integer" }, "cpa_pixel_type": { "type": "string", "enum": [ "CLICK", "IMPRESSION" ] }, "created_on": { "type": "string", "format": "date-time" }, "dynamic_pricing_option": { "type": "string", "enum": [ "AVERAGE", "STANDARD", "WIN", "SPEND" ] }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "imp_budget": { "type": "number" }, "learning_budget": { "type": "number" }, "learning_budget_pacing": { "type": "string", "enum": [ "ASAP", "EVEN", "HOURLY", "DAILY", "MONTHLY" ] }, "learning_slider": { "type": "integer" }, "name": { "type": "string" }, "pacing": { "type": "string", "enum": [ "asap", "deliver_overall_budget_evenly", "deliver_remaining_budget_evenly", "hourly_asap", "hourly_even", "daily_asap", "daily_even", "monthly_asap", "monthly_even" ] }, "price": { "type": "number" }, "pricing_type": { "type": "string", "enum": [ "CPA", "CPC", "CPM", "DYNAMIC" ] }, "rel": { "type": "string" }, "rmxapi_io_identifier": { "type": "integer" }, "rmxapi_li_identifier": { "type": "integer" }, "rmx_push_entity_id": { "type": "integer" }, "rmx_push_status": { "type": "string", "enum": [ "NEW", "UPDATED", "IN_PROGRESS", "PUSH_OK", "PUSH_FAILED" ] }, "roi_cpc_target_ctr": { "type": "string" }, "roi_cpc_target_ctr_type": { "type": "string", "enum": [ "DOLLARS", "PERCENT" ] }, "roi_modifier": { "type": "number" }, "roi_target_pixels": { "type": "array", "items": { "type": "object", "properties": { "created_on": { "type": "string", "format": "date-time" }, "entity_type": { "type": "string", "enum": [ "rmx_strategy_roi_target_pixel" ] }, "id": { "type": "integer" }, "name": { "type": "string" }, "pixel_bundle_id": { "type": "integer" }, "price": { "type": "number" }, "rel": { "type": "string" }, "rmx_pixel_type": { "type": "string", "enum": [ "CLICK", "IMPRESSION", "SEGMENT" ] }, "rmx_strategy_id": { "type": "integer" }, "status": { "type": "boolean" }, "updated_on": { "type": "string", "format": "date-time" }, "version": { "type": "integer" } } } }, "roi_targets": { "type": "string", "enum": [ "NONE", "CPA", "CPC" ] }, "status": { "type": "boolean" }, "strategy_id": { "type": "integer" }, "updated_on": { "type": "string", "format": "date-time" }, "version": { "type": "integer" } } }, "roi_target": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "number" } } }, "run_on_all_exchanges": { "type": "boolean" }, "run_on_all_pmp": { "type": "boolean" }, "run_on_display": { "type": "boolean" }, "run_on_mobile": { "type": "boolean" }, "run_on_only_fraud_filtered_exchanges": { "type": "boolean" }, "run_on_streaming": { "type": "boolean" }, "site_restriction_transparent_urls": { "type": "boolean" }, "site_selectiveness": { "type": "string", "description": "REDUCED is currently the only available option", "enum": [ "REDUCED" ] }, "source_only": { "type": "boolean" }, "start_date": { "type": "string" }, "status": { "type": "boolean" }, "supply_type": { "type": "string", "description": "Specify whether impressions will be bought and decisioned by the TerminalOne platform. Use 'RTB' for normal strategies that are bought/decisioned in T1. Use 'RMX_API' to use a tag to track media not purchased through TerminalOne.", "enum": [ "MKT", "RTB", "T1_RMX", "RMX_API" ] }, "targeting_segment_exclude_op": { "type": "string" }, "targeting_segment_include_op": { "type": "string" }, "type": { "type": "string", "description": "Specify the type of strategy (re-marketing (REM), goal-based optimization (GBO), audience (AUD))", "enum": [ "REM", "GBO", "AUD" ] }, "updated_on": { "type": "string" }, "use_bid_shading": { "type": "boolean" }, "use_campaign_end": { "type": "boolean" }, "use_campaign_start": { "type": "boolean" }, "use_mm_freq": { "type": "boolean", "description": "Unused legacy frequency cap setting. Must be set to 'off'. To control frequency capping at the campaign level, set the strategy-level frequency_type attribute to 'no-limit' and set a frequency cap on the campaign entity." }, "use_optimization": { "type": "boolean", "description": "Enable's T1 optimization algorithm (defaults to 'off' if unspecified).\n\nrequired if `goal_type!='spend'`" }, "version": { "type": "integer", "description": "This number increments whenever the strategy is updated. Do not define it upon creation." }, "value": { "type": "integer" }, "zone_name": { "type": "string" } } } }, "host": "api.mediamath.com", "info": { "description": "# Entity Hierarchy\n\n
\n\n\n![MediaMath Overview](https://mediamath.github.io/api-docs/images/T1-Entity-Heirarchy.png \"MediaMath Overview\")\n\n
\n\n- [Retrieving Entities](#retrieving-entities)\n - [Retrieving Single Entities](#retrieving-single-entities)\n - [Including Related Entities](#including-related-entities)\n - [Retrieving Multiple Entities](#retrieving-multiple-entities)\n - [Including Entity Properties](#including-entity-properties)\n - [Sorting](#sorting)\n - [Querying for entities](#querying-for-entities)\n - [Retrieving Multiple Specific Entities by ID](#retrieving-multiple-specific-entities-by-id)\n - [Substring search](#substring-search)\n - [Filtering based on IDs of related entities](#filtering-based-on-ids-of-related-entities)\n - [Filtering based on hierarchical relationships](#filtering-based-on-hierarchical-relationships)\n - [Filtering based on linkage relationships](#filtering-based-on-linkage-relationships)\n- [Creating New Entities](#creating-new-entities)\n- [Updating Entities](#updating-entities)\n - [Update Timeframes](#update-timeframes)\n - [Retrieving Entity Changelogs](#retrieving-entity-changelogs)\n\n\n\n## Retrieving Entities\n\nIndividual entities and collections of entities can be retrieved using HTTP `GET` requests to their respective API endpoints:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/organizations\n```\n\n``` response\n\n\n \n \n \n \n\n```\n\nResponses are made up of a `result` element at the root of the document, which contains a `status` element indicating the status of the API response. If the request was for a single entity, the `result` element will contain a single `entity` element; otherwise, it will contain an `entities` element containing `entity` elements representing the requested entities.\n\n### Retrieving Single Entities\n\nTo retrieve an entity by ID, issue a `GET` request to the entity API base followed by the entity ID, as in this example:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/strategies/515578\n```\n\n``` response\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n [ . . . ]\n \n \n\n```\n\n#### Including Related Entities\n\nSome entities contain references to other entities to which they are related. For example, a strategy belongs to a single campaign; when you retrieve a strategy entity, it will include a `campaign_id` property. You can include details about this kind of related entity inside the entity you're requesting by appending the `with` parameter to the URL you request. Pass the name (singular) of the entity you're interested in as the value of the `with` parameter:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/strategies/515578?with=campaign\n```\n\n``` response\n\n\n \n \n \n \n [ . . . ]\n \n \n [ . . . ]\n \n \n\n```\n\nTo retrieve details about multiple entities directly related to the top-level entity you're requesting, use multiple `with` parameters:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/advertisers/125819?with=agency&with=vertical\n```\n\n``` response\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n [ . . . ]\n \n \n\n```\n\nYou can also retrieve details about entities related to the related entities themselves. To do this, pass a comma-separated list of entity names in a `with` parameter:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/strategies/515578?with=campaign,advertiser\n```\n\n``` response\n\n\n \n \n \n \n \n \n \n \n [ . . . ]\n \n \n \n [ . . . ]\n \n \n [ . . . ]\n \n \n\n```\n\n### Retrieving Multiple Entities\n\nTo retrieve multiple entities in a single call, issue a GET request to the API endpoint for the entity you’re interested in. Lists of entities are paginated by default, and the maximum number of entities per page is 100. Use the `page_limit` parameter to specify how many entities to retrieve, and the `page_offset` parameter to specify the index of the first element in the collection to retrieve (*not* the page number).\n\n``` request\nGET https://api.mediamath.com/api/v2.0/strategies?page_limit=5&page_offset=10\n```\n\n``` response\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n```\n\n#### Including Entity Properties\n\nWhen requesting a collection of entities, the default output will return only the `name`, `id`, and `type` properties of the entity, as shown in the above example. To include all properties of entities returned by collection endpoints, include the `full` parameter in the URL query string. Set the `full` parameter to a comma-separated list of entities to include full properties for. For example, this query returns the requested strategies, and uses the `with` parameter to include their associated campaign, advertiser, agency, and organization. By setting `full=strategy,campaign`, it only includes full properties for the strategy and campaign entities:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/strategies?page_limit=2&with=campaign,advertiser,agency,organization&full=strategy,campaign\n```\n\n``` response\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n [ additional campaign properties ]\n \n \n \n \n \n \n [ additional strategy properties ]\n \n \n \n \n \n \n \n \n \n \n \n \n \n [ additional campaign properties ]\n \n \n \n \n \n \n \n [ additional strategy properties ]\n \n \n \n\n```\n\nTo include all properties for all entities returned by the API call, use `full=*`:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/strategies?page_limit=2&full=*\n```\n\n``` response\n\n\n \n \n \n \n \n \n \n \n [ additional strategy properties ]\n \n \n \n \n \n \n \n \n [ additional strategy properties ]\n \n \n \n\n```\n\n#### Sorting\n\nInclude a `sort_by` parameter in a requst for multiple entitites to sort the entities by a named property:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/strategies?page_limit=5&sort_by=name\n```\n\n``` response\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n\n```\n\nTo sort in descending order, use a `-` sign before the parameter to sort on, e.g. `sort_by=-name`. To sort by multiple properties, pass a comma-separated list of properties in the `sort_by` parameter. For example, `sort_by=name,-total_budget` would return a list of entities sorted by name ascending, then, for entities with the same name, by budget descending.\n\n#### Querying for entities\n\nTo retrieve elements that have properties matching certain expressions, you can use the `q` parameter. Query predicates are composed of three parts:\n\n- the property being searched upon;\n- the operator; and\n- the value to match.\n\nSupported operators include:\n\n- `==` (numeric equality or case-sensitive string identity)\n- `!=` (numeric inequality or case-sensitive string non-identity)\n- `=:` (case-insensitive match, allows substring using \\* wildcards)\n- `<` (less than)\n- `<=` (less than or equal to)\n- `>` (greater than)\n- `>=` (greater than or equal to)\n\nSuppose the user is interested in those campaigns whose `name` is `Lambda Campaign Spend`. In this case, the comparison of \"exact match\" would be expressed by an `==` operator. **Note that query strings must be URL-encoded:**\n\n``` request\nGET https://api.mediamath.com/api/v2.0/campaigns?q=name%3D%3DLambda%20Campaign%20Spend\n```\n\n``` response\n\n\n \n \n \n \n \n \n \n \n\n```\n\nTo combine multiple expressions in a query string, use an ampersand (`&`). For example, to retrieve all campaigns with the `name` of `Test Campaign` and a `total_budget` greater than or equal to $10,000, you could compose the query string `name==Test Campaign&total_budget>=10000`. The URL-encoded request would look like this:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/campaigns?q=name%3D%3DTest%20Campaign%26total_budget%3E%3D10000\n```\n\n``` response\n\n\n \n \n \n \n \n \n\n```\n\n#### Retrieving Multiple Specific Entities by ID\n\nThe 'q=' syntax also supports fetching a list of entities of the same type specified by their entity ID numbers. The general formula for this is:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/strategies?q=(123,234,456)\n```\n\n``` response\n\n\n \n \n \n \n \n \n\n```\n\nEntity IDs are limited to the range 1 through 2147483647. Requesting a `q=()` ID outside that range will result in a 400 response.\n\n#### Substring search\n\nAdding a search string between angled brackets to the 'q=' parameter will perform a substring match across all string fields of an entity.\n\n``` request\nGET https://api.mediamath.com/api/v2.0/users?q=\n```\n\n``` response\n\n\n \n \n \n \n \n \n\n```\n\n#### Filtering based on IDs of related entities\n\nWe often want to limit the data returned by an API GET call to those records which display a particular relationship to instances of other business objects. Such a relationship may be one of **hierarchy** – where an object is a descendent of a \"higher-level\" type of object – or one of **linkage** – where an object is linked to a particular instance of a completely different type of business object. In either case, the user wants to limit the selection of objects returned to a particular subset of those business objects.\n\nTo accomplish this, you can insert a `/limit` component in the URL of a request for multiple entities. This allows you to filter the data returned according to a hierarchical relationship, a linkage relationship, or a combination of both.\n\n##### Filtering based on hierarchical relationships\n\nThe main hierarchical relationship in the Execution and Management API is the one between organizations, advertisers, agencies, advertisers, campaigns, and strategies, respectively. When requesting a collection of entities in this hierarchy, you can use a `limit` URL component to retrieve only entities belonging to a specific parent. For example, to retrieve campaigns belonging to the advertiser with ID `126`, you could issue the following request:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/campaigns/limit/advertiser=126\n```\n\n``` response\n\n\n \n \n \n \n \n\n```\n\nYou can use `.` in `/limit` URL components to filter based on entities higher up the hierarchy. For example, to retrieve campaigns for all advertisers in agency ID `914`, you could issue this request:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/campaigns/limit/advertiser.agency=914\n```\n\n``` response\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n```\n\n#### Filtering based on linkage relationships\n\nSome entities are linked to other entities through other entities that are related to both. For example, a `vendor_contract` entity represents a relationship between a `campaign` entity and a `vendor` entity. To retrieve all campaigns using a specific vendor, then, you can issue a request like this:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/campaigns/limit/vendor_contracts.vendor=515\n```\n\n``` response\n\n\n \n \n \n \n \n [ . . . ]\n \n \n\n```\n\nNote that, for `/limit` URL components involving linkage relationships, **the plural form of the linkage entity must be used** — `/limit/vendor_contracts`, not `/limit/vendor_contract`.\n\n## Creating New Entities\n\nEntities in the MediaMath Execution and Management API are created by issuing a `POST` request to the entity's API endpoint. Entity properties should be sent as URL-encoded parameters in the POST body. The pages in this documentation describing individual entities include details on which properties must be specified when creating new entities. For example, creating a new [Agency](/docs/read/execution_and_management_api/Agencies) requires a `name` parameter and an `organization_id` parameter.\n\n``` request\nPOST https://api.mediamath.com/api/v2.0/agencies\n\nname=Demo Agency&organization_id=100048\n```\n\n``` response\n\n\n \n \n \n \n \n \n \n \n \n \n \n\n```\n\nIf all required parameters are valid, the server returns a new entity with its own `id` and `version` parameters. You can then access the entity at `https://api.mediamath.com/api/v2.0/[type]/[id]`, where `[type]` represents the entity type (`agency`, in this example) and `[id]` is the entity ID.\n\n## Updating Entities\n\nTo update an entity, you'll first need to know the current `version` property of the entity. You can access this by issuing a GET request to the entity's URL:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/agencies/104981\n```\n\n``` response\n\n\n \n \n \n \n \n \n \n \n \n \n \n\n```\n\nThen, issue a POST request to the entity's URL, including the `version` parameter and any properties you'd like to update:\n\n``` request\nPOST https://api.mediamath.com/api/v2.0/agencies/104981\n\nname=Demo Agency Updated&version=0\n```\n\n``` response\n\n\n \n \n \n \n \n \n \n \n \n \n \n\n```\n\nAfter validating the updated parameters, the server responds with the details of the updated entity. Note that the `version` parameter is updated, to prevent multiple clients from updating the same version of an entity at once.\n\nDo not include the entity's ID in the POST body, as it is already implicit from the URL and cannot be modified.\n\n### Update Timeframes\n\nUpdates to entities have to be propogated to the Bidders in order for them to affect how MediaMath bids for opportunities. Regular updates have an average latency of 1.5 hours. Updates of fields of entities below are *fast tracked* and update within 5 minutes.\n\n**Campaigns:**\n\n- id\n- end_date\n- start_date\n- status\n- total_budget\n\n**Strategies:**\n\n- budget\n- end_date\n- goal_value\n- id\n- max_bid\n- min_bid\n- pacing_amount\n- pacing_interval\n- pacing_type\n- start_date\n- status\n\n**USD Budget Flights:**\n\n- campaign_id\n- end_date\n- id\n- start_date\n- total_budget\n- total_budget_usd\n\n\n### Retrieving Entity Changelogs\n\nCertain entities allow you to retrieve a list of changes made to the entity over time. The endpoint only shows 90 days worth of history. To retrieve changelog data, make a request of the following form:\n\n``` endpoint\nGET https://api.mediamath.com/api/v2.0/[collection]/[id]/history\n```\n\nFor example, to retrieve the update history for the agency shown above, you could issue the following request:\n\n``` request\nGET https://api.mediamath.com/api/v2.0/agencies/104981/history\n```\n\n``` response\n\n\n \n \n \n \n \n \n \n \n \n \n \n\n```\n\n### Your Targeting Options\n\nTargeting is, roughly, the process of limiting the reach of advertisements, either by limiting the set of consumers to whom they will be shown, or by limiting the circumstances under which they will be shown. Mediamath supports multiple types of targeting for strategies, mostly implemented in the Adama service but for some types of targeting, implemented in the related Nemo service. \n\nSee the instructions under /nemo/attachment’s GET on how to determine specific values that will help you filter your WURFL, Hyperlocal or IP Targeting needs.\n\nBut let's look at a logical sequence of examining and editing your targeting. The following could be used to fetch all the Hyperlocal Targets who are children of the Hyperlocal parent record (id 1):\n```\nGET /target?id=1\n\n{\n \"data\" : [\n {\n \"updated_on\" : \"2016-06-07 02:06:58.068356+00\",\n \"created_on\" : \"2016-06-07 02:06:58.068356+00\",\n \"path\" : null,\n \"name\" : \"Hyperlocal\",\n \"factual_id\" : null,\n \"mediamath_organization_id\" : null,\n \"parent_id\" : null,\n \"id\" : 1\n }\n ],\n \"meta\" : {\n \"count\" : 1,\n \"total_count\" : 1,\n \"offset\" : 0,\n \"status\" : \"success\"\n }\n}\n```\n\nYou can then create a new target for our Hyperlocal (Factual) design as id=37, then attach that Target 37 to a MediaMath strategy ID:\n\nSo now that we know the Hyperlocal parent Target ID (1), we create a new Target for our Hyperlocal (Factual) design:\n\n```\nPOST /target { \n parent_id: 1,\n name: Factual Design 138,\n mediamath_organization_id: 100170,\n factual_id: 1f5b06bd-0cbd-4306-9ec3-37e5dd9cc780,\n}\n\n{ ...\n id: 37,\n path: 1.37,\n name: Factual Design 138,\n mediamath_organization_id: 100170,\n factual_id: 1f5b06bd-0cbd-4306-9ec3-37e5dd9cc780,\n ...\n} \n\n.\n.\n.\n\nPOST /attachment {\n target_id: 37,\n strategy_id: 11010,\n restriction: INCLUDE,\n operator: AND\n} ,\n\n{ ...\n id: 42,\n ...\n}\n```\n\nYou've now created Attachment ID 42.", "title": "Campaign Management API", "version": "2.0", "x-stoplight": { "id": "mediamath/specs/execution-and-management" }, "contact": { "name": "developers@mediamath.com", "email": "developers@mediamath.com", "url": "https://apidocs.mediamath.com" } }, "parameters": { "trait:jsonResponse:Accept": { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, "trait:limit:page_limit": { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, "trait:limit:page_offset": { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, "trait:querying:q": { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, "trait:returnAdditionalEntityProperties:full": { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, "trait:returnAdditionalEntityProperties:with": { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" }, "trait:sorting:sort_by": { "description": "name", "in": "query", "items": { "type": "string" }, "name": "sort_by", "required": false, "type": "string" }, "ad_server_fee": { "in": "formData", "name": "ad_server_fee", "description": "Fee charged by ad serving vendor", "type": "integer" }, "ad_server_id": { "in": "formData", "name": "ad_server_id", "description": "The ID for a third-party ad server", "type": "integer" }, "advertiser_id": { "in": "formData", "name": "advertiser_id", "default": 512321, "description": "T1 Advertiser ID to which a campaign belongs", "type": "integer" }, "agency_fee_pct": { "in": "formData", "name": "agency_fee_pct", "type": "integer" }, "conversion_type": { "in": "formData", "name": "conversion_type", "description": "Definition for conversions per user.\n\nevery: Attribute all Merit Events\n\nvariable: Attribute one Merit Event per X minutes - set inconversion_variable_minutes\n\none: Attribute one Merit Event per user (if converstion_type = one, then conversion_variable_minutes (integer) is required).\n\nrequired if `goal_type in ('cpa', 'roi')`\n", "enum": [ "every", "one", "variable" ], "type": "string" }, "conversion_variable_minutes": { "in": "formData", "name": "conversion_variable_minutes", "description": "Attribute one Merit Event per X minutes\n\nrequired if `goal_type in ('cpa', 'cpc', 'roi') && conversion_type=one`", "type": "integer" }, "created_on": { "in": "formData", "name": "created_on", "type": "string" }, "currency_code": { "in": "formData", "name": "currency_code", "default": "USD", "description": "Currency setting for campaign. All strategies under this value inherit the selected currency. Once the campaign launches, it cannot be switched to another currency (aka existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).", "type": "string" }, "dcs_data_is_campaign_level": { "in": "formData", "name": "dcs_data_is_campaign_level", "type": "boolean" }, "end_date": { "in": "formData", "name": "end_date", "description": "Last date of campaign in GMT", "type": "string" }, "frequency_amount": { "in": "formData", "name": "frequency_amount", "description": "required if `frequency_type=even||asap`", "type": "integer" }, "frequency_interval": { "in": "formData", "name": "frequency_interval", "description": "required if `frequency_type=even||asap`\n", "type": "string" }, "frequency_optimization": { "in": "formData", "name": "frequency_optimization", "description": "", "type": "boolean" }, "frequency_type": { "in": "formData", "name": "frequency_type", "default": "no-limit", "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap.", "enum": [ "even", "asap", "no-limit" ], "type": "string" }, "goal_type": { "in": "formData", "name": "goal_type", "description": "Goal type which campaign performance will be measured", "enum": [ "roi", "cpa", "cpc", "reach", "spend", "vcr", "ctr" ], "type": "string" }, "goal_value": { "in": "formData", "name": "goal_value", "description": "Target goal value for campaign respective to the goal_type selection.\n\nrequired if `goal_type in ('cpa','cpc','reach','roi', 'vcr', 'ctr')`\n\nIf goal type is `vcr` or `ctr`, goal_value is a percentage.", "type": "string" }, "has_custom_attribution": { "in": "formData", "name": "has_custom_attribution", "description": "", "type": "boolean" }, "impression_cap_amount": { "in": "formData", "name": "impression_cap_amount", "description": "Sets the amount of the available impression budget across the remaining number of days across all their strategies.", "type": "integer" }, "impression_cap_automatic": { "in": "formData", "name": "impression_cap_automatic", "description": "", "type": "boolean" }, "impression_cap_type": { "in": "formData", "name": "impression_cap_type", "default": "no-limit", "description": "Type of cap applied to impression budgets.", "enum": [ "even", "asap", "no-limit" ], "type": "string" }, "initial_start_date": { "in": "formData", "name": "initial_start_date", "type": "string" }, "io_name": { "in": "formData", "name": "io_name", "description": "Descriptive name of insertion order", "type": "string" }, "is_programmatic_guaranteed": { "in": "formData", "name": "is_programmatic_guaranteed", "type": "boolean", "description": "Sets the campaign as a Programmatic Guaranteed campaign. Once set for a campaign, it cannot be changed" }, "margin_pct": { "in": "formData", "name": "margin_pct", "description": "Margin percentage to be applied on campaign spend", "type": "integer" }, "merit_pixel_id": { "in": "formData", "name": "merit_pixel_id", "description": "Specify Merit Pixel that represents conversion or engagement on CPA or CPE type campaigns\n\nREQUIRED if `goal_type in ('cpa','roi')`", "type": "integer" }, "minimize_multi_ads": { "in": "formData", "name": "minimize_multi_ads", "default": 0, "description": "Enabling this field will cause T1 to avoid bidding on more than one ad opportunity on a single page view across. Warning: enabling this setting may limit pacing and reduce the available inventory for the campaigns by not bidding on impression opportunities where the URL is not transparent.", "type": "boolean" }, "name": { "in": "formData", "name": "name", "description": "Descriptive name of the campaign", "type": "string" }, "override_suspicious_traffic_filter": { "in": "formData", "name": "override_suspicious_traffic_filter", "type": "boolean", "default": 0, "description": "Enabling this setting allows you to set a campaign-specific level of suspicious traffic filtering using the 'suspicious_traffic_filter_level' property. This will override the T1 default (or organization-level, if configured) suspicious traffic filtering level." }, "pc_window_minutes": { "in": "formData", "name": "pc_window_minutes", "description": "Post-click window for attribution. Not to be confused with pv_window_minutes.\n\noptional if `goal_type in ('cpa','roi')`\n", "type": "integer" }, "pv_pct": { "in": "formData", "name": "pv_pct", "description": "Percentage of post-view windows to be used for attribution\n\noptional if `goal_type in ('cpa','roi')`", "type": "integer" }, "pv_window_minutes": { "in": "formData", "name": "pv_window_minutes", "description": "Post-view window for attribution \n\nrequired if `goal_type in ('cpa','roi')`", "type": "integer" }, "restrict_targeting_to_deterministic_id": { "in": "formData", "name": "restrict_targeting_to_deterministic_id", "type": "boolean" }, "restrict_targeting_to_same_device_id": { "in": "formData", "name": "restrict_targeting_to_same_device_id", "type": "boolean" }, "service_type": { "in": "formData", "name": "service_type", "description": "Indicate whether campaign will be self-service or managed (managed campaigns will incur manage service fee)", "enum": [ "SELF", "MANAGED" ], "type": "string" }, "spend_cap_amount": { "in": "formData", "name": "spend_cap_amount", "description": "only required if`spend_cap_enabled`is true", "type": "integer" }, "spend_cap_automatic": { "in": "formData", "name": "spend_cap_automatic", "type": "boolean", "description": "Automatically sets the available spend budget across all strategies through the end date of the campaign." }, "spend_cap_type": { "in": "formData", "name": "spend_cap_type", "description": "Type of cap applied to spend budgets.", "enum": [ "even", "asap", "no-limit" ], "type": "string" }, "start_date": { "in": "formData", "name": "start_date", "description": "Date on which the campaign will start (GMT)", "type": "string" }, "status": { "in": "formData", "name": "status", "default": false, "description": "Status of the campaign", "type": "boolean" }, "suspicious_traffic_filter_level": { "in": "formData", "name": "suspicious_traffic_filter_level", "description": "A value between 0 and 100 that determines the sensitivity of T1 suspicious traffic filtering capabilities.If the value = 0, all fraud and suspicious traffic filtering is turned off.It will not take effect if 'override_suspicious_traffic_filter_level' is not set.\n\n", "maximum": 100, "minimum": 0, "type": "integer" }, "total_budget": { "in": "formData", "name": "total_budget", "description": "Allocated budget for the campaign", "type": "integer" }, "updated_on": { "in": "formData", "name": "updated_on", "type": "string" }, "use_default_ad_server": { "in": "formData", "name": "use_default_ad_server", "type": "boolean" }, "use_mm_freq": { "in": "formData", "name": "use_mm_freq", "type": "boolean" }, "version": { "in": "formData", "name": "version", "type": "integer" }, "zone_name": { "in": "formData", "name": "zone_name", "default": "America/New_York", "description": "Indicate the time zone for reporting for the campaign", "type": "string" } }, "paths": { "/session": { "get": { "operationId": "GET_api-v2-0-session", "summary": "Get Current User Session Information", "description": "This path is used to gather information on your current session, or for services to validate sessions against the main authentication service.\n\nNo query parameters.", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" } ], "responses": { "200": { "description": "", "schema": { "properties": { "data": { "properties": { "entity_type": { "enum": [ "user" ], "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "session": { "properties": { "current_time": { "format": "date-time", "type": "string" }, "expires": { "format": "date-time", "type": "string" }, "sessionid": { "type": "string" } }, "type": "object" } }, "type": "object" }, "meta": { "properties": { "status": { "enum": [ "ok" ], "type": "string" } }, "type": "object" }, "uuid": { "type": "string" } }, "type": "object" }, "examples": { "application/vnd.mediamath.v1+json": { "data": { "entity_type": "user", "id": 12345, "name": "itsme", "session": { "current_time": "2019-05-31T14:59:23", "expires": "2019-06-01T14:59:23", "sessionid": "d2f90cae7ce3459b0b0307bede0336acd85b2fb8" } }, "meta": { "status": "ok" }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B" } } } }, "tags": [ "Users" ] } }, "/permissions": { "get": { "operationId": "GET_api-v2-0-permissions", "summary": "Get Current User Permissions Information", "description": "This path is used to gather information on your current session, or for services to validate sessions against the main authentication service.\n\nNo query parameters.", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" } ], "responses": { "200": { "description": "", "schema": { "properties": { "data": { "properties": { "permissions": { "properties": { "entities": { "properties": { "advertiser": { "items": { "properties": { "access": { "items": { "properties": { "agency_id": { "type": "integer" }, "dmp_enabled": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": "array" }, "agency": { "items": { "properties": { "access": { "items": { "properties": { "child_count": { "type": "integer" }, "dmp_enabled": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "type": "integer" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": "array" }, "organization": { "items": { "properties": { "access": { "items": { "properties": { "child_count": { "type": "integer" }, "dmp_enabled": { "type": "string" }, "id": { "type": "string" }, "name": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "flags": { "items": { "properties": { "access": { "items": { "properties": { "type": { "type": "string" }, "value": { "type": [ "integer", "string" ] } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": "array" } }, "type": "object" } }, "type": "object" }, "meta": { "properties": { "status": { "type": "string" } }, "type": "object" }, "uuid": { "type": "string" } }, "type": "object" }, "examples": { "application/vnd.mediamath.v1+json": { "data": { "permissions": { "entities": { "advertiser": [ { "access": [ { "agency_id": 103615, "dmp_enabled": "enabled", "id": "126261", "name": "GoFast", "value": "w" }, { "agency_id": 104349, "dmp_enabled": "enabled", "id": "141187", "name": "New Age Products", "value": "w" }, { "agency_id": 116123, "dmp_enabled": "enabled", "id": "205751", "name": "Project Cat", "value": "w" } ] } ], "agency": [ { "access": [ { "child_count": 0, "dmp_enabled": "enabled", "id": "122059", "name": "reg_prod_agency_name", "organization_id": 100048, "value": "w" }, { "child_count": 1, "dmp_enabled": "enabled", "id": "113421", "name": "test_agency_py_2.126.1", "organization_id": 100048, "value": "w" }, { "child_count": 1, "dmp_enabled": "enabled", "id": "119793", "name": "Watson", "organization_id": 100048, "value": "w" }, { "child_count": 1, "dmp_enabled": "enabled", "id": "120252", "name": "LATCOM", "organization_id": 100048, "value": "w" } ] } ], "organization": [ { "access": [ { "child_count": 622, "dmp_enabled": "enabled", "id": "100048", "name": "ACME Org", "value": "w" } ] } ] }, "flags": [ { "access": [ { "type": "access_internal_fees", "value": 0 }, { "type": "edit_campaigns", "value": 1 }, { "type": "edit_data_definition", "value": 1 }, { "type": "edit_margins_and_performance", "value": 1 }, { "type": "edit_segments", "value": 1 }, { "type": "role", "value": "ADMIN" }, { "type": "scope", "value": "SELECT" }, { "type": "type", "value": "INTERNAL" }, { "type": "view_data_definition", "value": 1 }, { "type": "view_dmp_reports", "value": 1 }, { "type": "view_organizations", "value": 1 }, { "type": "view_segments", "value": 1 } ] } ] } }, "meta": { "status": "ok" }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B" } } } }, "tags": [ "Session Management" ] } }, "/ad_servers": { "get": { "operationId": "findAdServers", "parameters": [ { "in": "header", "name": "Via", "type": "string" }, { "in": "header", "name": "Connect-Time", "type": "integer" }, { "in": "header", "name": "Total-Route-Time", "type": "integer" }, { "in": "header", "name": "Authorization", "type": "string" }, { "in": "header", "name": "Accept", "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "name": "sort_by", "type": "string" } ], "produces": [ "text/xml" ], "responses": { "200": { "description": "", "examples": { "application/json": { "data": [ { "entity_type": "ad_server", "id": 1, "name": "Atlas", "version": 0 }, { "entity_type": "ad_server", "id": 2, "name": "DART for Advertisers (DFA)", "version": 0 }, { "entity_type": "ad_server", "id": 3, "name": "Sizmek MDX", "version": 0 }, { "entity_type": "ad_server", "id": 4, "name": "Mediaplex", "version": 0 }, { "entity_type": "ad_server", "id": 5, "name": "Yield Manager", "version": 0 } ], "meta": { "called_on": "2019-05-24T16:54:48+0000", "count": 5, "etag": "faa7f5624c7ab4b31b59e6e07e937d3d42ec329a", "next_page": "https://api.mediamath.com/api/v2.0/ad_servers?page_limit=5&page_offset=5", "offset": 0, "status": "ok", "total_count": 10 }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B" } }, "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "entity_type": { "type": "string", "enum": [ "ad_server" ] }, "id": { "type": "integer" }, "name": { "type": "string" }, "version": { "type": "integer" } }, "required": [ "entity_type", "id", "name" ] } }, "meta": { "type": "object", "properties": { "called_on": { "format": "date-time", "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "next_page": { "format": "uri", "type": "string" }, "offset": { "type": "integer" }, "status": { "enum": [ "error", "ok" ], "type": "string" }, "total_count": { "type": "integer" } } }, "uuid": { "type": "string" } } } }, "401": { "description": "", "examples": { "application/json": { "meta": { "status": "auth_required" } } }, "schema": { "type": "object", "properties": { "meta": { "type": "object", "properties": { "status": { "type": "string" } } } } } } }, "security": [ { "oauth2": [] } ], "summary": "List supported ad servers", "tags": [ "Ad Servers" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "findAdServers", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "List supported ad servers\n\nQuery parameters:\nfull=* will provide fields beyond entity_type, id, name (which is why those 3 list as required in the response); version is the added field\n\n\"sort_by\" can use any parameter in the root of the data section\n\nThere is no \"with\" parameter" } }, "/ad_servers/{ad_server_id}": { "get": { "description": "Returns a single adserver by ID\n\n\n", "operationId": "findParticularAdServer", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": { "entity_type": "ad_server", "id": 1, "name": "Atlas", "version": 0 }, "meta": { "called_on": "2019-05-24T16:57:01+0000", "etag": "26e82b70a21a2f7e194282ea1500c9bc9c28a19a", "status": "ok" }, "uuid": "164BB66C-B21A-11E9-96DD-484026F3F03C" } }, "schema": { "properties": { "data": { "properties": { "entity_type": { "enum": [ "ad_server" ], "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "version": { "type": "integer" } }, "type": "object" }, "meta": { "properties": { "called_on": { "format": "date-time", "type": "string" }, "etag": { "type": "string" }, "status": { "enum": [ "error", "ok" ], "type": "string" } }, "type": "object" }, "uuid": { "type": "string" } }, "type": "object" } } }, "security": [ { "oauth2": [] } ], "summary": "Get ad server info", "tags": [ "Ad Servers" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "findParticularAdServer", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true } }, "parameters": [ { "name": "ad_server_id", "in": "path", "type": "string", "required": true } ] }, "/advertisers": { "get": { "operationId": "find-advertisers", "parameters": [ { "in": "header", "name": "Connect-Time", "type": "integer" }, { "in": "header", "name": "Total-Route-Time", "type": "integer" }, { "in": "header", "name": "Via", "type": "string" }, { "in": "header", "name": "Authorization", "type": "string" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" }, { "in": "query", "name": "sort_by", "type": "string" } ], "produces": [ "text/xml" ], "responses": { "200": { "description": "frequency_amount and external_id may appear but often don't\n\nVertical IDs are listed at https://api.mediamath.com/api/v2.0/verticals?sort_by=id and on 12/20/2019 are:\n1 'Air Travel'\n2 'Autos'\n3 'Business Services'\n4 'Electronics'\n5 'Clothing & Accessories'\n6 'Computer (Hardware & Software)'\n7 'Credit Cards'\n8 'Dating'\n9 'Employment'\n10 'Pharmaceuticals (Rx & OTC)'\n11 'Education'\n12 'Entertainment'\n13 'Food & Beverages'\n14 'Pets'\n15 'Toys'\n16 'Home & Garden'\n17 'Insurance'\n18 'Internet Services'\n19 'Personal Care'\n20 'Personal Finance'\n21 'Real Estate'\n22 'Sporting Goods'\n23 'Telecommunications'\n24 'Hotels'\n25 'Media'\n26 'Non-Profit'\n27 'Gambling'\n28 'Consumer Goods'\n29 'Government'\n30 'Alcohol'\n31 'Adult'\n32 'Tobacco'\n33 'Religion and Spirituality'\n34 'Weight Loss'", "examples": { "application/json": { "data": [ { "accountable_and_addressable": false, "ad_server_id": 8, "agency_id": 114303, "allow_x_strat_optimization": false, "created_on": "2019-09-10T12:25:01+0000", "data_sharing_enabled": false, "dmp_enabled": "disabled", "domain": "http://www.mediamath.com", "effective_ads_txt_verified": "ANY", "entity_type": "advertiser", "frequency_amount": 1, "frequency_interval": "not-applicable", "frequency_type": "no-limit", "id": 230057, "minimize_multi_ads": false, "name": "test", "status": true, "updated_on": "2019-09-10T12:25:01+0000", "version": 0, "vertical_id": 30 }, { "accountable_and_addressable": false, "ad_server_id": 8, "agency_id": 116868, "allow_x_strat_optimization": false, "created_on": "2019-09-04T10:53:33+0000", "data_sharing_enabled": true, "dmp_enabled": "inherits", "domain": "http://www.mediamath.com", "effective_ads_txt_verified": "ANY", "entity_type": "advertiser", "frequency_amount": 1, "frequency_interval": "day", "frequency_type": "asap", "id": 229788, "minimize_multi_ads": true, "name": "lalala", "status": true, "updated_on": "2019-09-04T10:53:33+0000", "version": 0, "vertical_id": 30 }, { "accountable_and_addressable": false, "ad_server_id": 9, "agency_id": 101619, "allow_x_strat_optimization": false, "created_on": "2019-09-10T02:41:34+0000", "data_sharing_enabled": true, "dmp_enabled": "inherits", "domain": "https://www.bbva.mx/", "effective_ads_txt_verified": "ANY", "entity_type": "advertiser", "frequency_interval": "not-applicable", "frequency_type": "no-limit", "id": 230037, "minimize_multi_ads": false, "name": "BBVA_APRENTIA", "status": true, "updated_on": "2019-09-10T02:41:34+0000", "version": 0, "vertical_id": 20 } ], "meta": { "called_on": "2019-09-10T15:07:37+0000", "count": 3, "etag": "6048115b3a9547c76b33f87a1de7f4d25af7a891", "next_page": "https://api.mediamath.com/api/v2.0/advertisers?full=*&page_limit=3&page_offset=3", "offset": 0, "status": "ok", "total_count": 928 }, "uuid": "BA1304B0-D3DC-11E9-9789-815127D76BB8" } }, "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "accountable_and_addressable": { "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "ad_server_fee": { "description": "Fee associated with third-party adserver - refer to the \"Ad Servers\" page", "type": "number" }, "ad_server_id": { "description": "Enter ID for third-party adserver - refer to the \"Ad Servers\" page", "type": "integer" }, "agency_id": { "default": "T1 Agency ID to which an advertiser belongs (see \"API for Agencies\")", "type": "integer" }, "allow_x_strat_optimization": { "description": "This option is only available if Cross-Advertiser Pacing has been enabled for the Agency. Cross-Advertiser pacing allows winning bids to be decided based on price AND pacing level. If 2 bids from participating Advertisers are competitive and the lower bid is from an under-pacing campaign, then the lower bid may win. If this field is set to No, this Advertiser will compete solely on bid price.", "type": "boolean" }, "billing_contact_id": { "type": "integer" }, "created_on": { "format": "date-time", "type": "string" }, "data_sharing_enabled": { "type": "boolean" }, "dmp_enabled": { "enum": [ "disabled", "enabled", "inherits" ], "type": "string" }, "domain": { "description": "The URL domain of the advertiser—for example, http://www.advertiser.com", "maxLength": 255, "type": "string" }, "effective_ads_txt_verified": { "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ], "type": "string", "description": "* ANY: can bid on all inventory where seller is listed in publishers ads.txt OR where publisher does not have ads.txt OR we have not checked publishers ads.txt\n* AUTHORIZED_ONLY: can only bid on inventory where seller is listed in publishers ads.txt\n* AUTHORIZED_DIRECT_ONLY: can only bid on inventory where seller is listed in publishers ads.txt as a DIRECT seller" }, "entity_type": { "enum": [ "advertiser" ], "type": "string" }, "external_id": { "description": "External ID name of the advertiser", "type": "string" }, "frequency_amount": { "type": "integer", "description": "Maximum frequency of impressions per user within interval set on frequency_interval\n\nrequired if frequency_type is even or asap." }, "frequency_interval": { "description": "Interval applicable for frequency_amount.\n\nRequired if `frequency_typeis even or asap`.", "enum": [ "campaign", "day", "hour", "month", "not-applicable", "week" ], "type": "string" }, "frequency_type": { "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "id": { "type": "integer" }, "inherited_ads_txt_verified": { "description": "Inherited ads ads_txt targeting values", "enum": [ "ANY", "AUTHORIZED_ONLY", "AUTHORIZED_DIRECT_ONLY" ], "type": "string" }, "inherited_ads_txt_verified_origin_entity_type": { "description": "Inherited ads ads_txt targeting level", "enum": [ "agency" ], "type": "string" }, "minimize_multi_ads": { "description": "Minimize occurrences of multiple ads appearing on the same page", "type": "boolean" }, "name": { "description": "Name for the Advertiser. 64 characters maximum allowed.", "maxLength": 64, "type": "string" }, "political": { "description": "Per compliance, is advertiser considered political?", "default": "false", "type": "boolean" }, "sales_contact_id": { "type": "integer" }, "status": { "description": "Status of advertiser (defaults to off if unspecified)", "type": "boolean" }, "updated_on": { "type": "string" }, "version": { "type": "integer" }, "vertical_id": { "description": "\nVertical IDs are listed at https://api.mediamath.com/api/v2.0/verticals?sort_by=id and on 12/20/2019 are:\n\n1 'Air Travel'\n2 'Autos'\n3 'Business Services'\n4 'Electronics'\n5 'Clothing & Accessories'\n6 'Computer (Hardware & Software)'\n7 'Credit Cards'\n8 'Dating'\n9 'Employment'\n10 'Pharmaceuticals (Rx & OTC)'\n11 'Education'\n12 'Entertainment'\n13 'Food & Beverages'\n14 'Pets'\n15 'Toys'\n16 'Home & Garden'\n17 'Insurance'\n18 'Internet Services'\n19 'Personal Care'\n20 'Personal Finance'\n21 'Real Estate'\n22 'Sporting Goods'\n23 'Telecommunications'\n24 'Hotels'\n25 'Media'\n26 'Non-Profit'\n27 'Gambling'\n28 'Consumer Goods'\n29 'Government'\n30 'Alcohol'\n31 'Adult'\n32 'Tobacco'\n33 'Religion and Spirituality'\n34 'Weight Loss'", "type": "integer" } }, "required": [ "entity_type", "id", "name" ] } }, "meta": { "type": "object", "properties": { "called_on": { "format": "date-time", "type": "string" }, "count": { "type": "integer" }, "etag": { "pattern": "^[0-9a-f]+", "type": "string" }, "next_page": { "format": "uri", "type": "string" }, "offset": { "type": "integer" }, "status": { "enum": [ "ok" ], "type": "string" }, "total_count": { "type": "integer" } } }, "uuid": { "type": "string" } } } } }, "security": [ { "oauth2": [] } ], "summary": "List advertisers", "tags": [ "Advertisers" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "find-advertisers", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Get list of advertisers\n\nQuery section:\n\"with\" accepts the following: agency, ad_server, vertical\n\n\"sort_by\" can use any parameter in the root of the data section\n\nWhen \"full=* \" is not included, only entity_type, id, and name appear in the data section" }, "post": { "consumes": [ "application/x-www-form-urlencoded" ], "description": "Create a new advertiser entity reserved for T1 admins\n\n\nVertical IDs:\n1 'Air Travel'\n2 'Autos'\n3 'Business Services'\n4 'Electronics'\n5 'Clothing & Accessories'\n6 'Computer (Hardware & Software)'\n7 'Credit Cards'\n8 'Dating'\n9 'Employment'\n10 'Pharmaceuticals (Rx & OTC)'\n11 'Education'\n12 'Entertainment'\n13 'Food & Beverages'\n14 'Pets'\n15 'Toys'\n16 'Home & Garden'\n17 'Insurance'\n18 'Internet Services'\n19 'Personal Care'\n20 'Personal Finance'\n21 'Real Estate'\n22 'Sporting Goods'\n23 'Telecommunications'\n24 'Hotels'\n25 'Media'\n26 'Non-Profit'\n27 'Gambling'\n28 'Consumer Goods'\n29 'Government'\n30 'Alcohol'\n31 'Adult'\n32 'Tobacco'\n33 'Religion and Spirituality'\n34 'Weight Loss'", "operationId": "createAdvertiser", "parameters": [ { "in": "formData", "name": "minimize_multi_ads", "type": "boolean" }, { "enum": [ "asap", "even", "no-limit" ], "in": "formData", "name": "frequency_type", "type": "string" }, { "enum": [ "hour", "day", "week", "month", "not-applicable" ], "in": "formData", "name": "frequency_interval", "type": "string" }, { "in": "formData", "name": "status", "type": "boolean" }, { "in": "formData", "name": "dmp_enabled", "type": "string" }, { "in": "formData", "name": "agency_id", "required": true, "type": "integer" }, { "in": "formData", "name": "allow_x_strat_optimization", "type": "boolean" }, { "in": "formData", "name": "domain", "required": true, "type": "string" }, { "in": "formData", "name": "ad_server_id", "required": true, "type": "integer" }, { "in": "formData", "name": "updated_on", "type": "string" }, { "in": "formData", "name": "vertical_id", "required": true, "type": "integer" }, { "in": "formData", "name": "created_on", "type": "string" }, { "in": "formData", "name": "name", "required": true, "type": "string" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" }, { "in": "formData", "name": "external_id", "type": "string", "maxLength": 255 }, { "in": "formData", "name": "accountable_and_addressable", "type": "boolean", "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature." }, { "in": "formData", "name": "data_sharing_enabled", "type": "boolean" }, { "in": "formData", "name": "effective_ads_txt_verified", "type": "string" }, { "in": "formData", "name": "frequency_amount", "type": "integer" }, { "in": "formData", "name": "version", "type": "integer" } ], "responses": { "201": { "description": "the newly created Organization\n\n", "schema": { "properties": { "data": { "example": { "accountable_and_addressable": false, "ad_server_id": 9, "agency_id": 122077, "allow_x_strat_optimization": false, "created_on": "2019-05-23T18:10:41+0000", "data_sharing_enabled": false, "dmp_enabled": "inherits", "domain": "https://www.roygbivintl.com/", "entity_type": "advertiser", "external_id": "Account #45612", "frequency_interval": "not-applicable", "frequency_type": "no-limit", "id": 225595, "minimize_multi_ads": false, "name": "Roy G Biv Intl.", "status": true, "updated_on": "2019-05-23T18:10:41+0000", "version": 0, "vertical_id": 5 }, "title": "Advertiser", "type": "object", "x-stoplight": { "id": "advertiser", "name": "Advertiser", "public": true }, "properties": { "accountable_and_addressable": { "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "ad_server_fee": { "description": "Fee charged by ad serving vendor", "type": "integer" }, "ad_server_id": { "description": "Enter ID for third-party adserver - refer to the \"Ad Servers\" page", "type": "integer" }, "agency_id": { "description": "T1 Agency ID to which an advertiser belongs (see \"API for Agencies\")", "type": "integer" }, "allow_x_strat_optimization": { "description": " \t\n\nThis option is only available if Cross-Advertiser Pacing has been enabled for the Agency. Cross-Advertiser pacing allows winning bids to be decided based on price AND pacing level. If two bids from participating Advertisers are competitive and the lower bid is from an under-pacing campaign, then the lower bid may win. If this field is set to No, this Advertiser will compete solely on bid price.", "type": "boolean" }, "billing_contact_id": { "description": "T1 id for person serving as billing contact. If desired, get list of valid names and IDs by making GET \"$API_BASE/contacts\" call.", "type": "integer" }, "created_on": { "type": "string" }, "dmp_enabled": { "type": "string" }, "domain": { "description": "The URL domain of the advertiser—for example, http://www.advertiser.com", "type": "string" }, "external_id": { "type": "string", "description": "External ID name of the advertiser", "maxLength": 255 }, "frequency_amount": { "description": "Maximum frequency of impressions per user within interval set on frequency_interval\n\nrequired if `frequency_typeis even or asap`.", "type": "integer" }, "frequency_interval": { "type": "string", "description": "Interval applicable for frequency_amount.\n\nRequired if `frequency_typeis even or asap`.", "enum": [ "hour", "day", "week", "month", "not-applicable", "campaign" ] }, "frequency_type": { "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "minimize_multi_ads": { "description": "Minimize occurrences of multiple ads appearing on the same page", "type": "boolean" }, "name": { "description": "Name for the Advertiser. 64 characters maximum allowed.", "type": "string" }, "status": { "description": "Status of advertiser (defaults to off if unspecified)", "type": "boolean" }, "updated_on": { "type": "string" }, "vertical_id": { "description": "\nVertical IDs are listed at https://api.mediamath.com/api/v2.0/verticals?sort_by=id and on 12/20/2019 are:\n\n1 'Air Travel'\n2 'Autos'\n3 'Business Services'\n4 'Electronics'\n5 'Clothing & Accessories'\n6 'Computer (Hardware & Software)'\n7 'Credit Cards'\n8 'Dating'\n9 'Employment'\n10 'Pharmaceuticals (Rx & OTC)'\n11 'Education'\n12 'Entertainment'\n13 'Food & Beverages'\n14 'Pets'\n15 'Toys'\n16 'Home & Garden'\n17 'Insurance'\n18 'Internet Services'\n19 'Personal Care'\n20 'Personal Finance'\n21 'Real Estate'\n22 'Sporting Goods'\n23 'Telecommunications'\n24 'Hotels'\n25 'Media'\n26 'Non-Profit'\n27 'Gambling'\n28 'Consumer Goods'\n29 'Government'\n30 'Alcohol'\n31 'Adult'\n32 'Tobacco'\n33 'Religion and Spirituality'\n34 'Weight Loss'", "type": "integer" }, "ad_server_password": { "type": "string" }, "ad_server_username": { "type": "string" }, "ads_txt_verified": { "type": "string", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ] }, "data_sharing_enabled": { "type": "boolean" }, "id": { "type": "integer" }, "political": { "type": "boolean" }, "sales_contact_id": { "type": "integer" }, "version": { "type": "integer" } }, "required": [ "ad_server_id", "agency_id", "domain", "name", "vertical_id" ] }, "uuid": { "type": "string" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } }, "type": "object" } }, "default": { "description": "Error" } }, "security": [ { "oauth2": [] } ], "summary": "Create a new advertiser", "tags": [ "Advertisers" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "createAdvertiser", "mock": { "enabled": false, "statusCode": 200 }, "public": true } } }, "/advertisers/{advertiser_id}": { "get": { "description": "Returns an advertiser's details\n\n\n\"with\" accepts the following: agency, ad_server, vertical\n\nVertical IDs:\n1 'Air Travel'\n2 'Autos'\n3 'Business Services'\n4 'Electronics'\n5 'Clothing & Accessories'\n6 'Computer (Hardware & Software)'\n7 'Credit Cards'\n8 'Dating'\n9 'Employment'\n10 'Pharmaceuticals (Rx & OTC)'\n11 'Education'\n12 'Entertainment'\n13 'Food & Beverages'\n14 'Pets'\n15 'Toys'\n16 'Home & Garden'\n17 'Insurance'\n18 'Internet Services'\n19 'Personal Care'\n20 'Personal Finance'\n21 'Real Estate'\n22 'Sporting Goods'\n23 'Telecommunications'\n24 'Hotels'\n25 'Media'\n26 'Non-Profit'\n27 'Gambling'\n28 'Consumer Goods'\n29 'Government'\n30 'Alcohol'\n31 'Adult'\n32 'Tobacco'\n33 'Religion and Spirituality'\n34 'Weight Loss'", "operationId": "findParticularAdvertiser", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "responses": { "200": { "description": "Get an advertiser's details\n\nfrequency_amount and external_id may appear but often don't", "examples": { "application/vnd.mediamath.v1+json": { "data": { "ad_server_id": 9, "ads_txt_verified": "ANY", "agency_id": 122077, "allow_x_strat_optimization": false, "created_on": "2019-05-23T18:10:41+0000", "data_sharing_enabled": false, "dmp_enabled": "inherits", "domain": "https://www.roygbivintl.com/", "entity_type": "advertiser", "external_id": "Account #45612", "frequency_interval": "not-applicable", "frequency_type": "no-limit", "id": 225595, "minimize_multi_ads": false, "name": "Roy G Biv Intl.", "status": true, "updated_on": "2019-05-23T18:10:41+0000", "version": 0, "vertical_id": 5 }, "meta": { "called_on": "2019-05-24T17:03:42+0000", "etag": "0909ae0d4977a28bfafecc326df1184c532affd0", "status": "ok" }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B" } }, "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "accountable_and_addressable": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "ad_server_fee": { "description": "Fee associated with third-party adserver - refer to the \"Ad Servers\" page", "type": "number" }, "ad_server_id": { "type": "integer", "description": "ID for third-party adserver - refer to the \"Ad Servers\" page" }, "ads_txt_verified": { "type": "string", "description": "", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ] }, "agency_id": { "type": "integer", "description": "T1 Agency ID to which an advertiser belongs (see \"API for Agencies\")" }, "allow_x_strat_optimization": { "type": "boolean", "description": "This option is only available if Cross-Advertiser Pacing has been enabled for the Agency. Cross-Advertiser pacing allows winning bids to be decided based on price AND pacing level. If two bids from participating Advertisers are competitive and the lower bid is from an under-pacing campaign, then the lower bid may win. If this field is set to No, this Advertiser will compete solely on bid price." }, "billing_contact_id": { "type": "integer" }, "created_on": { "type": "string" }, "data_sharing_enabled": { "type": "boolean" }, "dmp_enabled": { "enum": [ "disabled", "enabled", "inherits" ], "type": "string" }, "domain": { "format": "uri", "type": "string", "description": "The URL domain of the advertiser—for example, http://www.advertiser.com" }, "effective_ads_txt_verified": { "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ], "type": "string", "description": "* ANY: can bid on all inventory where seller is listed in publishers ads.txt OR where publisher does not have ads.txt OR we have not checked publishers ads.txt\n* AUTHORIZED_ONLY: can only bid on inventory where seller is listed in publishers ads.txt\n* AUTHORIZED_DIRECT_ONLY: can only bid on inventory where seller is listed in publishers ads.txt as a DIRECT seller" }, "entity_type": { "enum": [ "advertiser" ], "type": "string" }, "external_id": { "maxLength": 255, "type": "string", "description": "External ID name of the advertiser" }, "frequency_amount": { "type": "integer", "description": "Maximum frequency of impressions per user within interval set on frequency_interval\n\nrequired if frequency_type is even or asap." }, "frequency_interval": { "enum": [ "day", "hour", "month", "no_limit", "not-applicable", "week" ], "type": "string", "description": "Interval applicable for frequency_amount.\n\nRequired if `frequency_typeis even or asap`." }, "frequency_type": { "enum": [ "asap", "even", "no-limit" ], "type": "string", "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap" }, "id": { "type": "integer" }, "inherited_ads_txt_verified": { "description": "Inherited ads ads_txt targeting values", "enum": [ "ANY", "AUTHORIZED_ONLY", "AUTHORIZED_DIRECT_ONLY" ], "type": "string" }, "inherited_ads_txt_verified_origin_entity_type": { "description": "Inherited ads ads_txt targeting level", "enum": [ "agency" ], "type": "string" }, "minimize_multi_ads": { "type": "boolean", "description": "Minimize occurrences of multiple ads appearing on the same page" }, "name": { "type": "string", "description": "Name for the Advertiser. 64 characters maximum allowed." }, "political": { "description": "Per compliance, is advertiser considered political?", "default": "false", "type": "boolean" }, "sales_contact_id": { "type": "integer" }, "status": { "type": "boolean", "description": "Status of advertiser (defaults to off if unspecified)" }, "updated_on": { "format": "date-time", "type": "string" }, "version": { "type": "integer" }, "vertical_id": { "type": "integer", "description": "\nVertical IDs are listed at https://api.mediamath.com/api/v2.0/verticals?sort_by=id and on 12/20/2019 are:\n\n1 'Air Travel'\n2 'Autos'\n3 'Business Services'\n4 'Electronics'\n5 'Clothing & Accessories'\n6 'Computer (Hardware & Software)'\n7 'Credit Cards'\n8 'Dating'\n9 'Employment'\n10 'Pharmaceuticals (Rx & OTC)'\n11 'Education'\n12 'Entertainment'\n13 'Food & Beverages'\n14 'Pets'\n15 'Toys'\n16 'Home & Garden'\n17 'Insurance'\n18 'Internet Services'\n19 'Personal Care'\n20 'Personal Finance'\n21 'Real Estate'\n22 'Sporting Goods'\n23 'Telecommunications'\n24 'Hotels'\n25 'Media'\n26 'Non-Profit'\n27 'Gambling'\n28 'Consumer Goods'\n29 'Government'\n30 'Alcohol'\n31 'Adult'\n32 'Tobacco'\n33 'Religion and Spirituality'\n34 'Weight Loss'" } } }, "meta": { "type": "object", "properties": { "called_on": { "format": "date-time", "type": "string" }, "etag": { "type": "string" }, "status": { "enum": [ "error", "ok" ], "type": "string" } } }, "uuid": { "type": "string" } } } } }, "security": [ { "oauth2": [] } ], "summary": "Get an advertiser's details", "tags": [ "Advertisers" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "findParticularAdvertiser", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true } }, "parameters": [ { "name": "advertiser_id", "in": "path", "type": "string", "required": true } ], "post": { "consumes": [ "application/x-www-form-urlencoded" ], "description": "Update an advertiser entity reserved for T1 admins\n\n\nVertical IDs:\n1 'Air Travel'\n2 'Autos'\n3 'Business Services'\n4 'Electronics'\n5 'Clothing & Accessories'\n6 'Computer (Hardware & Software)'\n7 'Credit Cards'\n8 'Dating'\n9 'Employment'\n10 'Pharmaceuticals (Rx & OTC)'\n11 'Education'\n12 'Entertainment'\n13 'Food & Beverages'\n14 'Pets'\n15 'Toys'\n16 'Home & Garden'\n17 'Insurance'\n18 'Internet Services'\n19 'Personal Care'\n20 'Personal Finance'\n21 'Real Estate'\n22 'Sporting Goods'\n23 'Telecommunications'\n24 'Hotels'\n25 'Media'\n26 'Non-Profit'\n27 'Gambling'\n28 'Consumer Goods'\n29 'Government'\n30 'Alcohol'\n31 'Adult'\n32 'Tobacco'\n33 'Religion and Spirituality'\n34 'Weight Loss'", "operationId": "updateAdvertiser", "parameters": [ { "in": "formData", "name": "minimize_multi_ads", "type": "boolean" }, { "enum": [ "asap", "even", "no-limit" ], "in": "formData", "name": "frequency_type", "type": "string" }, { "enum": [ "hour", "day", "week", "month", "not-applicable" ], "in": "formData", "name": "frequency_interval", "type": "string" }, { "in": "formData", "name": "status", "type": "boolean" }, { "in": "formData", "name": "dmp_enabled", "type": "string" }, { "in": "formData", "name": "agency_id", "required": true, "type": "integer" }, { "in": "formData", "name": "allow_x_strat_optimization", "type": "boolean" }, { "in": "formData", "name": "domain", "required": true, "type": "string" }, { "in": "formData", "name": "ad_server_id", "required": true, "type": "integer" }, { "in": "formData", "name": "updated_on", "type": "string" }, { "in": "formData", "name": "vertical_id", "required": true, "type": "integer" }, { "in": "formData", "name": "created_on", "type": "string" }, { "in": "formData", "name": "version", "type": "integer" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "responses": { "200": { "description": "Update an existing advertiser", "schema": { "properties": { "data": { "example": { "accountable_and_addressable": false, "ad_server_id": 9, "agency_id": 122077, "allow_x_strat_optimization": false, "created_on": "2019-05-23T18:10:41+0000", "data_sharing_enabled": false, "dmp_enabled": "inherits", "domain": "https://www.roygbivintl.com/", "entity_type": "advertiser", "external_id": "Account #45612", "frequency_interval": "not-applicable", "frequency_type": "no-limit", "id": 225595, "minimize_multi_ads": false, "name": "Roy G Biv Intl.", "status": true, "updated_on": "2019-05-23T18:10:41+0000", "version": 0, "vertical_id": 5 }, "title": "Advertiser", "type": "object", "x-stoplight": { "id": "advertiser", "name": "Advertiser", "public": true }, "properties": { "accountable_and_addressable": { "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "ad_server_fee": { "description": "Fee charged by ad serving vendor", "type": "integer" }, "ad_server_id": { "description": "Enter ID for third-party adserver - refer to the \"Ad Servers\" page", "type": "integer" }, "agency_id": { "description": "T1 Agency ID to which an advertiser belongs (see \"API for Agencies\")", "type": "integer" }, "allow_x_strat_optimization": { "description": " \t\n\nThis option is only available if Cross-Advertiser Pacing has been enabled for the Agency. Cross-Advertiser pacing allows winning bids to be decided based on price AND pacing level. If two bids from participating Advertisers are competitive and the lower bid is from an under-pacing campaign, then the lower bid may win. If this field is set to No, this Advertiser will compete solely on bid price.", "type": "boolean" }, "billing_contact_id": { "description": "T1 id for person serving as billing contact. If desired, get list of valid names and IDs by making GET \"$API_BASE/contacts\" call.", "type": "integer" }, "created_on": { "type": "string" }, "dmp_enabled": { "type": "string" }, "domain": { "description": "The URL domain of the advertiser—for example, http://www.advertiser.com", "type": "string" }, "external_id": { "type": "string", "description": "External ID name of the advertiser", "maxLength": 255 }, "frequency_amount": { "description": "Maximum frequency of impressions per user within interval set on frequency_interval\n\nrequired if `frequency_typeis even or asap`.", "type": "integer" }, "frequency_interval": { "type": "string", "description": "Interval applicable for frequency_amount.\n\nRequired if `frequency_typeis even or asap`.", "enum": [ "hour", "day", "week", "month", "not-applicable", "campaign" ] }, "frequency_type": { "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "minimize_multi_ads": { "description": "Minimize occurrences of multiple ads appearing on the same page", "type": "boolean" }, "name": { "description": "Name for the Advertiser. 64 characters maximum allowed.", "type": "string" }, "status": { "description": "Status of advertiser (defaults to off if unspecified)", "type": "boolean" }, "updated_on": { "type": "string" }, "vertical_id": { "description": "\nVertical IDs are listed at https://api.mediamath.com/api/v2.0/verticals?sort_by=id and on 12/20/2019 are:\n\n1 'Air Travel'\n2 'Autos'\n3 'Business Services'\n4 'Electronics'\n5 'Clothing & Accessories'\n6 'Computer (Hardware & Software)'\n7 'Credit Cards'\n8 'Dating'\n9 'Employment'\n10 'Pharmaceuticals (Rx & OTC)'\n11 'Education'\n12 'Entertainment'\n13 'Food & Beverages'\n14 'Pets'\n15 'Toys'\n16 'Home & Garden'\n17 'Insurance'\n18 'Internet Services'\n19 'Personal Care'\n20 'Personal Finance'\n21 'Real Estate'\n22 'Sporting Goods'\n23 'Telecommunications'\n24 'Hotels'\n25 'Media'\n26 'Non-Profit'\n27 'Gambling'\n28 'Consumer Goods'\n29 'Government'\n30 'Alcohol'\n31 'Adult'\n32 'Tobacco'\n33 'Religion and Spirituality'\n34 'Weight Loss'", "type": "integer" }, "ad_server_password": { "type": "string" }, "ad_server_username": { "type": "string" }, "ads_txt_verified": { "type": "string", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ] }, "data_sharing_enabled": { "type": "boolean" }, "id": { "type": "integer" }, "political": { "type": "boolean" }, "sales_contact_id": { "type": "integer" }, "version": { "type": "integer" } }, "required": [ "ad_server_id", "agency_id", "domain", "name", "vertical_id" ] }, "uuid": { "type": "string" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } }, "type": "object" } }, "default": { "description": "Error" } }, "security": [ { "oauth2": [] } ], "summary": "Update an existing advertiser", "tags": [ "Advertisers" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "updateAdvertiser", "mock": { "enabled": false, "statusCode": 200 }, "public": true } } }, "/agencies": { "get": { "operationId": "FindAgencies", "parameters": [ { "in": "header", "name": "Authorization", "type": "string" }, { "in": "header", "name": "Connect-Time", "type": "integer" }, { "in": "header", "name": "Via", "type": "string" }, { "in": "header", "name": "Total-Route-Time", "type": "integer" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" }, { "in": "query", "name": "sort_by", "type": "string" } ], "produces": [ "text/xml" ], "responses": { "200": { "description": "", "examples": { "application/json": { "data": [ { "allow_x_adv_optimization": false, "allow_x_adv_pixels": false, "created_on": "2019-09-04T16:33:18+0000", "dmp_enabled": "inherits", "eligible_for_data_sharing": false, "entity_type": "agency", "id": 122818, "name": "4chr_pytest_agency", "organization_id": 100048, "status": false, "updated_on": "2019-09-04T16:33:18+0000", "version": 0 }, { "allow_x_adv_optimization": false, "allow_x_adv_pixels": false, "created_on": "2019-09-04T16:33:19+0000", "dmp_enabled": "inherits", "eligible_for_data_sharing": false, "entity_type": "agency", "id": 122819, "name": "reg_prod_agency_name", "organization_id": 100048, "status": false, "updated_on": "2019-09-04T16:33:19+0000", "version": 0 }, { "allow_x_adv_optimization": false, "allow_x_adv_pixels": false, "created_on": "2019-09-04T16:33:19+0000", "dmp_enabled": "inherits", "eligible_for_data_sharing": false, "entity_type": "agency", "id": 122820, "name": "reg_prod_agency_name", "organization_id": 100048, "status": false, "updated_on": "2019-09-04T16:33:19+0000", "version": 0 } ], "meta": { "called_on": "2019-09-10T14:18:06+0000", "count": 3, "etag": "df83a3438725876b5cee4ed07195670888837b25", "next_page": "https://api.mediamath.com/api/v2.0/agencies?full=*&page_limit=3&page_offset=3", "offset": 0, "status": "ok", "total_count": 660 }, "uuid": "CEE8A50E-D3D5-11E9-9F60-4E6126F3F03C" } }, "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "ads_txt_verified": { "default": "AUTHORIZED_ONLY", "description": "* ANY: can bid on all inventory where seller is listed in publishers ads.txt OR where publisher does not have ads.txt OR we have not checked publishers ads.txt\n* AUTHORIZED_ONLY: can only bid on inventory where seller is listed in publishers ads.txt\n* AUTHORIZED_DIRECT_ONLY: can only bid on inventory where seller is listed in publishers ads.txt as a DIRECT seller", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ], "type": "string" }, "allow_x_adv_optimization": { "description": "This option is only available if Cross-Advertiser Pacing has been enabled for the Agency. Cross-Advertiser pacing allows winning bids to be decided based on price AND pacing level. If two bids from participating Advertisers are competitive and the lower bid is from an under-pacing campaign, then the lower bid may win. If this field is set to No, this Advertiser will compete solely on bid price.\n", "type": "boolean" }, "allow_x_adv_pixels": { "description": "This field enables the Data Co-op functionality across all the Advertisers under this organization. Cross-Advertiser Pixel Targeting allows Advertisers to target other Advertiser Event Pixels within their Agency and any other similarly enabled Agency under the same Organization.\n", "type": "boolean" }, "billing_contact_id": { "type": "integer" }, "created_on": { "format": "date-time", "type": "string" }, "dmp_enabled": { "enum": [ "disabled", "enabled", "inherits" ], "type": "string" }, "eligible_for_data_sharing": { "description": "This field indicates that the agency has legally agreed to share data from existing pixels to improve campaign performance through targeting and optimization products. When enabled, advertisers in this agency may elect to share aggregated and anonymized data. When disabled, the agency has not provided legal access and their advertisers will not be permitted to use products that are powered by this shared data.", "type": "boolean" }, "entity_type": { "enum": [ "agency" ], "type": "string" }, "id": { "type": "integer" }, "logo": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "type": "integer" }, "sales_contact_id": { "type": "integer" }, "status": { "type": "boolean" }, "traffic_contact_id": { "type": "integer" }, "updated_on": { "format": "date-time", "type": "string" }, "version": { "type": "integer" } }, "required": [ "entity_type", "id", "name" ] } }, "meta": { "type": "object", "properties": { "called_on": { "format": "date-time", "type": "string" }, "count": { "type": "integer" }, "etag": { "pattern": "^[0-9a-f]+", "type": "string" }, "next_page": { "format": "uri", "type": "string" }, "offset": { "type": "integer" }, "status": { "enum": [ "ok" ], "type": "string" }, "total_count": { "type": "integer" } } }, "uuid": { "format": "uuid", "type": "string" } } } } }, "security": [ { "oauth2": [] } ], "summary": "List agencies in T1", "tags": [ "Agencies" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "FindAgencies", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "List agencies in T1\n\nQuery section:\n\"with\" accepts the following: organization\n\n\"sort_by\" can use any parameter in the root of the data section\n\nWhen \"full=* \" is not included, only entity_type, id, and name appear in the data section" }, "post": { "consumes": [ "application/x-www-form-urlencoded" ], "description": "Create a new agency entity", "operationId": "createAgency", "parameters": [ { "in": "formData", "name": "organization_id", "required": true, "type": "integer" }, { "in": "formData", "name": "status", "type": "boolean" }, { "in": "formData", "name": "allow_x_adv_pixels", "type": "boolean" }, { "in": "formData", "name": "allow_x_adv_optimization", "type": "boolean" }, { "in": "formData", "name": "updated_on", "type": "string" }, { "in": "formData", "name": "created_on", "type": "string" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "responses": { "201": { "description": "the newly created Organization", "schema": { "properties": { "data": { "example": { "allow_x_adv_optimization": false, "allow_x_adv_pixels": false, "created_on": "2016-03-19T16:12:12+0000", "dmp_enabled": "inherits", "entity_type": "agency", "id": 113388, "name": "test_py_postgres", "organization_id": 100048, "status": false, "updated_on": "2016-03-19T16:12:12+0000", "version": 0 }, "title": "Agency", "type": "object", "x-stoplight": { "id": "agency", "name": "Agency", "public": true }, "description": "Agency", "properties": { "ads_txt_verified": { "default": "AUTHORIZED_ONLY", "description": "* ANY: can bid on all inventory where seller is listed in publishers ads.txt OR where publisher does not have ads.txt OR we have not checked publishers ads.txt\n* AUTHORIZED_ONLY: can only bid on inventory where seller is listed in publishers ads.txt\n* AUTHORIZED_DIRECT_ONLY: can only bid on inventory where seller is listed in publishers ads.txt as a DIRECT seller", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ], "type": "string" }, "allow_x_adv_optimization": { "default": false, "description": "This option is only available if Cross-Advertiser Pacing has been enabled for the Agency. Cross-Advertiser pacing allows winning bids to be decided based on price AND pacing level. If two bids from participating Advertisers are competitive and the lower bid is from an under-pacing campaign, then the lower bid may win. If this field is set to No, this Advertiser will compete solely on bid price.\n\n", "type": "boolean" }, "allow_x_adv_pixels": { "default": false, "description": "This field enables the Data Co-op functionality across all the Advertisers under this organization. Cross-Advertiser Pixel Targeting allows Advertisers to target other Advertiser Event Pixels within their Agency and any other similarly enabled Agency under the same Organization.\n\n", "type": "boolean" }, "billing_contact_id": { "type": "integer" }, "created_on": { "type": "string" }, "dmp_enabled": { "type": "string", "enum": [ "disabled", "enabled", "inherits" ] }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "logo": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "type": "integer" }, "sales_contact_id": { "type": "integer" }, "status": { "type": "boolean" }, "traffic_contact_id": { "type": "integer" }, "updated_on": { "type": "string" }, "version": { "type": "integer" }, "eligible_for_data_sharing": { "type": "boolean" } } }, "uuid": { "type": "string" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } }, "type": "object" } }, "default": { "description": "Error" } }, "security": [ { "oauth2": [] } ], "summary": "Create a new agency", "tags": [ "Agencies" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "createAgency", "mock": { "enabled": false, "statusCode": 200 }, "public": true } } }, "/agencies/{agency_id}": { "get": { "operationId": "FindAgency", "parameters": [ { "in": "header", "name": "Authorization", "type": "string" }, { "in": "header", "name": "Connect-Time", "type": "integer" }, { "in": "header", "name": "Via", "type": "string" }, { "in": "header", "name": "Total-Route-Time", "type": "integer" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "produces": [ "text/xml" ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": { "allow_x_adv_optimization": false, "allow_x_adv_pixels": false, "created_on": "2019-05-16T19:04:12+0000", "dmp_enabled": "inherits", "eligible_for_data_sharing": false, "entity_type": "agency", "id": 123462, "name": "reg_prod_agency_name", "organization_id": 123048, "status": false, "updated_on": "2019-05-16T19:04:12+0000", "version": 0 }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "called_on": "2019-05-24T17:47:27+0000", "etag": "1234f51aec6cc6b4dbc72fa65f3b6a1cc71ede48", "status": "ok" } } }, "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "ads_txt_verified": { "default": "AUTHORIZED_ONLY", "description": "* ANY: can bid on all inventory where seller is listed in publishers ads.txt OR where publisher does not have ads.txt OR we have not checked publishers ads.txt\n* AUTHORIZED_ONLY: can only bid on inventory where seller is listed in publishers ads.txt\n* AUTHORIZED_DIRECT_ONLY: can only bid on inventory where seller is listed in publishers ads.txt as a DIRECT seller", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ], "type": "string" }, "allow_x_adv_optimization": { "description": "This option is only available if Cross-Advertiser Pacing has been enabled for the Agency. Cross-Advertiser pacing allows winning bids to be decided based on price AND pacing level. If two bids from participating Advertisers are competitive and the lower bid is from an under-pacing campaign, then the lower bid may win. If this field is set to No, this Advertiser will compete solely on bid price.\n", "type": "boolean" }, "allow_x_adv_pixels": { "description": "This field enables the Data Co-op functionality across all the Advertisers under this organization. Cross-Advertiser Pixel Targeting allows Advertisers to target other Advertiser Event Pixels within their Agency and any other similarly enabled Agency under the same Organization.\n", "type": "boolean" }, "billing_contact_id": { "type": "integer" }, "created_on": { "type": "string" }, "dmp_enabled": { "enum": [ "disabled", "enabled", "inherits" ], "type": "string" }, "eligible_for_data_sharing": { "description": "This field indicates that the agency has legally agreed to share data from existing pixels to improve campaign performance through targeting and optimization products. When enabled, advertisers in this agency may elect to share aggregated and anonymized data. When disabled, the agency has not provided legal access and their advertisers will not be permitted to use products that are powered by this shared data.", "type": "boolean" }, "entity_type": { "enum": [ "agency" ], "type": "string" }, "id": { "type": "integer" }, "logo": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "type": "integer" }, "sales_contact_id": { "type": "integer" }, "status": { "type": "boolean" }, "traffic_contact_id": { "type": "integer" }, "updated_on": { "format": "date-time", "type": "string" }, "version": { "type": "integer" } } }, "meta": { "type": "object", "properties": { "called_on": { "format": "date-time", "type": "string" }, "etag": { "type": "string" }, "status": { "enum": [ "error", "ok" ], "type": "string" } } }, "uuid": { "type": "string" } } } } }, "security": [ { "oauth2": [] } ], "summary": "Get data on an agency in T1", "tags": [ "Agencies" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "FindAgency", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Get information about particular agency in T1\n\n\nQuery section:\n\"with\" accepts the following: organization" }, "parameters": [ { "name": "agency_id", "in": "path", "type": "string", "required": true } ], "post": { "responses": { "200": { "description": "", "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "ads_txt_verified": { "default": "AUTHORIZED_ONLY", "description": "* ANY: can bid on all inventory where seller is listed in publishers ads.txt OR where publisher does not have ads.txt OR we have not checked publishers ads.txt\n* AUTHORIZED_ONLY: can only bid on inventory where seller is listed in publishers ads.txt\n* AUTHORIZED_DIRECT_ONLY: can only bid on inventory where seller is listed in publishers ads.txt as a DIRECT seller", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ], "type": "string" }, "allow_x_adv_optimization": { "description": "This option is only available if Cross-Advertiser Pacing has been enabled for the Agency. Cross-Advertiser pacing allows winning bids to be decided based on price AND pacing level. If two bids from participating Advertisers are competitive and the lower bid is from an under-pacing campaign, then the lower bid may win. If this field is set to No, this Advertiser will compete solely on bid price.", "type": "boolean" }, "allow_x_adv_pixels": { "description": "This field enables the Data Co-op functionality across all the Advertisers under this organization. Cross-Advertiser Pixel Targeting allows Advertisers to target other Advertiser Event Pixels within their Agency and any other similarly enabled Agency under the same Organization.", "type": "boolean" }, "billing_contact_id": { "type": "integer" }, "created_on": { "type": "string" }, "dmp_enabled": { "type": "string" }, "eligible_for_data_sharing": { "description": "This field indicates that the agency has legally agreed to share data from existing pixels to improve campaign performance through targeting and optimization products. When enabled, advertisers in this agency may elect to share aggregated and anonymized data. When disabled, the agency has not provided legal access and their advertisers will not be permitted to use products that are powered by this shared data.", "type": "boolean" }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "logo": { "type": "string" }, "name": { "type": "string" }, "organization_id": { "type": "integer" }, "sales_contact_id": { "type": "integer" }, "status": { "type": "boolean" }, "traffic_contact_id": { "type": "integer" }, "updated_on": { "type": "string" }, "version": { "type": "integer" } } }, "meta": { "type": "object", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } } }, "uuid": { "type": "string" } } }, "examples": { "application/json": {} } } }, "summary": "Update an existing agency", "description": "Update an agency entity reserved for T1 admins", "operationId": "Update-Agency", "tags": [ "Agencies" ], "consumes": [ "application/x-www-form-urlencoded" ], "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "description": "name", "in": "query", "items": { "type": "string" }, "name": "sort_by", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" }, { "in": "formData", "name": "organization_id", "type": "string", "required": true }, { "in": "formData", "name": "status", "type": "string" }, { "in": "formData", "name": "allow_x_adv_optimization", "type": "string" }, { "in": "formData", "name": "allow_x_adv_pixels", "type": "string" }, { "in": "formData", "name": "created_on", "type": "string" }, { "in": "formData", "name": "updated_on", "type": "string" }, { "in": "formData", "name": "version", "type": "string" } ] } }, "/atomic_creatives": { "post": { "consumes": [ "application/x-www-form-urlencoded" ], "operationId": "POST_atomic_creatives", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "produces": [ "text/xml" ], "responses": { "200": { "description": "", "examples": { "text/xml": "{\n \"ad_format\": \"FBX\",\n \"advertiser_id\": 153935,\n \"approval_status\": \"PENDING\",\n \"build_date\": \"2020-02-20T23:29:11+0000\",\n \"built\": false,\n \"built_by_user_id\": 26081,\n \"click_url\": \"\",\n \"concept_id\": 2340635,\n \"created_on\": \"2020-02-20T23:29:11+0000\",\n \"creative_import_file_id\": 130361,\n \"default_t1as_tag\": \"\",\n \"edited_tag\": \"\",\n \"entity_type\": \"atomic_creative\",\n \"expansion_direction\": \"NONRESTRICTED\",\n \"expansion_trigger\": \"MOUSEOVER\",\n \"external_identifier\": \"NOT AVAILABLE\",\n \"file_type\": \"gif\",\n \"has_sound\": false,\n \"height\": 90,\n \"id\": 7184370,\n \"is_https\": true,\n \"is_mraid\": false,\n \"is_multi_creative\": false,\n \"last_modified\": \"2020-02-20T23:29:11+0000​\",\n \"last_payload_modified\": \"2020-02-18T11:01:30+0000\",\n \"media_type\": \"display\",\n \"name\": \"HopeforVisionPSA_728x90\",\n \"rich_media\": false,\n \"sizmek_creative_status\": \"NOT_USED\",\n \"sizmek_tag_status\": \"NOT_USED\",\n \"status\": true,\n \"t1as\": false,\n \"tag\": \"\",\n \"tag_type\": \"IFRAME\",\n \"tpas_ad_tag_name\": \"HopeforVisionPSA_728x90\",\n \"updated_on\": \"2019-09-10T15:21:48+0000\",\n \"vast_version\": 2,\n \"version\": 0,\n \"width\": 0\n }" }, "schema": { "properties": { "data": { "properties": { "ad_format": { "type": "string", "enum": [ "DISPLAY", "MOBILE", "EXPANDABLE", "FBX", "COMPONENT" ], "description": "Advertising format in which creative will appear. " }, "ad_server_type": { "type": "string", "enum": [ "ATLAS", "DART", "EYEWONDER", "MEDIAMIND", "POINTROLL", "YIELD_MANAGER", "TERMINALONE", "MEDIAFORGE", "OTHER", "TERMINALONESZ" ], "description": "The primary Third Party Ad Server involved with serving the creative. To obtain the most up-to-date list of Ad Servers, see \"API for Ad Servers\"." }, "advertiser_id": { "type": "integer", "description": "ID of TerminalOne Advertiser to which the creative belongs. See \"API for Ad Servers\"." }, "approval_status": { "type": "string", "enum": [ "PENDING", "APPROVED", "REJECTED" ] }, "build_date": { "type": "string", "format": "date-time" }, "built": { "type": "boolean" }, "built_by_user_id": { "type": "integer", "description": "Id number for the user who made the creative." }, "click_url": { "type": "string", "maxLength": 10000, "description": "T1 user-declared URL describing where the end user is redirected after clicking an ad, after all redirects." }, "concept_id": { "type": "integer", "description": "ID of TerminalOne Concept ID which the creative belongs; see above." }, "created_on": { "type": "string", "format": "date-time" }, "creative_import_file_id": { "type": "integer", "description": "ID of the file where creative ad tag source came from during the Bulk 3PAS upload." }, "default_t1as_tag": { "type": "string", "description": "The default T1AS ad tag HTML used in order serve the ad. The appropriate T1 Macros necessary must be incorporated." }, "edited_tag": { "type": "string", "description": "" }, "entity_type": { "type": "string", "enum": [ "atomic_creative" ] }, "expansion_direction": { "type": "string", "maxLength": 19, "description": "Determines whether an 'EXPANDABLE' format ad is restricted with respect to its movement on a page and, if so, which directions are permissible.Defaults to: 'NONRESTRICTED'." }, "expansion_trigger": { "type": "string", "enum": [ "AUTOMATIC", "MOUSEOVER", "CLICK" ], "description": "Action which causes an ad to expand. Defaults to: 'MOUSEOVER'" }, "external_identifier": { "type": "string" }, "file_type": { "type": "string", "enum": [ "gif", "html5", "jpeg", "jpg", "swf", "tif", "tiff", "png", "unknown", "vast" ], "description": "Specify the file type" }, "has_sound": { "type": "boolean", "description": "Set to 'on' if the creative uses sound. This will restrict the creative from running on certain publishers, as enforced by each supply source. Defaults to: 'off'" }, "height": { "type": "integer" }, "id": { "type": "integer" }, "is_https": { "type": "boolean" }, "is_mraid": { "type": "boolean" }, "is_multi_creative": { "type": "boolean", "description": "Set to 'on' if the creatives serving through the ad tag vary significantly (e.g different offers or products or drastically different treatments) in order to reduce the weight given to the Creative in algorithmic optimization (when applied). Best practice is to separate creative with significant differences to allow full visibility to the optimization algorithm. Defaults to 'off'." }, "last_modified": { "type": "string", "format": "date-time" }, "last_payload_modified": { "type": "string", "format": "date-time" }, "media_type": { "type": "string", "enum": [ "display", "video", "mobile" ], "description": "Media Type of the creative. " }, "name": { "type": "string" }, "rich_media": { "type": "boolean" }, "sizmek_creative_status": { "type": "string", "enum": [ "PENDING", "UPDATE_IN_PROGRESS", "COMPLETE", "ERROR", "NOT_USED" ] }, "sizmek_tag_status": { "type": "string", "enum": [ "PENDING", "READY", "ERROR", "BAD_IO", "NOT_USED" ] }, "status": { "type": "boolean" }, "t1as": { "type": "boolean", "description": "If 'on', creative is served by MediaMath's TerminalOne Ad Server.If 'off', creative is a 3PAS creative." }, "tag": { "type": "string", "description": "The actual 3PAS ad tag HTML used in order serve the ad. The appropriate T1 Macros necessary must be incorporated." }, "tag_type": { "type": "string", "enum": [ "SCRIPT", "IFRAME", "NOSCRIPT" ], "description": "Specify the implementation tag type into this field" }, "tpas_ad_tag_name": { "type": "string", "maxLength": 255, "description": "Descriptive name of the placement from the 3PAS." }, "updated_on": { "type": "string", "format": "date-time" }, "vast_version": { "type": "integer" }, "version": { "type": "integer", "description": "Used to protect against simultaneous updates. Refer to \"Optimistc Locking\" in the API overview for more information." }, "width": { "type": "integer" } }, "type": "object" }, "meta": { "properties": { "called_on": { "format": "date-time", "type": "string" }, "etag": { "type": "string" }, "status": { "type": "string" } }, "type": "object" }, "uuid": { "type": "string" } }, "type": "object" } }, "401": { "description": "", "examples": { "text/xml": { "errors": [ { "message": "The access token expired" } ], "meta": { "called_on": "2016-11-22T22:23:23+0000", "status": "auth_error" } } }, "schema": { "properties": { "errors": { "items": { "properties": { "message": { "type": "string" } }, "type": "object" }, "type": "array" }, "meta": { "properties": { "called_on": { "type": "string" }, "status": { "type": "string" } }, "type": "object" } }, "type": "object" } } }, "summary": "Upload Single Creative to 3PAS", "tags": [ "Creatives" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "POST_atomiccreatives-", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Upload Single Creative to 3PAS" }, "get": { "responses": { "200": { "description": "", "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "ad_format": { "type": "string", "enum": [ "DISPLAY", "EXPANDABLE", "MOBILE" ], "description": "Advertising format in which creative will appear. " }, "ad_server_type": { "type": "string", "enum": [ "ATLAS", "DART", "EYEWONDER", "MEDIAMIND", "MEDIAPLEX", "POINTROLL", "YIELD_MANAGER", "TERMINALONE", "MEDIAFORGE", "OTHER", "FLASHTALKING", "TERMINALONESZ" ], "description": "The primary Third Party Ad Server involved with serving the creative. To obtain the most up-to-date list of Ad Servers, see \"API for Ad Servers\"." }, "advertiser_id": { "type": "integer", "description": "ID of TerminalOne Advertiser to which the creative belongs. See \"API for Ad Servers\"." }, "approval_status": { "type": "string", "enum": [ "APPROVED", "REJECTED", "PENDING" ] }, "build_date": { "type": "string", "format": "date-time" }, "built": { "type": "boolean" }, "built_by_user_id": { "type": "integer", "description": "Id number for the user who made the creative." }, "click_through_url": { "type": "string", "maxLength": 2048 }, "click_url": { "type": "string", "maxLength": 10000, "description": "T1 user-declared URL describing where the end user is redirected after clicking an ad, after all redirects." }, "concept_id": { "type": "integer", "description": "ID of TerminalOne Concept ID which the creative belongs; see above." }, "created_on": { "type": "string", "format": "date-time" }, "creative_import_file_id": { "type": "integer", "description": "ID of the file where creative ad tag source came from during the Bulk 3PAS upload." }, "default_t1as_tag": { "type": "string", "description": "The default T1AS ad tag HTML used in order serve the ad. The appropriate T1 Macros necessary must be incorporated." }, "edited_tag": { "type": "string", "description": "" }, "end_date": { "type": "string", "format": "date-time" }, "entity_type": { "type": "string", "enum": [ "atomic_creative" ] }, "expansion_direction": { "type": "string", "maxLength": 19, "description": "Determines whether an 'EXPANDABLE' format ad is restricted with respect to its movement on a page and, if so, which directions are permissible.Defaults to: 'NONRESTRICTED'." }, "expansion_trigger": { "type": "string", "enum": [ "AUTOMATIC", "MOUSEOVER", "CLICK" ], "description": "Action which causes an ad to expand. Defaults to: 'MOUSEOVER'" }, "external_identifier": { "type": "string" }, "file_type": { "type": "string", "enum": [ "gif", "html5", "jpeg", "jpg", "swf", "tif", "tiff", "png", "unknown", "vast" ], "description": "Specify the file type" }, "has_sound": { "type": "boolean", "description": "Set to 'on' if the creative uses sound. This will restrict the creative from running on certain publishers, as enforced by each supply source. Defaults to: 'off'" }, "height": { "type": "integer" }, "id": { "type": "integer" }, "is_https": { "type": "boolean" }, "is_mraid": { "type": "boolean" }, "is_multi_creative": { "type": "boolean", "description": "Set to 'on' if the creatives serving through the ad tag vary significantly (e.g different offers or products or drastically different treatments) in order to reduce the weight given to the Creative in algorithmic optimization (when applied). Best practice is to separate creative with significant differences to allow full visibility to the optimization algorithm. Defaults to 'off'." }, "last_modified": { "type": "string", "format": "date-time" }, "last_payload_modified": { "type": "string", "format": "date-time" }, "media_type": { "type": "string", "enum": [ "display", "video", "mobile" ], "description": "Media Type of the creative. " }, "name": { "type": "string" }, "rejected_reason": { "type": "string", "maxLength": 255 }, "rich_media": { "type": "boolean" }, "rich_media_provider": { "type": "string", "maxLength": 64 }, "sizmek_creative_status": { "type": "string", "enum": [ "PENDING", "UPDATE_IN_PROGRESS", "COMPLETE", "ERROR", "NOT_USED" ] }, "sizmek_tag_status": { "type": "string", "enum": [ "PENDING", "READY", "ERROR", "BAD_IO", "NOT_USED" ] }, "start_date": { "type": "string", "format": "date-time" }, "status": { "type": "boolean" }, "t1as": { "type": "boolean", "description": "If 'on', creative is served by MediaMath's TerminalOne Ad Server.If 'off', creative is a 3PAS creative." }, "tag": { "type": "string", "description": "The actual 3PAS ad tag HTML used in order serve the ad. The appropriate T1 Macros necessary must be incorporated." }, "tag_type": { "type": "string", "enum": [ "SCRIPT", "IFRAME", "NOSCRIPT" ], "description": "Specify the implementation tag type into this field" }, "tpas_ad_tag_name": { "type": "string", "maxLength": 255, "description": "Descriptive name of the placement from the 3PAS." }, "updated_on": { "type": "string", "format": "date-time" }, "vast_version": { "type": "integer" }, "version": { "type": "integer", "description": "Used to protect against simultaneous updates. Refer to \"Optimistc Locking\" in the API overview for more information." }, "width": { "type": "integer" } }, "required": [ "entity_type", "id", "name" ] } }, "meta": { "type": "object", "properties": { "called_on": { "type": "string", "format": "date-time" }, "count": { "type": "integer" }, "etag": { "type": "string", "pattern": "^[0-9a-f]+" }, "next_page": { "type": "string", "format": "uri" }, "offset": { "type": "integer" }, "status": { "type": "string", "enum": [ "ok" ] }, "total_count": { "type": "integer" } } }, "uuid": { "type": "string", "format": "uuid" } } }, "examples": { "application/vnd.mediamath.v1+json": { "data": [ { "ad_format": "DISPLAY", "ad_server_type": "DART", "advertiser_id": 128129, "approval_status": "PENDING", "build_date": "2020-02-20T23:29:11+0000", "built": false, "built_by_user_id": 26081, "click_url": "", "concept_id": 2340635, "created_on": "2020-02-20T23:29:11+0000", "creative_import_file_id": 130361, "default_t1as_tag": "", "edited_tag": "", "entity_type": "atomic_creative", "expansion_direction": "NONRESTRICTED", "expansion_trigger": "MOUSEOVER", "external_identifier": "NOT AVAILABLE", "file_type": "gif", "has_sound": false, "height": 90, "id": 7184370, "is_https": true, "is_mraid": false, "is_multi_creative": false, "last_modified": "2020-02-20T23:29:11+0000​", "last_payload_modified": "2020-02-18T11:01:30+0000", "media_type": "display", "name": "HopeforVisionPSA_728x90", "rich_media": false, "sizmek_creative_status": "NOT_USED", "sizmek_tag_status": "NOT_USED", "status": true, "t1as": false, "tag": "", "tag_type": "IFRAME", "tpas_ad_tag_name": "HopeforVisionPSA_728x90", "updated_on": "2019-09-10T15:21:48+0000", "vast_version": 2, "version": 1, "width": 728 }, { "ad_format": "DISPLAY", "ad_server_type": "DART", "advertiser_id": 128129, "approval_status": "PENDING", "built": false, "built_by_user_id": 26081, "click_url": "", "concept_id": 2340636, "created_on": "2019-09-10T15:21:45+0000", "creative_import_file_id": 130361, "entity_type": "atomic_creative", "expansion_direction": "NONRESTRICTED", "expansion_trigger": "MOUSEOVER", "external_identifier": "NOT AVAILABLE", "file_type": "gif", "has_sound": false, "height": 600, "id": 7184371, "is_https": true, "is_mraid": false, "is_multi_creative": false, "last_modified": "2019-09-10T15:21:48+0000", "media_type": "display", "name": "HopeforVisionPSA_160x600", "rich_media": false, "sizmek_creative_status": "NOT_USED", "sizmek_tag_status": "NOT_USED", "status": true, "t1as": false, "tag": "", "tag_type": "IFRAME", "tpas_ad_tag_name": "HopeforVisionPSA_160x600", "updated_on": "2019-09-10T15:21:48+0000", "version": 1, "width": 160 }, { "ad_format": "DISPLAY", "ad_server_type": "DART", "advertiser_id": 128129, "approval_status": "PENDING", "built": false, "built_by_user_id": 26081, "click_url": "", "concept_id": 2340637, "created_on": "2019-09-10T15:21:46+0000", "creative_import_file_id": 130361, "entity_type": "atomic_creative", "expansion_direction": "NONRESTRICTED", "expansion_trigger": "MOUSEOVER", "external_identifier": "NOT AVAILABLE", "file_type": "gif", "has_sound": false, "height": 60, "id": 7184372, "is_https": true, "is_mraid": false, "is_multi_creative": false, "last_modified": "2019-09-10T15:21:48+0000", "media_type": "display", "name": "HopeForVisionPSA_468x60", "rich_media": false, "sizmek_creative_status": "NOT_USED", "sizmek_tag_status": "NOT_USED", "status": true, "t1as": false, "tag": "", "tag_type": "IFRAME", "tpas_ad_tag_name": "HopeForVisionPSA_468x60", "updated_on": "2019-09-10T15:21:48+0000", "version": 1, "width": 468 } ], "meta": { "called_on": "2019-09-10T15:34:48+0000", "count": 3, "etag": "70c813262889021b6a3ea91bc54222b4a4117b5d", "next_page": "https://api.mediamath.com/api/v2.0/atomic_creatives?full=*&page_limit=3&page_offset=3", "offset": 0, "status": "ok", "total_count": 60301 }, "uuid": "85BA51E2-D3E0-11E9-89EA-D3636228C199" } } } }, "summary": "List Single Creatives", "description": "List single creatives\n\nQuery parameters:\nfull=* will provide fields beyond entity_type, id, name (which is why those 3 list as required in the response)\n\nsort_by can use any response field\n\nwith can use advertiser, built_by_user, concept, creative_approvals", "operationId": "List-single-creatives", "tags": [ "Creatives" ], "parameters": [ { "in": "query", "name": "full", "type": "string" }, { "in": "query", "name": "page_limit", "type": "integer" }, { "in": "query", "name": "page_offset", "type": "integer" }, { "in": "query", "name": "q", "type": "string" }, { "in": "query", "name": "sort_by", "type": "string" }, { "in": "query", "name": "with", "type": "string" } ] } }, "/hyperlocal/geopulse/designs/{design_id}": { "get": { "responses": { "200": { "description": "", "schema": { "properties": { "response": { "properties": { "data": { "properties": { "active_builds": { "description": "The number of builds associated with this design that have been deployed to a partner's On-Prem software", "example": 1, "type": "integer" }, "collaborators": { "description": "Users or orgs to grant access to", "items": { "properties": { "id": { "description": "Collaborator's user or org ID (GUID)", "example": "eea9f6ef-c9f3-430a-8db0-d89e8476aebd", "format": "uuid", "type": "string" }, "label": { "description": "Org name or user email", "example": "\"user1@factual.com\"", "type": "string" }, "permission": { "items": { "properties": { "edit": { "description": "Collaborator has design write access", "example": true, "type": "boolean" }, "view": { "description": "Collaborator has design read access", "example": true, "type": "boolean" } }, "type": "object" }, "type": "array" }, "type": { "description": "\"user\" or \"org\"", "enum": [ "org", "user" ], "example": "user", "maxLength": 4, "minLength": 3, "type": "string" } }, "type": "object" }, "type": "array" }, "created_at": { "description": "When the design was created", "example": "2016-01-06T17:11:17.000Z", "format": "date-time", "type": "string" }, "data_sources": { "example": [ "factual_dap" ], "items": { "type": "string" }, "type": "array" }, "design_size": { "description": "(Deprecated) An internal value that estimates how complex this design may be to build on a relative scale. Not intended to be user facing", "example": 12, "type": "integer" }, "id": { "description": "Design ID used in the API call", "example": "38697e15-9e9e-4917-b55b-6431b99392f4", "format": "uuid", "type": "string" }, "is_shared_to_current_org": { "description": "Has the current design been shared with the current user's whole organizaton?", "example": false, "type": "boolean" }, "is_shared_to_current_user": { "description": "Has the current design been shared with the current user?", "example": false, "type": "boolean" }, "most_recent_build": { "description": "Most recent build's ID, as a GUID", "example": "ac5925c7-e727-45b5-848b-c2532dc84db7", "format": "uuid", "type": "string" }, "name": { "description": "Design name", "example": "\"LA Car Dealerships\"", "type": "string" }, "owner_id": { "description": "User ID of the design's owner, as a GUID", "example": "eea9f6ef-c9f3-430a-8db0-d89e8476aebd", "format": "uuid", "type": "string" }, "owner_name": { "description": "Design owner's wmail", "example": "\"user1@factual.com\"", "type": "string" }, "owner_org_id": { "description": "Organzation ID of the design's owner, as a GUID", "example": "d4e49049-07fd-4c67-8325-1c803a8d1857", "format": "uuid", "type": "string" }, "price_cpm": { "description": "Price of the design in CPM. Base represents the price of this design when used to target impressions from most countries. Additional regional variations are coming soon.", "properties": { "base": { "description": "Base represents the price of this design when used to target impressions from most countries. The string is the price (a number) as a string.", "example": "0.75", "type": "string" } }, "type": "object" }, "set_ids": { "description": "All of the seti ID's associated with the design", "format": "uuid", "items": { "type": "string" }, "type": "array" }, "sets": { "items": { "properties": { "set_id": { "description": "ID of the set, as a GUID", "example": "d151ea2c-9879-460c-a169-77a0de9ec3c5", "format": "uuid", "type": "string" }, "set_name": { "description": "Set name", "example": "\"Used Car Dealers\"", "type": "string" }, "sources": { "type": "null" }, "targeting_code": { "description": "Set's targeting code", "example": "\"cars_1000m\"", "type": "string" } }, "type": "object" }, "type": "array" }, "status": { "description": "in_design, requested, rejected, building, failed, or built", "enum": [ "building", "built", "failed", "in_design", "rejected", "requested" ], "example": "in_design", "maxLength": 9, "minLength": 5, "type": "string" }, "type": { "description": "proximity or audience", "example": "\"proximity\"", "type": "string" }, "updated_at": { "description": "When the latest design edit occurred", "example": "2016-01-06T17:11:17.000Z", "format": "date-time", "type": "string" }, "version": { "description": "#, in quotes", "example": "2.1", "type": "string" } }, "type": "object" } }, "type": "object" }, "status": { "enum": [ "error", "ok" ], "type": "string" }, "version": { "type": "number" } }, "type": "object" }, "examples": { "application/vnd.mediamath.v1+json": { "response": { "data": { "active_builds": 1, "collaborators": [ { "id": "93fa7845-de45-45eb-b7a5-0937ca0a0851", "label": "partnerservices+mediamath@factual.com", "permissions": { "edit": true, "view": true }, "type": "user" } ], "created_at": "2019-05-13T16:00:03.565Z", "data_sources": [ "factual_dap" ], "design_size": 0, "id": "6bb29056-f06e-96e0-a23c-2fb973d2d23e", "is_shared_to_current_org": false, "is_shared_to_current_user": false, "most_recent_build": "437dc202-de34-9562-ce42-328368dcae4d", "name": "Brouhaha_Factual", "owner_id": "93fbc340-be34-68a3-574a-7783cbcd3458", "owner_name": "partnerservices+mediamath@factual.com", "owner_org_id": "fecd67a5-389e-9741-98ac-6975dcedbc30", "price_cpm": { "base": "1.50" }, "set_ids": [ "89bf6740-f7dc-bc45-8531-34f9642dc6b5" ], "sets": [ { "set_id": "8957ce40-fb6c-473b-8730-347dc8ed6b5", "set_name": "New Audience Segment", "sources": null, "targeting_code": "Brouhaha_1_Factual" } ], "status": "built", "type": "audience", "updated_at": "2019-05-13T18:58:44.402Z", "version": "2.1" } }, "status": "ok", "version": 4 } } }, "403": { "description": "Often this means that the required field (advertiser_id) is undefined or miskeyed", "schema": { "type": "object", "properties": { "errors": { "type": "array", "items": { "type": "object", "properties": { "message": { "type": "string" } } } }, "meta": { "type": "object", "properties": { "called_on": { "type": "string" }, "status": { "type": "string" } } } } }, "examples": { "application/json": { "errors": [ { "message": "advertiser_id is required" } ], "meta": { "called_on": "2019-05-29T19:02:37+0000", "status": "denied" } } } }, "404": { "description": "There may be a typo in the ID in the pathname", "examples": { "application/json": { "version": 4, "status": "error", "type": "Auth", "message": "Requested resource could not be found. Please check that all elements of your API path are correct." } }, "schema": { "type": "object", "properties": { "version": { "type": "integer" }, "status": { "type": "string" }, "type": { "type": "string" }, "message": { "type": "string" } } } } }, "description": "Returns all details about a specific Proximity or Audience design. This endpoint only accepts GET requests. Replace (design Id) with the id of the design for which you are requesting information.\n\nSample endpoint: /hyperlocal/geopulse/designs/(design Id)\n\nSample usage: /hyperlocal/geopulse/designs/223e8f0e-ab5f-69e0-8a3d-a7ce62945768\n", "summary": "Get Details for a Specific Design", "parameters": [ { "in": "path", "name": "design_id", "type": "string", "required": true, "description": "Design ID, which is a GUID" }, { "in": "query", "name": "advertiser_id", "type": "string", "required": true } ], "operationId": "get_geo_designs_did", "tags": [ "Targeting - Hyperlocal" ] } }, "/atomic_creatives/{atomic_creative_id}": { "get": { "description": "\nQuery parameters:\nfull=* will provide fields beyond entity_type, id, name (which is why those 3 list as required in the response)\n\nsort_by can use any response field\n\nwith can use advertiser, built_by_user, concept, creative_approvals\n\n#### Retrieve Secure/SSL Creative Scan and K-size Results\nThough users should still self-declare the security status of a creative (`atomic_creatives.is_https`), TerminalOne offers automated scanning/validation of the tag. The results of the automated scans are stored in `atomic_creative_ssl_validators` (high level metadata, i.e. is the creative secure, and what is the total k-size loaded) and `atomic_creative_detected_tag_urls` (individual http request URLs detected, broken out by secure and non-secure).\n\nIn cases where there is a conflict (i.e. self declared `atomic_creatives.is_https` was '1', but `atomic_creative_ssl_validators.is_https` = 'NO'), the validator results are honored for creative approvals (AdX, Appnexus, Yahoo Exchange) and bidding.\n\nIn cases where the validator results in an `is_https=UNKNOWN`, `ERROR` or `INACTIVE` result, the self declared atomic_creatives.is_https value are honored for creative approvals and bidding.\n\n", "operationId": "GET_atomic_creatives-id", "parameters": [ { "enum": [ "atomic_creative_ssl_validators", "atomic_creative_detected_tag_urls" ], "in": "query", "name": "with", "type": "string" }, { "in": "header", "name": "Via", "type": "string" }, { "in": "header", "name": "Total-Route-Time", "type": "integer" }, { "in": "header", "name": "Connect-Time", "type": "integer" }, { "in": "header", "name": "Authorization", "type": "string" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "name": "sort_by", "type": "string" } ], "produces": [ "text/xml" ], "responses": { "200": { "description": "", "examples": { "application/json": { "data": { "ad_format": "DISPLAY", "ad_server_type": "OTHER", "advertiser_id": 146641, "approval_status": "PENDING", "build_date": "2020-02-20T23:29:11+0000", "built": false, "built_by_user_id": 26081, "click_url": "", "concept_id": 2340635, "created_on": "2020-02-20T23:29:11+0000", "creative_import_file_id": 130361, "default_t1as_tag": "", "edited_tag": "", "entity_type": "atomic_creative", "expansion_direction": "NONRESTRICTED", "expansion_trigger": "MOUSEOVER", "external_identifier": "NOT AVAILABLE", "file_type": "gif", "has_sound": false, "height": 90, "id": 7184370, "is_https": true, "is_mraid": false, "is_multi_creative": false, "last_modified": "2020-02-20T23:29:11+0000​", "last_payload_modified": "2020-02-18T11:01:30+0000", "media_type": "display", "name": "HopeforVisionPSA_728x90", "rich_media": false, "sizmek_creative_status": "NOT_USED", "sizmek_tag_status": "NOT_USED", "status": true, "t1as": false, "tag": "", "tag_type": "IFRAME", "tpas_ad_tag_name": "HopeforVisionPSA_728x90", "updated_on": "2019-09-10T15:21:48+0000", "vast_version": 2, "version": 0, "width": 412 }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "etag": "f134560e37498d09139641caceb46dd7942590b9", "called_on": "2019-06-04T16:21:59+0000", "status": "ok" } } }, "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "ad_format": { "type": "string", "enum": [ "DISPLAY", "MOBILE", "EXPANDABLE", "FBX", "COMPONENT" ], "description": "Advertising format in which creative will appear. " }, "ad_server_type": { "type": "string", "enum": [ "ATLAS", "DART", "EYEWONDER", "MEDIAMIND", "POINTROLL", "YIELD_MANAGER", "TERMINALONE", "MEDIAFORGE", "OTHER", "TERMINALONESZ" ], "description": "The primary Third Party Ad Server involved with serving the creative. To obtain the most up-to-date list of Ad Servers, see \"API for Ad Servers\"." }, "advertiser_id": { "type": "integer", "description": "ID of TerminalOne Advertiser to which the creative belongs. See \"API for Ad Servers\"." }, "approval_status": { "type": "string", "enum": [ "PENDING", "APPROVED", "REJECTED" ] }, "build_date": { "type": "string", "format": "date-time" }, "built": { "type": "boolean" }, "built_by_user_id": { "type": "integer", "description": "Id number for the user who made the creative." }, "click_through_url": { "type": "string", "maxLength": 2048 }, "click_url": { "type": "string", "maxLength": 10000, "description": "T1 user-declared URL describing where the end user is redirected after clicking an ad, after all redirects." }, "concept_id": { "type": "integer", "description": "ID of TerminalOne Concept ID which the creative belongs; see above." }, "created_on": { "type": "string", "format": "date-time" }, "creative_import_file_id": { "type": "integer", "description": "ID of the file where creative ad tag source came from during the Bulk 3PAS upload." }, "default_t1as_tag": { "type": "string", "description": "The default T1AS ad tag HTML used in order serve the ad. The appropriate T1 Macros necessary must be incorporated." }, "edited_tag": { "type": "string", "description": "" }, "end_date": { "type": "string", "format": "date-time" }, "entity_type": { "type": "string", "enum": [ "atomic_creative" ] }, "expansion_direction": { "type": "string", "maxLength": 19, "description": "Determines whether an 'EXPANDABLE' format ad is restricted with respect to its movement on a page and, if so, which directions are permissible.Defaults to: 'NONRESTRICTED'." }, "expansion_trigger": { "type": "string", "enum": [ "AUTOMATIC", "MOUSEOVER", "CLICK" ], "description": "Action which causes an ad to expand. Defaults to: 'MOUSEOVER'" }, "external_identifier": { "type": "string" }, "file_type": { "type": "string", "enum": [ "gif", "html5", "jpeg", "jpg", "swf", "tif", "tiff", "png", "unknown", "vast" ], "description": "Specify the file type" }, "has_sound": { "type": "boolean", "description": "Set to 'on' if the creative uses sound. This will restrict the creative from running on certain publishers, as enforced by each supply source. Defaults to: 'off'" }, "height": { "type": "integer" }, "id": { "type": "integer" }, "is_https": { "type": "boolean" }, "is_mraid": { "type": "boolean" }, "is_multi_creative": { "type": "boolean", "description": "Set to 'on' if the creatives serving through the ad tag vary significantly (e.g different offers or products or drastically different treatments) in order to reduce the weight given to the Creative in algorithmic optimization (when applied). Best practice is to separate creative with significant differences to allow full visibility to the optimization algorithm. Defaults to 'off'." }, "last_modified": { "type": "string", "format": "date-time" }, "last_payload_modified": { "type": "string", "format": "date-time" }, "media_type": { "type": "string", "enum": [ "display", "video", "mobile" ], "description": "Media Type of the creative. " }, "name": { "type": "string" }, "rejected_reason": { "type": "string", "maxLength": 255 }, "rich_media": { "type": "boolean" }, "rich_media_provider": { "type": "string", "maxLength": 64 }, "sizmek_creative_status": { "type": "string", "enum": [ "PENDING", "UPDATE_IN_PROGRESS", "COMPLETE", "ERROR", "NOT_USED" ] }, "sizmek_tag_status": { "type": "string", "enum": [ "PENDING", "READY", "ERROR", "BAD_IO", "NOT_USED" ] }, "start_date": { "type": "string", "format": "date-time" }, "status": { "type": "boolean" }, "t1as": { "type": "boolean", "description": "If 'on', creative is served by MediaMath's TerminalOne Ad Server.If 'off', creative is a 3PAS creative." }, "tag": { "type": "string", "description": "The actual 3PAS ad tag HTML used in order serve the ad. The appropriate T1 Macros necessary must be incorporated." }, "tag_type": { "type": "string", "enum": [ "SCRIPT", "IFRAME", "NOSCRIPT" ], "description": "Specify the implementation tag type into this field" }, "tpas_ad_tag_name": { "type": "string", "maxLength": 255, "description": "Descriptive name of the placement from the 3PAS." }, "updated_on": { "type": "string", "format": "date-time" }, "vast_version": { "type": "integer" }, "version": { "type": "integer", "description": "Used to protect against simultaneous updates. Refer to \"Optimistc Locking\" in the API overview for more information." }, "width": { "type": "integer" } } }, "uuid": { "type": "string" }, "meta": { "type": "object", "properties": { "etag": { "type": "string" }, "called_on": { "type": "string", "format": "date-time" }, "status": { "type": "string", "enum": [ "ok" ] } } } } } }, "401": { "description": "", "examples": { "text/xml": { "errors": [ { "message": "The access token expired" } ], "meta": { "called_on": "2016-11-22T22:23:23+0000", "status": "auth_error" } } }, "schema": { "properties": { "errors": { "items": { "properties": { "message": { "type": "string" } }, "type": "object" }, "type": "array" }, "meta": { "properties": { "called_on": { "type": "string" }, "status": { "type": "string" } }, "type": "object" } }, "type": "object" } } }, "summary": "Get Atomic Creative", "tags": [ "Creatives" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET_atomiccreatives-id", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true } }, "parameters": [ { "name": "atomic_creative_id", "in": "path", "type": "string", "required": true } ], "post": { "consumes": [ "application/x-www-form-urlencoded" ], "operationId": "POST_atomic_creatives-id", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "produces": [ "application/xml" ], "responses": { "200": { "description": "", "examples": { "application/xml": "{\n \"ad_format\": \"FBX\",\n \"advertiser_id\": 153935,\n \"approval_status\": \"PENDING\",\n \"build_date\": \"2020-02-20T23:29:11+0000\",\n \"built\": false,\n \"built_by_user_id\": 26081,\n \"click_url\": \"\",\n \"concept_id\": 2340635,\n \"created_on\": \"2020-02-20T23:29:11+0000\",\n \"creative_import_file_id\": 130361,\n \"default_t1as_tag\": \"\",\n \"edited_tag\": \"\",\n \"entity_type\": \"atomic_creative\",\n \"expansion_direction\": \"NONRESTRICTED\",\n \"expansion_trigger\": \"MOUSEOVER\",\n \"external_identifier\": \"NOT AVAILABLE\",\n \"file_type\": \"gif\",\n \"has_sound\": false,\n \"height\": 90,\n \"id\": 7184370,\n \"is_https\": true,\n \"is_mraid\": false,\n \"is_multi_creative\": false,\n \"last_modified\": \"2020-02-20T23:29:11+0000​\",\n \"last_payload_modified\": \"2020-02-18T11:01:30+0000\",\n \"media_type\": \"display\",\n \"name\": \"HopeforVisionPSA_728x90\",\n \"rich_media\": false,\n \"sizmek_creative_status\": \"NOT_USED\",\n \"sizmek_tag_status\": \"NOT_USED\",\n \"status\": true,\n \"t1as\": false,\n \"tag\": \"\",\n \"tag_type\": \"IFRAME\",\n \"tpas_ad_tag_name\": \"HopeforVisionPSA_728x90\",\n \"updated_on\": \"2019-09-10T15:21:48+0000\",\n \"vast_version\": 2,\n \"version\": 0,\n \"width\": 0\n }" }, "schema": { "properties": { "data": { "properties": { "ad_format": { "type": "string", "enum": [ "DISPLAY", "MOBILE", "EXPANDABLE", "FBX", "COMPONENT" ], "description": "Advertising format in which creative will appear. " }, "ad_server_type": { "type": "string", "enum": [ "ATLAS", "DART", "EYEWONDER", "MEDIAMIND", "POINTROLL", "YIELD_MANAGER", "TERMINALONE", "MEDIAFORGE", "OTHER", "TERMINALONESZ" ], "description": "The primary Third Party Ad Server involved with serving the creative. To obtain the most up-to-date list of Ad Servers, see \"API for Ad Servers\"." }, "advertiser_id": { "type": "integer", "description": "ID of TerminalOne Advertiser to which the creative belongs. See \"API for Ad Servers\"." }, "approval_status": { "type": "string", "enum": [ "PENDING", "APPROVED", "REJECTED" ] }, "build_date": { "type": "string", "format": "date-time" }, "built": { "type": "boolean" }, "built_by_user_id": { "type": "integer", "description": "Id number for the user who made the creative." }, "click_url": { "type": "string", "maxLength": 10000, "description": "T1 user-declared URL describing where the end user is redirected after clicking an ad, after all redirects." }, "concept_id": { "type": "integer", "description": "ID of TerminalOne Concept ID which the creative belongs; see above." }, "created_on": { "type": "string", "format": "date-time" }, "creative_import_file_id": { "type": "integer", "description": "ID of the file where creative ad tag source came from during the Bulk 3PAS upload." }, "default_t1as_tag": { "type": "string", "description": "The default T1AS ad tag HTML used in order serve the ad. The appropriate T1 Macros necessary must be incorporated." }, "edited_tag": { "type": "string", "description": "" }, "entity_type": { "type": "string", "enum": [ "atomic_creative" ] }, "expansion_direction": { "type": "string", "maxLength": 19, "description": "Determines whether an 'EXPANDABLE' format ad is restricted with respect to its movement on a page and, if so, which directions are permissible.Defaults to: 'NONRESTRICTED'." }, "expansion_trigger": { "type": "string", "enum": [ "AUTOMATIC", "MOUSEOVER", "CLICK" ], "description": "Action which causes an ad to expand. Defaults to: 'MOUSEOVER'" }, "external_identifier": { "type": "string" }, "file_type": { "type": "string", "enum": [ "gif", "html5", "jpeg", "jpg", "swf", "tif", "tiff", "png", "unknown", "vast" ], "description": "Specify the file type" }, "has_sound": { "type": "boolean", "description": "Set to 'on' if the creative uses sound. This will restrict the creative from running on certain publishers, as enforced by each supply source. Defaults to: 'off'" }, "height": { "type": "integer" }, "id": { "type": "integer" }, "is_https": { "type": "boolean" }, "is_mraid": { "type": "boolean" }, "is_multi_creative": { "type": "boolean", "description": "Set to 'on' if the creatives serving through the ad tag vary significantly (e.g different offers or products or drastically different treatments) in order to reduce the weight given to the Creative in algorithmic optimization (when applied). Best practice is to separate creative with significant differences to allow full visibility to the optimization algorithm. Defaults to 'off'." }, "last_modified": { "type": "string", "format": "date-time" }, "last_payload_modified": { "type": "string", "format": "date-time" }, "media_type": { "type": "string", "enum": [ "display", "video", "mobile" ], "description": "Media Type of the creative. " }, "name": { "type": "string" }, "rich_media": { "type": "boolean" }, "sizmek_creative_status": { "type": "string", "enum": [ "PENDING", "UPDATE_IN_PROGRESS", "COMPLETE", "ERROR", "NOT_USED" ] }, "sizmek_tag_status": { "type": "string", "enum": [ "PENDING", "READY", "ERROR", "BAD_IO", "NOT_USED" ] }, "status": { "type": "boolean" }, "t1as": { "type": "boolean", "description": "If 'on', creative is served by MediaMath's TerminalOne Ad Server.If 'off', creative is a 3PAS creative." }, "tag": { "type": "string", "description": "The actual 3PAS ad tag HTML used in order serve the ad. The appropriate T1 Macros necessary must be incorporated." }, "tag_type": { "type": "string", "enum": [ "SCRIPT", "IFRAME", "NOSCRIPT" ], "description": "Specify the implementation tag type into this field" }, "tpas_ad_tag_name": { "type": "string", "maxLength": 255, "description": "Descriptive name of the placement from the 3PAS." }, "updated_on": { "type": "string", "format": "date-time" }, "vast_version": { "type": "integer" }, "version": { "type": "integer", "description": "Used to protect against simultaneous updates. Refer to \"Optimistc Locking\" in the API overview for more information." }, "width": { "type": "integer" } }, "type": "object" }, "meta": { "properties": { "called_on": { "format": "date-time", "type": "string" }, "etag": { "type": "string" }, "status": { "type": "string" } }, "type": "object" }, "uuid": { "type": "string" } }, "type": "object" } }, "401": { "description": "", "examples": { "application/xml": { "errors": [ { "message": "The access token expired" } ], "meta": { "called_on": "2016-11-22T22:23:23+0000", "status": "auth_error" } } }, "schema": { "properties": { "errors": { "items": { "properties": { "message": { "type": "string" } }, "type": "object" }, "type": "array" }, "meta": { "properties": { "called_on": { "type": "string" }, "status": { "type": "string" } }, "type": "object" } }, "type": "object" } } }, "summary": "Update Atomic Creative", "tags": [ "Creatives" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "POST_atomiccreatives-id", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Update Atomic Creative" } }, "/atomic_creatives/{atomic_creative_id}/creative_approvals": { "get": { "operationId": "GET_atomic_creatives-id-creative_approvals", "parameters": [ { "in": "header", "name": "Via", "type": "string" }, { "in": "header", "name": "Total-Route-Time", "type": "integer" }, { "in": "header", "name": "Connect-Time", "type": "integer" }, { "in": "header", "name": "Authorization", "type": "string" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" } ], "produces": [ "text/xml" ], "responses": { "200": { "description": "None of the standard query parameters work with this command", "examples": { "application/json": { "data": [ { "entity_type": "creative_approval", "id": 12349494, "name": "Creative Approvals #12349494" }, { "entity_type": "creative_approval", "id": 12349565, "name": "Creative Approvals #12349565" } ], "meta": { "called_on": "2019-06-03T18:04:04+0000", "count": 2, "etag": "9ef746a2a7c4f965e64a6ed8729e8934c3aff885", "offset": 0, "status": "ok", "total_count": 0 }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B" } }, "schema": { "properties": { "data": { "items": { "properties": { "entity_type": { "enum": [ "creative_approval" ], "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" } }, "type": "object" }, "type": "array" }, "meta": { "properties": { "called_on": { "format": "date-time", "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "enum": [ "error", "ok" ], "type": "string" }, "total_count": { "type": "integer" } }, "type": "object" }, "uuid": { "type": "string" } }, "type": "object" } }, "401": { "description": "", "examples": { "text/xml": { "errors": [ { "message": "The access token expired" } ], "meta": { "called_on": "2016-11-22T22:23:23+0000", "status": "auth_error" } } }, "schema": { "properties": { "errors": { "items": { "properties": { "message": { "type": "string" } }, "type": "object" }, "type": "array" }, "meta": { "properties": { "called_on": { "type": "string" }, "status": { "type": "string" } }, "type": "object" } }, "type": "object" } } }, "summary": "List Creative Approvals for a Creative", "tags": [ "Creatives" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET_atomiccreatives-id-creativeapprovals", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "List Creative Approvals\n\nNone of the standard query parameters (full, page_limit, page_offset, q, sort_by, with) work with this command" }, "parameters": [ { "name": "atomic_creative_id", "in": "path", "type": "string", "required": true } ] }, "/atomic_creatives/{atomic_creative_id}/creative_approvals/{approval_id}": { "get": { "operationId": "GET_atomic_creatives-id-creative_approvals-approval_id", "parameters": [ { "in": "header", "name": "Via", "type": "string" }, { "in": "header", "name": "Total-Route-Time", "type": "integer" }, { "in": "header", "name": "Connect-Time", "type": "integer" }, { "in": "header", "name": "Authorization", "type": "string" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "produces": [ "text/xml" ], "responses": { "200": { "description": "", "examples": { "application/json": { "data": { "additional_detail": "", "approval_status": "APPROVED", "approval_status_updated_on": "2019-03-11T21:02:02+0000", "atomic_creative_id": 6595252, "created_on": "2019-03-11T21:02:02+0000", "deal_status": "PENDING", "deal_status_rejected_reason": "", "deal_status_updated_on": "2019-03-11T21:02:02+0000", "entity_type": "creative_approval", "external_identifier": "6595252", "id": 204809494, "name": "Creative Approvals #204809494", "rejected_reason": "", "supply_source_id": 83, "updated_on": "2019-03-11T21:02:02+0000", "version": 0 }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "called_on": "2019-06-03T18:06:27+0000", "etag": "cbc9185c6a97618540c8cbc0f1feeae2249b15f8", "status": "ok" } } }, "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "additional_detail": { "type": "string" }, "approval_status": { "type": "string", "enum": [ "APPROVED", "PENDING", "REJECTED" ] }, "approval_status_updated_on": { "type": "string", "format": "date-time" }, "atomic_creative_id": { "type": "integer" }, "created_on": { "type": "string", "format": "date-time" }, "deal_status": { "type": "string" }, "deal_status_rejected_reason": { "type": "string" }, "deal_status_updated_on": { "type": "string", "format": "date-time" }, "entity_type": { "type": "string", "enum": [ "creative approval" ] }, "external_identifier": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "rejected_reason": { "type": "string" }, "supply_source_id": { "type": "integer" }, "updated_on": { "type": "string", "format": "date-time" }, "version": { "type": "integer" } } }, "uuid": { "type": "string" }, "meta": { "type": "object", "properties": { "called_on": { "type": "string", "format": "date-time" }, "etag": { "type": "string" }, "status": { "type": "string", "enum": [ "ok" ] } } } } } }, "401": { "description": "", "examples": { "text/xml": { "errors": [ { "message": "The access token expired" } ], "meta": { "called_on": "2016-11-22T22:23:23+0000", "status": "auth_error" } } }, "schema": { "properties": { "errors": { "items": { "properties": { "message": { "type": "string" } }, "type": "object" }, "type": "array" }, "meta": { "properties": { "called_on": { "type": "string" }, "status": { "type": "string" } }, "type": "object" } }, "type": "object" } } }, "summary": "Get Creative Approval", "tags": [ "Creatives" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET_atomiccreatives-id-creativeapprovals-approvalid", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Get Creative Approval data\n\nNone of the standard query parameters work with this command, so no \"with=supply_source\" or \"with=atomic_creative\"" }, "parameters": [ { "name": "atomic_creative_id", "in": "path", "type": "string", "required": true }, { "name": "approval_id", "in": "path", "type": "string", "required": true } ] }, "/atomic_creatives/{atomic_creative_id}/reset_edited_tag": { "parameters": [ { "name": "atomic_creative_id", "in": "path", "type": "string", "required": true } ], "post": { "consumes": [ "application/x-www-form-urlencoded" ], "operationId": "POST_atomic_creatives-id-reset_edited_tag", "parameters": [ { "in": "formData", "name": "version", "type": "integer" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "produces": [ "text/xml" ], "responses": { "200": { "description": "", "examples": { "text/xml": "{\n \"data\": [\n {\n \"entity_type\": \"atomic_creative\",\n \"id\": 3263857,\n \"name\": \"Expandable Test\"\n }\n ],\n\"uuid\" : \"E119F0A2-B21A-11E9-8F2B-D4AE668E900B\", \n \"meta\": {\n \"called_on\": \"2016-11-22T22:28:38+0000\",\n \"count\": 100,\n \"etag\": \"828840bb1eb89002d20a90d1505610e5c0f70218\",\n \"next_page\": \"https://api.mediamath.com/api/v2.0/atomic_creatives?page_offset=100&api_key=noapikey\",\n \"offset\": 0,\n \"status\": \"ok\",\n \"total_count\": 27109\n }\n}" }, "schema": { "properties": { "data": { "items": { "properties": { "entity_type": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" } }, "type": "object" }, "type": "array" }, "uuid": { "type": "string" }, "meta": { "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "next_page": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "type": "object" } }, "type": "object" } }, "401": { "description": "", "examples": { "text/xml": { "errors": [ { "message": "The access token expired" } ], "meta": { "called_on": "2016-11-22T22:23:23+0000", "status": "auth_error" } } }, "schema": { "properties": { "errors": { "items": { "properties": { "message": { "type": "string" } }, "type": "object" }, "type": "array" }, "meta": { "properties": { "called_on": { "type": "string" }, "status": { "type": "string" } }, "type": "object" } }, "type": "object" } } }, "summary": "Reset a Creative's Edited Tag", "tags": [ "Creatives" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "POST_atomiccreatives-id-reseteditedtag", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Reset a Creative's Edited Tag" } }, "/audience_segments": { "get": { "description": "The `audience_segments` API is used to target strategies based on third-party segments. \n\nTargeting audience segments is a two-step process:\n\n1. Find available audience segments in T1\n1. Assign audience segments to a strategy\n\n__Find Available Audience Segments__\n\nThe audience segments are organized as a taxonomy (tree) in T1. In order to retrieve audience segments, start with the top-level nodes, then recursively fetch child nodes for each level thus retrieved.\n\nThe first level in the audience segments taxonomy contains a root node for each data provider available in T1.\n\nOnce the audience segment id for an entity at the root node is known, it is possible to get information on the child audience segments of that entity.\n\nSecond-level nodes themselves have child audience segments, so the process can be repeated as needed.\n\n_Formerly, Audence Segments could also be used to apply contextual targeting provided by Integral Ad Science; however, this was deprecated. Please see `targeting_segments` for instructions to apply contextual targeting._\n\n__Special Behavior of ?q=__\n\nQueries like `GET /audience_segments?q=(123)` automatically have extra filters applied to them:\n* `parent_audience_segment_id IS NULL` - only top-level nodes are returned.\n* `type = 'normal'` - custom (private) segments are not returned.\n\nYou can still use `?q=` to retrieve child and private nodes. To do so you have to explicitly add one or more of the following query parameters that you have permission to access:\n* `GET /audience_segments?q=(123)&organization_id=567`\n* `GET /audience_segments?q=(123)&agency_id=890`\n* `GET /audience_segments?q=(123)&advertiser_id=976`\n\nQuery parameters:\nfull=* will provide fields beyond entity_type, id, name (which is why those 3 list as required in the response)\nsort_by can use any response field\nwith can use audience_vendor but not taxonomy", "operationId": "get-audience-segments", "parameters": [ { "in": "query", "name": "custom_brain_enabled", "type": "boolean" }, { "in": "query", "name": "only_brain_enabled", "type": "boolean" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "description": "name", "in": "query", "items": { "type": "string" }, "name": "sort_by", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": [ { "audience_vendor_id": 4920, "buyable": false, "child_count": 11, "created_on": "2019-08-13T19:41:49+0000", "entity_type": "audience_segment", "full_path": "Factual - NEW", "id": 3102239, "name": "Factual - NEW", "taxonomy_id": 102311, "type": "normal", "updated_on": "2019-08-13T19:41:49+0000", "version": 0 }, { "audience_vendor_id": 582, "buyable": false, "child_count": 9, "created_on": "2019-08-22T17:32:19+0000", "entity_type": "audience_segment", "full_path": "adsquare", "id": 3111437, "name": "adsquare", "taxonomy_id": 100489, "type": "normal", "updated_on": "2019-08-22T17:32:19+0000", "version": 0 }, { "audience_vendor_id": 87, "buyable": false, "child_count": 24, "created_on": "2019-09-06T13:59:46+0000", "entity_type": "audience_segment", "full_path": "Navegg", "id": 3115107, "name": "Navegg", "taxonomy_id": 100349, "type": "normal", "updated_on": "2019-09-06T13:59:46+0000", "version": 0 } ], "meta": { "called_on": "2019-09-10T16:41:52+0000", "count": 3, "etag": "7f4b9011dccd1ce5982bb86a3e1e6f0e0c9ca0fc", "next_page": "https://api.mediamath.com/api/v2.0/audience_segments?full=*&page_limit=3&page_offset=3", "offset": 0, "status": "ok", "total_count": 44 }, "uuid": "E49FDD0E-D3E9-11E9-AEB8-6E1C26F3F03C" } }, "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "audience_vendor_id": { "type": "integer" }, "buyable": { "type": "boolean" }, "child_count": { "type": "integer" }, "created_on": { "type": "string", "format": "date-time" }, "entity_type": { "type": "string", "enum": [ "audience_segment" ] }, "full_path": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "taxonomy_id": { "type": "integer" }, "type": { "type": "string" }, "updated_on": { "type": "string", "format": "date-time" }, "version": { "type": "integer" } }, "required": [ "entity_type", "id", "name" ] } }, "meta": { "type": "object", "properties": { "called_on": { "type": "string", "format": "date-time" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "next_page": { "type": "string", "format": "uri" }, "offset": { "type": "integer" }, "status": { "type": "string", "enum": [ "ok" ] }, "total_count": { "type": "integer" } } }, "uuid": { "type": "string", "format": "uuid" } } } } }, "summary": "List All Possible Audience Segments", "tags": [ "Targeting - Audience Segments" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "get-audience-segments", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true } } }, "/campaigns": { "get": { "operationId": "GET_campaigns", "parameters": [ { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "description": "name", "in": "query", "items": { "type": "string" }, "name": "sort_by", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" } ], "produces": [ "application/vnd.mediamath.unsupported+json" ], "responses": { "200": { "description": "\nQuery section:\n\"with\" accepts the following: ad_server, advertiser, currency, viewability\n\"sort_by\" can use any parameter in the root of the data section\nWhen \"full=* \" is not included, only entity_type, id, and name appear in the data section", "examples": { "application/vnd.mediamath.unsupported+json": { "data": [ { "accountable_and_addressable": false, "ad_server_id": 6, "advertiser_id": 128129, "agency_fee_pct": 0, "connected_id_type": "DETERMINISTIC_ONLY", "conversion_type": "variable", "conversion_variable_minutes": 1, "cost_passthrough_cpm_enabled": false, "cost_passthrough_percent_enabled": false, "created_on": "2019-09-10T17:21:07+0000", "currency_code": "ARS", "dcs_data_is_campaign_level": false, "end_date": "2019-09-30T23:59:00+0000", "entity_type": "campaign", "frequency_interval": "not-applicable", "frequency_optimization": true, "frequency_type": "no-limit", "goal_type": "cpa", "goal_value": [ { "currency_code": "ARS", "value": 300 } ], "has_custom_attribution": false, "id": 711426, "impression_cap_automatic": false, "impression_cap_type": "no-limit", "initial_start_date": "2019-09-11T00:00:00+0000", "is_programmatic_guaranteed": false, "margin_pct": 0, "merit_pixel_id": 1059758, "minimize_multi_ads": true, "name": "Green Giraffe Hotel Performance CPA", "override_suspicious_traffic_filter": false, "pc_window_minutes": 43200, "pv_pct": 100, "pv_window_minutes": 43200, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "spend_cap_automatic": true, "spend_cap_type": "asap", "start_date": "2019-09-11T00:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": [ { "currency_code": "ARS", "value": 5000 } ], "updated_on": "2019-09-10T17:21:07+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 0, "viewability_sample_rate": "1.00", "viewability_type": "BYOV", "viewability_vendor_id": 1078, "zone_name": "Etc/GMT" }, { "accountable_and_addressable": false, "ad_server_id": 9, "advertiser_id": 112018, "agency_fee_pct": 0, "connected_id_type": "DETERMINISTIC_ONLY", "conversion_type": "variable", "conversion_variable_minutes": 1, "cost_passthrough_cpm_enabled": false, "cost_passthrough_percent_enabled": false, "created_on": "2019-09-10T14:22:58+0000", "currency_code": "USD", "dcs_data_is_campaign_level": false, "end_date": "2019-10-11T03:59:00+0000", "entity_type": "campaign", "frequency_amount": 10, "frequency_interval": "day", "frequency_optimization": false, "frequency_type": "asap", "goal_type": "roi", "goal_value": [ { "currency_code": "USD", "value": 120 } ], "has_custom_attribution": false, "id": 711380, "impression_cap_automatic": true, "impression_cap_type": "no-limit", "initial_start_date": "2019-09-17T04:00:00+0000", "is_programmatic_guaranteed": false, "margin_pct": 0, "merit_pixel_id": 1264037, "minimize_multi_ads": true, "name": "melissa", "override_suspicious_traffic_filter": false, "pc_window_minutes": 43200, "pv_pct": 100, "pv_window_minutes": 43200, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "spend_cap_automatic": true, "spend_cap_type": "asap", "start_date": "2019-09-17T04:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": [ { "currency_code": "USD", "value": 1 } ], "updated_on": "2019-09-10T14:22:58+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 0, "zone_name": "America/New_York" } ], "meta": { "called_on": "2019-09-10T18:31:49+0000", "count": 2, "etag": "5d2684f9eb4d426b63c3cea8a046e5feda724d2f", "next_page": "https://api.mediamath.com/api/v2.0/campaigns?full=*&page_limit=2&page_offset=2", "offset": 0, "status": "ok", "total_count": 36939 }, "uuid": "40DAE9A6-D3F9-11E9-BB0A-47B1702346FC" } }, "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "accountable_and_addressable": { "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "ad_server_fee": { "description": "Fee charged by ad serving vendor", "type": "integer" }, "ad_server_id": { "description": "Fee charged by ad serving vendor", "type": "integer" }, "advertiser_id": { "description": "ID for a 3PAS", "type": "integer" }, "agency_fee_pct": { "type": "integer" }, "bid_min_devices": { "default": 1, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "maximum": 5, "minimum": 1, "type": "integer" }, "connected_id_type": { "enum": [ "DETERMINISTIC_FIRST", "DETERMINISTIC_ONLY" ], "type": "string" }, "conversion_type": { "description": "Definition for conversions per user. every = Attribute for all Merit Events. variable = Attribute one Merit Event per X minutes - set inconversion_variable_minutes one = Attribute one Merit Event per user (if conversion_type = one, then conversion_variable_minutes (integer) is required). required if goal_type in {cpa, roi}", "enum": [ "every", "one", "variable" ], "type": "string" }, "conversion_variable_minutes": { "description": "Attribute one Merit Event per X minutes, required if goal_type in {cpa, cpc, roi} && conversion_type=one", "type": "integer" }, "cost_passthrough_cpm_enabled": { "type": "boolean", "description": "Set to 1 if you want to track cpm costs in your total spend that you won't get billed for. Note - this feature is currently in closed beta - you will only be able to set this flag if you are in the closed beta and thus permissioned for this feature." }, "cost_passthrough_cpm_value": { "type": "integer", "description": "CPM value associated with your optional cost you want to track" }, "cost_passthrough_percent_enabled": { "type": "boolean", "description": "Set to 1 if you want to track % of media costs in your total spend that you won't get billed for. Note - this feature is currently in closed beta - you will only be able to set this flag if you are in the closed beta and thus permissioned for this feature." }, "cost_passthrough_percent_value": { "type": "integer", "description": "% of media value associated with your optional cost you want to track." }, "created_on": { "format": "date-time", "type": "string" }, "currency_code": { "description": "Currency setting for campaign. All strategies under this value inherit the selected currency. Once the campaign launches, it cannot be switched to another currency (aka existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).", "maxLength": 3, "minLength": 3, "type": "string" }, "custom_attribution_source": { "type": "string" }, "dcs_data_is_campaign_level": { "type": "boolean" }, "device_graph_only": { "type": "boolean" }, "end_date": { "description": "Last date of campaign in GMT", "format": "date-time", "type": "string" }, "entity_type": { "enum": [ "campaign" ], "type": "string" }, "frequency_amount": { "description": "required if `frequency_type=even||asap`", "type": "integer" }, "frequency_interval": { "description": "Required if frequency_type=even||asap", "enum": [ "campaign", "day", "hour", "month", "not-applicable", "week" ], "type": "string" }, "frequency_optimization": { "type": "boolean" }, "frequency_type": { "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap", "enum": [ "asap", "even", "no-limit", "t1-optimized" ], "type": "string" }, "goal_type": { "enum": [ "cpa", "cpc", "ctr", "reach", "roi", "spend", "vcpm", "vcr", "viewability_rate" ], "type": "string" }, "goal_value": { "description": "Target goal value for campaign respective to the goal_type selection. Required if goal_type in {cpa, cpc, reach, roi}", "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency codes", "maxLength": 3, "minLength": 3, "type": "string" }, "value": { "type": "integer" } } } }, "has_custom_attribution": { "type": "boolean" }, "id": { "type": "integer" }, "impression_cap_amount": { "description": "Sets the amount of the available impression budget across the remaining number of days across all their strategies.", "type": "integer" }, "impression_cap_automatic": { "type": "boolean" }, "impression_cap_type": { "description": "Type of cap applied to impression budgets", "enum": [ "asap", "even", "no-limit", "t1-optimize" ], "type": "string" }, "initial_start_date": { "format": "date-time", "type": "string" }, "io_name": { "type": "string", "description": "Descriptive name of insertion order", "maxLength": 256 }, "io_reference_num": { "type": [ "integer", "string" ], "description": "Reference number of insertion order", "maxLength": 32 }, "is_programmatic_guaranteed": { "type": "boolean", "description": "Set to 1 if you want to run programmatic guaranteed deals assigned to strategies within this campaign. Note - this feature is currently in closed beta - you will only be able to set this flag if you are in the closed beta and thus permissioned for this feature." }, "margin_pct": { "description": "Margin percentage to be applied on campaign spend", "type": "integer" }, "merit_pixel_id": { "description": "Specify Meric Pixel that represents conversion or engagement on CPA or CPE type campaigns. Required if goal_type in {cpa, roi}", "type": "integer" }, "minimize_multi_ads": { "description": "Enabling this field will cause t1 to avoid bidding on more than one ad opportunity on a single page view across. Warning: enabling this setting may limit pacing and reduce the available inventory for the campaigns by not bidding on impression opportunities where the URL is not transparent.", "type": "boolean" }, "name": { "description": "Descriptive name of the campaign", "maxLength": 256, "type": "string" }, "override_suspicious_traffic_filter": { "description": "Enabling this setting allows you to set a campaign-specific level of suspicious traffic filtering using the 'suspicious_traffic_filter_level' property. this will override the T1 default (or organizational-level, if configured) suspicious traffic filtering level.", "type": "boolean" }, "pc_window_minutes": { "description": "Post-click window for attribution. Not to be confused with pv_window_minutes. Optional if goal_type in {cpa, roi}", "type": "integer" }, "political": { "description": "Per compliance, is campaign considered political?", "default": false, "type": "boolean" }, "pv_pct": { "description": "% of post-view windows to be used for attribution", "type": "integer" }, "pv_window_minutes": { "description": "Post-view window for attribution. Required if goal_type in {cpa, roi}", "type": "integer" }, "restrict_targeting_to_deterministic_id": { "description": "This is a dis-used field, which now only allows the value 'true'.", "type": "boolean" }, "restrict_targeting_to_same_device_id": { "type": "boolean" }, "service_type": { "description": "Indicate whether campaign will be self-service or managed (managed campaigns will incur a managed service fee)", "enum": [ "MANAGED", "SELF" ], "type": "string" }, "source_campaign_id": { "type": "integer" }, "spend_cap_amount": { "description": "Spend cap amount", "type": "array", "items": { "type": "object", "properties": { "currency_code": { "maxLength": 3, "minLength": 3, "type": "string" }, "value": { "type": "integer" } } } }, "spend_cap_automatic": { "description": "Automatically sets the available spend budget across all strategies through the end date of the campaign", "type": "boolean" }, "spend_cap_type": { "description": "Type of cap applied to spend budgets.", "enum": [ "asap", "even", "no-limit", "t1-optimized" ], "type": "string" }, "start_date": { "description": "Date on which the campaign will start (GMT)", "format": "date-time", "type": "string" }, "status": { "description": "Status of the campaign", "type": "boolean" }, "suspicious_traffic_filter_level": { "description": "A value between 0 and 100 that determines the sensitivity of T1 suspicious traffic filtering capabilities, If the value = 0, all fraud and suspicious traffic filtering is turned off. It will not take effect if 'override_suspicious_traffic_filter_level' is not set.", "type": "integer" }, "total_budget": { "description": "Allocated budget for the campaign", "type": "array", "items": { "type": "object", "properties": { "currency_code": { "maxLength": 3, "minLength": 3, "type": "string" }, "value": { "type": "integer" } } } }, "updated_on": { "format": "date-time", "type": "string" }, "use_default_ad_server": { "type": "boolean" }, "use_mm_freq": { "type": "boolean" }, "version": { "type": "integer" }, "viewability_sample_rate": { "description": "Between or equal to 0.00 and 1.00", "type": "number" }, "viewability_type": { "enum": [ "AUTO_TAG", "BYOV" ], "type": "string" }, "viewability_vendor_id": { "type": "integer" }, "zone_name": { "description": "Indicate the time zone for reporting for the campaign", "maxLength": 64, "type": "string" } }, "required": [ "entity_type", "id", "name" ] } }, "meta": { "type": "object", "properties": { "called_on": { "format": "date-time", "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "next_page": { "format": "uri", "type": "string" }, "offset": { "type": "integer" }, "status": { "enum": [ "ok" ], "type": "string" }, "total_count": { "type": "integer" } } }, "uuid": { "format": "uuid", "type": "string" } } } }, "401": { "description": "", "examples": { "application/vnd.mediamath.unsupported+json": "\n\n The access token expired\n The access token expired\n The access token expired\n" }, "schema": { "type": "object" } } }, "security": [ { "oauth2": [] } ], "summary": "List Campaigns", "tags": [ "Campaigns" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET_campaigns", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "List Campaigns\n\nQuery parameters:\nfull=* will provide fields beyond entity_type, id, name (which is why those 3 list as required in the response)\nsort_by can use any response field\nwith can use ad_server, advertiser, currency and/or viewability" }, "post": { "consumes": [ "application/x-www-form-urlencoded" ], "operationId": "POST-campaigns", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" }, { "in": "formData", "name": "version", "type": "integer", "default": 0 }, { "in": "formData", "name": "advertiser_id", "type": "integer", "required": true }, { "in": "formData", "name": "status", "type": "integer", "description": "1. ", "maximum": 1, "minimum": 0, "default": 1 }, { "in": "formData", "name": "name", "type": "string" }, { "in": "formData", "name": "service_type", "type": "string", "enum": [ "MANAGED", "SELF" ], "required": true, "default": "SELF" }, { "in": "formData", "name": "currency_code", "type": "string", "default": "USD" }, { "in": "formData", "name": "goal_type", "type": "string", "default": "spend", "enum": [ "cpa", "cpc", "ctr", "reach", "roi", "spend", "vcpm", "vcr", "viewability_rate" ] }, { "in": "formData", "name": "goal_value", "type": "number", "format": "float" }, { "in": "formData", "name": "ad_server_id", "type": "integer", "default": 9 }, { "in": "formData", "name": "spend_cap_type", "enum": [ "even", "asap", "no-limit" ], "type": "string", "default": "asap" }, { "in": "formData", "name": "impression_cap_type", "enum": [ "even", "asap", "no-limit" ], "type": "string", "default": "asap" }, { "in": "formData", "name": "spend_cap_automatic", "type": "integer", "description": "1. ", "maximum": 1, "minimum": 0, "default": 1 }, { "in": "formData", "name": "impression_cap_automatic", "type": "integer", "maximum": 1, "minimum": 0, "default": 1 }, { "in": "formData", "name": "frequency_type", "enum": [ "even", "asap", "no-limit" ], "type": "string", "default": "even" }, { "in": "formData", "name": "frequency_amount", "type": "integer" }, { "in": "formData", "name": "frequency_interval", "type": "string", "default": "hour" }, { "in": "formData", "name": "minimize_multi_ads", "type": "integer", "description": "1. ", "maximum": 1, "minimum": 0, "default": 0 }, { "in": "formData", "name": "pv_pct", "type": "integer", "default": 100 }, { "in": "formData", "name": "conversion_variable_minutes", "type": "number", "default": "1" }, { "in": "formData", "name": "conversion_type", "type": "string", "default": "variable", "description": "Definition for conversions per user.\n\nevery: Attribute all Merit Events\n\nvariable: Attribute one Merit Event per X minutes - set inconversion_variable_minutes\n\none: Attribute one Merit Event per user (if converstion_type = one, then conversion_variable_minutes (integer) is required).\n\nrequired if `goal_type in ('cpa', 'roi')`\n", "enum": [ "every", "one", "variable" ] }, { "in": "formData", "name": "start_date", "type": "string", "format": "date-time" }, { "in": "formData", "name": "end_date", "type": "string", "format": "date-time" }, { "in": "formData", "name": "total_budget", "type": "integer" }, { "in": "formData", "name": "total_impression_budget", "type": "integer" }, { "in": "formData", "name": "zone_name", "type": "string", "default": "Etc/GMT" }, { "in": "formData", "name": "frequency_optimization", "type": "integer", "description": "1. ", "maximum": 1, "minimum": 0, "default": 0 }, { "in": "formData", "name": "has_custom_attribution", "type": "integer", "description": "1. ", "maximum": 1, "minimum": 0, "default": 0 }, { "in": "formData", "name": "restrict_targeting_to_same_device_id", "type": "integer", "description": "1. ", "maximum": 1, "minimum": 0, "default": 0 }, { "in": "formData", "name": "override_suspicious_traffic_filter", "type": "integer", "description": "1. ", "maximum": 1, "minimum": 0, "default": 0 }, { "in": "formData", "description": "A value between 0 and 100 that determines the sensitivity of T1 suspicious traffic filtering capabilities.If the value = 0, all fraud and suspicious traffic filtering is turned off.It will not take effect if 'override_suspicious_traffic_filter_level' is not set.\n\n", "name": "suspicious_traffic_filter_level", "type": "integer", "default": 25, "minimum": 0, "maximum": 100 } ], "responses": { "201": { "description": "", "schema": { "example": { "ad_server_id": 6, "advertiser_id": 122631, "agency_fee_pct": 0, "bid_min_devices": 1, "connected_id_type": "DETERMINISTIC_ONLY", "conversion_type": "variable", "conversion_variable_minutes": 1, "created_on": "2016-10-19T03:21:53+0000", "currency_code": "USD", "custom_attribution_source": "3rd Party Attribution", "dcs_data_is_campaign_level": false, "device_graph_only": false, "end_date": "2016-11-07T23:59:00+0000", "entity_type": "campaign", "frequency_amount": 2, "frequency_interval": "not-applicable", "frequency_optimization": false, "frequency_type": "no-limit", "goal_type": "spend", "goal_value": "2.5", "has_custom_attribution": false, "id": 300982, "impression_cap_amount": 5000, "impression_cap_automatic": false, "impression_cap_type": "asap", "initial_start_date": "2016-10-19T09:00:00+0000", "io_name": "", "io_reference_num": "", "margin_pct": 0, "minimize_multi_ads": false, "name": "MobileAds Test (Round 4)", "override_suspicious_traffic_filter": false, "pv_pct": 100, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "source_campaign_id": 395863, "spend_cap_amount": 5, "spend_cap_automatic": false, "spend_cap_type": "asap", "start_date": "2016-10-19T09:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": 40, "updated_on": "2016-11-01T07:18:56+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 5, "zone_name": "Etc/GMT" }, "title": "Create Campaign", "type": "object", "x-stoplight": { "id": "campaign", "name": "Create Campaign", "public": true }, "properties": { "accountable_and_addressable": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "ad_server_fee": { "description": "Fee charged by ad serving vendor", "type": "integer" }, "ad_server_id": { "description": "The ID for a third-party ad server", "type": "integer" }, "ad_server_password": { "type": "string", "description": "Ad server password, must be equal to or less than 64" }, "ad_server_username": { "type": "string", "description": "Ad server username, must be equal to or less than 64" }, "ads_txt_verified": { "type": "string", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ] }, "advertiser_id": { "default": 512321, "description": "T1 Advertiser ID to which a campaign belongs", "type": "integer" }, "agency_fee_pct": { "type": "number", "description": "The Agency Fee Percentage (for example: 0.45)" }, "bid_min_devices": { "default": 1, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "maximum": 5, "minimum": 1, "type": "integer" }, "connected_id_type": { "enum": [ "DETERMINISTIC_FIRST", "DETERMINISTIC_ONLY" ], "type": "string" }, "conversion_type": { "description": "Definition for conversions per user.\n\nevery: Attribute all Merit Events\n\nvariable: Attribute one Merit Event per X minutes - set inconversion_variable_minutes\n\none: Attribute one Merit Event per user (if converstion_type = one, then conversion_variable_minutes (integer) is required).\n\nrequired if `goal_type in ('cpa', 'roi')`\n", "enum": [ "every", "one", "variable" ], "type": "string" }, "conversion_variable_minutes": { "description": "Attribute one Merit Event per X minutes\n\nrequired if `goal_type in ('cpa', 'cpc', 'roi') && conversion_type=one`", "type": "integer" }, "cost_passthrough_cpm_enabled": { "type": "boolean" }, "cost_passthrough_cpm_value": { "type": "number" }, "cost_passthrough_percent_enabled": { "type": "boolean" }, "cost_passthrough_percent_value": { "type": "number" }, "created_on": { "type": "string" }, "currency_code": { "default": "USD", "description": "Currency setting for campaign. All strategies under this value inherit the selected currency. Once the campaign launches, it cannot be switched to another currency (aka existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).", "type": "string" }, "custom_attribution_source": { "type": "string" }, "dcs_data_is_campaign_level": { "type": "boolean" }, "device_graph_only": { "type": "boolean" }, "eligible_for_data_sharing": { "type": "boolean" }, "end_date": { "description": "Last date of campaign in GMT", "type": "string" }, "frequency_amount": { "description": "required if `frequency_type=even||asap`", "type": "integer" }, "frequency_interval": { "description": "required if `frequency_type=even||asap`\n", "type": "string" }, "frequency_optimization": { "description": "", "type": "boolean" }, "frequency_type": { "default": "no-limit", "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "goal_alert": { "type": "number", "description": "Goal Alert Min:0 Max:100, can be decimal", "format": "float", "minimum": 0, "maximum": 100 }, "goal_category": { "type": "string", "description": "goal_category must be one of the following: 'audience', 'engagement', 'response'", "enum": [ "audience", "engagement", "response" ] }, "goal_type": { "type": "string", "description": "Goal type which campaign performance will be measured", "enum": [ "cpa", "cpc", "ctr", "reach", "roi", "spend", "vcr", "vcpm", "viewability_rate" ] }, "goal_value": { "description": "Target goal value for campaign respective to the `goal_type` selection.\n\nrequired if `goal_type` in ('cpa','cpc','reach','roi', 'vcr', 'ctr')`\n\nIf `goal_type` is 'vcr' or 'ctr' or 'viewability_rat', `goal_value` is a percentage.\n\nGoal Value max=\"9999999.9999\" min=\"0.01\", unless goal_value is a percentage in which case max=100.00", "type": "string" }, "has_custom_attribution": { "description": "", "type": "boolean" }, "id": { "description": "", "type": "integer" }, "impression_cap_amount": { "description": "Sets the amount of the available impression budget across the remaining number of days across all their strategies.", "type": "integer" }, "impression_cap_automatic": { "description": "", "type": "boolean" }, "impression_cap_type": { "default": "no-limit", "description": "Type of cap applied to impression budgets.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "initial_start_date": { "type": "string" }, "io_name": { "type": "string", "description": "Descriptive name of insertion order", "maxLength": 256 }, "io_reference_num": { "type": [ "integer", "string" ], "description": "Reference number of insertion order", "maxLength": 32 }, "is_programmatic_guaranteed": { "description": "Sets the campaign as a Programmatic Guaranteed campaign. Once set for a campaign, it cannot be changed", "type": "boolean" }, "margin_pct": { "description": "Margin percentage to be applied on campaign spend", "type": "integer" }, "merit_pixel_id": { "description": "Specify Merit Pixel that represents conversion or engagement on CPA or CPE type campaigns\n\nREQUIRED if `goal_type in ('cpa','roi')`\n\nTHIS FIELD IS OBSOLETE", "type": "integer" }, "minimize_multi_ads": { "default": 0, "description": "Enabling this field will cause T1 to avoid bidding on more than one ad opportunity on a single page view across. Warning: enabling this setting may limit pacing and reduce the available inventory for the campaigns by not bidding on impression opportunities where the URL is not transparent.", "type": "boolean" }, "name": { "description": "Descriptive name of the campaign", "type": "string" }, "override_suspicious_traffic_filter": { "default": 0, "description": "Enabling this setting allows you to set a campaign-specific level of suspicious traffic filtering using the 'suspicious_traffic_filter_level' property. This will override the T1 default (or organization-level, if configured) suspicious traffic filtering level.", "type": "boolean" }, "pacing_alert": { "description": "", "type": "number" }, "pc_window_minutes": { "description": "Post-click window for attribution. Not to be confused with pv_window_minutes.\n\noptional if `goal_type in ('cpa','roi')`\n", "type": "integer" }, "pv_pct": { "description": "Percentage of post-view windows to be used for attribution\n\noptional if `goal_type in ('cpa','roi')`", "type": "integer" }, "pv_window_minutes": { "description": "Post-view window for attribution \n\nrequired if `goal_type in ('cpa','roi')`", "type": "integer" }, "restrict_targeting_to_deterministic_id": { "type": "boolean" }, "restrict_targeting_to_same_device_id": { "type": "boolean" }, "service_type": { "description": "Indicate whether campaign will be self-service or managed (managed campaigns will incur manage service fee)", "enum": [ "MANAGED", "SELF" ], "type": "string" }, "source_campaign_id": { "type": "integer" }, "spend_cap_amount": { "description": "only required if`spend_cap_enabled`is true", "type": "integer" }, "spend_cap_automatic": { "description": "Automatically sets the available spend budget across all strategies through the end date of the campaign.", "type": "boolean" }, "spend_cap_type": { "description": "Type of cap applied to spend budgets.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "start_date": { "description": "Date on which the campaign will start (GMT)", "type": "string" }, "status": { "default": false, "description": "Status of the campaign", "type": "boolean" }, "suspicious_traffic_filter_level": { "description": "A value between 0 and 100 that determines the sensitivity of T1 suspicious traffic filtering capabilities.If the value = 0, all fraud and suspicious traffic filtering is turned off.It will not take effect if 'override_suspicious_traffic_filter_level' is not set.\n\n", "maximum": 100, "minimum": 0, "type": "integer" }, "total_budget": { "description": "Allocated budget for the campaign", "type": "integer" }, "total_impression_budget": { "description": "", "type": "integer" }, "updated_on": { "type": "string" }, "use_default_ad_server": { "type": "boolean" }, "use_mm_freq": { "type": "boolean" }, "version": { "type": "integer", "description": "This number increments upon updating. Do not define it upon creation." }, "zone_name": { "type": "string", "default": "America/New_York", "description": "Indicate the time zone for reporting for the campaign. Default is America/New_York", "maxLength": 64 } }, "required": [ "ad_server_id", "advertiser_id", "end_date", "goal_type", "goal_value", "impression_cap_automatic", "name", "service_type", "start_date", "total_budget" ] } } }, "summary": "Create Campaign", "tags": [ "Campaigns" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "POST-campaigns", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Create Campaign", "security": [ { "oauth2": [] } ] } }, "/campaigns/{campaign_id}": { "get": { "operationId": "GET_campaign", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": { "ad_server_id": 2, "advertiser_id": 123264, "agency_fee_pct": 0, "connected_id_type": "DETERMINISTIC_ONLY", "conversion_type": "variable", "conversion_variable_minutes": 1, "cost_passthrough_cpm_enabled": false, "cost_passthrough_percent_enabled": false, "created_on": "2019-05-31T14:24:36+0000", "currency_code": "GBP", "dcs_data_is_campaign_level": false, "end_date": "2019-06-30T22:59:00+0000", "entity_type": "campaign", "frequency_interval": "not-applicable", "frequency_optimization": true, "frequency_type": "no-limit", "goal_type": "cpa", "goal_value": [ { "currency_code": "GBP", "value": 222 } ], "has_custom_attribution": false, "id": 123456, "impression_cap_automatic": true, "impression_cap_type": "no-limit", "initial_start_date": "2019-06-06T23:00:00+0000", "is_programmatic_guaranteed": false, "margin_pct": 4, "merit_pixel_id": 1345678, "minimize_multi_ads": false, "name": "BYOT campaign", "override_suspicious_traffic_filter": false, "pc_window_minutes": 31680, "pv_pct": 100, "pv_window_minutes": 31680, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "spend_cap_automatic": true, "spend_cap_type": "asap", "start_date": "2019-06-06T23:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": [ { "currency_code": "GBP", "value": 1000 } ], "total_impression_budget": 600, "updated_on": "2019-05-31T14:24:36+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 0, "viewability_sample_rate": "1.00", "viewability_type": "BYOV", "viewability_vendor_id": 1234, "zone_name": "Europe/London" }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "called_on": "2019-06-04T18:31:44+0000", "etag": "a616ba514bd1bd2386d63b9ac565308f0b962e74", "status": "ok" } } }, "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "accountable_and_addressable": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "ad_server_fee": { "description": "Fee charged by ad serving vendor", "type": "integer" }, "ad_server_id": { "description": "Fee charged by ad serving vendor", "type": "integer" }, "advertiser_id": { "description": "ID for a 3PAS", "type": "integer" }, "agency_fee_pct": { "type": "integer" }, "bid_min_devices": { "default": 1, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "maximum": 5, "minimum": 1, "type": "integer" }, "connected_id_type": { "enum": [ "DETERMINISTIC_ONLY", "DETERMISTIC_FIRST" ], "type": [ "null", "string" ] }, "conversion_type": { "description": "Definition for conversions per user. every = Attribute for all Merit Events. variable = Attribute one Merit Event per X minutes - set inconversion_variable_minutes one = Attribute one Merit Event per user (if conversion_type = one, then conversion_variable_minutes (integer) is required). required if goal_type in {cpa, roi}", "enum": [ "every", "one", "variable" ], "type": "string" }, "conversion_variable_minutes": { "description": "Attribute one Merit Event per X minutes, required if goal_type in {cpa, cpc, roi} && conversion_type=one", "type": "integer" }, "cost_passthrough_cpm_enabled": { "type": "boolean", "description": "Set to 1 if you want to track cpm costs in your total spend that you won't get billed for. Note - this feature is currently in closed beta - you will only be able to set this flag if you are in the closed beta and thus permissioned for this feature." }, "cost_passthrough_cpm_value": { "type": "integer", "description": "CPM value associated with your optional cost you want to track" }, "cost_passthrough_percent_enabled": { "type": "boolean", "description": "Set to 1 if you want to track % of media costs in your total spend that you won't get billed for. Note - this feature is currently in closed beta - you will only be able to set this flag if you are in the closed beta and thus permissioned for this feature." }, "cost_passthrough_percent_value": { "type": "integer", "description": "% of media value associated with your optional cost you want to track." }, "created_on": { "format": "date-time", "type": "string" }, "currency_code": { "description": "Currency setting for campaign. All strategies under this value inherit the selected currency. Once the campaign launches, it cannot be switched to another currency (aka existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).", "type": "string" }, "custom_attribution_source": { "type": "string" }, "dcs_data_is_campaign_level": { "type": "boolean" }, "device_graph_only": { "type": "boolean" }, "end_date": { "description": "Last date of campaign in GMT", "format": "date-time", "type": "string" }, "entity_type": { "enum": [ "campaign" ], "type": "string" }, "frequency_amount": { "description": "required if `frequency_type=even||asap`", "type": "integer" }, "frequency_interval": { "description": "Required if frequency_type=even||asap", "enum": [ "campaign", "day", "hour", "month", "not-applicable", "week" ], "type": "string" }, "frequency_optimization": { "type": "boolean" }, "frequency_type": { "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap", "enum": [ "asap", "even", "no-limit", "t1-optimized" ], "type": "string" }, "goal_type": { "description": "Goal type which campaign performance will be measured", "enum": [ "cpa", "cpc", "ctr", "reach", "roi", "spend", "vcpm", "vcr", "viewability-rate" ], "type": "string" }, "goal_value": { "description": "Target goal value for campaign respective to the goal_type selection. Required if goal_type in {cpa, cpc, reach, roi}", "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency codes", "type": "string" }, "value": { "type": "integer" } } } }, "has_custom_attribution": { "type": "boolean" }, "id": { "type": "integer" }, "impression_cap_amount": { "description": "Sets the amount of the available impression budget across the remaining number of days across all their strategies.", "type": "integer" }, "impression_cap_automatic": { "type": "boolean" }, "impression_cap_type": { "description": "Type of cap applied to impression budgets", "enum": [ "asap", "even", "no-limit", "t1-optimized" ], "type": "string" }, "initial_start_date": { "format": "date-time", "type": "string" }, "io_name": { "description": "Descriptive name of insertion order", "type": "string" }, "io_reference_num": { "description": "Reference number of insertion order", "type": [ "integer", "string" ] }, "is_programmatic_guaranteed": { "type": "boolean", "description": "Set to 1 if you want to run programmatic guaranteed deals assigned to strategies within this campaign. Note - this feature is currently in closed beta - you will only be able to set this flag if you are in the closed beta and thus permissioned for this feature." }, "margin_pct": { "description": "Margin percentage to be applied on campaign spend", "type": "integer" }, "merit_pixel_id": { "description": "Specify Meric Pixel that represents conversion or engagement on CPA or CPE type campaigns. Required if goal_type in {cpa, roi}", "type": "integer" }, "minimize_multi_ads": { "description": "Enabling this field will cause t1 to avoid bidding on more than one ad opportunity on a single page view across. Warning: enabling this setting may limit pacing and reduce the available inventory for the campaigns by not bidding on impression opportunities where the URL is not transparent.", "type": "boolean" }, "name": { "description": "Descriptive name of the campaign", "type": "string" }, "override_suspicious_traffic_filter": { "description": "Enabling this setting allows you to set a campaign-specific level of suspicious traffic filtering using the 'suspicious_traffic_filter_level' property. this will override the T1 default (or organizational-level, if configured) suspicious traffic filtering level.", "type": "boolean" }, "pc_window_minutes": { "description": "Post-click window for attribution. Not to be confused with pv_window_minutes. Optional if goal_type in {cpa, roi}", "type": "integer" }, "political": { "description": "Per compliance, is campaign considered political?", "default": false, "type": "boolean" }, "pv_pct": { "description": "% of post-view windows to be used for attribution", "type": "integer" }, "pv_window_minutes": { "description": "Post-view window for attribution. Required if goal_type in {cpa, roi}", "type": "integer" }, "restrict_targeting_to_deterministic_id": { "description": "This is a dis-used field, which now only allows the value 'true'.", "type": "boolean" }, "restrict_targeting_to_same_device_id": { "type": "boolean" }, "service_type": { "description": "Indicate whether campaign will be self-service or managed (managed campaigns will incur a managed service fee)", "enum": [ "MANAGED", "SELF" ], "type": "string" }, "source_campaign_id": { "type": "integer" }, "spend_cap_amount": { "description": "Spend cap amount", "type": "array", "items": { "type": "object", "properties": { "currency_code": { "maxLength": 3, "minLength": 3, "type": "string" }, "value": { "type": "integer" } } } }, "spend_cap_automatic": { "description": "Automatically sets the available spend budget across all strategies through the end date of the campaign", "type": "boolean" }, "spend_cap_type": { "description": "Type of cap applied to spend budgets", "enum": [ "asap", "even", "no-limit", "t1-optimized" ], "type": "string" }, "start_date": { "description": "Date on which the campaign will start (GMT)", "format": "date-time", "type": "string" }, "status": { "description": "Status of the campaign", "type": "boolean" }, "suspicious_traffic_filter_level": { "description": "A value between 0 and 100 that determines the sensitivity of T1 suspicious traffic filtering capabilities, If the value = 0, all fraud and suspicious traffic filtering is turned off. It will not take effect if 'override_suspicious_traffic_filter_level' is not set.", "maximum": 100, "minimum": 0, "type": "integer" }, "total_budget": { "description": "Allocated budget for the campaign", "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } } } }, "total_impression_budget": { "type": "integer" }, "updated_on": { "format": "date-time", "type": "string" }, "use_default_ad_server": { "type": "boolean" }, "use_mm_freq": { "type": "boolean" }, "version": { "type": "integer" }, "viewability_sample_rate": { "description": "Between or equal to 0.00 and 1.00", "type": "number" }, "viewability_type": { "enum": [ "AUTO_TAG", "BYOV" ], "type": "string" }, "viewability_vendor_id": { "type": "integer" }, "zone_name": { "description": "Indicate the time zone for reporting for the campaign", "type": "string" } } }, "meta": { "type": "object", "properties": { "called_on": { "format": "date-time", "type": "string" }, "etag": { "type": "string" }, "status": { "enum": [ "error", "ok" ], "type": "string" } } }, "uuid": { "type": "string" } } } } }, "summary": "Get Campaign", "tags": [ "Campaigns" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET-campaigns", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Get Campaign" }, "parameters": [ { "name": "campaign_id", "in": "path", "type": "string", "required": true } ], "post": { "consumes": [ "application/x-www-form-urlencoded" ], "operationId": "Update-campaigns", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": { "ad_server_id": 6, "advertiser_id": 122631, "agency_fee_pct": 0, "conversion_type": "variable", "conversion_variable_minutes": 1, "created_on": "2016-10-19T03:21:53+0000", "currency_code": "USD", "dcs_data_is_campaign_level": false, "end_date": "2016-11-07T23:59:00+0000", "entity_type": "campaign", "frequency_interval": "not-applicable", "frequency_optimization": false, "frequency_type": "no-limit", "goal_type": "spend", "goal_value": [ { "currency_code": "USD", "value": 2.5 } ], "has_custom_attribution": false, "id": 300982, "impression_cap_amount": 5000, "impression_cap_automatic": false, "impression_cap_type": "asap", "initial_start_date": "2016-10-19T09:00:00+0000", "io_name": "", "io_reference_num": "", "margin_pct": 0, "minimize_multi_ads": false, "name": "MobileAds Test (Round 4)", "override_suspicious_traffic_filter": false, "pv_pct": 100, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "spend_cap_amount": [ { "currency_code": "USD", "value": 5 } ], "spend_cap_automatic": false, "spend_cap_type": "asap", "start_date": "2016-10-19T09:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": [ { "currency_code": "USD", "value": 40 } ], "updated_on": "2016-11-01T07:18:56+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 5, "zone_name": "Etc/GMT" }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "called_on": "2016-11-23T19:15:16+0000", "etag": "3b15a5d063e860c3c33e2621207a12f940db04f9", "status": "ok" } } }, "schema": { "properties": { "data": { "example": { "ad_server_id": 6, "advertiser_id": 122631, "agency_fee_pct": 0, "bid_min_devices": 1, "connected_id_type": "DETERMINISTIC_ONLY", "conversion_type": "variable", "conversion_variable_minutes": 1, "created_on": "2016-10-19T03:21:53+0000", "currency_code": "USD", "custom_attribution_source": "3rd Party Attribution", "dcs_data_is_campaign_level": false, "device_graph_only": false, "end_date": "2016-11-07T23:59:00+0000", "entity_type": "campaign", "frequency_amount": 2, "frequency_interval": "not-applicable", "frequency_optimization": false, "frequency_type": "no-limit", "goal_type": "spend", "goal_value": "2.5", "has_custom_attribution": false, "id": 300982, "impression_cap_amount": 5000, "impression_cap_automatic": false, "impression_cap_type": "asap", "initial_start_date": "2016-10-19T09:00:00+0000", "io_name": "", "io_reference_num": "", "margin_pct": 0, "minimize_multi_ads": false, "name": "MobileAds Test (Round 4)", "override_suspicious_traffic_filter": false, "pv_pct": 100, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "source_campaign_id": 395863, "spend_cap_amount": 5, "spend_cap_automatic": false, "spend_cap_type": "asap", "start_date": "2016-10-19T09:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": 40, "updated_on": "2016-11-01T07:18:56+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 5, "zone_name": "Etc/GMT" }, "title": "Create Campaign", "type": "object", "x-stoplight": { "id": "campaign", "name": "Create Campaign", "public": true }, "properties": { "accountable_and_addressable": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "ad_server_fee": { "description": "Fee charged by ad serving vendor", "type": "integer" }, "ad_server_id": { "description": "The ID for a third-party ad server", "type": "integer" }, "ad_server_password": { "type": "string", "description": "Ad server password, must be equal to or less than 64" }, "ad_server_username": { "type": "string", "description": "Ad server username, must be equal to or less than 64" }, "ads_txt_verified": { "type": "string", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ] }, "advertiser_id": { "default": 512321, "description": "T1 Advertiser ID to which a campaign belongs", "type": "integer" }, "agency_fee_pct": { "type": "number", "description": "The Agency Fee Percentage (for example: 0.45)" }, "bid_min_devices": { "default": 1, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "maximum": 5, "minimum": 1, "type": "integer" }, "connected_id_type": { "enum": [ "DETERMINISTIC_FIRST", "DETERMINISTIC_ONLY" ], "type": "string" }, "conversion_type": { "description": "Definition for conversions per user.\n\nevery: Attribute all Merit Events\n\nvariable: Attribute one Merit Event per X minutes - set inconversion_variable_minutes\n\none: Attribute one Merit Event per user (if converstion_type = one, then conversion_variable_minutes (integer) is required).\n\nrequired if `goal_type in ('cpa', 'roi')`\n", "enum": [ "every", "one", "variable" ], "type": "string" }, "conversion_variable_minutes": { "description": "Attribute one Merit Event per X minutes\n\nrequired if `goal_type in ('cpa', 'cpc', 'roi') && conversion_type=one`", "type": "integer" }, "cost_passthrough_cpm_enabled": { "type": "boolean" }, "cost_passthrough_cpm_value": { "type": "number" }, "cost_passthrough_percent_enabled": { "type": "boolean" }, "cost_passthrough_percent_value": { "type": "number" }, "created_on": { "type": "string" }, "currency_code": { "default": "USD", "description": "Currency setting for campaign. All strategies under this value inherit the selected currency. Once the campaign launches, it cannot be switched to another currency (aka existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).", "type": "string" }, "custom_attribution_source": { "type": "string" }, "dcs_data_is_campaign_level": { "type": "boolean" }, "device_graph_only": { "type": "boolean" }, "eligible_for_data_sharing": { "type": "boolean" }, "end_date": { "description": "Last date of campaign in GMT", "type": "string" }, "frequency_amount": { "description": "required if `frequency_type=even||asap`", "type": "integer" }, "frequency_interval": { "description": "required if `frequency_type=even||asap`\n", "type": "string" }, "frequency_optimization": { "description": "", "type": "boolean" }, "frequency_type": { "default": "no-limit", "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "goal_alert": { "type": "number", "description": "Goal Alert Min:0 Max:100, can be decimal", "format": "float", "minimum": 0, "maximum": 100 }, "goal_category": { "type": "string", "description": "goal_category must be one of the following: 'audience', 'engagement', 'response'", "enum": [ "audience", "engagement", "response" ] }, "goal_type": { "type": "string", "description": "Goal type which campaign performance will be measured", "enum": [ "cpa", "cpc", "ctr", "reach", "roi", "spend", "vcr", "vcpm", "viewability_rate" ] }, "goal_value": { "description": "Target goal value for campaign respective to the `goal_type` selection.\n\nrequired if `goal_type` in ('cpa','cpc','reach','roi', 'vcr', 'ctr')`\n\nIf `goal_type` is 'vcr' or 'ctr' or 'viewability_rat', `goal_value` is a percentage.\n\nGoal Value max=\"9999999.9999\" min=\"0.01\", unless goal_value is a percentage in which case max=100.00", "type": "string" }, "has_custom_attribution": { "description": "", "type": "boolean" }, "id": { "description": "", "type": "integer" }, "impression_cap_amount": { "description": "Sets the amount of the available impression budget across the remaining number of days across all their strategies.", "type": "integer" }, "impression_cap_automatic": { "description": "", "type": "boolean" }, "impression_cap_type": { "default": "no-limit", "description": "Type of cap applied to impression budgets.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "initial_start_date": { "type": "string" }, "io_name": { "type": "string", "description": "Descriptive name of insertion order", "maxLength": 256 }, "io_reference_num": { "type": [ "integer", "string" ], "description": "Reference number of insertion order", "maxLength": 32 }, "is_programmatic_guaranteed": { "description": "Sets the campaign as a Programmatic Guaranteed campaign. Once set for a campaign, it cannot be changed", "type": "boolean" }, "margin_pct": { "description": "Margin percentage to be applied on campaign spend", "type": "integer" }, "merit_pixel_id": { "description": "Specify Merit Pixel that represents conversion or engagement on CPA or CPE type campaigns\n\nREQUIRED if `goal_type in ('cpa','roi')`\n\nTHIS FIELD IS OBSOLETE", "type": "integer" }, "minimize_multi_ads": { "default": 0, "description": "Enabling this field will cause T1 to avoid bidding on more than one ad opportunity on a single page view across. Warning: enabling this setting may limit pacing and reduce the available inventory for the campaigns by not bidding on impression opportunities where the URL is not transparent.", "type": "boolean" }, "name": { "description": "Descriptive name of the campaign", "type": "string" }, "override_suspicious_traffic_filter": { "default": 0, "description": "Enabling this setting allows you to set a campaign-specific level of suspicious traffic filtering using the 'suspicious_traffic_filter_level' property. This will override the T1 default (or organization-level, if configured) suspicious traffic filtering level.", "type": "boolean" }, "pacing_alert": { "description": "", "type": "number" }, "pc_window_minutes": { "description": "Post-click window for attribution. Not to be confused with pv_window_minutes.\n\noptional if `goal_type in ('cpa','roi')`\n", "type": "integer" }, "pv_pct": { "description": "Percentage of post-view windows to be used for attribution\n\noptional if `goal_type in ('cpa','roi')`", "type": "integer" }, "pv_window_minutes": { "description": "Post-view window for attribution \n\nrequired if `goal_type in ('cpa','roi')`", "type": "integer" }, "restrict_targeting_to_deterministic_id": { "type": "boolean" }, "restrict_targeting_to_same_device_id": { "type": "boolean" }, "service_type": { "description": "Indicate whether campaign will be self-service or managed (managed campaigns will incur manage service fee)", "enum": [ "MANAGED", "SELF" ], "type": "string" }, "source_campaign_id": { "type": "integer" }, "spend_cap_amount": { "description": "only required if`spend_cap_enabled`is true", "type": "integer" }, "spend_cap_automatic": { "description": "Automatically sets the available spend budget across all strategies through the end date of the campaign.", "type": "boolean" }, "spend_cap_type": { "description": "Type of cap applied to spend budgets.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "start_date": { "description": "Date on which the campaign will start (GMT)", "type": "string" }, "status": { "default": false, "description": "Status of the campaign", "type": "boolean" }, "suspicious_traffic_filter_level": { "description": "A value between 0 and 100 that determines the sensitivity of T1 suspicious traffic filtering capabilities.If the value = 0, all fraud and suspicious traffic filtering is turned off.It will not take effect if 'override_suspicious_traffic_filter_level' is not set.\n\n", "maximum": 100, "minimum": 0, "type": "integer" }, "total_budget": { "description": "Allocated budget for the campaign", "type": "integer" }, "total_impression_budget": { "description": "", "type": "integer" }, "updated_on": { "type": "string" }, "use_default_ad_server": { "type": "boolean" }, "use_mm_freq": { "type": "boolean" }, "version": { "type": "integer", "description": "This number increments upon updating. Do not define it upon creation." }, "zone_name": { "type": "string", "default": "America/New_York", "description": "Indicate the time zone for reporting for the campaign. Default is America/New_York", "maxLength": 64 } }, "required": [ "ad_server_id", "advertiser_id", "end_date", "goal_type", "goal_value", "impression_cap_automatic", "name", "service_type", "start_date", "total_budget" ] }, "uuid": { "type": "string" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } }, "type": "object" } } }, "summary": "Update Campaign", "tags": [ "Campaigns" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET-campaigns", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Update Campaign" } }, "/campaigns/{campaign_id}/budget_flights": { "get": { "operationId": "List-Budget-Flights", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" }, { "in": "query", "name": "sort_by", "type": "string" } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": [ { "campaign_id": 711426, "created_on": "2019-09-10T17:21:07+0000", "currency_code": "ARS", "end_date": "2019-09-30T23:59:00+0000", "entity_type": "budget_flight", "id": 1090230, "is_relevant": true, "name": "Budget Flights #1090230", "start_date": "2019-09-11T00:00:00+0000", "total_budget": [ { "currency_code": "ARS", "value": 5000 } ], "updated_on": "2019-09-10T17:21:07+0000", "version": 0, "zone_name": "Etc/GMT" } ], "meta": { "called_on": "2019-09-10T19:41:08+0000", "count": 1, "etag": "1bec9dbb50ed916b71fbcad8e5089736f45aa9db", "offset": 0, "status": "ok", "total_count": 1 }, "uuid": "EFBFBDDA-D402-11E9-B620-81EF702346FC" } }, "schema": { "properties": { "data": { "example": { "campaign_id": 301839, "created_on": "2016-10-20T16:32:37+0000", "currency_code": "EUR", "end_date": "2016-11-20T04:59:00+0000", "entity_type": "budget_flight", "id": 283192, "is_relevant": true, "name": "Budget Flights #283192", "start_date": "2016-10-27T04:00:00+0000", "total_budget": [ { "currency_code": "EUR", "value": 1200 } ], "updated_on": "2016-10-20T16:32:37+0000", "version": 0, "zone_name": "America/New_York" }, "title": "Budget Flight", "type": "object", "x-stoplight": { "id": "budget-flight", "name": "Budget Flight", "public": true }, "properties": { "campaign_id": { "type": "integer" }, "created_on": { "type": "string" }, "currency_code": { "type": "string", "description": "Currency setting for budget flight. All budget flights under a campaign inherit the campaign's selected currency. Once the campaign starts, it cannot be switched to another currency (existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).\n\n", "minLength": 3, "maxLength": 3 }, "end_date": { "type": "string" }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "is_relevant": { "type": "boolean", "description": "Which flight is the \"relevant\" one (0=not relevant, 1=relevant)\n\nScenarios:\n1) All budget flights are in the past: The very last budget flight for the campaign\n2) An existing budget flight has start <= now() <= end:\tSimply the flight where start <= now() <= end for the campaign\n3) now() is currently in a gap between two existing budget flights: The very next upcoming budget flight for the campaign\n4) All budget flights are in the future: The very next upcoming budget flight for the campaign" }, "name": { "type": "string" }, "start_date": { "type": "string" }, "total_budget": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string", "minLength": 3, "maxLength": 3 }, "value": { "type": "integer" } } } }, "updated_on": { "type": "string" }, "version": { "type": "integer" }, "zone_name": { "type": "string", "description": "Indicate the time zone for reporting for the campaign. All budget flights under a campaign inherit the campaign's selected zone_name.\n\n", "maxLength": 64 } } }, "uuid": { "type": "string" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } }, "type": "object" } } }, "summary": "List Budget Flights", "tags": [ "Campaigns" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET-campaigns", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "List Budget Flights\n\nQuery section:\n\"with\" accepts the following: campaign, currency\n\"sort_by\" can use any parameter in the root of the data section\nWhen \"full=* \" is not included, only entity_type, id, and name appear in the data section\n\n## **What is a Budget Flight?**\nThe concept of a Budget Flight is the combination of a given amount of budget and when it is to be spent at the campaign level. For every campaign in T1, there is initially a single budget flight. T1 campaigns can be configured to have multiple budget flights on the same campaign. Each of the budget flights can have different amounts of budget available between the start and end date. No 2 budget flights can overlap within a calendar day but there is no limit to the number of budget flights configurable on a T1 campaign and you can have time gaps between budget flights.\n\n## **How can it help me with campaign budgets in TerminalOne?**\nThis functionality may be used to alleviate some of the challenges with budget management for agencies and trading desks which may have very specific budget allocation needs resulting from recurring monthly insertion orders. Additionally, if budget levels vary by season or cycle, there would be a need to manually compute the necessary adjustments to the budget and pacing and time those configuration changes to occur at specific times. \n\nWith the ability to configure more than one budget flight on a T1 campaign, a user can simply configure separate budget flights with their allocated amount for specific months or seasonal trends." }, "parameters": [ { "in": "path", "name": "campaign_id", "required": true, "type": "integer" } ], "post": { "operationId": "CreateBudgetFlight", "parameters": [ { "in": "body", "name": "body", "schema": { "properties": { "end_date": { "type": "string" }, "start_date": { "type": "string" }, "total_budget": { "type": [ "integer", "number" ] }, "total_impression_budget": { "description": "Allocated impression budget for the campaign.\t", "type": "integer" } }, "required": [ "start_date", "end_date", "total_budget" ], "type": "object" } }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": { "ad_server_id": 6, "advertiser_id": 122631, "agency_fee_pct": 0, "conversion_type": "variable", "conversion_variable_minutes": 1, "created_on": "2016-10-19T03:21:53+0000", "currency_code": "USD", "dcs_data_is_campaign_level": false, "end_date": "2016-11-07T23:59:00+0000", "entity_type": "campaign", "frequency_interval": "not-applicable", "frequency_optimization": false, "frequency_type": "no-limit", "goal_type": "spend", "goal_value": [ { "currency_code": "USD", "value": 2.5 } ], "has_custom_attribution": false, "id": 300982, "impression_cap_amount": 5000, "impression_cap_automatic": false, "impression_cap_type": "asap", "initial_start_date": "2016-10-19T09:00:00+0000", "io_name": "", "io_reference_num": "", "margin_pct": 0, "minimize_multi_ads": false, "name": "MobileAds Test (Round 4)", "override_suspicious_traffic_filter": false, "pv_pct": 100, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "spend_cap_amount": [ { "currency_code": "USD", "value": 5 } ], "spend_cap_automatic": false, "spend_cap_type": "asap", "start_date": "2016-10-19T09:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": [ { "currency_code": "USD", "value": 40 } ], "updated_on": "2016-11-01T07:18:56+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 5, "zone_name": "Etc/GMT" }, "meta": { "called_on": "2016-11-23T19:15:16+0000", "etag": "3b15a5d063e860c3c33e2621207a12f940db04f9", "status": "ok" } } }, "schema": { "properties": { "data": { "example": { "campaign_id": 301839, "created_on": "2016-10-20T16:32:37+0000", "currency_code": "EUR", "end_date": "2016-11-20T04:59:00+0000", "entity_type": "budget_flight", "id": 283192, "is_relevant": true, "name": "Budget Flights #283192", "start_date": "2016-10-27T04:00:00+0000", "total_budget": [ { "currency_code": "EUR", "value": 1200 } ], "updated_on": "2016-10-20T16:32:37+0000", "version": 0, "zone_name": "America/New_York" }, "title": "Budget Flight", "type": "object", "x-stoplight": { "id": "budget-flight", "name": "Budget Flight", "public": true }, "properties": { "campaign_id": { "type": "integer" }, "created_on": { "type": "string" }, "currency_code": { "type": "string", "description": "Currency setting for budget flight. All budget flights under a campaign inherit the campaign's selected currency. Once the campaign starts, it cannot be switched to another currency (existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).\n\n", "minLength": 3, "maxLength": 3 }, "end_date": { "type": "string" }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "is_relevant": { "type": "boolean", "description": "Which flight is the \"relevant\" one (0=not relevant, 1=relevant)\n\nScenarios:\n1) All budget flights are in the past: The very last budget flight for the campaign\n2) An existing budget flight has start <= now() <= end:\tSimply the flight where start <= now() <= end for the campaign\n3) now() is currently in a gap between two existing budget flights: The very next upcoming budget flight for the campaign\n4) All budget flights are in the future: The very next upcoming budget flight for the campaign" }, "name": { "type": "string" }, "start_date": { "type": "string" }, "total_budget": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string", "minLength": 3, "maxLength": 3 }, "value": { "type": "integer" } } } }, "updated_on": { "type": "string" }, "version": { "type": "integer" }, "zone_name": { "type": "string", "description": "Indicate the time zone for reporting for the campaign. All budget flights under a campaign inherit the campaign's selected zone_name.\n\n", "maxLength": 64 } } }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } }, "type": "object" } } }, "summary": "Create Budget Flight", "tags": [ "Campaigns" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET-campaigns", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Create Budget Flight\n\n## **What is a Budget Flight?**\nThe concept of a Budget Flight is the combination of a given amount of budget and when it is to be spent at the campaign level. For every campaign in T1, there is initially a single budget flight. T1 campaigns can be configured to have multiple budget flights on the same campaign. Each of the budget flights can have different amounts of budget available between the start and end date. No 2 budget flights can overlap within a calendar day but there is no limit to the number of budget flights configurable on a T1 campaign and you can have time gaps between budget flights.\n\n## **How can it help me with campaign budgets in TerminalOne?**\nThis functionality may be used to alleviate some of the challenges with budget management for agencies and trading desks which may have very specific budget allocation needs resulting from recurring monthly insertion orders. Additionally, if budget levels vary by season or cycle, there would be a need to manually compute the necessary adjustments to the budget and pacing and time those configuration changes to occur at specific times. " } }, "/campaigns/{campaign_id}/budget_flights/bulk": { "parameters": [ { "in": "path", "name": "campaign_id", "required": true, "type": "integer" } ], "post": { "consumes": [ "application/x-www-form-urlencoded" ], "operationId": "bulk-create-budget-flights", "parameters": [ { "in": "formData", "name": "budget_flights.[x].start_date", "required": true, "type": "string" }, { "in": "formData", "name": "budget_flights.[x].end_date", "required": true, "type": "string" }, { "in": "formData", "name": "budget_flights.[x].total_budget", "required": true, "type": "integer" }, { "description": "Allocated impression budget for the campaign.\t", "in": "formData", "name": "budget_flights.[x].total_impression_budget", "type": "integer" }, { "in": "formData", "name": "budget_flights.[x].version", "type": "integer" }, { "description": "Update existing flight if positive id is supplied. Delete existing flight if negative. If id is not supplied, create new flight.", "in": "formData", "name": "budget_flights.[x].id", "type": "integer" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": [ { "ad_server_id": 6, "advertiser_id": 122631, "agency_fee_pct": 0, "conversion_type": "variable", "conversion_variable_minutes": 1, "created_on": "2016-10-19T03:21:53+0000", "currency_code": "USD", "dcs_data_is_campaign_level": false, "end_date": "2016-11-07T23:59:00+0000", "entity_type": "campaign", "frequency_interval": "not-applicable", "frequency_optimization": false, "frequency_type": "no-limit", "goal_type": "spend", "goal_value": [ { "currency_code": "USD", "value": 2.5 } ], "has_custom_attribution": false, "id": 300982, "impression_cap_amount": 5000, "impression_cap_automatic": false, "impression_cap_type": "asap", "initial_start_date": "2016-10-19T09:00:00+0000", "io_name": "", "io_reference_num": "", "margin_pct": 0, "minimize_multi_ads": false, "name": "MobileAds Test (Round 4)", "override_suspicious_traffic_filter": false, "pv_pct": 100, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "spend_cap_amount": [ { "currency_code": "USD", "value": 5 } ], "spend_cap_automatic": false, "spend_cap_type": "asap", "start_date": "2016-10-19T09:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": [ { "currency_code": "USD", "value": 40 } ], "updated_on": "2016-11-01T07:18:56+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 5, "zone_name": "Etc/GMT" } ], "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "called_on": "2016-11-23T19:15:16+0000", "etag": "3b15a5d063e860c3c33e2621207a12f940db04f9", "status": "ok" } } }, "schema": { "properties": { "data": { "items": { "example": { "campaign_id": 301839, "created_on": "2016-10-20T16:32:37+0000", "currency_code": "EUR", "end_date": "2016-11-20T04:59:00+0000", "entity_type": "budget_flight", "id": 283192, "is_relevant": true, "name": "Budget Flights #283192", "start_date": "2016-10-27T04:00:00+0000", "total_budget": [ { "currency_code": "EUR", "value": 1200 } ], "updated_on": "2016-10-20T16:32:37+0000", "version": 0, "zone_name": "America/New_York" }, "title": "Budget Flight", "type": "object", "x-stoplight": { "id": "budget-flight", "name": "Budget Flight", "public": true }, "properties": { "campaign_id": { "type": "integer" }, "created_on": { "type": "string" }, "currency_code": { "type": "string", "description": "Currency setting for budget flight. All budget flights under a campaign inherit the campaign's selected currency. Once the campaign starts, it cannot be switched to another currency (existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).\n\n", "minLength": 3, "maxLength": 3 }, "end_date": { "type": "string" }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "is_relevant": { "type": "boolean", "description": "Which flight is the \"relevant\" one (0=not relevant, 1=relevant)\n\nScenarios:\n1) All budget flights are in the past: The very last budget flight for the campaign\n2) An existing budget flight has start <= now() <= end:\tSimply the flight where start <= now() <= end for the campaign\n3) now() is currently in a gap between two existing budget flights: The very next upcoming budget flight for the campaign\n4) All budget flights are in the future: The very next upcoming budget flight for the campaign" }, "name": { "type": "string" }, "start_date": { "type": "string" }, "total_budget": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string", "minLength": 3, "maxLength": 3 }, "value": { "type": "integer" } } } }, "updated_on": { "type": "string" }, "version": { "type": "integer" }, "zone_name": { "type": "string", "description": "Indicate the time zone for reporting for the campaign. All budget flights under a campaign inherit the campaign's selected zone_name.\n\n", "maxLength": 64 } } }, "type": "array" }, "uuid": { "type": "string" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } }, "type": "object" } } }, "summary": "Bulk Create Budget Flights", "tags": [ "Campaigns" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET-campaigns", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Bulk Create Budget Flights\n\n## **What is a Budget Flight?**\nThe concept of a Budget Flight is the combination of a given amount of budget and when it is to be spent at the campaign level. For every campaign in T1, there is initially a single budget flight. T1 campaigns can be configured to have multiple budget flights on the same campaign. Each of the budget flights can have different amounts of budget available between the start and end date. No 2 budget flights can overlap within a calendar day but there is no limit to the number of budget flights configurable on a T1 campaign and you can have time gaps between budget flights.\n\n## **How can it help me with campaign budgets in TerminalOne?**\nThis functionality may be used to alleviate some of the challenges with budget management for agencies and trading desks which may have very specific budget allocation needs resulting from recurring monthly insertion orders. Additionally, if budget levels vary by season or cycle, there would be a need to manually compute the necessary adjustments to the budget and pacing and time those configuration changes to occur at specific times. " } }, "/campaigns/{campaign_id}/budget_flights/{budget_flight_id}": { "get": { "operationId": "Get-Budget-Flight", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" }, { "in": "query", "name": "sort_by", "type": "string" } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": { "campaign_id": 683110, "created_on": "2019-05-30T07:44:38+0000", "currency_code": "USD", "end_date": "2019-06-29T23:59:00+0000", "entity_type": "budget_flight", "id": 1018873, "is_relevant": true, "name": "Budget Flights #1018873", "start_date": "2019-06-06T00:00:00+0000", "total_budget": [ { "currency_code": "USD", "value": 12 } ], "total_impression_budget": 32, "updated_on": "2019-05-30T07:44:38+0000", "version": 0, "zone_name": "Etc/GMT" }, "meta": { "called_on": "2019-05-30T19:31:13+0000", "etag": "272d7f1a0725ed44cbe2afb7be98d0201f36e7e0", "status": "ok" }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B" } }, "schema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "campaign_id": { "type": "integer" }, "created_on": { "format": "date-time", "type": "string" }, "currency_code": { "description": "Currency setting for budget flight. All budget flights under a campaign inherit the campaign's selected currency. Once the campaign starts, it cannot be switched to another currency (existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).", "type": "string" }, "end_date": { "type": "string", "format": "date-time" }, "entity_type": { "type": "string", "enum": [ "budget_flight" ] }, "id": { "type": "integer" }, "is_relevant": { "type": "boolean", "description": "Which flight is the \"relevant\" one (0=not relevant, 1=relevant)\n\nScenarios:\n1) All budget flights are in the past: The very last budget flight for the campaign\n2) An existing budget flight has start <= now() <= end:\tSimply the flight where start <= now() <= end for the campaign\n3) now() is currently in a gap between two existing budget flights: The very next upcoming budget flight for the campaign\n4) All budget flights are in the future: The very next upcoming budget flight for the campaign" }, "name": { "type": "string" }, "start_date": { "type": "string", "format": "date-time" }, "total_budget": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string", "minLength": 3, "maxLength": 3 }, "value": { "type": "integer" } } } }, "total_impression_budget": { "type": "integer" }, "updated_on": { "format": "date-time", "type": "string" }, "version": { "type": "integer" }, "zone_name": { "type": "string", "description": "Indicate the time zone for reporting for the campaign. All budget flights under a campaign inherit the campaign's selected zone_name.", "maxLength": 64 } } }, "meta": { "type": "object", "properties": { "called_on": { "format": "date-time", "type": "string" }, "etag": { "type": "string" }, "status": { "enum": [ "ok" ], "type": "string" } } }, "uuid": { "type": "string", "format": "uuid" } } } } }, "summary": "Get Budget Flight", "tags": [ "Campaigns" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET-campaigns", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Get Budget Flight\n\n\n## **What is a Budget Flight?**\nThe concept of a Budget Flight is the combination of a given amount of budget and when it is to be spent at the campaign level. For every campaign in T1, there is initially a single budget flight. T1 campaigns can be configured to have multiple budget flights on the same campaign. Each of the budget flights can have different amounts of budget available between the start and end date. No 2 budget flights can overlap within a calendar day but there is no limit to the number of budget flights configurable on a T1 campaign and you can have time gaps between budget flights.\n\n## **How can it help me with campaign budgets in TerminalOne?**\nThis functionality may be used to alleviate some of the challenges with budget management for agencies and trading desks which may have very specific budget allocation needs resulting from recurring monthly insertion orders. Additionally, if budget levels vary by season or cycle, there would be a need to manually compute the necessary adjustments to the budget and pacing and time those configuration changes to occur at specific times. " }, "parameters": [ { "in": "path", "name": "campaign_id", "required": true, "type": "integer" }, { "in": "path", "name": "budget_flight_id", "required": true, "type": "string" } ], "post": { "consumes": [ "application/x-www-form-urlencoded" ], "operationId": "POST-update-budget-flight", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "responses": { "200": { "description": "", "schema": { "properties": { "data": { "example": { "campaign_id": 301839, "created_on": "2016-10-20T16:32:37+0000", "currency_code": "EUR", "end_date": "2016-11-20T04:59:00+0000", "entity_type": "budget_flight", "id": 283192, "is_relevant": true, "name": "Budget Flights #283192", "start_date": "2016-10-27T04:00:00+0000", "total_budget": [ { "currency_code": "EUR", "value": 1200 } ], "updated_on": "2016-10-20T16:32:37+0000", "version": 0, "zone_name": "America/New_York" }, "title": "Budget Flight", "type": "object", "x-stoplight": { "id": "budget-flight", "name": "Budget Flight", "public": true }, "properties": { "campaign_id": { "type": "integer" }, "created_on": { "type": "string" }, "currency_code": { "type": "string", "description": "Currency setting for budget flight. All budget flights under a campaign inherit the campaign's selected currency. Once the campaign starts, it cannot be switched to another currency (existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).\n\n", "minLength": 3, "maxLength": 3 }, "end_date": { "type": "string" }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "is_relevant": { "type": "boolean", "description": "Which flight is the \"relevant\" one (0=not relevant, 1=relevant)\n\nScenarios:\n1) All budget flights are in the past: The very last budget flight for the campaign\n2) An existing budget flight has start <= now() <= end:\tSimply the flight where start <= now() <= end for the campaign\n3) now() is currently in a gap between two existing budget flights: The very next upcoming budget flight for the campaign\n4) All budget flights are in the future: The very next upcoming budget flight for the campaign" }, "name": { "type": "string" }, "start_date": { "type": "string" }, "total_budget": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "type": "string", "minLength": 3, "maxLength": 3 }, "value": { "type": "integer" } } } }, "updated_on": { "type": "string" }, "version": { "type": "integer" }, "zone_name": { "type": "string", "description": "Indicate the time zone for reporting for the campaign. All budget flights under a campaign inherit the campaign's selected zone_name.\n\n", "maxLength": 64 } } }, "uuid": { "type": "string" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } }, "type": "object" } } }, "summary": "Update Budget Flight", "tags": [ "Campaigns" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "POST-update-budget-flight", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Update Budget Flight\n\n## **What is a Budget Flight?**\nThe concept of a Budget Flight is the combination of a given amount of budget and when it is to be spent at the campaign level. For every campaign in T1, there is initially a single budget flight. T1 campaigns can be configured to have multiple budget flights on the same campaign. Each of the budget flights can have different amounts of budget available between the start and end date. No 2 budget flights can overlap within a calendar day but there is no limit to the number of budget flights configurable on a T1 campaign and you can have time gaps between budget flights.\n\n## **How can it help me with campaign budgets in TerminalOne?**\nThis functionality may be used to alleviate some of the challenges with budget management for agencies and trading desks which may have very specific budget allocation needs resulting from recurring monthly insertion orders. Additionally, if budget levels vary by season or cycle, there would be a need to manually compute the necessary adjustments to the budget and pacing and time those configuration changes to occur at specific times. " } }, "/campaigns/{campaign_id}/budget_flights/{budget_flight_id}/delete": { "parameters": [ { "in": "path", "name": "campaign_id", "required": true, "type": "integer" }, { "in": "path", "name": "budget_flight_id", "required": true, "type": "string" } ], "post": { "consumes": [ "application/x-www-form-urlencoded" ], "operationId": "POST_campaigns-campaign_id-budget_flights-id-delete", "parameters": [ { "in": "formData", "name": "version", "type": "string" }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": { "ad_server_id": 6, "advertiser_id": 122631, "agency_fee_pct": 0, "conversion_type": "variable", "conversion_variable_minutes": 1, "created_on": "2016-10-19T03:21:53+0000", "currency_code": "USD", "dcs_data_is_campaign_level": false, "end_date": "2016-11-07T23:59:00+0000", "entity_type": "campaign", "frequency_interval": "not-applicable", "frequency_optimization": false, "frequency_type": "no-limit", "goal_type": "spend", "goal_value": [ { "currency_code": "USD", "value": 2.5 } ], "has_custom_attribution": false, "id": 300982, "impression_cap_amount": 5000, "impression_cap_automatic": false, "impression_cap_type": "asap", "initial_start_date": "2016-10-19T09:00:00+0000", "io_name": "", "io_reference_num": "", "margin_pct": 0, "minimize_multi_ads": false, "name": "MobileAds Test (Round 4)", "override_suspicious_traffic_filter": false, "pv_pct": 100, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "spend_cap_amount": [ { "currency_code": "USD", "value": 5 } ], "spend_cap_automatic": false, "spend_cap_type": "asap", "start_date": "2016-10-19T09:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": [ { "currency_code": "USD", "value": 40 } ], "updated_on": "2016-11-01T07:18:56+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 5, "zone_name": "Etc/GMT" }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "called_on": "2016-11-23T19:15:16+0000", "etag": "3b15a5d063e860c3c33e2621207a12f940db04f9", "status": "ok" } } }, "schema": { "properties": { "data": { "example": { "ad_server_id": 6, "advertiser_id": 122631, "agency_fee_pct": 0, "bid_min_devices": 1, "connected_id_type": "DETERMINISTIC_ONLY", "conversion_type": "variable", "conversion_variable_minutes": 1, "created_on": "2016-10-19T03:21:53+0000", "currency_code": "USD", "custom_attribution_source": "3rd Party Attribution", "dcs_data_is_campaign_level": false, "device_graph_only": false, "end_date": "2016-11-07T23:59:00+0000", "entity_type": "campaign", "frequency_amount": 2, "frequency_interval": "not-applicable", "frequency_optimization": false, "frequency_type": "no-limit", "goal_type": "spend", "goal_value": "2.5", "has_custom_attribution": false, "id": 300982, "impression_cap_amount": 5000, "impression_cap_automatic": false, "impression_cap_type": "asap", "initial_start_date": "2016-10-19T09:00:00+0000", "io_name": "", "io_reference_num": "", "margin_pct": 0, "minimize_multi_ads": false, "name": "MobileAds Test (Round 4)", "override_suspicious_traffic_filter": false, "pv_pct": 100, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "source_campaign_id": 395863, "spend_cap_amount": 5, "spend_cap_automatic": false, "spend_cap_type": "asap", "start_date": "2016-10-19T09:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": 40, "updated_on": "2016-11-01T07:18:56+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 5, "zone_name": "Etc/GMT" }, "title": "Create Campaign", "type": "object", "x-stoplight": { "id": "campaign", "name": "Create Campaign", "public": true }, "properties": { "accountable_and_addressable": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "ad_server_fee": { "description": "Fee charged by ad serving vendor", "type": "integer" }, "ad_server_id": { "description": "The ID for a third-party ad server", "type": "integer" }, "ad_server_password": { "type": "string", "description": "Ad server password, must be equal to or less than 64" }, "ad_server_username": { "type": "string", "description": "Ad server username, must be equal to or less than 64" }, "ads_txt_verified": { "type": "string", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ] }, "advertiser_id": { "default": 512321, "description": "T1 Advertiser ID to which a campaign belongs", "type": "integer" }, "agency_fee_pct": { "type": "number", "description": "The Agency Fee Percentage (for example: 0.45)" }, "bid_min_devices": { "default": 1, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "maximum": 5, "minimum": 1, "type": "integer" }, "connected_id_type": { "enum": [ "DETERMINISTIC_FIRST", "DETERMINISTIC_ONLY" ], "type": "string" }, "conversion_type": { "description": "Definition for conversions per user.\n\nevery: Attribute all Merit Events\n\nvariable: Attribute one Merit Event per X minutes - set inconversion_variable_minutes\n\none: Attribute one Merit Event per user (if converstion_type = one, then conversion_variable_minutes (integer) is required).\n\nrequired if `goal_type in ('cpa', 'roi')`\n", "enum": [ "every", "one", "variable" ], "type": "string" }, "conversion_variable_minutes": { "description": "Attribute one Merit Event per X minutes\n\nrequired if `goal_type in ('cpa', 'cpc', 'roi') && conversion_type=one`", "type": "integer" }, "cost_passthrough_cpm_enabled": { "type": "boolean" }, "cost_passthrough_cpm_value": { "type": "number" }, "cost_passthrough_percent_enabled": { "type": "boolean" }, "cost_passthrough_percent_value": { "type": "number" }, "created_on": { "type": "string" }, "currency_code": { "default": "USD", "description": "Currency setting for campaign. All strategies under this value inherit the selected currency. Once the campaign launches, it cannot be switched to another currency (aka existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).", "type": "string" }, "custom_attribution_source": { "type": "string" }, "dcs_data_is_campaign_level": { "type": "boolean" }, "device_graph_only": { "type": "boolean" }, "eligible_for_data_sharing": { "type": "boolean" }, "end_date": { "description": "Last date of campaign in GMT", "type": "string" }, "frequency_amount": { "description": "required if `frequency_type=even||asap`", "type": "integer" }, "frequency_interval": { "description": "required if `frequency_type=even||asap`\n", "type": "string" }, "frequency_optimization": { "description": "", "type": "boolean" }, "frequency_type": { "default": "no-limit", "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "goal_alert": { "type": "number", "description": "Goal Alert Min:0 Max:100, can be decimal", "format": "float", "minimum": 0, "maximum": 100 }, "goal_category": { "type": "string", "description": "goal_category must be one of the following: 'audience', 'engagement', 'response'", "enum": [ "audience", "engagement", "response" ] }, "goal_type": { "type": "string", "description": "Goal type which campaign performance will be measured", "enum": [ "cpa", "cpc", "ctr", "reach", "roi", "spend", "vcr", "vcpm", "viewability_rate" ] }, "goal_value": { "description": "Target goal value for campaign respective to the `goal_type` selection.\n\nrequired if `goal_type` in ('cpa','cpc','reach','roi', 'vcr', 'ctr')`\n\nIf `goal_type` is 'vcr' or 'ctr' or 'viewability_rat', `goal_value` is a percentage.\n\nGoal Value max=\"9999999.9999\" min=\"0.01\", unless goal_value is a percentage in which case max=100.00", "type": "string" }, "has_custom_attribution": { "description": "", "type": "boolean" }, "id": { "description": "", "type": "integer" }, "impression_cap_amount": { "description": "Sets the amount of the available impression budget across the remaining number of days across all their strategies.", "type": "integer" }, "impression_cap_automatic": { "description": "", "type": "boolean" }, "impression_cap_type": { "default": "no-limit", "description": "Type of cap applied to impression budgets.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "initial_start_date": { "type": "string" }, "io_name": { "type": "string", "description": "Descriptive name of insertion order", "maxLength": 256 }, "io_reference_num": { "type": [ "integer", "string" ], "description": "Reference number of insertion order", "maxLength": 32 }, "is_programmatic_guaranteed": { "description": "Sets the campaign as a Programmatic Guaranteed campaign. Once set for a campaign, it cannot be changed", "type": "boolean" }, "margin_pct": { "description": "Margin percentage to be applied on campaign spend", "type": "integer" }, "merit_pixel_id": { "description": "Specify Merit Pixel that represents conversion or engagement on CPA or CPE type campaigns\n\nREQUIRED if `goal_type in ('cpa','roi')`\n\nTHIS FIELD IS OBSOLETE", "type": "integer" }, "minimize_multi_ads": { "default": 0, "description": "Enabling this field will cause T1 to avoid bidding on more than one ad opportunity on a single page view across. Warning: enabling this setting may limit pacing and reduce the available inventory for the campaigns by not bidding on impression opportunities where the URL is not transparent.", "type": "boolean" }, "name": { "description": "Descriptive name of the campaign", "type": "string" }, "override_suspicious_traffic_filter": { "default": 0, "description": "Enabling this setting allows you to set a campaign-specific level of suspicious traffic filtering using the 'suspicious_traffic_filter_level' property. This will override the T1 default (or organization-level, if configured) suspicious traffic filtering level.", "type": "boolean" }, "pacing_alert": { "description": "", "type": "number" }, "pc_window_minutes": { "description": "Post-click window for attribution. Not to be confused with pv_window_minutes.\n\noptional if `goal_type in ('cpa','roi')`\n", "type": "integer" }, "pv_pct": { "description": "Percentage of post-view windows to be used for attribution\n\noptional if `goal_type in ('cpa','roi')`", "type": "integer" }, "pv_window_minutes": { "description": "Post-view window for attribution \n\nrequired if `goal_type in ('cpa','roi')`", "type": "integer" }, "restrict_targeting_to_deterministic_id": { "type": "boolean" }, "restrict_targeting_to_same_device_id": { "type": "boolean" }, "service_type": { "description": "Indicate whether campaign will be self-service or managed (managed campaigns will incur manage service fee)", "enum": [ "MANAGED", "SELF" ], "type": "string" }, "source_campaign_id": { "type": "integer" }, "spend_cap_amount": { "description": "only required if`spend_cap_enabled`is true", "type": "integer" }, "spend_cap_automatic": { "description": "Automatically sets the available spend budget across all strategies through the end date of the campaign.", "type": "boolean" }, "spend_cap_type": { "description": "Type of cap applied to spend budgets.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "start_date": { "description": "Date on which the campaign will start (GMT)", "type": "string" }, "status": { "default": false, "description": "Status of the campaign", "type": "boolean" }, "suspicious_traffic_filter_level": { "description": "A value between 0 and 100 that determines the sensitivity of T1 suspicious traffic filtering capabilities.If the value = 0, all fraud and suspicious traffic filtering is turned off.It will not take effect if 'override_suspicious_traffic_filter_level' is not set.\n\n", "maximum": 100, "minimum": 0, "type": "integer" }, "total_budget": { "description": "Allocated budget for the campaign", "type": "integer" }, "total_impression_budget": { "description": "", "type": "integer" }, "updated_on": { "type": "string" }, "use_default_ad_server": { "type": "boolean" }, "use_mm_freq": { "type": "boolean" }, "version": { "type": "integer", "description": "This number increments upon updating. Do not define it upon creation." }, "zone_name": { "type": "string", "default": "America/New_York", "description": "Indicate the time zone for reporting for the campaign. Default is America/New_York", "maxLength": 64 } }, "required": [ "ad_server_id", "advertiser_id", "end_date", "goal_type", "goal_value", "impression_cap_automatic", "name", "service_type", "start_date", "total_budget" ] }, "uuid": { "type": "string" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } }, "type": "object" } } }, "summary": "Delete Budget Flights", "tags": [ "Campaigns" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "POST_campaigns-campaignid-budgetflights-id-delete", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Delete Budget Flights\n\n## **What is a Budget Flight?**\nThe concept of a Budget Flight is the combination of a given amount of budget and when it is to be spent at the campaign level. For every campaign in T1, there is initially a single budget flight. T1 campaigns can be configured to have multiple budget flights on the same campaign. Each of the budget flights can have different amounts of budget available between the start and end date. No 2 budget flights can overlap within a calendar day but there is no limit to the number of budget flights configurable on a T1 campaign and you can have time gaps between budget flights.\n\n## **How can it help me with campaign budgets in TerminalOne?**\nThis functionality may be used to alleviate some of the challenges with budget management for agencies and trading desks which may have very specific budget allocation needs resulting from recurring monthly insertion orders. Additionally, if budget levels vary by season or cycle, there would be a need to manually compute the necessary adjustments to the budget and pacing and time those configuration changes to occur at specific times. " } }, "/campaigns/{campaign_id}/bulk_edits": { "get": { "operationId": "GET_campaigns-campaign_id-bulk_edits", "responses": { "200": { "description": "", "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "created_on": { "format": "date-time", "type": "string" }, "entity_type": { "enum": [ "bulk_editor" ], "type": "string" }, "errors": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "state": { "enum": [ "closed", "failed", "open", "pending" ], "type": "string" }, "updated_on": { "type": "string" }, "user_id": { "type": "integer" } } } }, "meta": { "type": "object", "properties": { "called_on": { "format": "date-time", "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "enum": [ "ok" ], "type": "string" }, "total_count": { "type": "integer" } } }, "uuid": { "format": "uuid", "type": "string" } } }, "examples": { "application/vnd.mediamath.v1+json": { "data": [ { "errors": "[]", "created_on": "2019-06-10T19:50:38+0000", "entity_type": "bulk_editor", "name": "campaigns.id(686299)", "user_id": 29466, "id": 155318, "state": "open", "updated_on": "2019-06-10T19:50:38+0000" } ], "uuid": "132276BA-D407-11E9-BB86-F2D3AAC0597C", "meta": { "etag": "2a9d730d3af4fdc723279cb81124253a54c818b5", "count": 1, "called_on": "2019-09-10T20:10:46+0000", "status": "ok", "offset": 0, "total_count": 1 } } } } }, "summary": "List Bulk Editors", "tags": [ "Campaign Bulk Editor" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET_campaigns-campaignid-bulkedits", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "List Bulk Editors\n\nQuery section:\n\"with\" accepts the following: user, but none of the other standard query parameters (full, page_limit, page_offset, q, sort_by) work with this endpoint\n\n", "parameters": [ { "in": "query", "name": "with", "type": "string" } ] }, "parameters": [ { "in": "path", "name": "campaign_id", "required": true, "type": "string" } ], "post": { "description": "The query param `create_and_execute` defines if we have to pass the data parameter in the request body. If this query param is set to `true` or `1` then we must pass the data in the request body", "operationId": "POST_campaigns-campaign_id-bulk_edits", "parameters": [ { "in": "query", "name": "create_and_execute", "type": "boolean" } ], "responses": { "200": { "description": "", "schema": {} } }, "summary": "Create Bulk Editor", "tags": [ "Campaign Bulk Editor" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "POST_campaigns-campaignid-bulkedits", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true } } }, "/campaigns/{campaign_id}/bulk_edits/{bulk_editor_id}/actions": { "delete": { "operationId": "DELETE_campaigns-campaign_id-bulk_edits-bulk_editor_id-actions", "parameters": [ { "default": "(1,2,3)", "in": "query", "name": "action_ids", "type": "string" }, { "default": "concepts", "description": "", "in": "query", "name": "tag", "type": "string" } ], "responses": { "200": { "description": "", "schema": {} } }, "summary": "Delete Bulk Editor Actions", "tags": [ "Campaign Bulk Editor" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "DELETE_campaigns-campaignid-bulkedits-bulkeditorid-actions", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Delete Bulk Editor Actions" }, "get": { "operationId": "GET_campaigns-campaign_id-bulk_edits-bulk_editor_id-actions", "responses": { "200": { "description": "The schema can vary greatly depending on the action.\nThe object in data can be: {add, remove, update, overwrite}, and there can be multiples of them. \ncollection can be {concepts, taregt_values, pixel_bundles}. \ntag can be {concepts, location, mydata, pixel_bundles}. \nParameters besides id and collections in the data add/remove/update/overwrite object include:\n {action_id, exclude, exclude_flag, frequency_count, recency_minutes, target_op}\n\nThe example below is not a real one; I created it to show different combinations of the varied schema.\n", "examples": { "application/vnd.mediamath.v1+json": { "data": [ { "add": { "id": 1305882, "collection": "pixel_bundles", "exclude_flag": 0 }, "tag": "mydata", "collection": "strategies", "action_id": 399402 }, { "overwrite": { "id": 1704457, "collection": "concepts" }, "tag": "concepts", "collection": "strategies", "action_id": 399386 }, { "remove": { "id": 100756, "collection": "target_values", "target_op": "OR", "exclude": 1 }, "tag": "location", "collection": "strategies", "action_id": 399388 }, { "add": { "id": 1319331, "collection": "pixel_bundles", "exclude_flag": 0 }, "tag": "mydata", "collection": "strategies", "action_id": 399405 }, { "overwrite": { "id": 724983, "collection": "target_values", "target_op": "OR", "exclude": 0 }, "tag": "location", "collection": "strategies", "action_id": 399401 }, { "add": { "id": 1319333, "collection": "pixel_bundles", "exclude_flag": 0 }, "tag": "mydata", "collection": "strategies", "action_id": 399407 }, { "add": { "id": 1319335, "collection": "pixel_bundles", "exclude_flag": 0 }, "tag": "mydata", "collection": "strategies", "action_id": 399408 }, { "add": { "id": 1319337, "collection": "pixel_bundles", "exclude_flag": 0 }, "tag": "mydata", "collection": "strategies", "action_id": 399409 }, { "add": { "id": 1319338, "collection": "pixel_bundles", "exclude_flag": 0 }, "tag": "mydata", "collection": "strategies", "action_id": 399410 }, { "add": { "id": 1319339, "collection": "pixel_bundles", "exclude_flag": 0 }, "tag": "mydata", "collection": "strategies", "action_id": 399411 } ], "uuid": "FC237A6C-D637-11E9-ABA4-734C27D76BB8", "meta": { "etag": "64ce11b4bc59610a0e7a05a2cfa9e7fbd21869a3", "count": 10, "called_on": "2019-09-13T15:05:55+0000", "status": "ok", "offset": 0, "total_count": 0 } } }, "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "action_id": { "type": "integer" }, "add": { "type": "object", "properties": { "collection": { "type": "string" }, "exclude_flag": { "type": "integer" }, "id": { "type": "integer" } } }, "collection": { "type": "string" }, "tag": { "type": "string" } } } }, "meta": { "type": "object", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } } }, "uuid": { "type": "string" } } } } }, "summary": "Get Bulk Editor Actions", "tags": [ "Campaign Bulk Editor" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET_campaigns-campaignid-bulkedits-bulkeditorid-actions", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Get Bulk Editor Actions\n" }, "parameters": [ { "in": "path", "name": "campaign_id", "required": true, "type": "string" }, { "in": "path", "name": "bulk_editor_id", "required": true, "type": "string" } ], "post": { "operationId": "POST_campaigns-campaign_id-bulk_edits-bulk_editor_id-actions", "parameters": [ { "in": "body", "name": "body", "schema": { "items": { "example": [ { "add": { "collection": "concepts", "id": 100001 }, "collection": "strategies", "tag": "concepts" }, { "add": { "collection": "concepts", "id": 100002 }, "collection": "strategies", "tag": "concepts" }, { "collection": "strategies", "overwrite": { "collection": "target_values", "exclude": false, "id": 100001 }, "tag": "location" }, { "collection": "strategies", "overwrite": { "collection": "target_values", "exclude": false, "id": 100003 }, "tag": "location" }, { "collection": "strategies", "overwrite": { "collection": "target_values", "exclude": true, "id": 100002 }, "tag": "location" }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100001 }, "tag": "location" }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100002 }, "tag": "location" }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100003 }, "tag": "location" }, { "collection": "strategies", "tag": "details" } ], "items": { "properties": { "collection": { "type": "string" }, "overwrite": { "properties": { "collection": { "type": "string" }, "exclude": { "type": "boolean" }, "id": { "type": "integer" } }, "type": "object" }, "remove": { "properties": { "collection": { "type": "string" }, "id": { "type": "integer" } }, "type": "object" }, "tag": { "type": "string" } }, "type": "object" }, "title": "Bulk Editing Actions Post Data", "type": "array", "x-stoplight": { "id": "bulk-editing-actions-post-data", "name": "Bulk Editing Actions Post Data", "public": true } }, "type": "array" } } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": [ { "collection": "strategies", "update": { "pixel_target_exrp_targeting_operator": "AND" }, "tag": "details", "action_id": 1 }, { "collection": "strategies", "update": { "time_zone": "Casablanca" }, "tag": "details", "action_id": 2 }, { "collection": "strategies", "add": { "collection": "concepts", "id": 100001 }, "tag": "concepts", "action_id": 3 }, { "collection": "strategies", "add": { "collection": "concepts", "id": 100002 }, "tag": "concepts", "action_id": 4 }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100001 }, "tag": "location", "action_id": 5 }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100002 }, "tag": "location", "action_id": 6 }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100003 }, "tag": "location", "action_id": 7 }, { "collection": "strategies", "overwrite": { "collection": "target_values", "id": 100001, "exclude": false }, "tag": "location", "action_id": 8 }, { "collection": "strategies", "overwrite": { "collection": "target_values", "id": 100002, "exclude": true }, "tag": "location", "action_id": 9 }, { "collection": "strategies", "overwrite": { "collection": "target_values", "id": 100003, "exclude": false }, "tag": "location", "action_id": 10 } ] }, "schema": { "items": { "example": [ { "add": { "collection": "concepts", "id": 100001 }, "collection": "strategies", "tag": "concepts" }, { "add": { "collection": "concepts", "id": 100002 }, "collection": "strategies", "tag": "concepts" }, { "collection": "strategies", "overwrite": { "collection": "target_values", "exclude": false, "id": 100001 }, "tag": "location" }, { "collection": "strategies", "overwrite": { "collection": "target_values", "exclude": false, "id": 100003 }, "tag": "location" }, { "collection": "strategies", "overwrite": { "collection": "target_values", "exclude": true, "id": 100002 }, "tag": "location" }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100001 }, "tag": "location" }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100002 }, "tag": "location" }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100003 }, "tag": "location" }, { "collection": "strategies", "tag": "details" } ], "items": { "properties": { "collection": { "type": "string" }, "overwrite": { "properties": { "collection": { "type": "string" }, "exclude": { "type": "boolean" }, "id": { "type": "integer" } }, "type": "object" }, "remove": { "properties": { "collection": { "type": "string" }, "id": { "type": "integer" } }, "type": "object" }, "tag": { "type": "string" } }, "type": "object" }, "title": "Bulk Editing Actions Post Data", "type": "array", "x-stoplight": { "id": "bulk-editing-actions-post-data", "name": "Bulk Editing Actions Post Data", "public": true } }, "type": "array" } } }, "summary": "Create Bulk Editor Actions", "tags": [ "Campaign Bulk Editor" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "POST_campaigns-campaignid-bulkedits-bulkeditorid-actions", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Create Bulk Editor Actions" } }, "/campaigns/{campaign_id}/bulk_edits/{bulk_editor_id}/execute": { "parameters": [ { "in": "path", "name": "campaign_id", "required": true, "type": "string" }, { "in": "path", "name": "bulk_editor_id", "required": true, "type": "string" } ], "post": { "description": "Marks the Bulk Editor as ready for execution. The bulk editor will be executed after the staging processes for all of the actions are finished.", "operationId": "POST_campaigns-campaign_id-bulk_edits-bulk_editor_id-execute", "responses": { "200": { "description": "", "schema": {} } }, "summary": "Stage Bulk Editor for Execution", "tags": [ "Campaign Bulk Editor" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "POST_campaigns-campaignid-bulkedits-bulkeditorid-execute", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true } } }, "/campaigns/{campaign_id}/bulk_edits/{bulk_editor_id}/status": { "get": { "operationId": "GET_campaigns-campaign_id-bulk_edits-bulk_editor_id-status", "parameters": [ { "description": "This flag causes the targets and actions fields to be omitted from the response.\n\n1 or 0", "in": "query", "name": "dynamic_only", "type": "boolean" } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "actions": [ { "action_id": 1, "collection": "strategies", "tag": "details" }, { "action_id": 2, "collection": "strategies", "tag": "details" }, { "action_id": 3, "add": { "collection": "concepts", "id": 100001 }, "collection": "strategies", "tag": "concepts" }, { "action_id": 4, "add": { "collection": "concepts", "id": 100002 }, "collection": "strategies", "tag": "concepts" }, { "action_id": 5, "collection": "strategies", "remove": { "collection": "target_values", "id": 100001 }, "tag": "location" }, { "action_id": 6, "collection": "strategies", "remove": { "collection": "target_values", "id": 100002 }, "tag": "location" }, { "action_id": 7, "collection": "strategies", "remove": { "collection": "target_values", "id": 100003 }, "tag": "location" }, { "action_id": 8, "collection": "strategies", "overwrite": { "collection": "target_values", "exclude": false, "id": 100001 }, "tag": "location" }, { "action_id": 9, "collection": "strategies", "overwrite": { "collection": "target_values", "exclude": true, "id": 100002 }, "tag": "location" }, { "action_id": 10, "collection": "strategies", "overwrite": { "collection": "target_values", "exclude": false, "id": 100003 }, "tag": "location" } ], "editor_error": "", "editor_id": 1, "editor_status": "open", "execution_errors": [ { "action": "add", "collection": "strategy", "error_message": "weighting types must all be the same", "id": 1, "subcollection": "concepts" }, { "action": "overwrite", "collection": "strategy", "error_message": "weighting percentages must add up to 100%", "id": 2, "subcollection": "concepts" } ], "execution_status": "pending", "targets": [ { "collection": "strategies", "entities": [ { "entity_id": 100001, "target_id": 1 }, { "entity_id": 100002, "target_id": 2 }, { "entity_id": 100003, "target_id": 2 }, { "entity_id": 100004, "target_id": 2 } ] } ] } }, "schema": { "properties": { "actions": { "items": { "properties": { "action_id": { "type": "integer" }, "collection": { "type": "string" }, "overwrite": { "properties": { "collection": { "type": "string" }, "exclude": { "type": "boolean" }, "id": { "type": "integer" } }, "type": "object" }, "remove": { "properties": { "collection": { "type": "string" }, "id": { "type": "integer" } }, "type": "object" }, "tag": { "type": "string" } }, "type": "object" }, "type": "array" }, "editor_error": { "type": "string" }, "editor_id": { "type": "integer" }, "editor_status": { "type": "string" }, "execution_errors": { "items": { "properties": { "action": { "type": "string" }, "collection": { "type": "string" }, "error_message": { "type": "string" }, "id": { "type": "integer" }, "subcollection": { "type": "string" } }, "type": "object" }, "type": "array" }, "execution_status": { "type": "string" }, "targets": { "items": { "properties": { "collection": { "type": "string" }, "entities": { "items": { "properties": { "entity_id": { "type": "integer" }, "target_id": { "type": "integer" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "type": "array" } }, "type": "object" } } }, "summary": "Get Bulk Editor Status", "tags": [ "Campaign Bulk Editor" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET_campaigns-campaignid-bulkedits-bulkeditorid-status", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Get Bulk Editor Status\n\nThe status endpoint merges actions and targets, so the inconsistencies in actions schema applies here too. Please look above for more details on actions.\n\nNone of the standard query parameters (full, page_limit, page_offset, q, sort_by, with) work with this endpoint, just dynamic_only.\n" }, "parameters": [ { "in": "path", "name": "campaign_id", "required": true, "type": "string" }, { "in": "path", "name": "bulk_editor_id", "required": true, "type": "string" } ] }, "/campaigns/{campaign_id}/bulk_edits/{bulk_editor_id}/targets": { "delete": { "description": "Deactivates targets in the Bulk Editor\n\n#### Data Format\n\n```\ntarget_ids=(1,2,3)\n```\n\n```\ncollection=strategies&entity_ids=(100001,100002,100003)\n```\n\n```\ncollection=strategies&parent_collection=campaigns&parent_id=100001&all=true\n```\n\n```\ncollection=strategies&parent_collection=campaigns&parent_id=100001&all=true&skip_entities=(100001)\n```\n\nThese four versions of the query data are available to make target deletion\nconvenient and analogous to the target creation.\n\nThe `target_ids` should be a list of `target_id` numbers as seen in the GET\n`targets` data.\n\nThe `collection` should be the name of the target collection and the\n`entity_ids` should be a list of `entity_id` numbers as seen in the GET\n`targets` data.\n\nThe `parent_collection` and `parent_id` fields are required if the `all` field\nis set to true. The `skip_entities` field may be used in this case as well.\n\nThis endpoint returns a `status` response on success or a standard Adama error\nmessage in case of failure.", "operationId": "DELETE_campaigns-campaign_id-bulk_edits-bulk_editor_id-targets", "parameters": [ { "default": "(1,2,3)", "in": "query", "name": "action_ids", "type": "string" }, { "default": "concepts", "description": "", "in": "query", "name": "tag", "type": "string" } ], "responses": { "200": { "description": "", "schema": {} } }, "summary": "Delete Bulk Editor Targets", "tags": [ "Campaign Bulk Editor" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "DELETE_campaigns-campaignid-bulkedits-bulkeditorid-targets", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true } }, "get": { "operationId": "GET_campaigns-campaign_id-bulk_edits-bulk_editor_id-targets", "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": [ { "collection": "strategies", "entities": [ { "entity_id": 3350596, "target_id": 1270945 }, { "entity_id": 3350597, "target_id": 1270946 }, { "entity_id": 3350598, "target_id": 1270947 }, { "entity_id": 3350599, "target_id": 1270948 }, { "entity_id": 3350600, "target_id": 1270949 }, { "entity_id": 3350601, "target_id": 1270950 }, { "entity_id": 3350602, "target_id": 1270951 }, { "entity_id": 3350603, "target_id": 1270952 } ] } ], "meta": { "called_on": "2019-09-11T19:17:26+0000", "count": 1, "etag": "88ea623719ae7929753f6fc0e96002dafd25233f", "offset": 0, "status": "ok", "total_count": 0 }, "uuid": "CA2FB8E2-D4C8-11E9-8DC0-A2C3668E900B" } }, "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "collection": { "type": "string" }, "entities": { "type": "array", "items": { "type": "object", "properties": { "entity_id": { "type": "integer" }, "target_id": { "type": "integer" } } } } } } }, "meta": { "type": "object", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } } }, "uuid": { "type": "string" } } } } }, "summary": "List Bulk Editor Targets", "tags": [ "Campaign Bulk Editor" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET_campaigns-campaignid-bulkedits-bulkeditorid-targets", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "List Bulk Editor Targets\n\nNo query parameters" }, "parameters": [ { "in": "path", "name": "campaign_id", "required": true, "type": "string" }, { "in": "path", "name": "bulk_editor_id", "required": true, "type": "string" } ], "post": { "operationId": "POST_campaigns-campaign_id-bulk_edits-bulk_editor_id-targets", "parameters": [ { "in": "body", "name": "body", "schema": { "items": { "example": { "all": false, "collection": "strategies", "entities": [ 1, 2, 3 ], "overwrite_existing_targets": false, "parent_collection": "campaigns", "parent_id": 1, "skip_entities": [] }, "properties": { "all": { "type": "boolean" }, "collection": { "type": "string" }, "entities": { "items": { "type": "integer" }, "type": "array" }, "overwrite_existing_targets": { "type": "boolean" }, "parent_collection": { "type": "string" }, "parent_id": { "type": "integer" }, "skip_entities": { "items": { "type": "object" }, "type": "array" } }, "title": "Bulk Editor Targeting Post Data", "type": "object", "x-stoplight": { "id": "bulk-editor-targeting-post-data", "name": "Bulk Editor Targeting Post Data", "public": true } }, "type": "array" } } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": [ { "collection": "strategies", "update": { "pixel_target_exrp_targeting_operator": "AND" }, "tag": "details", "action_id": 1 }, { "collection": "strategies", "update": { "time_zone": "Casablanca" }, "tag": "details", "action_id": 2 }, { "collection": "strategies", "add": { "collection": "concepts", "id": 100001 }, "tag": "concepts", "action_id": 3 }, { "collection": "strategies", "add": { "collection": "concepts", "id": 100002 }, "tag": "concepts", "action_id": 4 }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100001 }, "tag": "location", "action_id": 5 }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100002 }, "tag": "location", "action_id": 6 }, { "collection": "strategies", "remove": { "collection": "target_values", "id": 100003 }, "tag": "location", "action_id": 7 }, { "collection": "strategies", "overwrite": { "collection": "target_values", "id": 100001, "exclude": false }, "tag": "location", "action_id": 8 }, { "collection": "strategies", "overwrite": { "collection": "target_values", "id": 100002, "exclude": true }, "tag": "location", "action_id": 9 }, { "collection": "strategies", "overwrite": { "collection": "target_values", "id": 100003, "exclude": false }, "tag": "location", "action_id": 10 } ] }, "schema": { "items": { "example": { "all": false, "collection": "strategies", "entities": [ 1, 2, 3 ], "overwrite_existing_targets": false, "parent_collection": "campaigns", "parent_id": 1, "skip_entities": [] }, "properties": { "all": { "type": "boolean" }, "collection": { "type": "string" }, "entities": { "items": { "type": "integer" }, "type": "array" }, "overwrite_existing_targets": { "type": "boolean" }, "parent_collection": { "type": "string" }, "parent_id": { "type": "integer" }, "skip_entities": { "items": { "type": "object" }, "type": "array" } }, "title": "Bulk Editor Targeting Post Data", "type": "object", "x-stoplight": { "id": "bulk-editor-targeting-post-data", "name": "Bulk Editor Targeting Post Data", "public": true } }, "type": "array" } } }, "summary": "Create Bulk Editor Targets", "tags": [ "Campaign Bulk Editor" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "POST_campaigns-campaignid-bulkedits-bulkeditorid-targets", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Create Bulk Editor Targets" } }, "/campaigns/{campaign_id}/copy": { "parameters": [ { "in": "path", "name": "campaign_id", "required": true, "type": "string" } ], "post": { "description": "**Settings that don't get copied over:**\n1. Vendor Agreements \n2. Budget Flights\n3. Campaign's Brain\n4. Creative Concepts", "operationId": "copy-campaign", "parameters": [ { "in": "body", "name": "body", "schema": { "properties": { "end_date": { "type": "string" }, "name": { "type": "string" }, "start_date": { "type": "string" } }, "type": "object" } }, { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" } ], "responses": { "201": { "description": "", "schema": { "example": { "ad_server_id": 6, "advertiser_id": 122631, "agency_fee_pct": 0, "bid_min_devices": 1, "connected_id_type": "DETERMINISTIC_ONLY", "conversion_type": "variable", "conversion_variable_minutes": 1, "created_on": "2016-10-19T03:21:53+0000", "currency_code": "USD", "custom_attribution_source": "3rd Party Attribution", "dcs_data_is_campaign_level": false, "device_graph_only": false, "end_date": "2016-11-07T23:59:00+0000", "entity_type": "campaign", "frequency_amount": 2, "frequency_interval": "not-applicable", "frequency_optimization": false, "frequency_type": "no-limit", "goal_type": "spend", "goal_value": "2.5", "has_custom_attribution": false, "id": 300982, "impression_cap_amount": 5000, "impression_cap_automatic": false, "impression_cap_type": "asap", "initial_start_date": "2016-10-19T09:00:00+0000", "io_name": "", "io_reference_num": "", "margin_pct": 0, "minimize_multi_ads": false, "name": "MobileAds Test (Round 4)", "override_suspicious_traffic_filter": false, "pv_pct": 100, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "source_campaign_id": 395863, "spend_cap_amount": 5, "spend_cap_automatic": false, "spend_cap_type": "asap", "start_date": "2016-10-19T09:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": 40, "updated_on": "2016-11-01T07:18:56+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 5, "zone_name": "Etc/GMT" }, "title": "Create Campaign", "type": "object", "x-stoplight": { "id": "campaign", "name": "Create Campaign", "public": true }, "properties": { "accountable_and_addressable": { "default": false, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "type": "boolean" }, "ad_server_fee": { "description": "Fee charged by ad serving vendor", "type": "integer" }, "ad_server_id": { "description": "The ID for a third-party ad server", "type": "integer" }, "ad_server_password": { "type": "string", "description": "Ad server password, must be equal to or less than 64" }, "ad_server_username": { "type": "string", "description": "Ad server username, must be equal to or less than 64" }, "ads_txt_verified": { "type": "string", "enum": [ "ANY", "AUTHORIZED_DIRECT_ONLY", "AUTHORIZED_ONLY" ] }, "advertiser_id": { "default": 512321, "description": "T1 Advertiser ID to which a campaign belongs", "type": "integer" }, "agency_fee_pct": { "type": "number", "description": "The Agency Fee Percentage (for example: 0.45)" }, "bid_min_devices": { "default": 1, "description": "Pre-release field that may not be visible to all users and that should not be used until official announcement of the feature.", "maximum": 5, "minimum": 1, "type": "integer" }, "connected_id_type": { "enum": [ "DETERMINISTIC_FIRST", "DETERMINISTIC_ONLY" ], "type": "string" }, "conversion_type": { "description": "Definition for conversions per user.\n\nevery: Attribute all Merit Events\n\nvariable: Attribute one Merit Event per X minutes - set inconversion_variable_minutes\n\none: Attribute one Merit Event per user (if converstion_type = one, then conversion_variable_minutes (integer) is required).\n\nrequired if `goal_type in ('cpa', 'roi')`\n", "enum": [ "every", "one", "variable" ], "type": "string" }, "conversion_variable_minutes": { "description": "Attribute one Merit Event per X minutes\n\nrequired if `goal_type in ('cpa', 'cpc', 'roi') && conversion_type=one`", "type": "integer" }, "cost_passthrough_cpm_enabled": { "type": "boolean" }, "cost_passthrough_cpm_value": { "type": "number" }, "cost_passthrough_percent_enabled": { "type": "boolean" }, "cost_passthrough_percent_value": { "type": "number" }, "created_on": { "type": "string" }, "currency_code": { "default": "USD", "description": "Currency setting for campaign. All strategies under this value inherit the selected currency. Once the campaign launches, it cannot be switched to another currency (aka existing campaigns are locked into USD, and the currency for a new campaign can't be switched once it has launched).", "type": "string" }, "custom_attribution_source": { "type": "string" }, "dcs_data_is_campaign_level": { "type": "boolean" }, "device_graph_only": { "type": "boolean" }, "eligible_for_data_sharing": { "type": "boolean" }, "end_date": { "description": "Last date of campaign in GMT", "type": "string" }, "frequency_amount": { "description": "required if `frequency_type=even||asap`", "type": "integer" }, "frequency_interval": { "description": "required if `frequency_type=even||asap`\n", "type": "string" }, "frequency_optimization": { "description": "", "type": "boolean" }, "frequency_type": { "default": "no-limit", "description": "Distribute impressions across frequency_interval up to frequency_value evenly or asap.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "goal_alert": { "type": "number", "description": "Goal Alert Min:0 Max:100, can be decimal", "format": "float", "minimum": 0, "maximum": 100 }, "goal_category": { "type": "string", "description": "goal_category must be one of the following: 'audience', 'engagement', 'response'", "enum": [ "audience", "engagement", "response" ] }, "goal_type": { "type": "string", "description": "Goal type which campaign performance will be measured", "enum": [ "cpa", "cpc", "ctr", "reach", "roi", "spend", "vcr", "vcpm", "viewability_rate" ] }, "goal_value": { "description": "Target goal value for campaign respective to the `goal_type` selection.\n\nrequired if `goal_type` in ('cpa','cpc','reach','roi', 'vcr', 'ctr')`\n\nIf `goal_type` is 'vcr' or 'ctr' or 'viewability_rat', `goal_value` is a percentage.\n\nGoal Value max=\"9999999.9999\" min=\"0.01\", unless goal_value is a percentage in which case max=100.00", "type": "string" }, "has_custom_attribution": { "description": "", "type": "boolean" }, "id": { "description": "", "type": "integer" }, "impression_cap_amount": { "description": "Sets the amount of the available impression budget across the remaining number of days across all their strategies.", "type": "integer" }, "impression_cap_automatic": { "description": "", "type": "boolean" }, "impression_cap_type": { "default": "no-limit", "description": "Type of cap applied to impression budgets.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "initial_start_date": { "type": "string" }, "io_name": { "type": "string", "description": "Descriptive name of insertion order", "maxLength": 256 }, "io_reference_num": { "type": [ "integer", "string" ], "description": "Reference number of insertion order", "maxLength": 32 }, "is_programmatic_guaranteed": { "description": "Sets the campaign as a Programmatic Guaranteed campaign. Once set for a campaign, it cannot be changed", "type": "boolean" }, "margin_pct": { "description": "Margin percentage to be applied on campaign spend", "type": "integer" }, "merit_pixel_id": { "description": "Specify Merit Pixel that represents conversion or engagement on CPA or CPE type campaigns\n\nREQUIRED if `goal_type in ('cpa','roi')`\n\nTHIS FIELD IS OBSOLETE", "type": "integer" }, "minimize_multi_ads": { "default": 0, "description": "Enabling this field will cause T1 to avoid bidding on more than one ad opportunity on a single page view across. Warning: enabling this setting may limit pacing and reduce the available inventory for the campaigns by not bidding on impression opportunities where the URL is not transparent.", "type": "boolean" }, "name": { "description": "Descriptive name of the campaign", "type": "string" }, "override_suspicious_traffic_filter": { "default": 0, "description": "Enabling this setting allows you to set a campaign-specific level of suspicious traffic filtering using the 'suspicious_traffic_filter_level' property. This will override the T1 default (or organization-level, if configured) suspicious traffic filtering level.", "type": "boolean" }, "pacing_alert": { "description": "", "type": "number" }, "pc_window_minutes": { "description": "Post-click window for attribution. Not to be confused with pv_window_minutes.\n\noptional if `goal_type in ('cpa','roi')`\n", "type": "integer" }, "pv_pct": { "description": "Percentage of post-view windows to be used for attribution\n\noptional if `goal_type in ('cpa','roi')`", "type": "integer" }, "pv_window_minutes": { "description": "Post-view window for attribution \n\nrequired if `goal_type in ('cpa','roi')`", "type": "integer" }, "restrict_targeting_to_deterministic_id": { "type": "boolean" }, "restrict_targeting_to_same_device_id": { "type": "boolean" }, "service_type": { "description": "Indicate whether campaign will be self-service or managed (managed campaigns will incur manage service fee)", "enum": [ "MANAGED", "SELF" ], "type": "string" }, "source_campaign_id": { "type": "integer" }, "spend_cap_amount": { "description": "only required if`spend_cap_enabled`is true", "type": "integer" }, "spend_cap_automatic": { "description": "Automatically sets the available spend budget across all strategies through the end date of the campaign.", "type": "boolean" }, "spend_cap_type": { "description": "Type of cap applied to spend budgets.", "enum": [ "asap", "even", "no-limit" ], "type": "string" }, "start_date": { "description": "Date on which the campaign will start (GMT)", "type": "string" }, "status": { "default": false, "description": "Status of the campaign", "type": "boolean" }, "suspicious_traffic_filter_level": { "description": "A value between 0 and 100 that determines the sensitivity of T1 suspicious traffic filtering capabilities.If the value = 0, all fraud and suspicious traffic filtering is turned off.It will not take effect if 'override_suspicious_traffic_filter_level' is not set.\n\n", "maximum": 100, "minimum": 0, "type": "integer" }, "total_budget": { "description": "Allocated budget for the campaign", "type": "integer" }, "total_impression_budget": { "description": "", "type": "integer" }, "updated_on": { "type": "string" }, "use_default_ad_server": { "type": "boolean" }, "use_mm_freq": { "type": "boolean" }, "version": { "type": "integer", "description": "This number increments upon updating. Do not define it upon creation." }, "zone_name": { "type": "string", "default": "America/New_York", "description": "Indicate the time zone for reporting for the campaign. Default is America/New_York", "maxLength": 64 } }, "required": [ "ad_server_id", "advertiser_id", "end_date", "goal_type", "goal_value", "impression_cap_automatic", "name", "service_type", "start_date", "total_budget" ] } } }, "summary": "Copy Campaign", "tags": [ "Campaign Duplication" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "copy-campaign", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true } } }, "/campaigns/{campaign_id}/custom_brain_selections": { "get": { "operationId": "list-custom-brain-selections", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" }, { "in": "query", "name": "sort_by", "type": "string" } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": [ { "active": true, "campaign_id": 650808, "enable_mm_audiences_in_brain": false, "entity_type": "campaign_custom_brain_selection", "id": 563183, "name": "Campaign Custom Brain Selections #563183", "owner_name": "Green Giraffe Hotels", "selection_id": 1004647, "selection_name": "100% Video Complete", "selection_type": "Event Pixel", "uniques": 0, "version": 0 }, { "active": true, "campaign_id": 650808, "enable_mm_audiences_in_brain": false, "entity_type": "campaign_custom_brain_selection", "id": 563184, "name": "Campaign Custom Brain Selections #563184", "owner_name": "Green Giraffe Hotels", "selection_id": 995241, "selection_name": "AdaS - GGH Confirmation Page Pixel", "selection_type": "Event Pixel", "uniques": 0, "version": 0 } ], "meta": { "called_on": "2019-09-11T19:22:26+0000", "count": 2, "etag": "a4097dba2b4d905f01a1258e4d63583e517e9fca", "next_page": "https://api.mediamath.com/api/v2.0/campaigns/650808/custom_brain_selections?full=*&page_limit=2&page_offset=2", "offset": 0, "status": "ok", "total_count": 5 }, "uuid": "7D0525D8-D4C9-11E9-8BDB-3CA3AAC0597C" } }, "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "active": { "type": "boolean" }, "campaign_id": { "type": "integer" }, "enable_mm_audiences_in_brain": { "type": "boolean" }, "entity_type": { "type": "string", "enum": [ "campaign_custom_brain_selection" ] }, "id": { "type": "integer" }, "name": { "type": "string" }, "owner_name": { "type": "string" }, "selection_id": { "type": "integer" }, "selection_name": { "type": "string" }, "selection_type": { "type": "string", "enum": [ "Event Pixel", "Data Pixel", "Audience Target", "Segment" ] }, "uniques": { "type": "integer" }, "version": { "type": "integer" } } } }, "meta": { "type": "object", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "next_page": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } } }, "uuid": { "type": "string" } } } } }, "summary": "List Custom Brain Selections", "tags": [ "Campaigns" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET-campaigns", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "List Custom Brain Selections\n\n\"with\" accepts the following: campaign\nWhen \"full=* \" is not included, only entity_type, id, and name appear in the data section" }, "parameters": [ { "in": "path", "name": "campaign_id", "required": true, "type": "string" } ] }, "/campaigns/{campaign_id}/custom_brain_selections/bulk": { "parameters": [ { "in": "path", "name": "campaign_id", "required": true, "type": "string" } ], "post": { "consumes": [ "application/x-www-form-urlencoded" ], "description": "To set custom audiences in the brain for a campaign, construct a POST request as follows, inserting an id for each segment the campaign should include (up to 20)", "operationId": "edit-custom-brain", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": { "ad_server_id": 6, "advertiser_id": 122631, "agency_fee_pct": 0, "conversion_type": "variable", "conversion_variable_minutes": 1, "created_on": "2016-10-19T03:21:53+0000", "currency_code": "USD", "dcs_data_is_campaign_level": false, "end_date": "2016-11-07T23:59:00+0000", "entity_type": "campaign", "frequency_interval": "not-applicable", "frequency_optimization": false, "frequency_type": "no-limit", "goal_type": "spend", "goal_value": [ { "currency_code": "USD", "value": 2.5 } ], "has_custom_attribution": false, "id": 300982, "impression_cap_amount": 5000, "impression_cap_automatic": false, "impression_cap_type": "asap", "initial_start_date": "2016-10-19T09:00:00+0000", "io_name": "", "io_reference_num": "", "margin_pct": 0, "minimize_multi_ads": false, "name": "MobileAds Test (Round 4)", "override_suspicious_traffic_filter": false, "pv_pct": 100, "restrict_targeting_to_deterministic_id": false, "restrict_targeting_to_same_device_id": false, "service_type": "SELF", "spend_cap_amount": [ { "currency_code": "USD", "value": 5 } ], "spend_cap_automatic": false, "spend_cap_type": "asap", "start_date": "2016-10-19T09:00:00+0000", "status": true, "suspicious_traffic_filter_level": 25, "total_budget": [ { "currency_code": "USD", "value": 40 } ], "updated_on": "2016-11-01T07:18:56+0000", "use_default_ad_server": false, "use_mm_freq": false, "version": 5, "zone_name": "Etc/GMT" }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "called_on": "2016-11-23T19:15:16+0000", "etag": "3b15a5d063e860c3c33e2621207a12f940db04f9", "status": "ok" } } }, "schema": { "properties": { "data": { "example": { "active": false, "campaign_id": -13129825, "child_count": -35599919, "entity_type": "dolore ea deserunt", "full_path": "do", "id": 46512678, "is_retired": true, "load_count": -99526154, "name": "commodo Lorem reprehenderit qui", "owner_name": "sunt laboris veniam amet", "parent_audience_segment_id": 60078089, "refer_url": "adipisicing consectetur", "retail_cpm": [ { "currency_code": "cupidatat fugiat aute qui", "value": -47610824 } ], "selection_id": 72439766, "selection_name": "dolore ", "selection_type": "Data Pixel", "uniques": -73623784, "version": -21888191, "wholesale_cpm": [ { "value": -23482783 } ] }, "properties": { "active": { "type": "boolean" }, "campaign_id": { "type": "integer" }, "child_count": { "description": "Only returned in selection_type 'Audience Target", "type": "integer" }, "entity_type": { "type": "string" }, "full_path": { "description": "Only returned in selection_type 'Audience Target", "type": "string" }, "id": { "type": "integer" }, "is_retired": { "description": "Only returned in selection_type 'Audience Target", "type": "boolean" }, "load_count": { "type": "integer" }, "name": { "type": "string" }, "owner_name": { "type": "string" }, "parent_audience_segment_id": { "description": "Only returned in selection_type 'Audience Target", "type": "integer" }, "refer_url": { "type": "string" }, "retail_cpm": { "description": "Only returned in selection_type 'Audience Target", "items": { "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } }, "required": [ "currency_code", "value" ], "type": "object" }, "type": "array" }, "selection_id": { "type": "integer" }, "selection_name": { "type": "string" }, "selection_type": { "enum": [ "Event Pixel", "Dynamic", "Audience Target", "Data Pixel" ], "type": "string" }, "uniques": { "type": "integer" }, "version": { "type": "integer" }, "wholesale_cpm": { "description": "Only returned in selection_type 'Audience Target", "items": { "properties": { "currency_code": { "type": "string" }, "value": { "type": "integer" } }, "type": "object" }, "type": "array" } }, "title": "Campaign Custom Brain Selection", "type": "object", "x-stoplight": { "id": "campaign-custom-brain-selection", "name": "Campaign Custom Brain Selection", "public": true } }, "uuid": { "type": "string" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } }, "type": "object" } } }, "summary": "Edit Custom Brain Selections", "tags": [ "Campaigns" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET-campaigns", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true } } }, "/campaigns/{campaign_id}/site_lists": { "parameters": [ { "name": "campaign_id", "in": "path", "type": "string", "required": true } ], "post": { "consumes": [ "application/x-www-form-urlencoded" ], "operationId": "POST_campaigns-campaign_id-site_lists", "parameters": [ { "in": "formData", "name": "site_lists.1.id", "type": "string" }, { "in": "formData", "name": "site_lists.1.assigned", "type": "string" } ], "responses": { "200": { "description": "", "schema": {} } }, "summary": "Assign Site List to Campaign", "tags": [ "Site Lists" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "POST_campaigns-campaignid-sitelists", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Assign Site List to Campaign" }, "get": { "responses": { "200": { "description": "\nQuery section:\n\"with\" accepts the following: organization, campaign, sites\n\"sort_by\" can use any parameter in the root of the data section\nWhen \"full=* \" is not included, only entity_type, id, and name appear in the data section", "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "assigned": { "type": "boolean" }, "campaign_assigned": { "type": "boolean" }, "campaign_id": { "type": "integer" }, "created_on": { "type": "string", "format": "date-time" }, "entity_type": { "type": "string", "enum": [ "site_lists_for_campaigns" ] }, "filename": { "type": "string", "maxLength": 255 }, "id": { "type": "integer" }, "name": { "type": "string", "maxLength": 64 }, "organization_id": { "type": "integer" }, "restriction": { "type": "string", "enum": [ "INCLUDE", "EXCLUDE" ] }, "sites_count": { "type": "integer" }, "sites_count_app": { "type": "integer" }, "sites_count_domain": { "type": "integer" }, "status": { "type": "boolean" }, "updated_on": { "type": "string", "format": "date-time" }, "version": { "type": "integer" } } } }, "meta": { "type": "object", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "next_page": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } } }, "uuid": { "type": "string" } } }, "examples": { "application/vnd.mediamath.v1+json": { "data": [ { "assigned": false, "campaign_assigned": false, "campaign_id": 650808, "created_on": "2019-08-23T19:52:59+0000", "entity_type": "site_lists_for_campaign", "filename": "EL Site List.csv", "id": 170767, "name": "k12 EL Site List", "organization_id": 100048, "restriction": "INCLUDE", "sites_count": 110, "sites_count_domain": 110, "status": true, "updated_on": "2019-08-23T19:52:59+0000", "version": 0 }, { "assigned": false, "campaign_assigned": false, "campaign_id": 650808, "created_on": "2019-08-23T19:53:25+0000", "entity_type": "site_lists_for_campaign", "filename": "SL Endemic Site List.csv", "id": 170768, "name": "k12 SL Endemic Site List", "organization_id": 100048, "restriction": "INCLUDE", "sites_count": 22, "sites_count_domain": 22, "status": true, "updated_on": "2019-08-23T19:53:25+0000", "version": 0 } ], "meta": { "called_on": "2019-09-11T20:42:16+0000", "count": 2, "etag": "2debc5042387ff6e5bf09f5f9bd3f27d79f1b9e0", "next_page": "https://api.mediamath.com/api/v2.0/campaigns/650808/site_lists?full=*&page_limit=2&page_offset=2", "offset": 0, "status": "ok", "total_count": 777 }, "uuid": "A48066B2-D4D4-11E9-BDE0-38AAAAC0597C" } } } }, "summary": "List Campaign Site Lists", "description": "List Campaign Site Lists", "operationId": "ListCampaignSiteLists", "tags": [ "Site Lists" ], "parameters": [ { "in": "query", "name": "full", "type": "string" }, { "in": "query", "name": "page_limit", "type": "integer" }, { "in": "query", "name": "page_offset", "type": "integer" }, { "in": "query", "name": "q", "type": "string" }, { "in": "query", "name": "sort_by", "type": "string" }, { "in": "query", "name": "with", "type": "string" } ] } }, "/campaigns/{campaign_id}/total_spend": { "get": { "consumes": [ "application/json" ], "operationId": "GET_campaigns-id-total_spend", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" } ], "produces": [ "application/json" ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": { "aggregate": { "function": "sum", "name": "our_total_spend", "value": "0.00" }, "entity_type": "campaign", "id": 2644723, "name": "test" }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "status": "ok" } } }, "schema": { "properties": { "data": { "properties": { "aggregate": { "properties": { "function": { "type": "string" }, "name": { "type": "string" }, "value": { "type": "string" } }, "type": "object" }, "entity_type": { "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" } }, "type": "object" }, "uuid": { "type": "string" }, "meta": { "properties": { "status": { "type": "string" } }, "type": "object" } }, "type": "object" } } }, "security": [ { "oauth2": [] } ], "summary": "Get Campaign Total Spend", "tags": [ "Campaigns" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET_campaigns-id-totalspend", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Get Campaign Total Spend\n\nNo query parameters, not even \"with=currency\"" }, "parameters": [ { "in": "path", "name": "campaign_id", "required": true, "type": "string" } ] }, "/concepts": { "get": { "operationId": "GET_concepts", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" }, { "in": "query", "name": "sort_by", "type": "string" } ], "produces": [ "text/xml" ], "responses": { "200": { "description": "\nQuery section:\n\"with\" accepts the following: advertiser\n\"sort_by\" can use any parameter in the root of the data section\nWhen \"full=* \" is not included, only entity_type, id, and name appear in the data section", "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "advertiser_id": { "type": "integer" }, "created_on": { "type": "string", "format": "date-time" }, "entity_type": { "type": "string", "enum": [ "concept" ] }, "id": { "type": "integer" }, "name": { "type": "string" }, "status": { "type": "boolean" }, "updated_on": { "type": "string", "format": "date-time" }, "version": { "type": "integer" } } } }, "meta": { "type": "object", "properties": { "called_on": { "type": "string", "format": "date-time" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "next_page": { "type": "string", "format": "uri" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } } }, "uuid": { "type": "string" } } }, "examples": { "application/vnd.mediamath.v1+json": { "data": [ { "advertiser_id": 146491, "created_on": "2019-09-11T10:44:14+0000", "entity_type": "concept", "id": 2341787, "name": "Amber Alert ID: 30321", "status": true, "updated_on": "2019-09-11T10:44:14+0000", "version": 0 }, { "advertiser_id": 196023, "created_on": "2019-09-11T18:13:40+0000", "entity_type": "concept", "id": 2342317, "name": "Desktop_620x366 Test 2", "status": true, "updated_on": "2019-09-11T18:13:40+0000", "version": 0 } ], "meta": { "called_on": "2019-09-11T20:51:01+0000", "count": 2, "etag": "19cde155ec2f057a71c90dcc9a75640fc1120919", "next_page": "https://api.mediamath.com/api/v2.0/concepts?full=*&page_limit=2&page_offset=2", "offset": 0, "status": "ok", "total_count": 21072 }, "uuid": "DD2CD576-D4D5-11E9-834E-CFC9668E900B" } } } }, "summary": "List Concepts", "tags": [ "Concepts" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET_concepts", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "List Concepts" }, "post": { "consumes": [ "application/x-www-form-urlencoded" ], "operationId": "POST-concepts", "responses": { "201": { "description": "", "schema": { "allOf": [ { "properties": { "advertiser_id": { "type": "integer" }, "name": { "type": "string" }, "status": { "type": "boolean" } }, "required": [ "advertiser_id", "name" ], "title": "Input Concept", "type": "object", "x-stoplight": { "id": "input-concept", "name": "Input Concept", "public": true } }, { "example": { "created_on": "4838-01-01T02:34:39.905Z", "id": 1, "updated_on": "3214-02-18T04:49:20.878Z", "version": 46559379 }, "properties": { "created_on": { "format": "date-time", "type": "string" }, "id": { "minimum": 0, "type": "integer" }, "updated_on": { "format": "date-time", "type": "string" }, "version": { "type": "integer" } }, "title": "Output Common", "type": "object", "x-stoplight": { "id": "output_common", "name": "Output Common", "public": true } } ], "title": "Output Concept", "type": "object", "x-stoplight": { "id": "output-concept", "name": "Output Concept", "public": true } } } }, "security": [ { "oauth2": [] } ], "summary": "Create Concept", "tags": [ "Concepts" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "POST-concepts", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Create Concept" } }, "/concepts/{concept_id}": { "get": { "operationId": "GET_concepts-concept_id", "parameters": [ { "default": "application/vnd.mediamath.v1+json", "in": "header", "name": "Accept", "required": false, "type": "string" }, { "in": "query", "maximum": 100, "minimum": 1, "name": "page_limit", "required": false, "type": "integer" }, { "description": "Index of the first element in the collection to retrieve", "in": "query", "name": "page_offset", "required": false, "type": "integer" }, { "in": "query", "items": { "type": "string" }, "name": "q", "required": false, "type": "string" }, { "default": "", "description": "To include all properties for all entities returned by the API call, use `full=*:`", "in": "query", "items": { "type": "string" }, "name": "full", "required": false, "type": "string" }, { "in": "query", "items": { "type": "string" }, "name": "with", "required": false, "type": "string" }, { "in": "query", "name": "sort_by", "type": "string" } ], "produces": [ "text/xml" ], "responses": { "200": { "description": "", "schema": { "properties": { "data": { "properties": { "advertiser_id": { "type": "integer" }, "created_on": { "format": "date-time", "type": "string" }, "entity_type": { "enum": [ "concept" ], "type": "string" }, "id": { "type": "integer" }, "name": { "type": "string" }, "status": { "type": "boolean" }, "updated_on": { "format": "date-time", "type": "string" }, "version": { "type": "integer" } }, "type": "object" }, "meta": { "properties": { "called_on": { "format": "date-time", "type": "string" }, "etag": { "type": "string" }, "status": { "enum": [ "ok" ], "type": "string" } }, "type": "object" }, "uuid": { "type": "string" } }, "type": "object" }, "examples": { "application/vnd.mediamath.v1+json": { "data": { "advertiser_id": 1234850, "created_on": "2019-05-28T12:36:52+0000", "entity_type": "concept", "id": 2217557, "name": "160x600_broccoli", "status": true, "updated_on": "2019-05-28T12:36:52+0000", "version": 0 }, "meta": { "called_on": "2019-05-28T18:42:11+0000", "etag": "6a7246034598dec0622abc82367d49cac67132f7", "status": "ok" }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B" } } } }, "summary": "Get Concept", "tags": [ "Concepts" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET_concepts-conceptid", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Get Concept" }, "parameters": [ { "in": "path", "name": "concept_id", "required": true, "type": "string" } ] }, "/contracts": { "get": { "operationId": "LIST-contracts", "responses": { "200": { "description": "\nQuery section:\n\"with\" accepts the following: organization, currency\n\"sort_by\" can use any parameter in the root of the data section\nWhen \"full=* \" is not included, only entity_type, id, and name appear in the data section", "examples": { "application/vnd.mediamath.v1+json": { "data": [ { "adaptive_segment_cpm": [ { "currency_code": "USD", "value": 0.4 } ], "audience_verification_cost": [ { "currency_code": "USD", "value": 0.25 } ], "connected_id_cost": [ { "currency_code": "USD", "value": 0 } ], "contract_number": 107970, "created_on": "2019-05-29T16:24:14+0000", "currency_code": "USD", "effective_end_date": "2020-04-30T00:00:00+0000", "effective_start_date": "2019-06-01T00:00:00+0000", "entity_type": "contract", "evidon_privacy_cost_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "exclude_agency_margin": false, "external_media_tracking_cpm": [ { "currency_code": "USD", "value": 0.005 } ], "fbx_dynamic_cpm": [ { "currency_code": "USD", "value": 0.18 } ], "financing_cost": [ { "currency_code": "USD", "value": 0 } ], "id": 8284, "managed_service_fee_pct": 0, "managed_service_fee_unit": "PCT_TOTAL_COST", "name": "Contracts #8284", "optimization_fee_pct": 0, "optimization_fee_unit": "PCT_TOTAL_COST", "organization_id": 100048, "peer39_quality_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "peer39_safety_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "platform_access_fee_pct": 0, "platform_access_fee_unit": "PCT_TOTAL_COST", "platform_monthly_min": 0, "pmp_optimization_off_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_off_unit": "CPM", "pmp_optimization_on_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_on_unit": "CPM", "profit_share_fee_pct": 0, "programmatic_guaranteed_platform_access_fee_pct": 0, "programmatic_guaranteed_platform_access_fee_unit": "PCT_TOTAL_COST", "spend_cap": 0, "standard_segment_cpm": [ { "currency_code": "USD", "value": 0.1 } ], "t1_as_fee_cpm": [ { "currency_code": "USD", "value": 0.05 } ], "t1_html5_fee_cpm": [ { "currency_code": "USD", "value": 0.05 } ], "t1_vads_fee_cpm": [ { "currency_code": "USD", "value": 0.25 } ], "updated_on": "2019-05-29T16:24:14+0000", "version": 0, "viewability_display_all_imps": 0.1, "viewability_display_sample": 0.03, "viewability_video_all_imps": 0.2, "viewability_video_sample": 0.06 }, { "adaptive_segment_cpm": [ { "currency_code": "USD", "value": 0.4 } ], "audience_verification_cost": [ { "currency_code": "USD", "value": 0.25 } ], "connected_id_cost": [ { "currency_code": "USD", "value": 0 } ], "contract_number": 108416, "created_on": "2019-07-31T19:54:47+0000", "currency_code": "USD", "effective_end_date": "2019-08-31T00:00:00+0000", "effective_start_date": "2019-08-01T00:00:00+0000", "entity_type": "contract", "evidon_privacy_cost_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "exclude_agency_margin": true, "external_media_tracking_cpm": [ { "currency_code": "USD", "value": 0.005 } ], "fbx_dynamic_cpm": [ { "currency_code": "USD", "value": 0.18 } ], "financing_cost": [ { "currency_code": "USD", "value": 0 } ], "id": 8730, "managed_service_fee_pct": 13.89, "managed_service_fee_unit": "PCT_TOTAL_COST", "name": "Contracts #8730", "optimization_fee_pct": 5.17, "optimization_fee_unit": "PCT_TOTAL_COST", "organization_id": 102032, "peer39_quality_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "peer39_safety_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "platform_access_fee_pct": 11.11, "platform_access_fee_unit": "PCT_TOTAL_COST", "platform_monthly_min": 25000, "pmp_optimization_off_fee_pct": 11.11, "pmp_optimization_off_unit": "PCT_TOTAL_COST", "pmp_optimization_on_fee_pct": 0, "pmp_optimization_on_unit": "PCT_TOTAL_COST", "profit_share_fee_pct": 0, "programmatic_guaranteed_platform_access_fee_pct": 5.26, "programmatic_guaranteed_platform_access_fee_unit": "PCT_TOTAL_COST", "standard_segment_cpm": [ { "currency_code": "USD", "value": 0.1 } ], "t1_as_fee_cpm": [ { "currency_code": "USD", "value": 0.05 } ], "t1_html5_fee_cpm": [ { "currency_code": "USD", "value": 0.05 } ], "t1_vads_fee_cpm": [ { "currency_code": "USD", "value": 0.25 } ], "updated_on": "2019-08-30T09:25:22+0000", "version": 1, "viewability_display_all_imps": 0.1, "viewability_display_sample": 0.03, "viewability_video_all_imps": 0.2, "viewability_video_sample": 0.06 } ], "meta": { "called_on": "2019-09-11T20:51:48+0000", "count": 2, "etag": "e54d229b57d37aee4f074cfceb03b74e19b49d03", "next_page": "https://api.mediamath.com/api/v2.0/contracts?full=*&page_limit=2&page_offset=2", "offset": 0, "status": "ok", "total_count": 19 }, "uuid": "F94CBBB8-D4D5-11E9-811C-1B1726F3F03C" } }, "schema": { "type": "object", "properties": { "data": { "type": "array", "items": { "type": "object", "properties": { "adaptive_segment_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "audience_verification_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "connected_id_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "contract_number": { "type": "integer" }, "country_tax_withholding_fee_pct": { "type": "integer" }, "country_tax_withholding_fee_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "created_on": { "format": "date-time", "type": "string" }, "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "effective_end_date": { "format": "date-time", "type": "string" }, "effective_start_date": { "format": "date-time", "type": "string" }, "entity_type": { "enum": [ "contract" ], "type": "string" }, "evidon_privacy_cost_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "exclude_agency_margin": { "type": "boolean" }, "external_media_tracking_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "fbx_dynamic_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "financing_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "id": { "type": "integer" }, "managed_sevrice_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "managed_service_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied to impressions on campaigns where the campaign is set to be \"Managed By\" Managed Service." }, "managed_service_fee_unit": { "enum": [ "CPM", "FIXED", "PCT_TOTAL_COST" ], "type": "string", "description": "This fee is applied to impressions on campaigns where the campaign is set to be \"Managed By\" Managed Service." }, "media_enablement_fee_pct": { "type": [ "integer", "number" ], "description": "" }, "media_enablement_fee_unit": { "enum": [ "CPM", "FIXED", "PCT_TOTAL_COST" ], "type": "string", "description": "" }, "name": { "type": "string" }, "optimization_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied to impressions on campaigns where a strategy has optimization
turned on AND the campaign IS NOT \"Managed Service\"." }, "optimization_fee_unit": { "enum": [ "CPM", "FIXED", "PCT_TOTAL_COST" ], "type": "string", "description": "This fee is applied to impressions on campaigns where a strategy has optimization turned on AND the campaign IS NOT \"Managed Service\"." }, "organization_id": { "type": "integer" }, "partnership_rebate_fee_pct": { "type": "integer" }, "partnership_rebate_fee_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "peer39_channel_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_custom_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_quality_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_safety_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "platform_access_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied for use of T1 on all inventory with exception of User-Sourced PMP." }, "platform_access_fee_unit": { "enum": [ "CPM", "FIXED", "PCT_TOTAL_COST" ], "type": "string", "description": "This fee is applied for use of T1 on all inventory with exception of User-Sourced PMP." }, "platform_monthly_min": { "type": "integer" }, "pmp_optimization_off_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "pmp_optimization_off_fee_pct": { "type": "number" }, "pmp_optimization_off_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "pmp_optimization_on_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "pmp_optimization_on_fee_pct": { "type": "integer" }, "pmp_optimization_on_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "profit_share_fee_pct": { "type": "integer" }, "programmatic_guaranteed_platform_access_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals." }, "programmatic_guaranteed_platform_access_fee_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string", "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals." }, "spend_cap": { "type": "integer" }, "standard_segment_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_as_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_html5_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_vads_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "updated_on": { "format": "date-time", "type": "string" }, "value": { "type": "integer" }, "version": { "type": "integer" }, "viewability_display_all_imps": { "type": "number" }, "viewability_display_sample": { "type": "number" }, "viewability_video_all_imps": { "type": "number" }, "viewability_video_sample": { "type": "number" } } } }, "meta": { "type": "object", "properties": { "called_on": { "format": "date-time", "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "next_page": { "format": "uri", "type": "string" }, "offset": { "type": "integer" }, "status": { "enum": [ "ok" ], "type": "string" }, "total_count": { "type": "integer" } } }, "uuid": { "type": "string" } } } } }, "summary": "List Contracts", "tags": [ "Contracts" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "LIST-contracts", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "List Contracts", "parameters": [ { "in": "query", "name": "full", "type": "string" }, { "in": "query", "name": "page_limit", "type": "string" }, { "in": "query", "name": "page_offset", "type": "string" }, { "in": "query", "name": "q", "type": "string" }, { "in": "query", "name": "sort_by", "type": "string" }, { "in": "query", "name": "with", "type": "string" } ] }, "post": { "consumes": [ "application/x-www-form-urlencoded" ], "operationId": "POST-contracts", "responses": { "201": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": { "adaptive_segment_cpm": [ { "currency_code": "USD", "value": 0 } ], "contract_number": 103074, "created_on": "2016-08-29T19:54:25+0000", "currency_code": "USD", "effective_end_date": "2017-03-21T00:00:00+0000", "effective_start_date": "2016-09-01T00:00:00+0000", "entity_type": "contract", "evidon_privacy_cost_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "exclude_agency_margin": false, "external_media_tracking_cpm": [ { "currency_code": "USD", "value": 0.005 } ], "fbx_dynamic_cpm": [ { "currency_code": "USD", "value": 0.3 } ], "id": 3385, "managed_service_fee_pct": 0, "managed_service_fee_unit": "PCT_TOTAL_COST", "name": "Contracts #3385", "optimization_fee_pct": 0, "optimization_fee_unit": "PCT_TOTAL_COST", "organization_id": 100048, "peer39_channel_fee_cpm": [ { "currency_code": "USD", "value": 0.1 } ], "peer39_custom_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ], "peer39_quality_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "peer39_safety_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "platform_access_fee_pct": 0, "platform_access_fee_unit": "PCT_TOTAL_COST", "platform_monthly_min": 0, "pmp_optimization_off_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_off_unit": "CPM", "pmp_optimization_on_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_on_unit": "CPM", "profit_share_fee_pct": 0, "spend_cap": 15000, "t1_as_fee_cpm": [ { "currency_code": "USD", "value": 0.02 } ], "t1_html5_fee_cpm": [ { "currency_code": "USD", "value": 0.08 } ], "t1_vads_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ], "updated_on": "2016-08-29T19:54:25+0000", "version": 8 }, "uuid": { "type": "string" }, "meta": { "called_on": "2017-03-03T20:08:20+0000", "etag": "2a64a9a52d66302464fe557340b33ec849028460", "status": "ok" } } }, "schema": { "example": { "data": { "adaptive_segment_cpm": [ {} ], "contract_number": -34492430, "currency_code": "Lorem cupidatat qui ullamco", "effective_end_date": "2017-09-01T00:00:00+0000", "effective_start_date": "2016-09-01T00:00:00+0000", "entity_type": "sit labore et Ut adipisicing", "evidon_privacy_cost_cpm": [ {}, {}, {}, { "currency_code": "do aute cillum deserunt qui", "value": -54392635 } ], "exclude_agency_margin": false, "external_media_tracking_cpm": [ {}, {} ], "fbx_dynamic_cpm": [ {}, {}, { "value": -47958450 }, {}, {} ], "managed_service_fee_pct": 63292875, "managed_service_fee_unit": "anim sint", "name": "irure reprehenderit Excepteur laboris", "optimization_fee_pct": -85118338, "optimization_fee_unit": "dolore ipsum pariatur", "organization_id": -9920526, "peer39_channel_fee_cpm": [ {}, { "value": -46124930 }, { "currency_code": "laborum", "value": 24673781 }, {} ], "peer39_custom_fee_cpm": [ {}, { "currency_code": "non deserunt cupidatat anim" }, {} ], "peer39_quality_fee_cpm": [ { "value": -85179 }, { "value": -10240689 }, { "value": -4954655 }, { "value": -84377398 } ], "peer39_safety_fee_cpm": [ {}, {}, {}, {} ], "platform_access_fee_pct": -71104119, "platform_access_fee_unit": "reprehenderit laborum dolor mollit ullamco", "platform_monthly_min": -73493003, "pmp_optimization_off_fee_cpm": [ { "currency_code": "ut sint ut occaecat" }, { "currency_code": "Excepteur ut tempor", "value": 99751657 } ], "pmp_optimization_off_unit": "sed esse nulla", "pmp_optimization_on_fee_cpm": [ { "currency_code": "ex deserunt p", "value": 38523577 }, { "value": -85647761 }, { "currency_code": "labore commodo consectetur consequat", "value": -49826722 }, {} ], "pmp_optimization_on_unit": "Ut", "profit_share_fee_pct": 41207491, "spend_cap": -12156130, "t1_as_fee_cpm": [ {}, { "value": 99250012 }, {} ], "t1_html5_fee_cpm": [ { "currency_code": "velit" }, {}, {}, {} ], "t1_vads_fee_cpm": [ { "value": -835869 }, {}, { "value": -398843 }, {}, { "currency_code": "sint ex aliqua irure exercitation" } ] }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "called_on": "laborum voluptate dolore", "count": 27422536, "etag": "enim id Excepteur magna", "offset": -47785040, "status": "amet", "total_count": -77774937 } }, "title": "Contracts Output", "type": "object", "x-stoplight": { "id": "contracts-output", "name": "Contracts Output", "public": true }, "properties": { "data": { "example": { "adaptive_segment_cpm": [ { "currency_code": "USD", "value": 0 } ], "contract_number": 103074, "currency_code": "USD", "effective_end_date": "2017-09-01T00:00:00+0000", "effective_start_date": "2016-09-01T00:00:00+0000", "entity_type": "contract", "evidon_privacy_cost_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "exclude_agency_margin": false, "external_media_tracking_cpm": [ { "currency_code": "USD", "value": 0.005 } ], "fbx_dynamic_cpm": [ { "currency_code": "USD", "value": 0.3 } ], "managed_service_fee_pct": 0, "managed_service_fee_unit": "PCT_TOTAL_COST", "name": "Contracts #3385", "optimization_fee_pct": 0, "optimization_fee_unit": "PCT_TOTAL_COST", "organization_id": 100048, "peer39_channel_fee_cpm": [ { "currency_code": "USD", "value": 0.1 } ], "peer39_custom_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ], "peer39_quality_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "peer39_safety_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "platform_access_fee_pct": 0, "platform_access_fee_unit": "PCT_TOTAL_COST", "platform_monthly_min": 0, "pmp_optimization_off_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_off_unit": "CPM", "pmp_optimization_on_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_on_unit": "CPM", "profit_share_fee_pct": 0, "spend_cap": 15000, "t1_as_fee_cpm": [ { "currency_code": "USD", "value": 0.02 } ], "t1_html5_fee_cpm": [ { "currency_code": "USD", "value": 0.08 } ], "t1_vads_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ] }, "title": "Contracts Input", "type": "object", "x-stoplight": { "id": "contracts-input", "name": "Contracts Input", "public": true }, "properties": { "adaptive_segment_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "audience_verification_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "connected_id_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "contract_number": { "type": "integer" }, "country_tax_withholding_fee_pct": { "type": "integer" }, "country_tax_withholding_fee_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "created_on": { "format": "date-time", "type": "string" }, "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "effective_end_date": { "type": "string" }, "effective_start_date": { "type": "string" }, "entity_type": { "type": "string", "description": "Should be set to \"contract\"" }, "evidon_privacy_cost_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "exclude_agency_margin": { "type": "boolean" }, "external_media_tracking_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "fbx_dynamic_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "financing_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "id": { "type": "integer" }, "managed_sevrice_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "managed_service_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied to impressions on campaigns where the campaign is set to be \"Managed By\" Managed Service." }, "managed_service_fee_unit": { "type": "string", "description": "This fee is applied to impressions on campaigns where the campaign is set to be \"Managed By\" Managed Service.\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "media_enablement_fee_pct": { "type": [ "integer", "number" ], "description": "" }, "media_enablement_fee_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "name": { "type": "string" }, "optimization_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied to impressions on campaigns where a strategy has optimization
turned on AND the campaign IS NOT \"Managed Service\"." }, "optimization_fee_unit": { "type": "string", "description": "This fee is applied to impressions on campaigns where a strategy has optimization
turned on AND the campaign IS NOT \"Managed Service\".\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "organization_id": { "type": "integer" }, "partnership_rebate_fee_pct": { "type": "integer" }, "partnership_rebate_fee_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "peer39_channel_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_custom_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_quality_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_safety_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "platform_access_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied for use of T1 on all inventory with exception of User-Sourced PMP." }, "platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all inventory with exception of User-Sourced PMP.\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "platform_monthly_min": { "type": "integer" }, "pmp_optimization_off_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "pmp_optimization_off_fee_pct": { "type": "number" }, "pmp_optimization_off_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "pmp_optimization_on_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "pmp_optimization_on_fee_pct": { "type": "integer" }, "pmp_optimization_on_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "profit_share_fee_pct": { "type": "integer" }, "programmatic_guaranteed_platform_access_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals." }, "programmatic_guaranteed_platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals.\n\nAcceptable values are: CPM, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "source_platform_access_fee_pct": { "type": "integer" }, "source_platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals.\n\nAcceptable values are: CPM, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "spend_cap": { "type": "integer" }, "standard_segment_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_as_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_html5_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_vads_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "updated_on": { "format": "date-time", "type": "string" }, "value": { "type": "integer" }, "version": { "type": "integer" }, "viewability_display_all_imps": { "type": "number" }, "viewability_display_sample": { "type": "number" }, "viewability_video_all_imps": { "type": "number" }, "viewability_video_sample": { "type": "number" } } }, "uuid": { "type": "string" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } } } } }, "summary": "Create Contracts", "tags": [ "Contracts" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "POST-contracts", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Create Contracts" } }, "/contracts/{contract_id}": { "delete": { "operationId": "DELETE-contract", "parameters": [ { "in": "path", "name": "contract_id", "required": true, "type": "integer" } ], "responses": { "204": { "description": "", "schema": { "type": "object" } } }, "summary": "Delete Contract", "tags": [ "Contracts" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "DELETE-contracts", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Delete Contracts" }, "get": { "operationId": "GET-a-contract", "parameters": [ { "in": "path", "name": "contract_id", "required": true, "type": "integer" } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": [ { "standard_segment_cpm": [ { "currency_code": "USD", "value": 0.1 } ], "t1_vads_fee_cpm": [ { "currency_code": "USD", "value": 0.25 } ], "managed_service_fee_pct": 13.89, "platform_access_fee_unit": "PCT_TOTAL_COST", "updated_on": "2019-08-30T09:25:22+0000", "viewability_display_sample": 0.03, "viewability_video_sample": 0.06, "peer39_quality_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "created_on": "2019-07-31T19:54:47+0000", "id": 8730, "t1_html5_fee_cpm": [ { "currency_code": "USD", "value": 0.05 } ], "programmatic_guaranteed_platform_access_fee_unit": "PCT_TOTAL_COST", "currency_code": "USD", "contract_number": 108416, "pmp_optimization_off_unit": "PCT_TOTAL_COST", "pmp_optimization_on_unit": "PCT_TOTAL_COST", "audience_verification_cost": [ { "currency_code": "USD", "value": 0.25 } ], "name": "Contracts #8730", "platform_access_fee_pct": 11.11, "financing_cost": [ { "currency_code": "USD", "value": 0 } ], "effective_end_date": "2019-08-31T00:00:00+0000", "optimization_fee_unit": "PCT_TOTAL_COST", "optimization_fee_pct": 5.17, "fbx_dynamic_cpm": [ { "currency_code": "USD", "value": 0.18 } ], "platform_monthly_min": 25000, "exclude_agency_margin": true, "pmp_optimization_off_fee_pct": 11.11, "pmp_optimization_on_fee_pct": 0, "t1_as_fee_cpm": [ { "currency_code": "USD", "value": 0.05 } ], "entity_type": "contract", "programmatic_guaranteed_platform_access_fee_pct": 5.26, "managed_service_fee_unit": "PCT_TOTAL_COST", "organization_id": 102032, "version": 1, "profit_share_fee_pct": 0, "effective_start_date": "2019-08-01T00:00:00+0000", "peer39_safety_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "connected_id_cost": [ { "currency_code": "USD", "value": 0 } ], "external_media_tracking_cpm": [ { "currency_code": "USD", "value": 0.005 } ], "viewability_display_all_imps": 0.1, "evidon_privacy_cost_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "viewability_video_all_imps": 0.2, "adaptive_segment_cpm": [ { "currency_code": "USD", "value": 0.4 } ] }, { "standard_segment_cpm": [ { "currency_code": "USD", "value": 0.1 } ], "t1_vads_fee_cpm": [ { "currency_code": "USD", "value": 0.25 } ], "managed_service_fee_pct": 0, "platform_access_fee_unit": "PCT_TOTAL_COST", "updated_on": "2019-05-29T16:24:14+0000", "viewability_display_sample": 0.03, "viewability_video_sample": 0.06, "peer39_quality_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "created_on": "2019-05-29T16:24:14+0000", "id": 8284, "t1_html5_fee_cpm": [ { "currency_code": "USD", "value": 0.05 } ], "programmatic_guaranteed_platform_access_fee_unit": "PCT_TOTAL_COST", "currency_code": "USD", "contract_number": 107970, "pmp_optimization_off_unit": "CPM", "pmp_optimization_on_unit": "CPM", "audience_verification_cost": [ { "currency_code": "USD", "value": 0.25 } ], "name": "Contracts #8284", "pmp_optimization_on_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "platform_access_fee_pct": 0, "financing_cost": [ { "currency_code": "USD", "value": 0 } ], "effective_end_date": "2020-04-30T00:00:00+0000", "optimization_fee_unit": "PCT_TOTAL_COST", "pmp_optimization_off_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "optimization_fee_pct": 0, "fbx_dynamic_cpm": [ { "currency_code": "USD", "value": 0.18 } ], "platform_monthly_min": 0, "exclude_agency_margin": false, "t1_as_fee_cpm": [ { "currency_code": "USD", "value": 0.05 } ], "entity_type": "contract", "programmatic_guaranteed_platform_access_fee_pct": 0, "managed_service_fee_unit": "PCT_TOTAL_COST", "organization_id": 100048, "version": 0, "profit_share_fee_pct": 0, "effective_start_date": "2019-06-01T00:00:00+0000", "peer39_safety_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "connected_id_cost": [ { "currency_code": "USD", "value": 0 } ], "external_media_tracking_cpm": [ { "currency_code": "USD", "value": 0.005 } ], "viewability_display_all_imps": 0.1, "evidon_privacy_cost_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "viewability_video_all_imps": 0.2, "adaptive_segment_cpm": [ { "currency_code": "USD", "value": 0.4 } ], "spend_cap": 0 } ], "uuid": "3523E56C-D977-11E9-90C7-A5F9AAC0597C", "meta": { "next_page": "https://api.mediamath.com/api/v2.0//contracts?full=*&page_limit=2&page_offset=2", "etag": "e54d229b57d37aee4f074cfceb03b74e19b49d03", "count": 2, "called_on": "2019-09-17T18:16:02+0000", "status": "ok", "offset": 0, "total_count": 19 } } }, "schema": { "example": { "data": { "adaptive_segment_cpm": [ {} ], "contract_number": -34492430, "currency_code": "Lorem cupidatat qui ullamco", "effective_end_date": "2017-09-01T00:00:00+0000", "effective_start_date": "2016-09-01T00:00:00+0000", "entity_type": "sit labore et Ut adipisicing", "evidon_privacy_cost_cpm": [ {}, {}, {}, { "currency_code": "do aute cillum deserunt qui", "value": -54392635 } ], "exclude_agency_margin": false, "external_media_tracking_cpm": [ {}, {} ], "fbx_dynamic_cpm": [ {}, {}, { "value": -47958450 }, {}, {} ], "managed_service_fee_pct": 63292875, "managed_service_fee_unit": "anim sint", "name": "irure reprehenderit Excepteur laboris", "optimization_fee_pct": -85118338, "optimization_fee_unit": "dolore ipsum pariatur", "organization_id": -9920526, "peer39_channel_fee_cpm": [ {}, { "value": -46124930 }, { "currency_code": "laborum", "value": 24673781 }, {} ], "peer39_custom_fee_cpm": [ {}, { "currency_code": "non deserunt cupidatat anim" }, {} ], "peer39_quality_fee_cpm": [ { "value": -85179 }, { "value": -10240689 }, { "value": -4954655 }, { "value": -84377398 } ], "peer39_safety_fee_cpm": [ {}, {}, {}, {} ], "platform_access_fee_pct": -71104119, "platform_access_fee_unit": "reprehenderit laborum dolor mollit ullamco", "platform_monthly_min": -73493003, "pmp_optimization_off_fee_cpm": [ { "currency_code": "ut sint ut occaecat" }, { "currency_code": "Excepteur ut tempor", "value": 99751657 } ], "pmp_optimization_off_unit": "sed esse nulla", "pmp_optimization_on_fee_cpm": [ { "currency_code": "ex deserunt p", "value": 38523577 }, { "value": -85647761 }, { "currency_code": "labore commodo consectetur consequat", "value": -49826722 }, {} ], "pmp_optimization_on_unit": "Ut", "profit_share_fee_pct": 41207491, "spend_cap": -12156130, "t1_as_fee_cpm": [ {}, { "value": 99250012 }, {} ], "t1_html5_fee_cpm": [ { "currency_code": "velit" }, {}, {}, {} ], "t1_vads_fee_cpm": [ { "value": -835869 }, {}, { "value": -398843 }, {}, { "currency_code": "sint ex aliqua irure exercitation" } ] }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "called_on": "laborum voluptate dolore", "count": 27422536, "etag": "enim id Excepteur magna", "offset": -47785040, "status": "amet", "total_count": -77774937 } }, "title": "Contracts Output", "type": "object", "x-stoplight": { "id": "contracts-output", "name": "Contracts Output", "public": true }, "properties": { "data": { "example": { "adaptive_segment_cpm": [ { "currency_code": "USD", "value": 0 } ], "contract_number": 103074, "currency_code": "USD", "effective_end_date": "2017-09-01T00:00:00+0000", "effective_start_date": "2016-09-01T00:00:00+0000", "entity_type": "contract", "evidon_privacy_cost_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "exclude_agency_margin": false, "external_media_tracking_cpm": [ { "currency_code": "USD", "value": 0.005 } ], "fbx_dynamic_cpm": [ { "currency_code": "USD", "value": 0.3 } ], "managed_service_fee_pct": 0, "managed_service_fee_unit": "PCT_TOTAL_COST", "name": "Contracts #3385", "optimization_fee_pct": 0, "optimization_fee_unit": "PCT_TOTAL_COST", "organization_id": 100048, "peer39_channel_fee_cpm": [ { "currency_code": "USD", "value": 0.1 } ], "peer39_custom_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ], "peer39_quality_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "peer39_safety_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "platform_access_fee_pct": 0, "platform_access_fee_unit": "PCT_TOTAL_COST", "platform_monthly_min": 0, "pmp_optimization_off_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_off_unit": "CPM", "pmp_optimization_on_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_on_unit": "CPM", "profit_share_fee_pct": 0, "spend_cap": 15000, "t1_as_fee_cpm": [ { "currency_code": "USD", "value": 0.02 } ], "t1_html5_fee_cpm": [ { "currency_code": "USD", "value": 0.08 } ], "t1_vads_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ] }, "title": "Contracts Input", "type": "object", "x-stoplight": { "id": "contracts-input", "name": "Contracts Input", "public": true }, "properties": { "adaptive_segment_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "audience_verification_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "connected_id_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "contract_number": { "type": "integer" }, "country_tax_withholding_fee_pct": { "type": "integer" }, "country_tax_withholding_fee_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "created_on": { "format": "date-time", "type": "string" }, "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "effective_end_date": { "type": "string" }, "effective_start_date": { "type": "string" }, "entity_type": { "type": "string", "description": "Should be set to \"contract\"" }, "evidon_privacy_cost_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "exclude_agency_margin": { "type": "boolean" }, "external_media_tracking_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "fbx_dynamic_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "financing_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "id": { "type": "integer" }, "managed_sevrice_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "managed_service_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied to impressions on campaigns where the campaign is set to be \"Managed By\" Managed Service." }, "managed_service_fee_unit": { "type": "string", "description": "This fee is applied to impressions on campaigns where the campaign is set to be \"Managed By\" Managed Service.\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "media_enablement_fee_pct": { "type": [ "integer", "number" ], "description": "" }, "media_enablement_fee_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "name": { "type": "string" }, "optimization_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied to impressions on campaigns where a strategy has optimization
turned on AND the campaign IS NOT \"Managed Service\"." }, "optimization_fee_unit": { "type": "string", "description": "This fee is applied to impressions on campaigns where a strategy has optimization
turned on AND the campaign IS NOT \"Managed Service\".\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "organization_id": { "type": "integer" }, "partnership_rebate_fee_pct": { "type": "integer" }, "partnership_rebate_fee_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "peer39_channel_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_custom_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_quality_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_safety_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "platform_access_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied for use of T1 on all inventory with exception of User-Sourced PMP." }, "platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all inventory with exception of User-Sourced PMP.\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "platform_monthly_min": { "type": "integer" }, "pmp_optimization_off_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "pmp_optimization_off_fee_pct": { "type": "number" }, "pmp_optimization_off_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "pmp_optimization_on_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "pmp_optimization_on_fee_pct": { "type": "integer" }, "pmp_optimization_on_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "profit_share_fee_pct": { "type": "integer" }, "programmatic_guaranteed_platform_access_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals." }, "programmatic_guaranteed_platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals.\n\nAcceptable values are: CPM, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "source_platform_access_fee_pct": { "type": "integer" }, "source_platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals.\n\nAcceptable values are: CPM, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "spend_cap": { "type": "integer" }, "standard_segment_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_as_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_html5_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_vads_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "updated_on": { "format": "date-time", "type": "string" }, "value": { "type": "integer" }, "version": { "type": "integer" }, "viewability_display_all_imps": { "type": "number" }, "viewability_display_sample": { "type": "number" }, "viewability_video_all_imps": { "type": "number" }, "viewability_video_sample": { "type": "number" } } }, "uuid": { "type": "string" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } } } } }, "summary": "List Contracts", "tags": [ "Contracts" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "GET-contracts", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "List a Contract" }, "parameters": [ { "in": "path", "name": "contract_id", "required": true, "type": "string" } ], "put": { "operationId": "PUT-a-contract", "parameters": [ { "in": "path", "name": "contract_id", "required": true, "type": "integer" }, { "in": "body", "name": "body", "schema": { "properties": {}, "type": "object" }, "x-examples": { "application/json": "" } } ], "responses": { "200": { "description": "", "examples": { "application/vnd.mediamath.v1+json": { "data": { "adaptive_segment_cpm": [ { "currency_code": "USD", "value": 0 } ], "contract_number": 103074, "created_on": "2016-08-29T19:54:25+0000", "currency_code": "USD", "effective_end_date": "2017-03-21T00:00:00+0000", "effective_start_date": "2016-09-01T00:00:00+0000", "entity_type": "contract", "evidon_privacy_cost_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "exclude_agency_margin": false, "external_media_tracking_cpm": [ { "currency_code": "USD", "value": 0.005 } ], "fbx_dynamic_cpm": [ { "currency_code": "USD", "value": 0.3 } ], "id": 3385, "managed_service_fee_pct": 0, "managed_service_fee_unit": "PCT_TOTAL_COST", "name": "Contracts #3385", "optimization_fee_pct": 0, "optimization_fee_unit": "PCT_TOTAL_COST", "organization_id": 100048, "peer39_channel_fee_cpm": [ { "currency_code": "USD", "value": 0.1 } ], "peer39_custom_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ], "peer39_quality_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "peer39_safety_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "platform_access_fee_pct": 0, "platform_access_fee_unit": "PCT_TOTAL_COST", "platform_monthly_min": 0, "pmp_optimization_off_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_off_unit": "CPM", "pmp_optimization_on_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_on_unit": "CPM", "profit_share_fee_pct": 0, "spend_cap": 15000, "t1_as_fee_cpm": [ { "currency_code": "USD", "value": 0.02 } ], "t1_html5_fee_cpm": [ { "currency_code": "USD", "value": 0.08 } ], "t1_vads_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ], "updated_on": "2016-08-29T19:54:25+0000", "version": 8 }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "called_on": "2017-03-03T20:08:20+0000", "etag": "2a64a9a52d66302464fe557340b33ec849028460", "status": "ok" } } }, "schema": { "example": { "data": { "adaptive_segment_cpm": [ {} ], "contract_number": -34492430, "currency_code": "Lorem cupidatat qui ullamco", "effective_end_date": "2017-09-01T00:00:00+0000", "effective_start_date": "2016-09-01T00:00:00+0000", "entity_type": "sit labore et Ut adipisicing", "evidon_privacy_cost_cpm": [ {}, {}, {}, { "currency_code": "do aute cillum deserunt qui", "value": -54392635 } ], "exclude_agency_margin": false, "external_media_tracking_cpm": [ {}, {} ], "fbx_dynamic_cpm": [ {}, {}, { "value": -47958450 }, {}, {} ], "managed_service_fee_pct": 63292875, "managed_service_fee_unit": "anim sint", "name": "irure reprehenderit Excepteur laboris", "optimization_fee_pct": -85118338, "optimization_fee_unit": "dolore ipsum pariatur", "organization_id": -9920526, "peer39_channel_fee_cpm": [ {}, { "value": -46124930 }, { "currency_code": "laborum", "value": 24673781 }, {} ], "peer39_custom_fee_cpm": [ {}, { "currency_code": "non deserunt cupidatat anim" }, {} ], "peer39_quality_fee_cpm": [ { "value": -85179 }, { "value": -10240689 }, { "value": -4954655 }, { "value": -84377398 } ], "peer39_safety_fee_cpm": [ {}, {}, {}, {} ], "platform_access_fee_pct": -71104119, "platform_access_fee_unit": "reprehenderit laborum dolor mollit ullamco", "platform_monthly_min": -73493003, "pmp_optimization_off_fee_cpm": [ { "currency_code": "ut sint ut occaecat" }, { "currency_code": "Excepteur ut tempor", "value": 99751657 } ], "pmp_optimization_off_unit": "sed esse nulla", "pmp_optimization_on_fee_cpm": [ { "currency_code": "ex deserunt p", "value": 38523577 }, { "value": -85647761 }, { "currency_code": "labore commodo consectetur consequat", "value": -49826722 }, {} ], "pmp_optimization_on_unit": "Ut", "profit_share_fee_pct": 41207491, "spend_cap": -12156130, "t1_as_fee_cpm": [ {}, { "value": 99250012 }, {} ], "t1_html5_fee_cpm": [ { "currency_code": "velit" }, {}, {}, {} ], "t1_vads_fee_cpm": [ { "value": -835869 }, {}, { "value": -398843 }, {}, { "currency_code": "sint ex aliqua irure exercitation" } ] }, "uuid": "E119F0A2-B21A-11E9-8F2B-D4AE668E900B", "meta": { "called_on": "laborum voluptate dolore", "count": 27422536, "etag": "enim id Excepteur magna", "offset": -47785040, "status": "amet", "total_count": -77774937 } }, "title": "Contracts Output", "type": "object", "x-stoplight": { "id": "contracts-output", "name": "Contracts Output", "public": true }, "properties": { "data": { "example": { "adaptive_segment_cpm": [ { "currency_code": "USD", "value": 0 } ], "contract_number": 103074, "currency_code": "USD", "effective_end_date": "2017-09-01T00:00:00+0000", "effective_start_date": "2016-09-01T00:00:00+0000", "entity_type": "contract", "evidon_privacy_cost_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "exclude_agency_margin": false, "external_media_tracking_cpm": [ { "currency_code": "USD", "value": 0.005 } ], "fbx_dynamic_cpm": [ { "currency_code": "USD", "value": 0.3 } ], "managed_service_fee_pct": 0, "managed_service_fee_unit": "PCT_TOTAL_COST", "name": "Contracts #3385", "optimization_fee_pct": 0, "optimization_fee_unit": "PCT_TOTAL_COST", "organization_id": 100048, "peer39_channel_fee_cpm": [ { "currency_code": "USD", "value": 0.1 } ], "peer39_custom_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ], "peer39_quality_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "peer39_safety_fee_cpm": [ { "currency_code": "USD", "value": 0.03 } ], "platform_access_fee_pct": 0, "platform_access_fee_unit": "PCT_TOTAL_COST", "platform_monthly_min": 0, "pmp_optimization_off_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_off_unit": "CPM", "pmp_optimization_on_fee_cpm": [ { "currency_code": "USD", "value": 0 } ], "pmp_optimization_on_unit": "CPM", "profit_share_fee_pct": 0, "spend_cap": 15000, "t1_as_fee_cpm": [ { "currency_code": "USD", "value": 0.02 } ], "t1_html5_fee_cpm": [ { "currency_code": "USD", "value": 0.08 } ], "t1_vads_fee_cpm": [ { "currency_code": "USD", "value": 0.15 } ] }, "title": "Contracts Input", "type": "object", "x-stoplight": { "id": "contracts-input", "name": "Contracts Input", "public": true }, "properties": { "adaptive_segment_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "audience_verification_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "connected_id_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "contract_number": { "type": "integer" }, "country_tax_withholding_fee_pct": { "type": "integer" }, "country_tax_withholding_fee_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "created_on": { "format": "date-time", "type": "string" }, "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "effective_end_date": { "type": "string" }, "effective_start_date": { "type": "string" }, "entity_type": { "type": "string", "description": "Should be set to \"contract\"" }, "evidon_privacy_cost_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "exclude_agency_margin": { "type": "boolean" }, "external_media_tracking_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "fbx_dynamic_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "financing_cost": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "id": { "type": "integer" }, "managed_sevrice_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "managed_service_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied to impressions on campaigns where the campaign is set to be \"Managed By\" Managed Service." }, "managed_service_fee_unit": { "type": "string", "description": "This fee is applied to impressions on campaigns where the campaign is set to be \"Managed By\" Managed Service.\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "media_enablement_fee_pct": { "type": [ "integer", "number" ], "description": "" }, "media_enablement_fee_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "name": { "type": "string" }, "optimization_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied to impressions on campaigns where a strategy has optimization
turned on AND the campaign IS NOT \"Managed Service\"." }, "optimization_fee_unit": { "type": "string", "description": "This fee is applied to impressions on campaigns where a strategy has optimization
turned on AND the campaign IS NOT \"Managed Service\".\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "organization_id": { "type": "integer" }, "partnership_rebate_fee_pct": { "type": "integer" }, "partnership_rebate_fee_unit": { "enum": [ "CPM", "PCT_TOTAL_COST" ], "type": "string" }, "peer39_channel_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_custom_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_quality_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "peer39_safety_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "platform_access_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied for use of T1 on all inventory with exception of User-Sourced PMP." }, "platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all inventory with exception of User-Sourced PMP.\n\nAcceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "platform_monthly_min": { "type": "integer" }, "pmp_optimization_off_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "pmp_optimization_off_fee_pct": { "type": "number" }, "pmp_optimization_off_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "pmp_optimization_on_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "integer" } } } }, "pmp_optimization_on_fee_pct": { "type": "integer" }, "pmp_optimization_on_unit": { "type": "string", "description": "Acceptable values are: CPM, FIXED, PCT_TOTAL_COST" }, "profit_share_fee_pct": { "type": "integer" }, "programmatic_guaranteed_platform_access_fee_pct": { "type": [ "integer", "number" ], "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals." }, "programmatic_guaranteed_platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals.\n\nAcceptable values are: CPM, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "source_platform_access_fee_pct": { "type": "integer" }, "source_platform_access_fee_unit": { "type": "string", "description": "This fee is applied for use of T1 on all impressions purchased via Programmatic Guaranteed deals.\n\nAcceptable values are: CPM, PCT_TOTAL_COST", "enum": [ "CPM", "PCT_TOTAL_COST" ] }, "spend_cap": { "type": "integer" }, "standard_segment_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_as_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_html5_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "t1_vads_fee_cpm": { "type": "array", "items": { "type": "object", "properties": { "currency_code": { "description": "ISO 4217 3-letter currency code", "type": "string" }, "value": { "type": "number" } } } }, "updated_on": { "format": "date-time", "type": "string" }, "value": { "type": "integer" }, "version": { "type": "integer" }, "viewability_display_all_imps": { "type": "number" }, "viewability_display_sample": { "type": "number" }, "viewability_video_all_imps": { "type": "number" }, "viewability_video_sample": { "type": "number" } } }, "uuid": { "type": "string" }, "meta": { "description": "Meta response for all API endpoints", "properties": { "called_on": { "type": "string" }, "count": { "type": "integer" }, "etag": { "type": "string" }, "offset": { "type": "integer" }, "status": { "type": "string" }, "total_count": { "type": "integer" } }, "title": "meta", "type": "object", "x-stoplight": { "id": "t1-meta", "name": "meta", "public": true } } } } } }, "summary": "Update Contracts", "tags": [ "Contracts" ], "x-stoplight": { "afterScript": null, "beforeScript": null, "id": "PUT-contracts", "mock": { "dynamic": false, "enabled": false, "statusCode": 200 }, "public": true }, "description": "Update a Contract" } }, "/creative_assets/approve": { "post": { "consumes": [ "multipart/form-data" ], "description": "## Second T1AS API call\n\n`POST $API_BASE/creative_assets/approve`\n\nURL encoded body parameters\n```\nis_https=1\nadvertiserid=178\nlandingPage.1=http://ad.vendor.com/clicktracker/?id=1234\nclick_url.1=http://theactuallandingpage.com\nprimary.1=DSP_PRO_160x600_v1.swf\nbackup.1=DSP_PRO_160x600_v1.jpg\nconcept.1=638\n```", "operationId": "POST_creative_assets-approve", "parameters": [ { "in": "formData", "name": "is_https", "type": "integer" }, { "in": "formData", "name": "advertiserid", "required": true, "type": "integer" }, { "in": "formData", "name": "landingPage.[x]", "required": true, "type": "string" }, { "in": "formData", "name": "click_url.[x]", "type": "string" }, { "in": "formData", "name": "primary.[x]", "required": true, "type": "string" }, { "in": "formData", "name": "backup.[x]", "type": "string" }, { "in": "formData", "name": "concept.[x]", "type": "integer" } ], "produces": [ "application/xml" ], "responses":