История страницы

Оглавление

Advertiser

...

Блок кода

language	js
title	Example
linenumbers	true

        {
            "id": "21",
            "name": "Any advertiser",
            "url": "http://advertiser.domain/",
            "timezone": "Europe/Moscow",
            "default_dsp_commission": "35",
            "currency": "USD",
            "prepayment_mode": "false",
            "hide_billing": "true",
            "credit": 10000,
			"max_budget": 4707.27			"max_budget": 4707.27
		}

Advertiser attributes

Attribute

Description

Required	Type	Description

Values

name

Default valuemax_budgetMax budget, available for advertiserinteger0..0

manage_campaigns_commissions

Activates managing DSP/Agency commissions at campaign levelbooleanfalse, true

hide_billing

Activating/hiding financial info in UIbooleanfalse, true

credit

max_budget

Campaign (Display)

yes	string	Advertiser name
`url`	no	string	Advertiser domain
`currency`	no	string	Advertiser currency

Campaign

Browser campaign

Блок кода

language	js
title	Example
linenumbers	true

{
	"name"

Блок кода

language	js
title	Example
linenumbers	true

{
	"name": "Test campaign!",
	"advertiser_id": 27,
	"test-field": "test",
	"starts": "2013-11-12 00:00:00",
	"ends": "2014-03-09 22:59:59",
	"currency": "USD",
	"creatives_type": "plain",
	"landing_page": "http://getintent.com",
	"disabled": true,
	"budget": 1000,
	"financing": {
		"type": "max_cpm",
		"price": 3.5
	},
	"commissionsgroup_id": {0,
		"agencytargeting": "0",{
		"dspgeo": "10"{
	},
		"group_idcountries": 0,[
	"was_enabled": 1421915484,
	"targeting": {
		"geo": {
			"countries": [
				"US"
			],
			"regions": [
				"US/FL",
				"US/PA",
				"US/NJ"
			],
			"cities": [
				"Jersey City",
				"Houston"
			],
			"dma_code": [
				"500",
				"502"
			],
			"zip_code": [
				"10010"
			]
		},
		"segments": [
			1009,
			1048,
			1050,
			1071
		],
		"categories": [
			"iab2",
			"iab2-1",
			"iab2-2",
			"iab2-3",
			"iab2-12"
		], 
		"frequency_capping": {
			"hour": 4,
			"day": 10,
			"week": 30
		},
		"weekdays": [
			"1",
			"2",
			"3",
			"4",
			"5",
			"6",
			"7"
		],
		"time": [
			"1",
			"2",
			"3",
			"4",
			"5",
			"6",
			"7",
			"8",
			"9",
			"10",
			"11",
			"12",
			"13",
			"14",
			"15",
			"16",
			"17",
			"18",
			"19",
			"20",
			"21",
			"22",
			"23",
			"0"
		],
		"ssps": [
			"goog",
			"bsw.rubicon",
			"bsw.pubmatic"
		],
		"page_language": [
			"en"
		],
		"devices": [
			"DESKTOP",
			"SMARTPHONE",
			"TABLET"
		],
		"positions": [
			"above",
			"below",
			"unknown"
		],
		"operating_systems": [
			"IOS",
			"ANDROID",
			"WINDOWS",
			"LINUX",
			"MACOS",
			"OTHER",
			"WINDOWS_PHONE"
		],
		"browsers": [
			"FIREFOX",
			"IE",
			"EDGE",
			"OPERA",
			"YANDEX",
			"CHROME",
			"SAFARI",
			"ANDROID_BROWSER",
			"OTHER"
		]
	},
	"negative_targeting": {
		"domains_lists": [
			"6"
		]
	},
	"daily_budget": 12,
	"site_id": 42,
	"creatives": [
		210,
		3013,
		3014,
		3015,
		3016,
		3017,
		3018,
		3019,
		3020,
		3021,
		3022,
		3023,
		3024
	]
}

...

In-App

...

campaign

Блок кода

language	js

      {
            "name": "In app campaign",
            "advertiser_id": "26",
            "starts": "2015-01-02 21:00:00",
            "ends": "2015-01-11 20:59:59",
            "group_id": "181",
            "currency": "USD",
            "budget": "3000",
            "financing": {
                "type": "max_cpm",
                "price": "3.25"
            },
            "targeting": {
                "devices": [
                    "SMARTPHONE"
                ],
	                "geo": {
                    "regions": [
                        "77",
                        "78"
                    ]
                },
                "mobile": {

                    					"application_category": [
                        "Business",
                        "IT&Gadgets",
                        "Education&Science",
                        "Reference"
                    ]
                },
                "frequency_capping": {
                    "day": "10",
                    "week": "30"
                },
                "operating_systems": [
                    "IOS"
                ]
            },
            "creatives_type": "plain",
            "landing_page": "https://...",
            "was_enableddisabled": 1420453290true,
            "disabledfor_mobile_device": "true",
            "commissionsnegative_targeting": {
                "agencymobile": 0,{
                    "dspapplication": "15"[
            },
            "for_mobile_device": "true"555717978",
            "negative_targeting": {
            "866990710",
        "mobile": {
               "799442576"
     "application": [
              ]
          "555717978",
      }
            },
      "866990710",
      "creatives": [
                 "7994425766869",
                "6870",
    ]
            "6871",
    }
            }"6872",
            "creatives": [
                "6869"6873",
                "68706874",
                "68716875",
                "68726876",
            ]
    "6873",
    }

Campaign attributes

Attribute	Required	Type	Description
`name`	yes	string	Campaign name
`currency`	yes	string	ISO-4217 currency code
`starts`	yes	YYYY-MM-DD HH:MM:SS formatted string	Campaign start time (UTC)
`ends`	yes	YYYY-MM-DD HH:MM:SS

...

formatted string	Campaign end time (UTC)
`for_mobile_device`	no	boolean	Is in-app campaign (default false)
`group_id`	no	integer	Campaign groupId in case campaign is sharing budget with other campaigns
`creative_type`	yes	string	Campaign creative type, enum value "plain"/"3rd_party_creatives"/"dynamic_creatives""video"/"native_creatives"
`budget`	yes	float	Campaign budget
`disabled`	no	boolean	Activates/stops campaign (default false)
`financing`	yes	object	Campaign pricing model
`landing_page`	yes	string	Declared campaign landing page URL
`daily_budget`	no	float	Campaign budget limit
`site_id`	no	integer	Campaign related site object
`creatives`	yes	array of integers	Campaign creatives
`targeting`	yes	object	Campaign positive targetings
`negative_targeting`	no	object	Campaign negative targetings
`fp_switch`	no	string	Fillrate predictor "on" - enabled "off" - disabled "inherit" - inherit fillrate predictor state from advertiser
`budget_pacing`	no	string	Campaign budget pacing. Values: "DAILY", "CAMPAIGN" (default "CAMPAIGN").

Campaign Financing

Attribute	Required	Type	Description
type	yes	string	Type of financing: fixed_cpm, max_cpm, target_cpc, target_cpmv, fixed_cpc, target_cpa
price	yes	string	Price value.
dynamic_prices	no	array of object	Micro Bidding configuration. See table below for object description.

Campaign Dynamic Financing

Attribute	Required	Type	Description
id	yes	number	Unique ID
price	yes	number	Price for the current set of features.
features	yes	object	Features for the current price
features.ssp	no	string	SSP name feature. Example: "adx"
features.browser	no	string	Browser name feature. Values: FIREFOX, IE, EDGE, OPERA, YANDEX, ANDROID_BROWSER, CHROME, SAFARI, FACEBOOK_APP
features.device	no	string	Device type feature. Values: UNKNOWN, SMARTPHONE, TABLET, DESKTOP, SMART_TV, GAME_CONSOLE
features.domain	no	string	Domain feature. Example: "*.google.com", "facebook.com"
features.app_id	no	string	Application ID feature. Example: "com.instagram.android", "389801252"
features.size	no	string	Creative Size feature. Example: "320x240"
features.os	no	string	Operating System feature. IOS, ANDROID, WINDOWS, LINUX, MACOS, OTHER, WINDOWS_PHONE, BLACKBERRY
features.segment_id	no	number	Segment id feature. Example: 16951

Example

Блок кода

language	js
title	Dynamic Financing JSON Example
linenumbers	true

"financing": {
		"type": "max_cpm",
		"price": "3",
		"dynamic_prices": [
			{
				"id": 1,
				"price": 5,
				"features": {
					"ssp": "bsw.brx",
                    "segment_id": 1000
				}
			},
			{
				"id": 2,
				"price": 6,
				"features": {
					"ssp": "bsw.vi",
					"domain": "*.google.com"
				}
			},
			{
				"id": 3,
				"price": 10,
				"features": {
					"ssp": "adx",
					"device": "SMARTPHONE",
					"domain": "cnn.com"
				}
			}
		]
	}

Campaign targetings

Campaign can have both positive and negative targetings, negative targeting features set is customisable.

GetIntent supports the following targeting list:

Targeting	Type	Description
`geo`	object	Placeholder for geo targetings
`geo.countries`	array of strings	Country codes
`geo.regions`	array of strings	Country region codes
`geo.cities`	array of strings	Cities
`geo.dma_code`	array of strings	DMA codes
`geo.zip_code`	array of strings	Zip codes
`segments`	array of strings	User segment targeting
`segments_all`	array of strings	User segment targeting - all at once
`categories`	array of strings	IAB content category targeting
`frequency_capping`	object	Frequency capping
`frequency_capping.week`	integer	Impressions per week (optional)
`frequency_capping.day`	integer	Impressions per day (optional)
`frequency_capping.hour`	integer	Impressions per hour (optional)
`weekdays`	array of integers	Weekday targeting: 1(Monday)..7(Sunday)
`time`	array of integers	Hour targeting: 0..23
`ssps`	array of strings	SSP targeting
`page_language`	array of strings	Browser language
`devices`	array of strings	Device targeting: "DESKTOP","SMARTPHONE","TABLET"
`positions`	array of strings	Position: "above","below","unknown"
`operating_systems`	array of strings	Operating systems targeting: "IOS","ANDROID","WINDOWS","LINUX","MACOS","OTHER","WINDOWS_PHONE"
`browsers`	array of strings	Browser targeting: "FIREFOX","IE","EDGE","OPERA","YANDEX","CHROME","SAFARI","ANDROID_BROWSER","OTHER"
`domains`	array of strings	Excluded domains (usually for negative targeting only)
`domains_lists`	array of integers	Domain list ID targeting (usually for negative targeting only)

Domains_lists/domains targeting can not be used simultaneously, only one targeting should be applied.

Geo taxonomy depend on GeoIP provider (different providers use different lists for country/regions).

Campaigns group

Блок кода

language	js
title	Example
linenumbers	true

        {
            "id": "1",
            "name": "Test",
            "advertiser_id": "2",
            "budget_limit": "100000.00"
        }

Campaign group attributes

Attribute	Required	Type	Description
`advertiser_id`	yes	integer	Advertiser Id
`name`	yes	string	Advertiser name
`budget_limit`	yes	float	Budget limit for the group of campaigns

Domains list

Блок кода

language	js
title	Example
linenumbers	true

{
	"name": "Test list",
	"advertiser_id": 27,
	"domains": [
		"yandex.ru",
		"google.com",
		"yahoo.com"
	]
}

Domain list attributes

Attribute	Required	Type	Description
`name`	yes	string	Domain list name
`domains`	yes	array of strings	Domains

Creative

Блок кода

language	js
title	Standard Creative Example
linenumbers	true

{
	"name": "1220849983_p9290052.jpg",
	"advertiser_id": 27,
	"creative_type": "plain",
	"url": "cdn.adhigh.net/media/1424168069-1220849983_p9290052.jpg",
	"size": "700x525"
}

Блок кода

language	js
title	Dynamic Creative Example
linenumbers	true

{
	"name": "240 for show",
	"advertiser_id": 27,
	"creative_type": "dynamic_creatives",
	"site_logo": "cdn.adhigh.net/media/1432213856-logo.png",
	"size": "240x400",
	"snippets": [
		169
	]
}

Блок кода

language	js
title	Third-party Creative Example
linenumbers	true

{
	"name": "Test_rtbmedia",
	"advertiser_id": 27,
	"creative_type": "3rd_party_creatives",
	"size": "300x250",
	"HTML": "<iframe src=\"http://localnetmarketer.com/ads/frame/300x250/722647/ad.html?t=142986782&click=[[CLICK_PREFIX_ENCODED]]\" style=\"border:0;width:300px;height:250px\"></iframe>\n\n",
	"ssl_compliant": "false",
	"click_tracking": "false"
}

Блок кода

language	js
title	Native Creative Example
linenumbers	true

{
	"name": "http://whoabella.com/whoabella-connected-s1e16-with-change-comes-challenge",
	"advertiser_id": 27,
	"creative_type": "native_creatives",
	"landing_page": "http://whoabella.com/monitordtr.php?i=pp.s1&url=http://whoabella.com/whoabella-connected-s1e16-with-change-comes-challenge/?utm_source=getintent&utm_medium=referral&utm_campaign=3bluemedia_camp1_cv1",
	"assets": [
		{
			"type": "img",
			"url": "nm.contextweb.com/media/1434570383-connected_cast.jpg",
			"image_type": 3,
			"size": "300x260"
		},
		{
			"type": "title",
			"text": "Check Out Latest Episode Of 'Connected'"
		},
		{
			"type": "data",
			"data_type": 1,
			"value": "Whoa Bella!"
		},
		{
			"type": "data",
			"data_type": 2,
			"value": "We've been rooting for Rosie's career to take off for a long time. Anyone can see that she's crazy talented, gorgeous and really freakin' deserves her big break and the sooner the better.\n\n"
		}
	]
}

Native Video Examples

Блок кода

language	js
title	Native Video Plain Example
linenumbers	true

 {
	"name": "http://whoabella.com/whoabella-connected-s1e16-with-change-comes-challenge

Campaigns group object

Блок кода

language	js
title	Example
linenumbers	true

        {
            "id": "1",
            "name": "Test",
            "advertiser_id": "2",
            "budget_limit": "100000.00"
        }

Domains list

Блок кода

language	js
title	Example
linenumbers	true

{
	"name": "Test list",
	"advertiser_id": 27,
	"domains": [
		"yandex.ru",
		"google.com",
		"yahoo.com"
	]
}

Creative

Блок кода

language	js
title	Standard Creative Example
linenumbers	true

{
	"name": "1220849983_p9290052.jpg",
	"advertiser_id": 27,
	"creative_type": "plain",
	"url": "cdn.adhigh.net/media/1424168069-1220849983_p9290052.jpg",
	"size": "700x525",
	"alternative_creative_id": "false"
}

{ "name": "Test_rtbmedia", "advertiser_id": 27, "creative_type": "3rd_party_creatives", "size": "300x250", "HTML": "<iframe src=\"http://localnetmarketer.com/ads/frame/300x250/722647/ad.html?t=142986782&click=[[CLICK_PREFIX_ENCODED]]\" style=\"border:0;width:300px;height:250px\"></iframe>\n\n", "ssl_compliant": "false", "click_tracking": "false" }

Блок кода

language	js
title	Dynamic Creative Example
linenumbers	true

{
	"name": "240 for show",
	"advertiser_id": 27,
	"creative_type": "dynamicnative_creatives",
	"sitelanding_logopage": "cdn.adhigh.net/media/1432213856-logo.png",
	"size": "240x400",
	"snippets": [
		169
	]
}

Блок кода

language	js
title	Third-party Creative Example
linenumbers	true

http://whoabella.com/monitordtr.php?i=pp.s1&url=http://whoabella.com/whoabella-connected-s1e16-with-change-comes-challenge/?utm_source=getintent&utm_medium=referral&utm_campaign=3bluemedia_camp1_cv1",
	"assets": [
		{
        	"type": "video",
        	"file": {
          		"url": "http://cdn.liverail.com/adasset4/1331/229/7969/me.mp4",
          		"file_size" : 1280000,
          		"size": "640x480"
        	},
        	"duration": 7,
        	"required": true
      }
	]
}

Блок кода

language	js
title	Native Creative Third Party Video Example
linenumbers	true

 {
	"name": "http://whoabella.com/whoabella-connected-s1e16-with-change-comes-challenge",
	"advertiser_id": 27,
	"creative_type": "native_creatives",
	"landing_page": "http://whoabella.com/monitordtr.php?i=pp.s1&url=http://whoabella.com/whoabella-connected-s1e16-with-change-comes-challenge/?utm_source=getintent&utm_medium=referral&utm_campaign=3bluemedia_camp1_cv1",
	"assets": [
		{
		        	"type": "imgvideo",
			"url": "nm.contextweb.com/media/1434570383-connected_cast.jpg",
			"image_type": 3,        	"third_party": {
				"sizewrapperTagUrl": "300x260"
		}http://vast.tag/vpaid.xml",
		{
			"typemime_types": ["application/javascript", "titlevideo/mp4"],
				"textssl_compliant": "Check Out Latest Episode Of 'Connected'"false
			},
		{
			"type        	"duration": "data",
			"data_type": 1,
			"value": "Whoa Bella!"
		},
		{
			"type": "data",
			"data_type": 2,
			"value": "We've been rooting for Rosie's career to take off for a long time. Anyone can see that she's crazy talented, gorgeous and really freakin' deserves her big break and the sooner the better.\n\n"
		}
	]
}7,
        	"required": true
      }
	]
}

Creative attributes

Attribute	Required	Type	Description
`name`	yes	string	Creative name
`advertiser_id`	yes	integer	Advertiser Id
`creative_type`	yes	string	Creative type, enum value: "plain"/"3rd_party_creatives"/"dynamic_creatives""video"/"native_creatives"
`landing_page`	no	string	Landing page URL (with macros)
`assets`	no	array of objects	Native creative assets
`asset.type`	yes	string	Asset type, enum value: "img","title","data","video"
`asset.data_type`	yes	integer	IAB data asset type

Site object

Блок кода

language	js
title	Example
linenumbers	true

{
	"name": "http://test.com",
	"advertiser_id": 27,
	"click_control": "false",
	"feed_url": "http://names.ru/bitrix/catalog_export/rtb.xml"
}

...

Блок кода

language	js
title	Third-party Segment Example
linenumbers	true

{
	"name": "AmberData",
	"name"available_to_all": true,
	"type": "3rdparty",
	"3rd_party_id": "AmberData/Продукты питания/Молочные продуктыvi_316104",
	"available_to_allprice": true1.5,
	"currency": "USD"
}

Segment attributes

Attribute	Required	Type	Description
`name`	yes	string	Creative name
`advertiser_id`	no	integer	Advertiser Id
`type`

...

	yes	string	Segment type, enum value: "standard"/"3rd_party"
`3rd_party_id`	no	string	3rd party segment Id
`price`	no	float	Segment price (CPM)
`currency`	no	string	Segment currency
`terms`	no	object	Segment rules

Snippet

Блок кода

language	js
title	Example
linenumbers	true

        {
            "id": "5",
            "name": "testDynamicCreativeSnippetJS",
            "advertiser_id": "45",
            "js": "var s = '<div style=\"padding: 6px 10px 0px 15px;border: 1px solid black;border-radius: 10px;\"'; for(var i=0; i<products.length && i<3; i++) {   var product=products[i]; s += '<p style=\"margin-top: 0px;\"><a href=\"' + product['url'] + '\"><img class=\"productImg\" src=\"' + product['picture'] + '\"/><br>' + product['name'] + ' <br> ' + product['price'] + ' руб.</a><br>'; } s+='</div>'; document.getElementById(elementId).innerHTML += s;",
            "css": "#creative_[[FUNCTION_NAME]] { border: 0px solid black; font-size: 10pt; font-family: Geneva, Arial, Helvetica, sans-serif; padding: 10px; } #creative_[[FUNCTION_NAME]] .productImg{width:100px;height:80px;}"
        }

chromechrome

Дерево страниц

Сравнение версий

Старая версия 16

Новая версия Текущий

Ключ

Advertiser

Campaign (Display)

Campaign

Browser campaign

In-App

campaign

Campaign attributes

Campaign Financing

Campaign Dynamic Financing

Example

Campaign targetings

Campaigns group

Domains list

Creative

Native Video Examples

Campaigns group object

Domains list

Creative

Site object

Snippet