Beruflich Dokumente
Kultur Dokumente
version 1.38
Services
Table of Contents
Services.................................................................................................................................................................................1
Adjustment Service..................................................................................................................................................1
AdvertiserDomain Service.......................................................................................................................................5
BuyingTerms Service.............................................................................................................................................10
Campaign Service.................................................................................................................................................13
Contact Service.....................................................................................................................................................20
Creative Service....................................................................................................................................................26
DemandBlocklist Service.......................................................................................................................................39
Dictionary Service..................................................................................................................................................42
Entity Service.........................................................................................................................................................54
InsertionOrder Service...........................................................................................................................................67
InventoryVisibilityControls Service.........................................................................................................................75
LineItem Service....................................................................................................................................................77
Linking Service......................................................................................................................................................86
Notification Service................................................................................................................................................92
Passback Service..................................................................................................................................................95
Pixel Service..........................................................................................................................................................97
PreferredTerms Service.......................................................................................................................................110
PublisherReservePrice Service...........................................................................................................................114
Quota Service......................................................................................................................................................116
Report Service.....................................................................................................................................................117
Rtbd Service........................................................................................................................................................120
Search Service....................................................................................................................................................122
Section Service....................................................................................................................................................123
SegmentDefinition Service..................................................................................................................................128
Segment Service.................................................................................................................................................130
Sitelist Service.....................................................................................................................................................134
Site Service..........................................................................................................................................................139
SupplyBlocklist Service........................................................................................................................................144
TargetProfile Service...........................................................................................................................................147
Data types..........................................................................................................................................................................189
ad_tag_options.....................................................................................................................................................189
adv_domain_blocklist...........................................................................................................................................191
advertiser_domain_blocklist_download................................................................................................................192
advertiser_domain_blocklist.................................................................................................................................192
advertiser_domain................................................................................................................................................192
advertiser_domain_industry_vertical....................................................................................................................194
advertiser_domain_parent....................................................................................................................................194
advertiser_domain_search_options......................................................................................................................195
advertiser_list........................................................................................................................................................195
advertiser_section_list..........................................................................................................................................196
adware_section_params.......................................................................................................................................197
age........................................................................................................................................................................198
beacon_search_options........................................................................................................................................198
blocklist_getall......................................................................................................................................................199
blocklist_search_options.......................................................................................................................................200
bought_segment...................................................................................................................................................201
browser.................................................................................................................................................................202
buying_terms........................................................................................................................................................202
buying_terms_managed_demand........................................................................................................................204
buying_terms_supply............................................................................................................................................204
campaign_goal.....................................................................................................................................................205
campaign..............................................................................................................................................................205
can_status............................................................................................................................................................209
ccp_creative_search_options...............................................................................................................................210
channel.................................................................................................................................................................213
Class Trees for Package soap_api-......................................................................................................................214
click_url_data........................................................................................................................................................214
click_url.................................................................................................................................................................214
comment...............................................................................................................................................................216
contact..................................................................................................................................................................216
content_buyer_contact.........................................................................................................................................219
content_seller_contact..........................................................................................................................................220
content_vendor_salt.............................................................................................................................................220
contract_history_item............................................................................................................................................221
contracting_entity..................................................................................................................................................221
country_group.......................................................................................................................................................221
country..................................................................................................................................................................222
creative_attachment.............................................................................................................................................223
creative_beacon_list_item....................................................................................................................................223
creative_classification_status...............................................................................................................................224
creative_comment_search_options......................................................................................................................224
creative_comments...............................................................................................................................................224
creative_content_expanded..................................................................................................................................225
Services
Table of Contents
Data types
creative_content...................................................................................................................................................225
creative_custom_object........................................................................................................................................226
creative_further_comment....................................................................................................................................227
creative.................................................................................................................................................................227
creative_lineitem...................................................................................................................................................237
creative_macro.....................................................................................................................................................237
creative_options....................................................................................................................................................237
creative_owner_data............................................................................................................................................239
creative_properties...............................................................................................................................................239
creative_publisher_comments..............................................................................................................................240
creative_reviewer..................................................................................................................................................240
creative_review_options.......................................................................................................................................240
creative_search_options.......................................................................................................................................241
creative_search_result..........................................................................................................................................244
creative_specs......................................................................................................................................................245
creative_tag_list_item...........................................................................................................................................248
creative_with_review_status.................................................................................................................................249
ct_report_result.....................................................................................................................................................250
currency................................................................................................................................................................250
custom_creative....................................................................................................................................................251
custom_geo_area.................................................................................................................................................252
custom_settings....................................................................................................................................................253
data_buyer_contact..............................................................................................................................................253
data_seller_contact...............................................................................................................................................253
date_imps.............................................................................................................................................................254
date_range............................................................................................................................................................254
daypart..................................................................................................................................................................255
dbl_creative_search_options................................................................................................................................255
deal_properties.....................................................................................................................................................257
default_target_profile............................................................................................................................................257
demand_blocklist..................................................................................................................................................258
demand.................................................................................................................................................................260
domain_url_data...................................................................................................................................................260
dxr_migration_reports...........................................................................................................................................261
Element index for package soap_api-..................................................................................................................261
e............................................................................................................................................................................261
i.............................................................................................................................................................................261
p............................................................................................................................................................................262
r.............................................................................................................................................................................262
entity_broker_fee..................................................................................................................................................262
entity_data............................................................................................................................................................263
entity.....................................................................................................................................................................264
entity_info.............................................................................................................................................................272
entity_official_contacts..........................................................................................................................................273
entity_shell............................................................................................................................................................273
exception_detail....................................................................................................................................................274
ex_entity_ids.........................................................................................................................................................274
flash_info..............................................................................................................................................................275
gender...................................................................................................................................................................275
gender_target.......................................................................................................................................................276
get_ivc_hidden_params........................................................................................................................................276
getrtbdadminqpsresp............................................................................................................................................277
getrtbdqpsresp......................................................................................................................................................277
global_template....................................................................................................................................................278
id_name................................................................................................................................................................280
insertion_order......................................................................................................................................................280
inventory_media_type...........................................................................................................................................286
inventory_type......................................................................................................................................................287
inventory_visibility_controls..................................................................................................................................287
isp.........................................................................................................................................................................288
ivc_hidden_params_details..................................................................................................................................289
ivc_hidden_params...............................................................................................................................................289
language...............................................................................................................................................................290
last_creative_reviewer_details..............................................................................................................................290
learn_type.............................................................................................................................................................291
line_item_adjustment............................................................................................................................................291
line_item_goal.......................................................................................................................................................293
line_item...............................................................................................................................................................293
link_data...............................................................................................................................................................301
linked_entities_info...............................................................................................................................................302
linking_profile........................................................................................................................................................303
linking_rating.........................................................................................................................................................305
YieldManager SOAP API Documentation.............................................................................................................305
login_options.........................................................................................................................................................306
Services
Table of Contents
Data types
macro_hidden_params.........................................................................................................................................306
managed_demand................................................................................................................................................307
managed_supply..................................................................................................................................................308
managing_entity_ids.............................................................................................................................................309
marketplace_settings............................................................................................................................................309
media_type...........................................................................................................................................................311
mg_label_mapping...............................................................................................................................................312
mime_type............................................................................................................................................................312
msa.......................................................................................................................................................................313
multiple_data_response........................................................................................................................................313
multiple_data_result..............................................................................................................................................314
multiple_result.......................................................................................................................................................315
netspeed...............................................................................................................................................................316
notice....................................................................................................................................................................316
offer_type..............................................................................................................................................................317
optimization_config...............................................................................................................................................317
optimization_para_name......................................................................................................................................318
passback...............................................................................................................................................................318
payment_method..................................................................................................................................................320
piggyback_pixel....................................................................................................................................................320
pixel......................................................................................................................................................................321
pixel_pair..............................................................................................................................................................324
pixel_tag_params.................................................................................................................................................324
placement_creative...............................................................................................................................................325
placement.............................................................................................................................................................334
pop_type...............................................................................................................................................................335
postal_code..........................................................................................................................................................335
postal_codes.........................................................................................................................................................336
preferred_terms_demand.....................................................................................................................................336
preferred_terms_getall..........................................................................................................................................337
preferred_terms....................................................................................................................................................338
preferred_terms_managed_supply.......................................................................................................................340
preferred_terms_search_options..........................................................................................................................342
private_marketplace_controls...............................................................................................................................342
private_marketplace.............................................................................................................................................343
publisher_control_data.........................................................................................................................................344
publisher_control_masks......................................................................................................................................345
publisher_data......................................................................................................................................................346
publisher_list.........................................................................................................................................................346
publisher_reserve_price_profile............................................................................................................................347
pv_section_data....................................................................................................................................................349
pvt_marketplace...................................................................................................................................................349
quicksearch_result................................................................................................................................................350
quota.....................................................................................................................................................................351
rating_options.......................................................................................................................................................352
region....................................................................................................................................................................352
reserve_price_buyer_entity..................................................................................................................................353
reserve_price_filter_options..................................................................................................................................354
richmedia_creative_attributes...............................................................................................................................354
role........................................................................................................................................................................355
rtbdadminqps........................................................................................................................................................355
rtbdbidurl...............................................................................................................................................................356
rtbdfailurereport....................................................................................................................................................357
rtbd_hidden_params.............................................................................................................................................358
rtbdqps..................................................................................................................................................................359
rtbdrecenttrafficreport...........................................................................................................................................360
rtbdsuccessreport.................................................................................................................................................361
rule_attribute.........................................................................................................................................................362
rule_attribute_ids..................................................................................................................................................363
rule_attribute_names............................................................................................................................................364
rule_dayparts........................................................................................................................................................364
rule_deal_properties.............................................................................................................................................364
rule_getall.............................................................................................................................................................365
rule_search_options.............................................................................................................................................366
rule_vurl_data.......................................................................................................................................................367
sales_region.........................................................................................................................................................367
search_data..........................................................................................................................................................368
section_custom_group..........................................................................................................................................368
section..................................................................................................................................................................369
section_url............................................................................................................................................................372
section_urls...........................................................................................................................................................372
segment_attributes...............................................................................................................................................372
segment_contributor.............................................................................................................................................373
segment................................................................................................................................................................373
Services
Table of Contents
Data types
segment_public_info.............................................................................................................................................376
segment_report_visibility......................................................................................................................................377
segment_search_options......................................................................................................................................378
segment_share.....................................................................................................................................................379
segment_share_info.............................................................................................................................................380
served_domain_data............................................................................................................................................380
session..................................................................................................................................................................381
site........................................................................................................................................................................381
size_data..............................................................................................................................................................383
size.......................................................................................................................................................................383
srt_segment_attributes.........................................................................................................................................384
srt_segment_report...............................................................................................................................................385
srt_segment_status..............................................................................................................................................385
supply_blocklist.....................................................................................................................................................386
supply...................................................................................................................................................................387
supported_locale..................................................................................................................................................388
supporting_file......................................................................................................................................................388
sync_segment_response......................................................................................................................................389
tag_emails............................................................................................................................................................389
target_advertiser_entity........................................................................................................................................390
target_age.............................................................................................................................................................390
target_asl..............................................................................................................................................................390
target_browser......................................................................................................................................................391
target_buyer_entity...............................................................................................................................................391
target_buyer_line_item.........................................................................................................................................391
target_cga.............................................................................................................................................................392
target_channel......................................................................................................................................................392
target_click_url......................................................................................................................................................392
target_click_url_object..........................................................................................................................................393
target_click_url_v2................................................................................................................................................393
target_country.......................................................................................................................................................393
target_creative_beacon........................................................................................................................................394
target_creative......................................................................................................................................................394
target_creative_tag...............................................................................................................................................394
target_csl..............................................................................................................................................................395
target_daypart.......................................................................................................................................................395
target_frequency...................................................................................................................................................395
target_gender.......................................................................................................................................................396
target_geography..................................................................................................................................................396
targeting_hidden_params.....................................................................................................................................397
targetings..............................................................................................................................................................397
target_inventory_media_type...............................................................................................................................400
target_inventory_type...........................................................................................................................................401
target_isp..............................................................................................................................................................401
target_language....................................................................................................................................................401
target_mobile_carrier_data...................................................................................................................................402
target_mobile_os_data.........................................................................................................................................402
target_netspeed....................................................................................................................................................402
target_offer_type...................................................................................................................................................403
target_pixel...........................................................................................................................................................403
target_pixels.........................................................................................................................................................404
target_profile.........................................................................................................................................................404
target_publisher_entity.........................................................................................................................................410
target_pvt_marketplace........................................................................................................................................410
target_querystring.................................................................................................................................................410
target_rating..........................................................................................................................................................411
target_section.......................................................................................................................................................411
target_seller_line_item..........................................................................................................................................412
target_size............................................................................................................................................................412
target_transparency..............................................................................................................................................412
target_url...............................................................................................................................................................413
target_vurl.............................................................................................................................................................413
target_vurl_tag......................................................................................................................................................413
target_woeid_cga.................................................................................................................................................414
target_woeid.........................................................................................................................................................414
techno_data..........................................................................................................................................................414
tiered_rev_share...................................................................................................................................................415
tpbe_currency.......................................................................................................................................................415
tp_billing_entity_preferences................................................................................................................................416
trading_pit_billing_entity.......................................................................................................................................416
trading_pit_blocklist..............................................................................................................................................417
trading_pit_creative_properties............................................................................................................................418
trading_pit_demand..............................................................................................................................................419
trading_pit_supply.................................................................................................................................................419
Services
Table of Contents
Data types
traf_monitor_alert..................................................................................................................................................420
url..........................................................................................................................................................................423
valid_vurl...............................................................................................................................................................423
vast_tag................................................................................................................................................................423
video_api_framework............................................................................................................................................424
video_creative.......................................................................................................................................................424
video_delivery.......................................................................................................................................................425
video_placement_type..........................................................................................................................................426
video_vast_type....................................................................................................................................................426
vurl_category........................................................................................................................................................426
vurl_data...............................................................................................................................................................427
vurl_get_data........................................................................................................................................................427
vurl........................................................................................................................................................................428
vurl_options..........................................................................................................................................................429
vurl_search_options..............................................................................................................................................431
vurl_tag_list...........................................................................................................................................................432
woeid....................................................................................................................................................................433
woeid_search_result.............................................................................................................................................435
Services
Adjustment Service
Adjustments allow you to change the data that the ad server recorded for a certain period of activity.
Review the Yahoo Ad Exchange Knowledge Base for additional details on adjustments.
https://api.yieldmanager.com/api-1.38/adjustment.php?wsdl
https://api-test.yieldmanager.com/api-1.38/adjustment.php?wsdl
Requests Summary
finalizeMonths Finalizes all the line item adjustments made for 1 line item during a given period (minimum
1 month).
get Returns the corresponding adjustment object.
getAll The getAll method returns line_item_adjustment records for the current entity and a specified date
range.
getAllByLineItem Get all existing line_item_adjustment records for the given period and line item.
getByBuyer Use the getByBuyer method to return adjustment records from a given buyer.
getCreatedByDates Returns all adjustments made within a specified date range.
getImpsByDates Returns numbers as an array of class with fields 'date' and 'imps.'
isMonthFinalized Return true if month is finalized, false otherwise.
reset Reset adjustments to a line item.
set Makes adjustments to a line item.
setDiscretionaryEcpm Sets discretionary_cpm and ecpm_calculation_method fields in a line_item.
submitCredit Adds additional credit to a line item.
Requests
finalizeMonths
Use finalizeMonths to finalize all the line item adjustments made for 1 line item during a given period (minimum 1
month).
Input parameters:
string $token: This variable represents your current API session token.
int $line_item_id: The ID of the line_item to be adjusted.
date $period_start: Beginning of period you want to finalize.
date $period_end: End of period you want to finalize.
Output parameters:
none
get (read-only)
Given an adjustment ID, this method returns the corresponding adjustment object. Note: When retrieving credits on
line items with advertiser billing price, refer to Retrieving credits on line items that use an advertiser billing price article
for additional details.
Input parameters:
string $token: This variable represents your current API session token.
int $adjustment_id: Use this to pass in an adjustment ID.
Output parameters:
1
Services
getAll (read-only)
The getAll method returns line_item_adjustment records for the current entity and a specified date range. Use the
getAll method to return an array of existing line_item_adjustment objects for a specified time period. Note: When
retrieving credits on line items with advertiser billing price, refer to Retrieving credits on line items that use an
advertiser billing price article for additional details.
Input parameters:
string $token: This variable represents your current API session token.
date $period_start: Defines the starting date for the adjustment period.
date $period_end: Defines the end date for the adjustment period.
enum_adjustments_type $type: Defines the type of adjustments to return: credit, discrepancy, and
linkedcredit. Discrepancy is default.
int $entries_on_page: A pagination parameter. Use this to get n number of results per page and break up a
larger report request into smaller chunks.
int $page_num: A pagination parameter. Use it with $entries_on_page to determine which page should hold
n number of results.
Output parameters:
getAllByLineItem (read-only)
Get all existing line_item_adjustment records for the given period and line item. Note: When retrieving credits on line
items with advertiser billing price, refer to Retrieving credits on line items that use an advertiser billing price article for
additional details.
Input parameters:
string $token: This variable represents your current API session token.
int $line_item_id: The ID of the line_item to be adjusted.
date $period_start: Defines the starting date for the adjustment period.
date $period_end: Defines the end date for the adjustment period.
enum_adjustments_type $type: Defines the type of adjustments to return: credit, discrepancy, and
linkedcredit. Discrepancy is default.
Output parameters:
getByBuyer (read-only)
Return adjustment records from a given buyer. Note: The current entity ID will be used if $buyer_entity_id is null.
When retrieving credits on line items with advertiser billing price, refer to Retrieving credits on line items that use an
advertiser billing price article for additional details.
Input parameters:
string $token: This variable represents your current API session token.
2
Services
Output parameters:
getCreatedByDates (read-only)
Returns all adjustments made within a specified date range. Note: When retrieving credits on line items with advertiser
billing price, refer to Retrieving credits on line items that use an advertiser billing price article for additional details.
Input parameters:
string $token: This variable represents your current API session token.
date $start_date: Defines the starting date for the adjustment period.
date $end_date: Defines the end date for the adjustment period.
enum_adjustments_type $type: Defines the type of adjustments to return: credit, discrepancy, and
linkedcredit. Discrepancy is default.
int $entries_on_page: A pagination parameter. Use this to get n number of results per page and break up a
larger report request into smaller chunks.
int $page_num: A pagination parameter. Use this with $entries_on_page to determine which page should
hold n number of results.
Output parameters:
getImpsByDates (read-only)
Returns numbers as an array of class with fields 'date' and 'imps.' Note: When retrieving credits on line items with
advertiser billing price, refer to Retrieving credits on line items that use an advertiser billing price article for additional
details.
Input parameters:
string $token: This variable represents your current API session token.
int $line_item_id: The ID of the line_item to be adjusted.
date $range_start: Defines the starting date for the adjustment period.
date $range_end: Defines the end date for the adjustment period.
Output parameters:
array_of_date_imps $date_imps
isMonthFinalized (read-only)
Input parameters:
3
Services
string $token: This variable represents your current API session token.
int $line_item_id: The ID of the line_item to be adjusted.
date $date: This is the month to be checked. Use the format yyyy-mm-dd.
Output parameters:
boolean $is_finalized
reset
Reset adjustments with the status complete, delete_complete, or error_reset. See also Adjustments_Troubleshooting
for additional details on resetting adjustments.
Input parameters:
string $token: This variable represents your current API session token.
int $line_item_id: The ID of the line_item to be adjusted.
date $range_start: Defines the starting date for the adjustment period.
date $range_end: Defines the end date for the adjustment period.
Output parameters:
none
set
Makes adjustments to a line item. The total adjustment value will be spread evenly across adjustments for each day if
any line_item_adjustment contains a date range of more than 1 day.
Review the following Exchange Knowledge Base articles for more information:
Adjustments: Overview
Discretionary adjustments: About
Input parameters:
string $token: This variable represents your current API session token.
int $line_item_id: The ID of the line_item to be adjusted.
array_of_line_item_adjustment $line_item_adjustments: An array of line_item_adjustment objects.
Output parameters:
setDiscretionaryEcpm
Input parameters:
4
Services
string $token: This variable represents your current API session token.
int $line_item_id: The ID of the line_item to be adjusted.
enum_calculation_method $calculation_method
Output parameters:
none
submitCredit
Used to add additional credit to a line item. See Credits_Overview for more details. Use the UI to approve credits
when $auto_approve = false. Note: When submitting credits on line items with advertiser billing price, refer to
Submitting credits on line items that use an advertiser billing price article for additional details.
Input parameters:
string $token: This variable represents your current API session token.
int $line_item_id: The ID of the line_item to be adjusted.
date $month: Month to be adjusted. Use the format yyyy-mm-dd.
float $final_revenue: Total value of the month's revenue. For fixed-rate, this is in USD; for dynamic-rate, this
is in the currency specified by the owning entity's currency_id.
string $comment: Comment explaining the adjustment.
boolean $auto_approve: Automatically approve the credit. Defaults to "true," but "true" will only be accepted
if the month is complete.
Output parameters:
AdvertiserDomain Service
Advertiser Domain Service lets api users to manage advertiser domains and advertiser block lists.
Seller Networks upload the advertiser domains & this list will be available for blocking at supplier seat or its managed
publisher level. Buyer Network can download blocklist to identify which supplier are blocking which advertiser
domains.
https://api.yieldmanager.com/api-1.38/advertiser_domain.php?wsdl
https://api-test.yieldmanager.com/api-1.38/advertiser_domain.php?wsdl
Requests Summary
add Creates a one or more new advertiser domains
delete Deletes advertiser domains. The input object should be domain ids
deleteByUrls Deletes advertiser domains. The input object should be domain urls.
downloadBlockList Downloads the blocked advertiser domains set by publishers. This API is to used by
Advertising Networks.
getAll Retrieves all advertiser domains that were previously created.
getAllSince Return advertiser domains changed between start_date and end_date.
getBlockList Retrieves block list of advertiser domains that are currently set.
getByDomainUrls Retrieves all advertiser domains that were previously created.
getByIds Retrieves all advertiser domains that were previously created.
getIndustryVerticals Returns available list of industry verticals
getParentBrands Returns available list of advertiser domain parents
listAllSince Return advertiser domain IDs changed between start_date and end_date.
search Retrieves all advertiser domains matching search criteria.
setBlockList Sets the list of advertiser domains as the block list.
update Updates advertiser domains. The input object should contain either id or domain.
Requests
5
Services
add
Input parameters:
string $token: This variable represents your current API session token.
array_of_advertiser_domain $advertiser_domains
Output parameters:
delete
Input parameters:
string $token: This variable represents your current API session token.
array_of_int $advertiser_domain_ids
Output parameters:
deleteByUrls
Input parameters:
string $token: This variable represents your current API session token.
array_of_string $advertiser_domain_urls
Output parameters:
downloadBlockList (read-only)
Downloads the blocked advertiser domains set by publishers. This API is to used by Advertising Networks.
Input parameters:
string $token: This variable represents your current API session token.
int $seller_entity_id: entity id of the seller seat or publisher
int $buyer_entity_id: entity id of the buyer
array_of_string $domain_urls: Optional domain list when set,retrieves blocklist for those specific domains.
If the list is empty all the domains that are blocked is retrieved.
6
Services
Output parameters:
array_of_advertiser_domain_blocklist_download $blocklists
getAll (read-only)
Input parameters:
string $token: This variable represents your current API session token.
enum_advertiser_domain_search_status $status: See valid types in Advertiser Domain Search Status
Enum
int $entries_on_page: A pagination parameter. Use this to get n number of results per page and break up a
larger report request into smaller chunks.
int $page_num: A pagination parameter. Use it with $entries_on_page to determine which page should hold
n number of results.
Output parameters:
getAllSince (read-only)
Note: This method sets the start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time
interval to 24 hours or less.
Input parameters:
string $token
dateTime $start_date
dateTime $end_date
int $entries_on_page
int $page_num
Output parameters:
getBlockList (read-only)
Input parameters:
string $token: This variable represents your current API session token.
int $seller_entity_id: entity id of the seller seat or publisher (get by network on behalf of the publisher)
int $buyer_entity_id: entity id of the buyer
Output parameters:
7
Services
array_of_domain_url_data $domain_urls
getByDomainUrls (read-only)
Input parameters:
string $token: This variable represents your current API session token.
array_of_string $domain_urls: advertiser domain urls
Output parameters:
getByIds (read-only)
Input parameters:
string $token: This variable represents your current API session token.
array_of_int $ids: advertiser domain ids
Output parameters:
getIndustryVerticals (read-only)
Input parameters:
Output parameters:
getParentBrands (read-only)
Input parameters:
Output parameters:
8
Services
listAllSince (read-only)
Note: This method sets the start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time
interval to 24 hours or less.
Input parameters:
string $token
dateTime $start_date
dateTime $end_date
Output parameters:
array_of_int $ids
search (read-only)
Input parameters:
string $token: This variable represents your current API session token.
advertiser_domain_search_options $search_options
int $entries_on_page: A pagination parameter. Use this to get n number of results per page and break up a
larger report request into smaller chunks.
int $page_num: A pagination parameter. Use it with $entries_on_page to determine which page should hold
n number of results.
Output parameters:
setBlockList
Input parameters:
string $token: This variable represents your current API session token.
int $seller_entity_id: entity id of the seller seat or publisher (set by network on behalf of the publisher)
array_of_advertiser_domain_blocklist $blocklist: Array of buyer id and corresponding domains to be
blocked for that buyer. Buyer id=0 corresponds to global blocking. Example 0 => array('www.xxx.com')
means 'www.xxx.com' is globally blocked for all buyers.
Output parameters:
none
update
9
Services
Updates advertiser domains. The input object should contain either id or domain.
Input parameters:
string $token: This variable represents your current API session token.
array_of_advertiser_domain $advertiser_domains
Output parameters:
BuyingTerms Service
This service lets you add/modify/delete/get buying terms.
Review the Buying terms section in the Yield Manager Knowledge Base for additional details.
Requests Summary
add Add/Create business terms on inventory on behalf of managed demand.
delete Deletes business terms on inventory created on behalf of managed demand.
getAllBuyingTerms Returns an array of all business terms on inventory created on behalf of managed
demand that you are allowed to access.
getAllSince Return all buying terms changed between a specified start_date and end_date.
getByObjectId Returns the buying_terms data object for specified id.
listAll Returns buying_terms data object ids that you are allowed to access.
listAllSince Return buying terms IDs changed between a specified start_date and end_date.
quickSearch Returns an array of all buying terms you are allowed to access.
update Modify business terms on inventory on behalf of managed demand.
Requests
add
Input parameters:
Output parameters:
delete
10
Services
Input parameters:
Output parameters:
none
getAllBuyingTerms (read-only)
Returns an array of all business terms on inventory created on behalf of managed demand that you are allowed to
access.
Input parameters:
Output parameters:
array_of_buying_terms $buying_terms
int $total_count: The total number of records returned in the result set.
getAllSince (read-only)
Return buying terms IDs changed between a specified start_date and end_date. Note: This method sets the
start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
getByObjectId (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
buying_terms $buying_terms
11
Services
listAll (read-only)
Returns buying_terms data object ids that you are allowed to access.
Input parameters:
Output parameters:
array_of_int $buying_terms_ids
listAllSince (read-only)
Return buying terms IDs changed between a specified start_date and end_date. Note: This method sets the
start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
quickSearch (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
array_of_rule_getall $buying_terms
int $total_count: The total number of records returned in the result set.
update
Input parameters:
12
Services
Output parameters:
none
Campaign Service
The CampaignService lets you add or modify a campaign and prepare it for trafficking.
The campaign starts trafficking only after all elements of the trafficking chain (creative, line item, insertion order, etc.)
are set active. See the Campiagn setup tutorial for additional details.
https://api.yieldmanager.com/api-1.38/campaign.php?wsdl
https://api-test.yieldmanager.com/api-1.38/campaign.php?wsdl
Requests Summary
add This api is no more supported. Use line_item service instead.
addCreative This api is no more supported. Use line_item service instead.
addCreatives This api is no more supported. Use line_item service instead.
addLineItem This api is no more supported. Use line_item service instead.
delCreative Deletes a creative from a campaign.
delete Deletes a single campaign.
deleteCampaigns Deletes multiple campaigns.
delLineItem Removes the link between a line item and a campaign.
get Retrieves all information about the specified campaign.
getAll Gets the list of all campaign objects you are authorized to see.
getAllSince Returns campaigns changed between start_date and end_date.
getByCreative Returns an array of all campaign data objects for a creative.
getByEntity Get the list of campaign objects for the specified entity.
getByLineItem Returns an array of all campaign data objects for a give line item.
listAll Gets the list of all campaign IDs you are authorized to see.
listAllDeletedSince Returns campaign IDs deleted between a specified start_date and end_date.
listAllSince Returns the campaign IDs changed between a specified start_date and end_date.
listByCreative Returns an array of all campaign data objects for a creative.
listByEntity Gets the list of campaign IDs for the specified entity.
listByLineItem Returns the array of campaign IDs associated with a line item.
lookup Returns a list of all campaign IDs for a given integration code.
update Used to modify a campaign.
Requests
add
This api is no more supported. Use line_item service instead. Create a new campaign for the advertiser specified by
campaign::$advertiser_entity_id. Note: Set the $advertiser_entity_id property of the campaign object before passing it
to this method.
Input parameters:
string $token: This variable represents your current API session token.
campaign $campaign: campaign data object.
Output parameters:
13
Services
addCreative
This api is no more supported. Use line_item service instead. Adds a single creative to a campaign. Note: You must
have the creative ID and campaign ID already created to use this method. See the:
CreativeService::add() method
CampaignService::add() method
Input parameters:
string $token: This variable represents your current API session token.
int $campaign_id: Campaign ID.
int $creative_id: Creative ID.
Output parameters:
none
addCreatives
This api is no more supported. Use line_item service instead. Adds multiple creatives to a campaign. Note: You must
have the creative ID and campaign ID already created to use this method. See the:
CreativeService::add() method
@link CampaignService::add()} method
has_transaction_commit
Input parameters:
string $token: This variable represents your current API session token.
int $campaign_id: Campaign ID.
array_of_int $creative_ids: Creative IDs.
Output parameters:
array_of_multiple_data_result $results
addLineItem
This api is no more supported. Use line_item service instead. Sets up a link between the line item and the campaign
specified by the line item ID and campaign ID. See LineItemService::add() and CampaignService::add().
Input parameters:
14
Services
string $token: This variable represents your current API session token.
int $campaign_id: campaign data object.
int $line_item_id: line_item data object.
Output parameters:
none
delCreative
Input parameters:
string $token: This variable represents your current API session token.
int $campaign_id: Campaign ID.
int $creative_id: Creative ID.
Output parameters:
none
delete
Used to delete an existing (single) campaign. Note: Use with care. You can delete an active or inactive campaign with
this method. Deactivate your campaign first before deleting it.
Input parameters:
string $token: This variable represents your current API session token.
int $id: Campaign ID.
Output parameters:
none
deleteCampaigns
Deletes multiple campaigns. Note: Use with care. You can delete active or inactive campaigns with this method.
Deactivate your campaigns first before deleting them.
has_transaction_commit
Input parameters:
string $token: This variable represents your current API session token.
array_of_int $ids: Campaign IDs.
Output parameters:
delLineItem
15
Services
Remove the link between the line item and the campaign specified by the line item ID and campaign ID.
Input parameters:
string $token: This variable represents your current API session token.
int $campaign_id: campaign data object.
int $line_item_id: line_item data object.
Output parameters:
none
get (read-only)
Input parameters:
string $token: This variable represents your current API session token.
int $id: Campaign ID.
Output parameters:
getAll (read-only)
Returns the array of campaign objects which you are allowed to see.
Input parameters:
string $token: This variable represents your current API session token.
int $entries_on_page: A pagination parameter. Use this to get n number of results per page and break up a
larger report request into smaller chunks.
int $page_num: A pagination parameter. Use it with $entries_on_page to determine which page should hold
n number of results.
Output parameters:
getAllSince (read-only)
Note: This method sets the start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time
interval to 24 hours or less.
Input parameters:
string $token: This variable represents your current API session token.
dateTime $start_date: Specified in yyyy-mm-dd hh:mm:ss format.
dateTime $end_date: Specified in yyyy-mm-dd hh:mm:ss format.
16
Services
int $entries_on_page: A pagination parameter. Use this to get n number of results per page and break up a
larger report request into smaller chunks.
int $page_num: A pagination parameter. Use it with $entries_on_page to determine which page should hold
n number of results.
Output parameters:
getByCreative
Returns an array of all campaign data objects for a creative. Use the CampaignService::addCreative() method to link
campaigns and creatives together.
Input parameters:
string $token: This variable represents your current API session token.
int $creative_id: Creative ID.
int $entries_on_page: A pagination parameter. Use this to get n number of results per page and break up a
larger report request into smaller chunks.
int $page_num: A pagination parameter. Use it with $entries_on_page to determine which page should hold
n number of results.
Output parameters:
array_of_campaign $campaigns: An array of the entire campaign object for each campaign returned by this
method.
int $total_count: The total number of records returned in the result set.
getByEntity (read-only)
Return the array of campaign data objects that belong to the entity specified by entity_id.
Input parameters:
string $token: This variable represents your current API session token.
int $entity_id: Entity ID.
int $entries_on_page: A pagination parameter. Use this to get n number of results per page and break up a
larger report request into smaller chunks.
int $page_num: A pagination parameter. Use it with $entries_on_page to determine which page should hold
n number of results.
Output parameters:
getByLineItem
Return an array of all campaign data objects for a line item. You can use CampaignService::addLineItem() to link
campaigns and line items together.
17
Services
Network
Input parameters:
string $token: This variable represents your current API session token.
int $li_id: Line item ID.
int $entries_on_page: A pagination parameter. Use this to get n number of results per page and break up a
larger report request into smaller chunks.
int $page_num: A pagination parameter. Use it with $entries_on_page to determine which page should hold
n number of results.
Output parameters:
array_of_campaign $campaigns: An array of the entire campaign object for each campaign returned by this
method.
int $total_count: The total number of records returned in the result set.
listAll (read-only)
Returns the array of campaign IDs which you are allowed to see. Use CampaignService::get() to get the whole
campaign data object by its ID.
Input parameters:
string $token: This variable represents your current API session token.
Output parameters:
listAllDeletedSince (read-only)
Returns campaign IDs deleted between a specified start_date and end_date. Note: This method sets the start_date =
'0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
string $token: This variable represents your current API session token.
dateTime $start_date: Specified in yyyy-mm-dd hh:mm:ss format.
dateTime $end_date: Specified in yyyy-mm-dd hh:mm:ss format.
Output parameters:
array_of_int $ids
listAllSince (read-only)
Returns campaign IDs changed between a specified start_date and end_date. Note: This method sets the start_date =
'0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
string $token: This variable represents your current API session token.
dateTime $start_date: Specified in yyyy-mm-dd hh:mm:ss format.
dateTime $end_date: Specified in yyyy-mm-dd hh:mm:ss format.
18
Services
Output parameters:
array_of_int $ids
listByCreative
Return an array of all campaign data objects for a creative. Use the CampaignService::addCreative() method to link
campaigns and creatives together.
Input parameters:
string $token: This variable represents your current API session token.
int $creative_id: Creative ID.
Output parameters:
array_of_int $campaigns: An array of the entire campaign object for each campaign returned by this
method.
listByEntity (read-only)
Return the array of campaign IDs which belong to the entity specified by entity_id. Use CampaignService::get() to get
the whole campaign data object by its id.
Input parameters:
string $token: This variable represents your current API session token.
int $entity_id: Entity ID.
Output parameters:
listByLineItem
Returns the array of campaign IDs associated with a line item. You can use CampaignService::addLineItem() to link
campaigns and line items together. You can use then CampaignService::get() to get the whole campaign data object
by its id.
Input parameters:
string $token: This variable represents your current API session token.
int $li_id: Line item ID.
Output parameters:
array_of_int $campaign_ids
19
Services
lookup
Return the array of arrays of campaign IDs for a given integration code. You can use CampaignService::get() to get
the whole campaign data object by its id.
Input parameters:
string $token: This variable represents your current API session token.
array_of_string $codes: Campaign codes.
Output parameters:
update
Update modifies the fields of a campaign data object. Notes: Some fields are system generated (e.g. campaign::$id)
and can't be changed by the client.
If you're updating cpc_target field, learning position for related line_item will be re-calculated
Input parameters:
string $token: This variable represents your current API session token.
campaign $campaign: modified campaign data object
Output parameters:
none
Contact Service
This service allows you to manage entity contacts. Also it provides an API to get a session token required to access
other API calls.
Requests Summary
add add a new contact
changePassword change contact password
delete delete a contact
get retrieve all contact information
getActiveSessions List existing sessions
getAll get all the contacts you are authorized to see
getAllSince Return contacts changed between start_date and end_date.
getByEntity get all the contacts you are authorized to see by entity id
getSelf retrieve all information about the current contact
listAll get all the contacts you are authorized to see
listAllDeletedSince Return contact IDs deleted between start_date and end_date.
listAllSince Return contact IDs changed between start_date and end_date.
listByEntity get all the contacts you are authorized to see by entity id
login create a session token
logout drop session token
logoutAll cancel all currently active sessions for the user
20
Services
Requests
add
Input parameters:
Output parameters:
changePassword
Input parameters:
Output parameters:
none
delete
Input parameters:
Output parameters:
none
get (read-only)
Input parameters:
21
Services
Output parameters:
getActiveSessions
Accessible for all entity types
Input parameters:
Output parameters:
getAll (read-only)
Return the array of contact' objects which you are allowed to see according to security model.
Input parameters:
Output parameters:
getAllSince (read-only)
Note: This method sets the start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time
interval to 24 hours or less.
Input parameters:
string $token
dateTime $start_date
dateTime $end_date
int $entries_on_page
int $page_num
Output parameters:
getByEntity (read-only)
Return the array of contact' objects with the specified entity_id which you are allowed to see according to security
model.
22
Services
Input parameters:
Output parameters:
getSelf (read-only)
Return the full contact data object about the current contact.
Input parameters:
Output parameters:
listAll (read-only)
Return the array of contact' id which you are allowed to see according to security model. Use ContactService::get() to
get whole contact data object by its id.
Input parameters:
Output parameters:
listAllDeletedSince (read-only)
Note: This method sets the start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time
interval to 24 hours or less.
Input parameters:
string $token
dateTime $start_date
dateTime $end_date
Output parameters:
array_of_int $ids
23
Services
listAllSince (read-only)
Note: This method sets the start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time
interval to 24 hours or less.
Input parameters:
string $token
dateTime $start_date
dateTime $end_date
Output parameters:
array_of_int $ids
listByEntity (read-only)
Return the array of contact' id with the specified entity_id which you are allowed to see according to security model.
Use ContactService::get() to get whole contact data object by its id.
Input parameters:
Output parameters:
login
Return the session token required by all other API calls. Normally you need to login at the start of your API client
program.
Creative Tester
Input parameters:
Output parameters:
logout (read-only)
24
Services
Creative Tester
has_transaction_commit
Input parameters:
Output parameters:
none
logoutAll
Accessible for all entity types
Input parameters:
Output parameters:
none
setPassword
Set the password on the contact. The user must use this new password next time they log in.
Input parameters:
Output parameters:
none
update
Change the fields of a contact data object. Keep in mind that some fields are generated behind API (e.g. contact::$id)
and cannot be changed by client.
Input parameters:
Output parameters:
none
validateCredentials (read-only)
Accessible for all entity types
Input parameters:
25
Services
Output parameters:
boolean $contact_valid: Returns 'true' if valid contact exists. Returns 'false' if contact is invalid.
Creative Service
The CreativeService lets you add/modify a creative and prepare it for trafficking.
Reivew the Creatives section in the Yield Manager Knowledge Base for additonal details. Note: Creatives start serving
only after all elements of the trafficking chain (campaign, line item, insertion order, delivery rules, etc.) are completed
and made active.
https://api.yieldmanager.com/api-1.38/creative.php?wsdl
https://api-test.yieldmanager.com/api-1.38/creative.php?wsdl
Requests Summary
add Adds a new creative.
addAttach Adds the new creative and attaches it to specified line item.
addAttachCreatives Adds the given creatives and attaches it to specified line items.
addCreatives Adds new creatives.
addSupportingFiles Used to upload a creative binary file and generate a filename for the creative.
attachSegments Attaches segment pixels to a creative.
delete Deletes a single creative.
deleteCreatives Deletes multiple creatives.
deleteSupportingFiles Deletes temporary creative files that were uploaded using addSupportingFiles() but
not associated with a creative_content object.
detachSegments Detach segments from creative
get Retrieves all information about the specified creative.
getAll Gets the list of all the creative objects you are allowed to see.
getAllSince Returns creatives changed between a specified start_date and end_date.
getAttachedSegments Returns a list of segment pixel objects attached to a creative.
getByCampaign Returns all the creative data types linked to the campaign.
getByEntity Returns all contact data objects by specified entity ID.
getByIntCode Retrieve all information about the specified creative and review status with the code
(externalCreativeID) and advertiseID.
getByIntCodes Retrieve all information about the specified creatives and review status with the codes
(externalCreativeID) and advertiseID.
getByLineItem Returns an array of all creative objects linked to a given line_item (indirectly via
campaigns).
getClassificationReport Used to get the current status of misclassified creative.
getCreativeBeacons Used to get a list of Creative Beacons associated with a creative.
getCreativeComments Used to fetch creative review comments.
getCreativeSpecs Used to get a list of creative_specs objects for a creative.
getCreativeTags Used to get a list of Creative Tags associated with a creative.
getFullCTStack Used to retrieve full call stack of Creative Tester for non ssl creative.
getMGSuggestedClassification Used to retrieve creative misclassification suggested by the Media Guard.
getNonSslUrls Used to retrieve creative non secure urls checked by Creative Tester.
getReviewStatus Returns review status for the specified creativeID
isAudited Checks a given creative to see if it was audited by Media Guard.
listAll Gets the list of all creative IDs you are authorized to see.
listAllDeletedSince Returns creative IDs deleted between a specified start_date and end_date.
listAllSince Returns creative IDs changed between a specified start_date and end_date.
listAttachedSegments Returns a list of segment pixel IDs attached to creative
listByCampaign Returns the array of creative IDs associated with a campaign.
listByEntity Returns all creative IDs by specified entity ID.
listByLineItem Returns an array of all creative IDs linked to a given line_item (indirectly via campaigns).
lookup Returns a list of creative IDs that correspond to the requested $code.
lookupByDescription Returns a list of creative IDs matching the given creative description.
reportMisClassification Used to reports creative misclassification by Suppliers.
search Returns the list of creative objects according to the given search rules.
26
Services
setCreativeTags Used to associate one or more Creative Tags with a creative object.
sort_objects_by_id
triggerCreativeTest Used to trigger creative testing to Creative Tester.
update Used to modify a creative.
Requests
add
Input parameters:
Output parameters:
addAttach
Input parameters:
Output parameters:
addAttachCreatives
Input parameters:
Output parameters:
addCreatives
Accessible for all entity types
has_transaction_commit
27
Services
Input parameters:
Output parameters:
addSupportingFiles
Used to upload a creative binary file and generate a filename for the creative on RM servers. This filename can later
be associated with a $creative_content object.
Input parameters:
Output parameters:
attachSegments
Input parameters:
Output parameters:
none
delete
Input parameters:
Output parameters:
none
deleteCreatives
28
Services
has_transaction_commit
Input parameters:
Output parameters:
deleteSupportingFiles
Deletes temporary creative files that were uploaded using addSupportingFiles() but not associated with a
creative_content object.
Input parameters:
Output parameters:
none
detachSegments
Accessible for all entity types
Input parameters:
Output parameters:
none
get (read-only)
Creative Tester
Input parameters:
Output parameters:
getAll (read-only)
29
Services
readonly
Input parameters:
Output parameters:
getAllSince (read-only)
Returns all creatives changed between a specified start_date and end_date. Note: This method sets the start_date =
'0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
getAttachedSegments (read-only)
Input parameters:
Output parameters:
30
Services
getByCampaign
Input parameters:
Output parameters:
getByEntity
Input parameters:
Output parameters:
getByIntCode (read-only)
Retrieve all information about the specified creative and review status with the code(externalCreativeID) and
advertiseID.
Input parameters:
Output parameters:
getByIntCodes (read-only)
31
Services
Retrieve all information about the specified creatives and review status with the codes (externalCreativeID) and
advertiseID.
Input parameters:
Output parameters:
getByLineItem
Returns an array of all creative objects linked to a given line_item (indirectly via campaigns).
Input parameters:
Output parameters:
getClassificationReport
Input parameters:
Output parameters:
getCreativeBeacons
32
Services
Compare these Beacon ID(s) to DictionaryService::getCreativeBeaconList() obtain the associated creative beacon
objects.
Input parameters:
Output parameters:
getCreativeComments (read-only)
Input parameters:
Output parameters:
getCreativeSpecs (read-only)
Input parameters:
Output parameters:
getCreativeTags
Used to get a list of Creative Tags associated with a creative. Compare these tag ID(s) to
DictionaryService::getCreativeTagList() obtain the associated creative tag objects. See Creative Tagging and
Classification using API for more information on creative tags.
Creative Tester
Input parameters:
33
Services
Output parameters:
getFullCTStack (read-only)
Used to retrieve full call stack of Creative Tester for non ssl creative
readonly
Input parameters:
Output parameters:
getMGSuggestedClassification (read-only)
Accessible for all entity types
readonly
Input parameters:
Output parameters:
int $offer_type_id: offer type suggested by media guard. offer_type offer_type enum. See Offer Type Enum
for more information.
array_of_int $creative_tag_list_ids: List of creative tag identifiers. Creative Tags.
getNonSslUrls (read-only)
readonly
Input parameters:
Output parameters:
getReviewStatus (read-only)
34
Services
Input parameters:
Output parameters:
isAudited (read-only)
Checks a given creative to see if it was audited by Media Guard. Return boolean true if creative is currently marked as
audited, false otherwise.
Input parameters:
Output parameters:
listAll
Return the array of creative IDs which you are allowed to see.
Input parameters:
Output parameters:
listAllDeletedSince (read-only)
Returns creative IDs deleted between a specified start_date and end_date. Note: This method sets the start_date =
'0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
35
Services
listAllSince (read-only)
Returns creative IDs changed between a specified start_date and end_date. Note: This method sets the start_date =
'0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
listAttachedSegments (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
listByCampaign
Input parameters:
Output parameters:
listByEntity
Input parameters:
Output parameters:
36
Services
listByLineItem
Returns an array of all creative IDs linked to a given line_item (indirectly via campaigns linked to the line item).
Input parameters:
Output parameters:
lookup
Returns a list of creative IDs that correspond to the requested $code. You can pass in multiple codes in the $codes
array.
Input parameters:
Output parameters:
lookupByDescription
Input parameters:
Output parameters:
reportMisClassification
Input parameters:
37
Services
int $offer_type_id: Creative's offer type. See Offer Type table for additional information. See also Creative
offer types for details.
array_of_int $creative_tag_list_ids: List of creative tag identifiers. Creative Tags
Output parameters:
none
search
Search allows a network or a publisher (managed or self managed) to see the list of creatives that get served at the
entity (network or publisher) level or the buyer line item level of the entity filtered by some rules. Note: Search
parameters must be specified in a creative_search_options object. Only creatives that are eligible to serve will be
returned via the search function.
Input parameters:
Output parameters:
setCreativeTags
Used to associate one or more Creative Tags with a creative object. See Creative Tagging and Classification using
API for more information on creative tags.
Input parameters:
Output parameters:
none
sort_objects_by_id (read-only)
Input parameters:
Output parameters:
none
triggerCreativeTest (read-only)
Used to trigger creative testing to Creative Tester, size of creative_ids is limited to 5, and the quota of this interface is
200 a day.
readonly
Input parameters:
38
Services
Output parameters:
update
Update modifies the fields of a creative data object. Note: Some fields are system generated (e.g. campaign::$id) and
can't be changed by the client.
Input parameters:
Output parameters:
none
DemandBlocklist Service
This service lets you add/modify/delete/get demand blocklists.
Review the Demand blocklist section in the Yield Manager Knowledge Base for additional details.
Requests Summary
add Add/Create blocklist for demand from accessing (a slice of) managed supply of the network.
delete Deletes a demand blocklist
getAllBlocklists Returns an array of all demand blocklist you are allowed to access.
getAllSince Return all demand blocklist changed between a specified start_date and end_date.
getByObjectId Returns the demand_blocklist data object for specified id.
listAll Returns demand_blocklist data object ids that you are allowed to access.
listAllSince Return demand blocklist IDs changed between a specified start_date and end_date.
quickSearch Returns an array of all demand blocklist you are allowed to access.
reviewCreatives Add/updates the creative_visibility (approved/ban).
searchCreatives Returns the list of creatives according to the given search rules.
update Modify a demand blocklist.
Requests
add
Input parameters:
Output parameters:
39
Services
delete
Input parameters:
Output parameters:
none
getAllBlocklists (read-only)
Input parameters:
Output parameters:
array_of_demand_blocklist $demand_blocklists
int $total_count: The total number of records returned in the result set.
getAllSince (read-only)
Return demand blocklist IDs changed between a specified start_date and end_date. Note: This method sets the
start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
getByObjectId (read-only)
40
Services
Input parameters:
Output parameters:
demand_blocklist $demand_blocklist
listAll (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
array_of_int $blocklist_ids
listAllSince (read-only)
Return demand blocklist IDs changed between a specified start_date and end_date. Note: This method sets the
start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
quickSearch (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
array_of_blocklist_getall $demand_blocklist
int $total_count: The total number of records returned in the result set.
reviewCreatives
41
Services
Input parameters:
Output parameters:
none
searchCreatives
searchCreatives allows a network to search the creatives in the context of demand blocklist.
For allow_till_review rules it returns the allowed creatives after applying filters.
For block_till_review rules it returns the blocked creatives after applying filters.
Note: Search parameters must be specified in a dbl_creative_search_options object.
Input parameters:
Output parameters:
update
Input parameters:
Output parameters:
none
Dictionary Service
This service provides operations that let you obtain data that may be required by other API calls.
https://api.yieldmanager.com/api-1.38/dictionary.php?wsdl
https://api-test.yieldmanager.com/api-1.38/dictionary.php?wsdl
42
Services
Requests Summary
getBillingStatuses Returns the array of $billing_status strings corresponding to the billing_status enum.
getBrowsers Returns the array of $browser objects corresponding to the browser enum.
getChannels Returns the array of $channel objects corresponding to the channel enum.
getCountries Returns the array of $country objects corresponding to the country enum.
getCountryGroups Returns the array of $country_group objects corresponding to the country_group enum.
getCreativeBeaconList Returns the array of $creative_beacon_list objects corresponding to the
creative_beacon_list enum.
getCreativeMacro Returns the array of $creative_macro objects corresponding to the creative_macro
enum.
getCreativeTagList Returns the array of $creative_tag_list objects corresponding to the creative_tag_list
enum.
getCurrencies Returns the array of $currency objects corresponding to the currency enum.
getCurrencyConversionRate Returns the $conversion_rate corresponding to the currency id and date
passed to the function.
getDeliveryTypes Returns the array of $delivery_type strings corresponding to the delivery_type enum.
getEnumValues Returns an array of strings for all available values for the given enum.
getInventoryTypes Returns the array of $inventory_type objectscorresponding to the inventory_type enum.
getIsps Returns the array of $isp objects corresponding to the isp enum.
getIVCHiddenParameters Returns array of hidden parameters available for a inventory visibility controls
profile.
getLanguages Returns the array of $language objects corresponding to the language enum.
getLearnTypes Returns the array of $learn_type objects corresponding to the learn_type enum.
getLineItemInventoryMediaType Returns array of Inventory Media Types.
getMediaTypes Returns the array of $media_type objects corresponding to the media_type enum.
getMGLabelMappings Returns the array of $mg_label_mappings corresponding to the
mg_label_mappings enum.
getMobileCarriers Returns all the available mobile carriers along with country information
getMobileOSs Returns all the available OS names
getMsas Returns the array of $msas objects corresponding to the msas enum.
getNetspeeds Returns the array of $netspeed objects corresponding to the netspeed enum.
getOfferTypes Returns the array of $offer_type objects corresponding to the offer_type enum.
getPopTypes Returns the array of $pop_type objects corresponding to the pop_type enum.
getPostalCodes Returns list of postal codes for given country iso & pattern
getPricingTypes Returns the array of $pricing_type objects corresponding to the pricing_type enum.
getRatings Returns the array of $rating objects corresponding to the rating enum.
getRegions Returns the array of $region objects corresponding to the region enum.
getRoles Returns the array of $role objects corresponding to the role enum.
getSizes Returns the array of $size objects corresponding to the size enum.
getSupportedLocales Returns the array of $supportedLocales objects
getTechnoDimensions Returns array of techno_data for top level dimensions.
getTechnoIds Returns array of techno_data which fall under the given $techno_parent_id and are at given
level below the parent.
getVideoPlacementType Returns array of Video Placement Types.
getVideoVastType Returns array of Video Vast Types.
getVurlCategories Returns the array of $vurl_category objects corresponding to the vurl_category enum.
getVurlTags Returns the array of $vurl_tag_list objects corresponding to the vurl_tag enum.
getWoeidDetails Returns details of given WOEID
getWoeids Returns list of WOEIds
validateVurls Returns validate vurls for given array of url.
Requests
getBillingStatuses (read-only)
Returns the array of $billing_status strings corresponding to the billing_status enum. See Billing Status Enum for more
information.
Input parameters:
Output parameters:
43
Services
getBrowsers (read-only)
Returns the array of browser objects corresponding to the browser enum. See Browser Enum for more information.
Input parameters:
Output parameters:
getChannels (read-only)
Returns the array of channel objects corresponding to the channel enum. See Channel Enum and Channels: About for
more information.
Input parameters:
Output parameters:
getCountries (read-only)
Returns the array of country objects corresponding to the country enum.. See Country Enum and Targeting by
Geography for more information.
Input parameters:
Output parameters:
getCountryGroups (read-only)
Returns the array of country_group objects corresponding to the country_group enum. See Country Group Enum for
more information.
Input parameters:
Output parameters:
44
Services
getCreativeBeaconList (read-only)
Input parameters:
Output parameters:
getCreativeMacro (read-only)
Returns the array of creative_macro objects corresponding to the creative_macro enum. See Creative Macro Enum
and Macros Syntax and Descriptions for more information.
Input parameters:
Output parameters:
getCreativeTagList (read-only)
Returns the array of creative_tag_list_item objects corresponding to the creative_tag_list enum. See Creative Tag List
Enum for more information.
Input parameters:
Output parameters:
getCurrencies (read-only)
Returns the array of currency objects corresponding to the currencies enum. See Currency Enum for more
information.
45
Services
Input parameters:
Output parameters:
getCurrencyConversionRate (read-only)
Returns the conversion rate in USD corresponding to the currency id and date passed to the function.
Input parameters:
Output parameters:
float $conversion_rate
getDeliveryTypes (read-only)
Returns the array of $delivery_type strings corresponding to the delivery_type enum. See Delivery Type Enum and
Delivery Pacing and Budget Cap Options for more information.
Input parameters:
Output parameters:
getEnumValues (read-only)
Returns an array of strings for all available values for the given enum.
Input parameters:
Output parameters:
getInventoryTypes (read-only)
46
Services
Returns the array of inventory_type objects corresponding to the inventory_type enum. See Inventory Type Enum and
Inventory Types for more information.
Input parameters:
Output parameters:
getIsps (read-only)
Returns the array of isp objects corresponding to the isp enum. See Isp Enum for more information.
Input parameters:
Output parameters:
getIVCHiddenParameters (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
getLanguages (read-only)
Returns the array of language objects corresponding to the language enum. See Language Enum for more
information.
Input parameters:
Output parameters:
getLearnTypes (read-only)
Returns the array of learn_type objects corresponding to the learn type enum. See Learn Type Enum for more
information.
47
Services
Input parameters:
Output parameters:
getLineItemInventoryMediaType (read-only)
Returns array of Inventory Media Types. See Inventory Media Type Enum for more information.
Input parameters:
Output parameters:
getMediaTypes (read-only)
Returns the array of media_type objects corresponding to the media type enum. See Media Type Enum for more
information.
Input parameters:
Output parameters:
getMGLabelMappings (read-only)
Returns the array of Media Guard label mappings corresponding to the mg_label_mappings enum. See Media Guard:
About for more information.
Input parameters:
Output parameters:
getMobileCarriers (read-only)
Returns all the available mobile carriers along with country information
48
Services
Input parameters:
Output parameters:
getMobileOSs (read-only)
Input parameters:
Output parameters:
getMsas (read-only)
Returns the array of msa objects corresponding to the msas enum. See Msa Enum and Designated Marketing Areas
for more information.
Input parameters:
Output parameters:
getNetspeeds (read-only)
Returns the array of netspeed objects corresponding to the netspeed enum. See Netspeed Enum for more
information.
Input parameters:
Output parameters:
getOfferTypes (read-only)
49
Services
Returns the array of offer_type objects corresponding to the offer_type enum. See Offer Type Enum for more
information.
Input parameters:
Output parameters:
getPopTypes (read-only)
Returns the array of pop_type objects corresponding to the pop_type enum. See Pop Types Enum for more
information.
Input parameters:
Output parameters:
getPostalCodes (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
getPricingTypes (read-only)
Returns the array of $pricing_type objects corresponding to the pricing_type enum. See Pricing Type Enum and
Pricing Options for Line Items and Campaigns for more information.
Input parameters:
Output parameters:
50
Services
getRatings (read-only)
Returns the array of $rating objects corresponding to the rating enum. See Rating Enum and Section Ratings for more
information.
Input parameters:
Output parameters:
getRegions (read-only)
Returns the array of region objects corresponding to the region enum. See Region Enum for more information.
Input parameters:
Output parameters:
getRoles (read-only)
Returns the array of role objects corresponding to the role enum. See Role Enum and User Roles, Permissions, and
for more information.
Input parameters:
Output parameters:
getSizes (read-only)
Returns the array of size objects corresponding to the size enum. See Size Enum and for more information.
Input parameters:
Output parameters:
51
Services
getSupportedLocales (read-only)
Input parameters:
Output parameters:
getTechnoDimensions (read-only)
Input parameters:
Output parameters:
getTechnoIds (read-only)
Returns array of techno_data which fall under the given $techno_parent_id and are at given level below the parent.
Input parameters:
Output parameters:
getVideoPlacementType (read-only)
Returns array of Video Placement Types. See Video Placement Type Enum for more information.
Input parameters:
Output parameters:
52
Services
getVideoVastType (read-only)
Returns array of Video Vast Types. See Video Vast Type Enum for more information.
Input parameters:
Output parameters:
getVurlCategories (read-only)
Returns the array of vurl_category objects corresponding to the vurl_category enum. See Vurl Category Enum for
more information.
Input parameters:
Output parameters:
getVurlTags (read-only)
Returns the array of vurl_tag_list objects corresponding to the vurl_tag enum. See Vurl Tag Enum for more
information.
Input parameters:
Output parameters:
getWoeidDetails (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
53
Services
getWoeids (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
validateVurls (read-only)
Input parameters:
Output parameters:
Entity Service
The EntityService lets you add, get, or modify settings for an entity. The Tutorial and Training Index contains additional
information about self-paced and instructor-led training on creating and managing entities.
https://api.yieldmanager.com/api-1.38/entity.php?wsdl
https://api-test.yieldmanager.com/api-1.38/entity.php?wsdl
Requests Summary
add Creates a new entity.
addEx Creates a new entity, default site and section, an insertion order, and line item.
addTargetProfile Sets up a link between a target profile and an entity.
delete Deletes an entity.
deleteAllPublisherControls Deletes publisher controls for specified entity id and buyer_entity_ids.
(deprecated)
deleteEntities Deletes multiple entities.
deletePublisherControls Deletes publisher mask controls See Managing Publisher Controls Using the API
for more information on managing publisher controls. (deprecated)
delTargetProfile Deletes the default target profile belonging to the entity.
get Retrieves all information about the specified entity.
getAdvByName This method allows to search (contains search) all advertisers with specified name and
Retrieves all information about searched entities.
getAll Returns the array of all entity objects you are allowed to see.
getAllPublisherControls Gets publisher mask controls for specified entity. (deprecated)
54
Services
Requests
add
Use the add method to create a new entity. For providing age and gender information for targeting, see
https://kb.yieldmanager.com/article.php?id=392 for more details.
Input parameters:
Output parameters:
addEx
addEx uses the values passed in to entity_data to create a new entity, site/section, insertion order and line item.
55
Services
Input parameters:
Output parameters:
ex_entity_ids $ex_entity_id: Returns the IDs of the newly created data objects.
addTargetProfile
Input parameters:
Output parameters:
delete
Input parameters:
Output parameters:
none
deleteAllPublisherControls (deprecated)
See Managing Publisher Controls Using the API for more information on managing publisher controls.
Input parameters:
Output parameters:
56
Services
deleteEntities
has_transaction_commit
Input parameters:
Output parameters:
Input parameters:
Output parameters:
none
delTargetProfile
Deletes a target profile and all linked targeting rules (see TargetProfileService) for the entity.
Input parameters:
Output parameters:
none
get (read-only)
Input parameters:
57
Services
Output parameters:
getAdvByName (read-only)
Returns the list of entity_info data objects of all advertisers with specified name.
Network
readonly
Input parameters:
Output parameters:
getAll (read-only)
Input parameters:
Output parameters:
int $total_count: The total number of records returned in the result set.
array_of_entity $entities: Array of $entities. See {@link::entity entity} data type for more information.
See Managing Publisher Controls Using the API for more information on managing publisher controls.
Input parameters:
58
Services
Output parameters:
getAllSalesRegions (read-only)
Input parameters:
Output parameters:
array_of_sales_region $sales_regions: Array of $sales_regions. See sales_region and Sales Regions for
more information.
int $total_count: The total number of records returned in the result set.
getAllSince (read-only)
Return entities changed between a specified start_date and end_date. Note: This method sets the start_date =
'0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
getByIds (read-only)
Network
readonly
59
Services
Input parameters:
Output parameters:
getByShellId (read-only)
Input parameters:
Output parameters:
getCANStatus (read-only)
Publisher
Network
Input parameters:
Output parameters:
getContentVendorUrlHashSalt (read-only)
Input parameters:
Output parameters:
60
Services
getEligiblePrivateMarketPlaces (read-only)
Input parameters:
Output parameters:
getLanguage (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
getLineItemMarketPlace (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
getMapByShellIds (read-only)
Input parameters:
Output parameters:
61
Services
getNetByName (read-only)
Returns the list of entity_info data objects of all networks with specified name.
Network
readonly
Input parameters:
Output parameters:
getOfficialContacts (read-only)
Gets arrays of contacts for the given entity organized by contact role. See User Roles for more information.
Input parameters:
Output parameters:
getPubAdTags
Return the list of strings representing separate tags, filtered by the ad_tag_options parameter and only for the
specified sections.
Input parameters:
Output parameters:
62
Services
getPubDefaultChannels
Return the list of default channels IDs for the given publisher.
Input parameters:
Output parameters:
getPubDefaultInventoryType
Input parameters:
Output parameters:
Input parameters:
Output parameters:
63
Services
languageFlipFinished (read-only)
Checks on the status of the process that converts creative language tags to a different language. See Classifying the
Language of Your Creatives for more information.
Input parameters:
Output parameters:
listAdvertiserEntityByBroker (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
listAll (read-only)
Returns the array of entity IDs that you are allowed to see. Review the entity ID data type for more information.
Input parameters:
Output parameters:
array_of_int $entity_ids: Array of $entity_ids. See the entity data type ID parameter for more information.
listAllSince (read-only)
Returns entity IDs for entities changed between a specified start_date and end_date. Note: This method sets the
start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
64
Services
Output parameters:
lookup
Input parameters:
Output parameters:
setAllPublisherControls (deprecated)
See Managing Publisher Controls Using the API for more information on managing publisher controls.
Input parameters:
Output parameters:
setCANStatus
Publisher
Network
Input parameters:
Output parameters:
none
setIntegrationCode
65
Services
Sets the publisher's integration code. See Macros and Integration Codes for details. Note: Before you set an
integration code, at least one insertion order should be present.
Input parameters:
Output parameters:
none
setLanguage
Accessible for all entity types
Input parameters:
Output parameters:
none
setLineItemMarketPlace
Accessible for all entity types
Input parameters:
Output parameters:
none
setPubDefaultChannels
Sets the default channels for the given publisher. See Channels: About for more information.
Input parameters:
Output parameters:
none
setPubDefaultInventoryType
66
Services
Input parameters:
Output parameters:
none
Input parameters:
Output parameters:
none
update
Update modifies the fields of a entity data object. For providing age and gender information for targeting, see
https://kb.yieldmanager.com/article.php?id=392 for more details. Note: Some fields are system generated (e.g.
entity::$id) and cannot be changed by the client.
Input parameters:
Output parameters:
none
InsertionOrder Service
The InsertionOrderService lets you add, delete, get, or list settings for an entity. See Insertion orders and line items
defined for additional details.
67
Services
https://api.yieldmanager.com/api-1.38/insertion_order.php?wsdl
https://api-test.yieldmanager.com/api-1.38/insertion_order.php?wsdl
Requests Summary
add Adds a new insertion order.
convertFromUSD Converts USD amount into non-USD currency.
convertToUSD Converts non-USD amount into USD.
delete Deletes an insertion order.
deleteInsertionOrders Deletes multiple insertion orders.
dxrMigrationStatus Checks for the status of IO migration process, responds with new IO id if migration is
complete.
dxrRequestMigration Requests migration of the specified (fixed exchange rate) insertion_order to create a
new (dynamic exchange rate) insertion_order. The new IO will get the specified description. The migration
process is asynchronous; use the dxrMigrationStatus() to poll for the new insertion_order's ID.
get Retrieves all information about the specified insertion order.
getAll Gets the list of all insertion order objects you are allowed to see.
getAllSince Returns insertion_order objects changed between a specified start_date and end_date.
getByBuyer Gets the list of all insertion order objects owned by the current entity and linked to the given
buyer.
getByBuyers Gets the list of all insertion order objects owned by the current entity and linked to the given
buyers.
getBySeller Gets the list of all insertion order objects owned by the current entity and linked to the given
seller.
getBySellers Gets the list of all insertion order objects owned by the current entity and linked to the given
sellers.
getInsertionOrderType Returns insertion order type.
getLinkedInfo Get linked entity information.
listAll Gets the list of all insertion order IDs you are allowed to see.
listAllDeletedSince Returns IDs of insertion_orders deleted between a specified start_date and end_date.
listAllSince Returns IDs of insertion_orders changed between a specified start_date and end_date.
listByBuyer Gets the list of all insertion order IDs owned by the current entity and linked to the given buyer.
listBySeller Gets the list of all insertion order IDs owned by the current entity and linked to the given seller.
update Modifies an insertion order.
Requests
add
Input parameters:
Output parameters:
convertFromUSD (read-only)
Converts USD amount into non-USD currency. See Working with currencies in the Exchange API for assistance in
working with non-USD currency amounts.
68
Services
Input parameters:
Output parameters:
convertToUSD (read-only)
Converts non-USD amount into USD. See Working with currencies in the Exchange API for assistance in working with
non-USD currency amounts.
Input parameters:
Output parameters:
delete
Input parameters:
Output parameters:
none
deleteInsertionOrders
has_transaction_commit
Input parameters:
Output parameters:
array_of_multiple_data_result $result
69
Services
dxrMigrationStatus (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
dxr_migration_reports $migration_reports: This will be false until migration is complete and the new IO
has been created.
dxrRequestMigration (read-only)
Input parameters:
Output parameters:
none
get (read-only)
Input parameters:
Output parameters:
getAll (read-only)
Gets the list of all insertion order IDs you are allowed to see.
Input parameters:
70
Services
int $entries_on_page: A pagination parameter. Use this to get n number of results per page and break up a
larger report request into smaller chunks.
int $page_num: A pagination parameter. Use it with $entries_on_page to determine which page should hold
n number of results.
Output parameters:
getAllSince (read-only)
Returns insertion_orders changed between a specified start_date and end_date. Note: This method sets the
start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
getByBuyer (read-only)
Gets the list of all insertion order IDs owned by the current entity and linked to the given buyer. Buyers may be either
networks or advertisers. The current entity is set by your session token.
Input parameters:
Output parameters:
getByBuyers (read-only)
Gets the list of all insertion order IDs owned by the current entity and linked to the given buyers. Buyers may be either
networks or advertisers. The current entity is set by your session token.
71
Services
Network
Input parameters:
Output parameters:
getBySeller (read-only)
Gets the list of all insertion order objects owned by the current entity and linked to the given seller. Sellers may be
either networks or publishers. The current entity is set by your session token.
Input parameters:
Output parameters:
getBySellers (read-only)
Gets the list of all insertion order IDs owned by the current entity and linked to the given sellers. sellers may be either
networks or publishers. The current entity is set by your session token.
Network
Input parameters:
Output parameters:
getInsertionOrderType (read-only)
72
Services
Input parameters:
Output parameters:
getLinkedInfo (read-only)
readonly
Input parameters:
Output parameters:
listAll (read-only)
Gets the list of all insertion order IDs you are allowed to see.
Input parameters:
Output parameters:
listAllDeletedSince (read-only)
Returns IDs of insertion_order deleted between a specified start_date and end_date. Note: This method sets the
start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
73
Services
Output parameters:
listAllSince (read-only)
Returns IDs of insertion_orders changed between a specified start_date and end_date. Note: This method sets the
start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
string $token
dateTime $start_date
dateTime $end_date
Output parameters:
listByBuyer (read-only)
Gets the list of all insertion order IDs owned by the current entity and linked to the given buyer. Buyers may be either
networks or publishers. The current entity is set by your session token.
Input parameters:
Output parameters:
listBySeller (read-only)
Gets the list of all insertion order IDs owned by the current entity and linked to the given seller. Sellers may be either
networks or publishers. The current entity is set by your session token.
Input parameters:
Output parameters:
74
Services
update
Update modifies the fields of an insertion order data object. Note: Some fields are system generated (e.g.
campaign::$id) and can't be changed by the client.
Input parameters:
Output parameters:
none
InventoryVisibilityControls Service
This service lets you add/modify/delete/get Inventory Visibility Controls Profiles.
Review the Managing Publisher Controls Using the API in the Yield Manager Knowledge Base for additional details.
Requests Summary
add Creates IVC profile for specified entity and buyer entity ids.
addProfiles Creates multiple IVC profiles for specified owner types and owner ids.
delete Deletes a IVC profile.
deleteProfiles Deletes multiple IVC profiles.
get Retrieves all information about the specified IVC profile id.
getProfiles Returns an array of all reserve price profiles you are allowed to see at network, publisher or
section level.
update Updates a IVC profile.
updateProfiles Updates multiple IVC profiles for specified profile ids and buyer entity ids.
Requests
add
Accessible for all entity types
Input parameters:
Output parameters:
75
Services
addProfiles
has_transaction_commit
Input parameters:
Output parameters:
delete
Input parameters:
Output parameters:
none
deleteProfiles
Accessible for all entity types
has_transaction_commit
Input parameters:
Output parameters:
get (read-only)
Input parameters:
Output parameters:
76
Services
getProfiles (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
array_of_inventory_visibility_controls $ivc_profiles
int $total_count: The total number of records returned in the result set.
update
Accessible for all entity types
Input parameters:
Output parameters:
none
updateProfiles
has_transaction_commit
Input parameters:
Output parameters:
LineItem Service
The LineItemService lets you add, delete, or modify a line item and associated delivery rules. See Insertion orders and
line items defined for additional details.
https://api.yieldmanager.com/api-1.38/line_item.php?wsdl
https://api-test.yieldmanager.com/api-1.38/line_item.php?wsdl
77
Services
Requests Summary
add Adds a new line item.
addCreative Associates a creative with a line item.
addCreatives Associates creatives with line items.
addSalesRegion Adds a sales region to an entity.
delCreative Deletes a single creative from a line item.
delete Deletes a line item.
deleteLineItems Deletes multiple line items.
duplicate Duplicate existing line items
get Retrieves all information about the specified line item.
getAll Returns the list of all line items objects you are allowed to see.
getAllSince Returns the list of all line item data objects changed between a specified start_date and
end_date.
getByBuyer Gets the list of all line item objects owned by the current entity and linked to the given buyer.
getByCampaign Returns the list of all line item data objects for the given campaign.
getByCreative Returns the array of all line item objects for a specified creative.
getByInsertionOrder Returns the array of all line item objects for the specified insertion order.
getBySeller Returns the list of all line item objects owned by the current entity and linked to the given
seller.
getSalesRegion Returns a sales region name for the given ID.
getSalesRegionsByEntity Returns the list of all sales region IDs for the specified entity.
listAll Gets the list of all line item IDs you are allowed to see.
listAllDeletedSince Returns the list of all line_item IDs deleted between a specified start_date and
end_date.
listAllSince Returns the list of all line item IDs changed between a specified start_date and end_date.
listByBuyer Gets the list of all line item IDs owned by the current entity and linked to the given buyer.
listByCampaign Returns the array of line item IDs associated with a campaign.
listByCreative Returns the array of all line item IDs for the specified creative.
listByInsertionOrder Returns the array of all line item IDs associated with a specified insertion order.
listBySeller Gets the list of all line item IDs owned by the current entity and linked to the given seller.
setBillingStatus Sets the billing status of line items for the specified month.
update Modifies a line item.
Requests
add
Use add to create a new line item. Note: When setting advertiser billing price, refer to Decouple bidding from billing:
About article for additional details.
Input parameters:
Output parameters:
addCreative
Add a creative to a line item. To use this method, you need to have the IDs of an existing creative and line item.
Input parameters:
78
Services
Output parameters:
none
addCreatives
Add creatives to provided line items. To use this method, you need to have the IDs of an existing creatives and line
items.
Input parameters:
Output parameters:
addSalesRegion
Input parameters:
Output parameters:
delCreative
Input parameters:
Output parameters:
none
delete
79
Services
Input parameters:
Output parameters:
none
deleteLineItems
has_transaction_commit
Input parameters:
Output parameters:
duplicate
This method can assign new line item to different insertion order under the same Advertiser then original line item
assigned to. But $insertion_order_id is optional, if you don't pass it, insertion order from original line item will be
assined
Input parameters:
Output parameters:
get (read-only)
Input parameters:
Output parameters:
80
Services
getAll (read-only)
Input parameters:
Output parameters:
getAllSince (read-only)
Returns all the line item data objects changed beween a specified start_date and end_date. Note: This method sets
the start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or
less.
Input parameters:
Output parameters:
getByBuyer
Gets the list of all line item IDs owned by the current entity and linked to the given buyer. Buyers may be either
networks or advertisers. The current entity is set by your session token.
Input parameters:
Output parameters:
81
Services
getByCampaign
Returns the list of all line item data objects for the given campaign.
Input parameters:
Output parameters:
getByCreative (read-only)
Input parameters:
Output parameters:
getByInsertionOrder (read-only)
Returns the array of all line_item objects for the specified insertion order.
Input parameters:
Output parameters:
82
Services
int $total_count: The total number of records returned in the result set.
getBySeller
Gets the list of all line item IDs owned by the current entity and linked to the given seller. Sellers may be either
networks or publishers. The current entity is set by your session token.
Input parameters:
Output parameters:
getSalesRegion (read-only)
Input parameters:
Output parameters:
getSalesRegionsByEntity (read-only)
Returns the lst of all sales region IDs for the specified entity.
Input parameters:
Output parameters:
83
Services
listAll (read-only)
Input parameters:
Output parameters:
listAllDeletedSince (read-only)
Returns the array of all line item IDs deleted between a specified start_date and end_date. Note: This method sets the
start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
listAllSince (read-only)
Returns line item IDs changed between a specified start_date and end_date. Note: This method sets the start_date =
'0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
listByBuyer
Gets the list of all line_items owned by the current entity and linked to the given buyer. Buyers may be either networks
or publishers. The current entity is set by your session token.
Input parameters:
84
Services
Output parameters:
listByCampaign
Input parameters:
Output parameters:
listByCreative (read-only)
Input parameters:
Output parameters:
listByInsertionOrder (read-only)
Returns the array of all line item IDs associated with a specified insertion order. Use LineItemService::get() to get the
whole line item data object by its ID.
Input parameters:
Output parameters:
listBySeller
Gets the list of all line_items owned by the current entity and linked to the given seller. Sellers may be either networks
or publishers. The current entity is set by your session token.
85
Services
Input parameters:
Output parameters:
setBillingStatus
Sets the billing status of line items for the specified month. See Month-end certification: About for more information.
Input parameters:
Output parameters:
update
Update modifies the fields of a line_item data object. Note: some fields are system generated (e.g. campaign::$id) and
can't be changed by the client.
Input parameters:
Output parameters:
none
Linking Service
One of the benefits of membership in the Yahoo Ad Exchange is the ability to link directly to other companies. Linking
helps increase your scale and reach by connecting you with potential business partners. Use the LinkingService to
manage your company profile and links.
See the Linking section in the Yahoo Ad Exchange Knowledge Base for additional information, sample linking
agreements, best practices, and tips on creating your company profile.
https://api.yieldmanager.com/api-1.38/linking.php?wsdl
https://api-test.yieldmanager.com/api-1.38/linking.php?wsdl
Requests Summary
acceptLink Used to accept a link request from a potential partner.
86
Services
Requests
acceptLink
Used to accept a link request from a potential partner. By approving a linking request from a potential partner, you are
agreeing to work with them in the Yahoo Ad Exchange under the terms of any proposed insertion order. Only approve
a request after you have signed a contract with that company. If you do not want to work with them, reject the link. See
Approving and rejecting linking requests for additional details.
Input parameters:
Output parameters:
none
addProfile
Use addProfile to create a linking profile for your organization. See Creating your company profile for additional
details.
Input parameters:
Output parameters:
87
Services
none
cancelLink
Input parameters:
Output parameters:
none
getAllLinks (read-only)
Return the array of link data on all entities that have an active, pending or rejected link with your entity.
Network
readonly
Input parameters:
Output parameters:
getAppliedLinks
Returns the array of link_data objects of all entities to whom your entity has sent linking requests.
Input parameters:
88
Services
int $entries_on_page: A pagination parameter. Use this to get n number of results per page and break up a
larger report request into smaller chunks.
int $page_num: A pagination parameter. Use it with $entries_on_page to determine which page should hold
n number of results.
Output parameters:
int $total_count: The total number of records returned in the result set.
array_of_link_data $proposed_links: Array of link_data objects for proposed links.
getLinkableEntityData (read-only)
Return the array of link data on all entities that can be linked with your entity.
Network
readonly
Input parameters:
Output parameters:
getLinkData
Returns the link_data object for the specified network entity which is visible or has an active linked IO.
Input parameters:
Output parameters:
getLinkedEntityData
Return the array of link_data objects of all entities that share one or more active links with your entity.
89
Services
Network
RMX Direct
Simplified SMP
Input parameters:
Output parameters:
int $total_count: The total number of records returned in the result set.
array_of_link_data $link_data: Array of $link_data.
getNonlinkedEntityData
Returns the array of link_data objects of all entities that do not share an active insertion order with your entity.
Input parameters:
Output parameters:
int $total_count: The total number of records returned in the result set.
array_of_link_data $link_data: Array of $link_data.
getProfile
Input parameters:
Output parameters:
getProposedLinks
90
Services
Returns the array of link_data objects of all entities that have sent linking requests to you.
Input parameters:
Output parameters:
int $total_count: The total number of records returned in the result set.
array_of_link_data $proposed_links: Array of $proposed_links.
proposeLink
Sends your potential linked partner a linking request. The link will not be created until the potential partner has
accepted your request. See Sending a linking request for additional details.
Input parameters:
Output parameters:
rejectLink
Used for rejecting a link request of a partner. See Approving and rejecting linking requests for additional details.
Input parameters:
91
Services
int $billing_entity_id: Entity ID of the managed advertiser under the buyer seat. Applicable when rejecting
the billing links, otherwise zero. See Brand level billing for additional details.
Output parameters:
none
setRating
Input parameters:
Output parameters:
none
updateProfile
Input parameters:
Output parameters:
none
Notification Service
The NotificationService allows you to manage traffic monitor alerts and get system status information. See also
Automatic alerts and notifications for more details.
https://api.yieldmanager.com/api-1.38/notification.php?wsdl
https://api-test.yieldmanager.com/api-1.38/notification.php?wsdl
Requests Summary
addTMAlert Adds a new traf_monitor_alert.
deleteTMAlert Deletes the traf_monitor_alert object.
getAllTMAlerts Gets the list of the traf_monitor_alert objects you are allowed to see.
92
Services
Requests
addTMAlert
Input parameters:
Output parameters:
deleteTMAlert
Input parameters:
Output parameters:
none
getAllTMAlerts (read-only)
Gets the list of the traf_monitor_alert objects you are allowed to see.
Input parameters:
Output parameters:
getNotices (read-only)
93
Services
Input parameters:
Output parameters:
getSystemStatus (read-only)
Input parameters:
Output parameters:
getTMAlert (read-only)
Input parameters:
Output parameters:
listAllTMAlerts (read-only)
Gets the list of all traf_monitor_alert IDs you are allowed to see.
Input parameters:
Output parameters:
removeTMAlertEmail
94
Services
Input parameters:
Output parameters:
none
updateTMAlert
Input parameters:
Output parameters:
none
Passback Service
The Passback lets publisher add, delete, or modify a passback url associated one or multipe section. See
http://kb.yieldmanager.com/article.php?id= for additional details.
https://api.yieldmanager.com/api-1.38/passback.php?wsdl
https://api-test.yieldmanager.com/api-1.38/passback.php?wsdl
Requests Summary
activatePassbacks Activate a Passback.
add Add a new passback.
deactivatePassbacks Deactivate a Passback.
deletePassbacks Delete passbacks.
get Retrieves all information about the specified passback.
getAll Gets the list of all the passback objects for the logged in publisher.
update update a passback.
Requests
activatePassbacks
Accessible for all entity types
has_transaction_commit
Input parameters:
Output parameters:
95
Services
add
Input parameters:
Output parameters:
deactivatePassbacks
Accessible for all entity types
has_transaction_commit
Input parameters:
Output parameters:
deletePassbacks
Accessible for all entity types
has_transaction_commit
Input parameters:
Output parameters:
get (read-only)
readonly
Input parameters:
96
Services
Output parameters:
getAll (read-only)
readonly
Input parameters:
Output parameters:
update
Input parameters:
Output parameters:
Pixel Service
This service lets you add/get/modify pixels.
Requests Summary
add Create a new pixel.
addPiggybackPixel Add a new piggyback pixel.
addSegmentContributor Creates a unique publisher tag that identifies the publisher segmenting a user.
addSegmentShares Create new segment shares and assign them to specified buyers.
attachCreatives Attach creatives to a segment pixel.
delete Delete a pixel.
deletePiggybackPixel Delete a piggyback pixel.
97
Services
Requests
add
Input parameters:
Output parameters:
addPiggybackPixel
Bind the specified pixel by its pixel::$id to the given piggyback pixel.
Input parameters:
Output parameters:
98
Services
addSegmentContributor
Creates a unique publisher tag that identifies the publisher segmenting a user. Available to Audience Manager sellers
only. Contact API support to enable publisher tracking.
Input parameters:
Output parameters:
addSegmentShares
Create new segment shares and assign them to specified buyers. Available to Audience Manager sellers and Content
Manager sellers. When adding share for segments that support a hierarchy(via parent relations) this method will throw
an exception if the parent segment of the segment in input is already shared with the same buyer.
Input parameters:
Output parameters:
attachCreatives
Input parameters:
Output parameters:
none
delete
Remove an existing pixel data object. Note: Deleting any segment pixel that you have shared via Audience Share will
also remove the corresponding segment shares, and thus will deactivate any line items -- except your own -- that are
targeting this pixel and notify their owners. See Sharing or unsharing segments in the Audience marketplace for
details.
99
Services
Input parameters:
Output parameters:
none
deletePiggybackPixel
Input parameters:
Output parameters:
none
deletePixels
Remove existing pixel data objects. Note: Deleting any segment pixel that you have shared via Audience Share will
also remove the corresponding segment shares, and thus will deactivate any line items -- except your own -- that are
targeting this pixel and notify their owners. See Sharing or unsharing segments in the Audience marketplace for
details.
has_transaction_commit
Input parameters:
Output parameters:
array_of_multiple_data_result $results
deleteSegmentContributor
Delete a specified segment contributor ID. Available to Audience Manager sellers only.
Input parameters:
Output parameters:
none
detachCreatives
100
Services
Input parameters:
Output parameters:
none
get
Input parameters:
Output parameters:
getAll (read-only)
Return the array of pixel objects which you are allowed to see according to security model.
readonly
Input parameters:
Output parameters:
getAllBoughtSegments (read-only)
Return an array of bought_segments that have been purchased by you. Available to Audience Manager buyers and
Content Manager buyers only.
Input parameters:
Output parameters:
101
Services
getAllPiggybackPixelsSince (read-only)
Return piggyback pixels changed between start_date and end_date. Note: This method sets the start_date =
'0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less
Input parameters:
Output parameters:
getAllSince (read-only)
Return pixels changed between start_date and end_date. Note: This method sets the start_date = '0000-00-00
00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less
Input parameters:
string $token
dateTime $start_date
dateTime $end_date
int $entries_on_page
int $page_num
Output parameters:
getAttachedCreatives (read-only)
Input parameters:
Output parameters:
array_of_creative $creatives
getAvailableContentCategoriesBuyers (read-only)
Returns an array of available content buyer contacts. Available to Content Category sellers only.
102
Services
Input parameters:
Output parameters:
getAvailableSegmentBuyers (read-only)
Returns an array of available data buyer contacts. Available to Audience Manager sellers only.
Input parameters:
Output parameters:
getByEntity (read-only)
Return the array of pixel's data objects which belong to the entity specified by entity_id.
Input parameters:
Output parameters:
getByLineItem (read-only)
Return the array of pixel's data objects which belong to the line_item specified by line_item_id.
Input parameters:
Output parameters:
103
Services
getContentCategoryOwner (read-only)
Get owner information for a given public segment id. Available to Content Manager buyers only.
Input parameters:
Output parameters:
getPiggybackPixels
Retrieve the list of piggyback pixels associated with the given pixel.
Input parameters:
Output parameters:
getPixelTags (read-only)
Input parameters:
Output parameters:
getSegmentContributor (read-only)
Returns the segment contributor object based on the segment contributor ID. Available to Audience Manager sellers
only.
Input parameters:
104
Services
Output parameters:
getSegmentOwner (read-only)
Get owner information for a given public segment id. Available to Audience Manager buyers only.
Input parameters:
Output parameters:
getSegments (read-only)
Input parameters:
Output parameters:
array_of_pixel $pixel
int $count_of_pixels
getSegmentShares (read-only)
Returns an array of segment shares that you own. Available to Audience Manager sellers and Content Manager
sellers.
Input parameters:
105
Services
Output parameters:
getShareForSegments (read-only)
Returns an array of segment shares of specified segments. Available to Audience Manager sellers and Content
Manager sellers.
Input parameters:
Output parameters:
listAll
Return the array of pixel objects which you are allowed to see according to security model.
Input parameters:
Output parameters:
listAllDeletedSince (read-only)
Return pixel ids deleted between start_date and end_date. Note: This method sets the start_date = '0000-00-00
00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less
Input parameters:
string $token
dateTime $start_date
dateTime $end_date
Output parameters:
array_of_int $ids
listAllPiggybackPixelsSince (read-only)
Return piggyback pixel ids changed between start_date and end_date. Note: This method sets the start_date =
'0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less
106
Services
Input parameters:
Output parameters:
listAllSegmentContributors
Returns all segment contributor IDs created by your network. Available to Audience Manager sellers only.
Input parameters:
Output parameters:
listAllSince (read-only)
Return pixel ids changed between start_date and end_date. Note: This method sets the start_date = '0000-00-00
00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less
Input parameters:
string $token
dateTime $start_date
dateTime $end_date
Output parameters:
array_of_int $ids
listAttachedCreatives (read-only)
Input parameters:
Output parameters:
array_of_int $creative_ids
107
Services
listByEntity (read-only)
Return the array of section ids which belong to the entity specified by entity_id. Use PixelService::get() to get the
whole pixel's data object by its id.
Input parameters:
Output parameters:
listByLineItem (read-only)
Return the array of ids which belong to the line item specified by line_item_id. Use PixelService::get() to get the whole
pixel's data object by its id.
Input parameters:
Output parameters:
listSegments (read-only)
Input parameters:
Output parameters:
array_of_int $pixel
lookup
Return the array of arrays of all pixel ids for each code. You can use PixelService::get() to get the whole pixel data
object by its id.
Input parameters:
Output parameters:
108
Services
array_of_array_of_int $pixel_ids
removeBoughtSegments (read-only)
Input parameters:
Output parameters:
none
removeSegmentShares
Remove specified segment shares owned by you. Available to Audience Manager sellers and Content Manager
sellers. When removing share for segments that support a hierarchy(via parent relations) this method will throw an
exception if the parent segment of the segment in input is already shared with the same buyer. Note: The buyer(s) of
these segment shares will be notified. Any line items -- except your own -- that are targeting these segments will be
deactivated. See http://kb.yieldmanager.com/article.php?id=746 Sharing or unsharing segments in the Audience
marketplace for details.
Input parameters:
Output parameters:
none
syncSegmentShares
Creates and removes segment shares as specified by the input. Available to Audience Manager sellers and Content
Manager sellers. Please note that the segment share remove requests will be processed first followed by adds. In
case of syncing shares for segments that support a hierarchy(via parent relations) this method will deactivate line
items only in case where there is an actual removal of segment shares. In cases where the remove and add operation
leave a certain segment share untouched the line items will not be deactivated.
Input parameters:
Output parameters:
update
Change the fields of pixel data object. Note: Some fields are generated by API (e.g. pixel::$id) and cannot be changed
by the client.
109
Services
Input parameters:
Output parameters:
none
PreferredTerms Service
This service lets you add/modify/delete/get preferred terms.
Review the Preferred Terms section in the Yield Manager Knowledge Base for additional details.
Requests Summary
add Add/Create preferred terms for demand from accessing (a slice of) managed supply of the network.
delete Deletes a preferred terms
getAllPreferredTerms Returns an array of all preferred terms you are allowed to access.
getAllSince Return all preferred terms changed between a specified start_date and end_date.
getByObjectId Returns the preferred_terms data object for specified id.
getPartialPreferredTermObject Returns an array of all preferred terms you are allowed to access.
getVurls Gets list of Vurls for specific rule id/pattern.
listAll Returns preferred_terms data object ids that you are allowed to access.
listAllSince Return preferred terms IDs changed between a specified start_date and end_date.
quickSearch Returns an array of all demand blocklist you are allowed to access.
setVurls Creates preferred terms for VURL.
update Modify a preferred terms.
Requests
add
Input parameters:
Output parameters:
delete
Input parameters:
110
Services
Output parameters:
none
getAllPreferredTerms (read-only)
Input parameters:
Output parameters:
array_of_preferred_terms $preferred_terms
int $total_count: The total number of records returned in the result set.
getAllSince (read-only)
Return preferred terms IDs changed between a specified start_date and end_date. Note: This method sets the
start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
getByObjectId (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
preferred_terms $preferred_terms
getPartialPreferredTermObject (read-only)
111
Services
Input parameters:
Output parameters:
array_of_preferred_terms_getall $preferred_terms
int $total_count: The total number of records returned in the result set.
getVurls (read-only)
Input parameters:
Output parameters:
array_of_vurl_get_data $vurl_data
int $total_count: The total number of records returned in the result set.
listAll (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
array_of_int $preferred_terms_ids
listAllSince (read-only)
Return preferred terms IDs changed between a specified start_date and end_date. Note: This method sets the
start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
112
Services
Output parameters:
quickSearch (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
array_of_preferred_terms_getall $preferred_terms
int $total_count: The total number of records returned in the result set.
setVurls
Input parameters:
Output parameters:
none
update
Input parameters:
Output parameters:
none
113
Services
PublisherReservePrice Service
This service lets you add/modify/delete/get Publisher Reserve Price Profile.
Review the Publisher Reserve Price section in the Yield Manager Knowledge Base for additional details.
Requests Summary
add Create a new publisher reserve price profile.
addProfiles Method for bulk add.
delete Deletes a publisher reserve price profile.
deleteProfiles Deletes multiple publisher reserve price profiles.
get Retrieves all information about the specified publisher reserve price profile.
getAll Returns an array of all reserve price profiles you are allowed to see at network, publisher or section
level.
update Modify a publisher reserve price profile.
updateProfiles Method for bulk update.
Requests
add
Input parameters:
Output parameters:
addProfiles
has_transaction_commit
Input parameters:
Output parameters:
delete
114
Services
Input parameters:
Output parameters:
none
deleteProfiles
Accessible for all entity types
has_transaction_commit
Input parameters:
Output parameters:
get (read-only)
Input parameters:
Output parameters:
getAll (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
array_of_publisher_reserve_price_profile $publisher_reserve_price_profiles
int $total_count: The total number of records returned in the result set.
115
Services
update
Input parameters:
Output parameters:
none
updateProfiles
has_transaction_commit
Input parameters:
Output parameters:
Quota Service
This service provides information about quota usage
Requests Summary
getQuotaByCmdGroup Retrieve information about daily quota assigned by command group.
getQuotaByServiceByMethod Retrieve information about quota usage for a given service and method.
Requests
getQuotaByCmdGroup (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
116
Services
getQuotaByServiceByMethod (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
Report Service
The ReportService class includes methods that allow you to request, retrieve, and work with reporting data.
Use these methods to run reports against the Exchange's databases and recover data for your account.
Requests Summary
addSegmentReportVisibility Add the report visibility permissions for content category sellers. Only
accessible to content category buyers.
getSegmentReportVisibility Get the report visibility permissions for content category sellers. Only
accessible to content category buyers.
isMonthCertified Checks if the numbers for a given month have been certified.
opportunityRequestViaXML make a xml request to generate an Opportunity Report
requestSavedReport generate a report using a saved request
requestViaXML make a xml request to generate a report
status get a report URL if it has been generated successfully
updateSegmentReportVisibility Updates the report visibility permissions for content category sellers. Only
accessible to content category buyers.
Requests
addSegmentReportVisibility
This API adds report visibility permissions for content category sellers. The buyer_id is ignored. The seller ids should
be unique and this will be specified as the item_id in the return objects.
Input parameters:
Output parameters:
getSegmentReportVisibility (read-only)
117
Services
This API get report visibility permissions for content category sellers.
Input parameters:
Output parameters:
isMonthCertified (read-only)
This method is a boolean datatype. It returns boolean true if numbers have been certified. It returns boolean false if
the numbers have not been certified.
Input parameters:
Output parameters:
opportunityRequestViaXML
This method is functionally identical to requestViaXML, but opportunityRequestViaXML has a more restrictive quota
limit.
You may use either method to submit Opportunity Report requests, but both will route such requests to this method,
and thus be subject to the more restrictive limit. You will probably find it most convenient to use requestViaXML for all
your report requests, but in that case be aware that, when submitting requests for Opportunity Reports, both the quota
feedback SOAP headers and the exception message if the quota limit is reached will be specific to
opportunityRequestViaXML.
Input parameters:
Output parameters:
requestSavedReport
Note: The API allows only one ReportService query at a time for a given user.
118
Services
Input parameters:
Output parameters:
requestViaXML
Use the requestViaXML method to generate report data. The requestViaXML method makes code development
efficient because it allows you to form your report request in XML. Review the Reportware XML Syntax page or the
Yield Manager KB article "The requestViaXML method: About" for additional details.
Note: The API allows only one ReportService query at a time for a given user.
Input parameters:
Output parameters:
status
The status method monitors the file system to determine if your report is ready. Once it is, status returns a URL that
points to the XML block containing your report data. Review the Yield Manager article "The status method: About" for
additional details.
Input parameters:
Output parameters:
updateSegmentReportVisibility
This API updates an existing report visibility permissions for content category sellers. The buyer_id is ignored. The
seller ids should be unique and this will be specified as the item_id in the return objects.
Input parameters:
Output parameters:
119
Services
Rtbd Service
WSDL links for this service:
https://api.yieldmanager.com/api-1.38/rtbd.php?wsdl
https://api-test.yieldmanager.com/api-1.38/rtbd.php?wsdl
Requests Summary
getBidURL Return current BidURL setting for RTBD advertiser in specified region.
getFailureReport Get traffic failure metrics. There are multiple rows returned over the reporting period, and
there are multiple rows per period as well and per bid url?, having one row per distinct failure type (eg
timeout, connect error, etc).
getQPS Get current qps setting for the RTBD advertiser in specified region.
getRecentTrafficReport Report per region for this advertiser, the traffic and statistics observed over the
last 24 hours.
getSuccessReport Report traffic metrics to the advertiser including the aggregates relative to success.
There will be one row per time period (default 30 mins) per bid url?, listing the total number of bids, the
number of sucessful bid responses, and the measurement of the latency over the successful responses.
setBidURL Set bid_url, bid_api_version, transport format for this RTBD advertiser in specified region.
setQPS Set max qps for the RTBD advertiser in specified region.
Requests
getBidURL
Return current rtbdbidurl BidURL setting for RTBD advertiser in specified region.
Input parameters:
getFailureReport
Get traffic failure metrics. There are multiple rows returned over the reporting period, and there are multiple rows per
period as well and per bid url?, having one row per distinct failure type (eg timeout, connect error, etc).
Input parameters:
Output parameters:
120
Services
rtbdfailurereport $RtbdFaliureReport
getQPS
Get current getrtbdqpsresp QPS setting for the RTBD advertiser in specified region.
Input parameters:
Output parameters:
getRecentTrafficReport
Report per region for this advertiser, the traffic and statistics observed over the last 24 hours.
Input parameters:
Output parameters:
getSuccessReport
Report traffic metrics to the advertiser including the aggregates relative to success. There will be one row per time
period (default 30 mins) per bid url?, listing the total number of bids, the number of sucessful bid responses, and the
measurement of the latency over the successful responses.
Input parameters:
Output parameters:
rtbdsuccessreport $RtbdSuccessReport
121
Services
setBidURL
Set bid_url, bid_api_version, transport format for this RTBD advertiser in specified region.
Input parameters:
Output parameters:
none
setQPS
Return none
Input parameters:
Output parameters:
none
Search Service
This service lets you run a search
Requests Summary
quickSearch Run a search for objects
search
searchWoeids Returns all woe ids having their description that matches the search pattern provided by
API user
Requests
quickSearch (read-only)
122
Services
Searches entries of search_clause : entity by name field value; contact by first_name and last_name fields value;
insertion order / line item / creative / pixel / site / section by description field value.
Input parameters:
Output parameters:
search (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
searchWoeids (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
Section Service
This service lets you add/modify a section.
123
Services
Requests Summary
add add a new section
get retrieve all information about the specified section
getAll get all sections you are authorized to see
getAllSince Return sections changed between start_date and end_date.
getByEntity get the list of sections for the specified entity
getBySite get the list of sections available for the specified site
listAll get the list of all section`s ids you are authorized to see
listAllSince Return section IDs changed between start_date and end_date.
listBeaconPixels retrieve the list of beacon pixels available
listByEntity get the list of section's ids for the specified entity
listBySite get the list of all sections available for the specified site
lookup return the list of list of all section' ids for each given code
update modify a section
Requests
add
Input parameters:
Output parameters:
get (read-only)
readonly
Input parameters:
Output parameters:
getAll (read-only)
Return the array of all section's data objects which you are allowed to see according to security model
Input parameters:
124
Services
Output parameters:
getAllSince (read-only)
Note: This method sets the start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time
interval to 24 hours or less.
Input parameters:
string $token
dateTime $start_date
dateTime $end_date
int $entries_on_page
int $page_num
Output parameters:
getByEntity (read-only)
Return the array of section's data objects which belong to the entity specified by entity_id.
Input parameters:
Output parameters:
getBySite (read-only)
Return the array of all section's data objects available for the site specified by site_id.
Input parameters:
Output parameters:
125
Services
listAll (read-only)
Return the array of section's ids which you are allowed to see according to security model Use SectionService::get() to
get the whole section data object by its id or SectionService::getAll() to get the list of all data objects.
Input parameters:
Output parameters:
listAllSince (read-only)
Note: This method sets the start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time
interval to 24 hours or less.
Input parameters:
string $token
dateTime $start_date
dateTime $end_date
Output parameters:
array_of_int $ids
listBeaconPixels (read-only)
Input parameters:
Output parameters:
listByEntity (read-only)
Return the array of section's ids which belong to the entity specified by entity_id. Use SectionService::get() to get the
whole section's data object by its id.
126
Services
Input parameters:
Output parameters:
listBySite (read-only)
Return the array of section's ids available for the site specified by site_id. Use SectionService::get() to get the whole
section data object by its id or SectionService::getBySite() to get the list of all data objects.
Input parameters:
Output parameters:
lookup
Return the array of arrays of section' ids for each code You can use SectionService::get() to get the whole section
data object by its id.
Input parameters:
Output parameters:
array_of_array_of_int $section_ids
update
Change the fields of section's data object. Please keep in mind that some fields are generated behind API (e.g.
section::$id) and cannot be changed by the client.
Input parameters:
Output parameters:
none
127
Services
SegmentDefinition Service
Segment definition service allows users to request the creation of segments under a particular segment service
provider and manage these segment.
https://api.yieldmanager.com/api-1.38/segment_definition.php?wsdl
https://api-test.yieldmanager.com/api-1.38/segment_definition.php?wsdl
Requests Summary
add Creates a targeting segment and shares it back to you.
delete Deletes the YAX segment pixel and associated segment share data from the segment service
provider entity's seat.
get Gets the segment attributes for a given public segment ID.
srtKeywordsDelete Delete keywords from a previously created segment.
srtKeywordsGet Get keywords from existing segment.
srtKeywordsReport Get a report about all keywords that comprise a previously created segment.
srtKeywordsSet Add keywords to a previously created segment.
update Update an existing segment and its attributes.
Requests
add
Creates a targeting segment under the requested target service provider and shares it back to you.
Input parameters:
string $token: This variable represents your current API session token.
string $segment_name: Short name of the segment you are creating.
int $segment_type_id: Segment type ID. See valid types in Segment Type Enum.
segment_attributes $segment_attributes: Segment attributes.
int $segment_provider_entity_id: Entity id of the segment provider you are allowed to request service from.
int $advertiser_entity_id: Only relevant if caller == $segment_provider_entity_id. In this case, this is
assumed (and enforced) to be a managed advertiser belonging to the caller. Everyone elase should either
skip this parameter, provide a value of 0, null or the same value as the $segment_provider_entity_id. Thease
are all equivalent.
Output parameters:
pixel_pair $pixel_pair: Pixel pair object of private and public segment ids of the pixel. Private pixel id will not
be populated if you are not the service provider.
delete
Deletes the YAX segment pixel and associated segment share data from the segment service provider entity's seat.
This method is available for segment managers and segment service providers.
Input parameters:
string $token: This variable represents your current API session token.
int $public_segment_id: Public segment ID.
Output parameters:
none
128
Services
get (read-only)
Gets the segment attributes for a given public segment ID. This method is available for segment managers and
segment service providers.
readonly
Input parameters:
string $token: This variable represents your current API session token.
int $public_segment_id: Public segment ID.
Output parameters:
srtKeywordsDelete
Delete keywords from a previously created segment. This method is available for segment managers and segment
service providers.
Input parameters:
string $token: This variable represents your current API session token.
int $public_segment_id: Public segment ID.
array_of_string $keywords: Keywords that will be deleted from segment.
Output parameters:
none
srtKeywordsGet (read-only)
Get keywords from existing segment. This method is available for segment managers and segment service providers.
readonly
Input parameters:
string $token: This variable represents your current API session token.
int $public_segment_id: Public segment ID.
string $keyword_status_filter: Optional filter to only get keywords of a certain status that populates this
segment. See valid types in Srt Keyword Status Enum.
Output parameters:
srtKeywordsReport (read-only)
Get a report about all keywords that comprise a previously created segment. This method is available for segment
managers and segment service providers.
129
Services
readonly
Input parameters:
string $token: This variable represents your current API session token.
int $public_segment_id: Public segment ID.
string $date: Defines the date for which a report is being requested. Use the format yyyy-mm-dd.
Output parameters:
srtKeywordsSet
Add keywords to a previously created segment. This method is available for segment managers and segment service
providers.
Input parameters:
string $token: This variable represents your current API session token.
int $public_segment_id: Public segment ID.
array_of_string $keywords: Keywords that will be added to the segment.
boolean $append: Set "true" to add keywords to existing keywords in this segment. Set "false" to overwrite
the existing keywords.
Output parameters:
none
update
Update an existing segment and its attributes. This method is available for segment managers and segment service
providers.
Input parameters:
string $token: This variable represents your current API session token.
int $public_segment_id: Public segment ID.
segment_attributes $segment_attributes: Segment attributes.
Output parameters:
none
Segment Service
This service lets you add/get/modify segments.
Requests Summary
add Create a new segment.
delete Delete a segment. (deprecated)
get Retrieve all information about the specified segment.
getAll Get all segments which you are authorized to see.
130
Services
getAncestorsInfo Get all the ancestor list for all the segment ids (which you are authorized to view)
getAncestorsPublicInfo Get all the ancestor list for given public segment ids (which you are authorized to
view)
getChildSegments Get all the child segments of a particular type, which you are authorized to see.
getDescendantsPublicInfo Get the descendant list for all the given public segment ids (which you are
authorized to view)
syncSegments Single bulk method for doing add and update
update Modify a segment.
Requests
add
Create a new segment. Additionally for segments that have specified a parent, the new segment will be automatically
be shared with any segment buyers with whom the parent is already shared. Currently this works for content
segments.
Input parameters:
Output parameters:
delete (deprecated)
Remove an existing segment data object. Note: Deleting any segment that you have shared via Audience Share will
also remove the corresponding segment shares, and thus will deactivate any line items -- except your own -- that are
targeting this segment and notify their owners. See Sharing or unsharing segments in the Audience marketplace for
details.
Input parameters:
Output parameters:
none
get
Input parameters:
Output parameters:
131
Services
getAll (read-only)
Return the array of segment objects which you are allowed to see according to security model.
readonly
Input parameters:
Output parameters:
getAncestorsInfo (read-only)
Return the array of parent segment objects of given segment ids, which you are allowed to see according to security
model.
readonly
Input parameters:
Output parameters:
getAncestorsPublicInfo (read-only)
Return the array of parent segment_public_info objects of given public segment ids, which you are allowed to see
according to security model.
readonly
Input parameters:
Output parameters:
getChildSegments (read-only)
132
Services
Return the array of child segment objects of a particular type, which you are allowed to see according to security
model.
readonly
Input parameters:
Output parameters:
getDescendantsPublicInfo (read-only)
Return the array of multiple_data_response objects and descendant segment_public_info objects of given public
segment ids, which you are allowed to see according to security model. Avaiable to content buyers only.
readonly
Input parameters:
Output parameters:
syncSegments
Single bulk method for doing add and update. Creates new segment if id is not present in segment object. Updates
the segment if id is present and is_deleted is not present.
Input parameters:
Output parameters:
update
Change the fields of segment data object. Additionally for segments that are modifying their parent(re-parenting), the
segment shares will be adjusted(sharing removed or added) to ensure that the segment is now shared based on the
new parent segments existing shares. In case any shares are removed as a result of this operation the corresponding
line items will be deactivated. Note: Some fields are generated by API (e.g. segment::$id) and cannot be changed by
the client.
133
Services
Input parameters:
Output parameters:
none
Sitelist Service
The sitelist service lets advertiser and publisher add Global Sitelist and advertiser site lists. See
http://kb.yieldmanager.com/article.php?id= for additional details.
https://api.yieldmanager.com/api-1.38/sitelist.php?wsdl
https://api-test.yieldmanager.com/api-1.38/sitelist.php?wsdl
Requests Summary
addGTSections Add sections to given GT ID.
createASL Add a array of new ASL from a list of global templates and sections ids.
createASLs Add a array of new ASL from a list of global templates and sections ids.
createGT Add a new global sitelist template.
createGTs Add a array of new global sitelist template.
duplicateASL Duplicate existing ASL
duplicateGT Duplicate existing GT
getAllASL Gets the list of all the advertiser section list object for the logged in User.
getAllGT Gets the list of all the Global template object for the logged in User.
getASL Retrieves all information about the specified advertiser section list.
getGT Retrieves all information about the specified global template.
removeGTSections Remove sections from given GT ID.
updateASL Update a advertiser section list.
updateASLs Update a array of advertiser section list.
updateGT Update a global sitelist template.
updateGTs Update a array of global sitelist template.
Requests
addGTSections
Input parameters:
Output parameters:
none
createASL
134
Services
has_transaction_commit
Input parameters:
Output parameters:
createASLs
has_transaction_commit
Input parameters:
Output parameters:
createGT
Input parameters:
Output parameters:
createGTs
has_transaction_commit
Input parameters:
Output parameters:
135
Services
duplicateASL
Accessible for all entity types
Input parameters:
Output parameters:
duplicateGT
Accessible for all entity types
Input parameters:
Output parameters:
getAllASL (read-only)
readonly
Input parameters:
Output parameters:
getAllGT (read-only)
readonly
Input parameters:
136
Services
int $entries_on_page: A pagination parameter. Use this to get n number of results per page and break up a
larger report request into smaller chunks.
int $page_num: A pagination parameter. Use it with $entries_on_page to determine which page should hold
n number of results.
Output parameters:
getASL (read-only)
readonly
Input parameters:
Output parameters:
getGT (read-only)
readonly
Input parameters:
Output parameters:
removeGTSections
Input parameters:
Output parameters:
none
137
Services
updateASL
Input parameters:
Output parameters:
updateASLs
Input parameters:
Output parameters:
updateGT
Input parameters:
Output parameters:
updateGTs
Input parameters:
Output parameters:
138
Services
Site Service
This service lets you add/modify a site.
Requests Summary
add add a new site
deleteAllPublisherControls Deletes publisher controls for specified site id and buyer_entity_ids.
(deprecated)
deletePublisherControls Deletes publisher mask controls See Managing Publisher Controls Using the API
for more information on managing publisher controls. (deprecated)
get retrieve all information about the specified site
getAll get all the sites you are authorized to see
getAllPublisherControls Gets publisher mask controls for specified site. (deprecated)
getAllSince Return sites changed between start_date and end_date.
getByEntity get the list of sites for the specified entity
getPublisherControls Gets the publisher mask controls See Managing Publisher Controls Using the API
for more information on managing publisher controls. (deprecated)
listAll get the list of all site`s ids you are authorized to see
listAllSince Return site IDs changed between start_date and end_date.
listByEntity get the list of site's ids for the specified entity
lookup return the list of list of all site' ids for each given code
setAllPublisherControls Sets publisher mask controls for specified advertisers. (deprecated)
setPublisherControls Sets the publisher mask controls See Managing Publisher Controls Using the API for
more information on managing publisher controls. (deprecated)
update modify a site
Requests
add
Input parameters:
Output parameters:
deleteAllPublisherControls (deprecated)
See Managing Publisher Controls Using the API for more information on managing publisher controls.
Input parameters:
139
Services
Output parameters:
Input parameters:
Output parameters:
none
get (read-only)
Input parameters:
Output parameters:
getAll (read-only)
Return the array of site' objects which you are allowed to see according to security model.
Input parameters:
Output parameters:
140
Services
See Managing Publisher Controls Using the API for more information on managing publisher controls.
Input parameters:
Output parameters:
getAllSince (read-only)
Note: This method sets the start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time
interval to 24 hours or less.
Input parameters:
string $token
dateTime $start_date
dateTime $end_date
int $entries_on_page
int $page_num
Output parameters:
getByEntity (read-only)
Return the array of site's data objects which belong to the entity specified by entity_id.
Input parameters:
Output parameters:
141
Services
Input parameters:
Output parameters:
listAll (read-only)
Return the array of site' id which you are allowed to see according to security model. Use SiteService::get() to get
whole site data object by its id.
Input parameters:
Output parameters:
listAllSince (read-only)
Note: This method sets the start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time
interval to 24 hours or less.
Input parameters:
string $token
dateTime $start_date
dateTime $end_date
Output parameters:
array_of_int $ids
listByEntity (read-only)
Return the array of site's ids which belong to the entity specified by entity_id. Use SiteService::get() to get the whole
site's data object by its id.
Input parameters:
Output parameters:
142
Services
lookup
Return the array of arrays of site' ids for each code You can use SiteService::get() to get the whole site data object by
its id.
Input parameters:
Output parameters:
array_of_array_of_int $site_ids
setAllPublisherControls (deprecated)
See Managing Publisher Controls Using the API for more information on managing publisher controls.
Input parameters:
Output parameters:
Input parameters:
Output parameters:
none
update
143
Services
Change the fields of site data object. Please keep in mind that some fields are generated behind API (e.g. site::$id)
and cannot be changed by client.
Input parameters:
Output parameters:
none
SupplyBlocklist Service
This service lets you add/modify/delete/get supply blocklists.
Review the Supply blocklist section in the Yield Manager Knowledge Base for additional details.
Requests Summary
add Add/Create blocklist for supply from accessing (a slice of) managed supply of the network.
delete Deletes a supply blocklist
getAllBlocklists Returns an array of all supply blocklist you are allowed to access.
getAllSince Return all supply blocklist changed between a specified start_date and end_date.
getByObjectId Returns the supply_blocklist data object for specified id.
getVurls Gets list of Vurls for specific rule id/pattern.
listAll Returns supply_blocklist data object ids that you are allowed to access.
listAllSince Return supply blocklist IDs changed between a specified start_date and end_date.
quickSearch Returns an array of all supply blocklist you are allowed to access.
setVurls Creates blocklist for VURL.
update Modify a supply blocklist.
Requests
add
Input parameters:
Output parameters:
delete
144
Services
Input parameters:
Output parameters:
none
getAllBlocklists (read-only)
Input parameters:
Output parameters:
array_of_supply_blocklist $supply_blocklist
int $total_count: The total number of records returned in the result set.
getAllSince (read-only)
Return supply blocklist IDs changed between a specified start_date and end_date. Note: This method sets the
start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
getByObjectId (read-only)
Input parameters:
Output parameters:
145
Services
supply_blocklist $supply_blocklist
getVurls (read-only)
Input parameters:
Output parameters:
array_of_vurl_get_data $vurl_data
int $total_count: The total number of records returned in the result set.
listAll (read-only)
Returns supply_blocklist data object ids that you are allowed to access.
Input parameters:
Output parameters:
array_of_int $blocklist_ids
listAllSince (read-only)
Return supply blocklist IDs changed between a specified start_date and end_date. Note: This method sets the
start_date = '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
quickSearch (read-only)
146
Services
Input parameters:
Output parameters:
array_of_blocklist_getall $supply_blocklist
int $total_count: The total number of records returned in the result set.
setVurls
Input parameters:
Output parameters:
none
update
Input parameters:
Output parameters:
none
TargetProfile Service
The TargetProfileService lets you manage targeting rules for target profiles. Use targeting rules on buyer and seller
line items to control traffic, delivery, and ensure that users see appropriate ads on appropriate inventory. See
Targeting rules defined for more information.
https://api.yieldmanager.com/api-1.38/target_profile.php?wsdl
https://api-test.yieldmanager.com/api-1.38/target_profile.php?wsdl
147
Services
Requests Summary
addApprovedCreatives Adds approved creatives.
addBannedCreatives Adds banned creatives to a given target profile.
addCustomGeoArea Adds a new Custom Geographic Area under current entity. Custom Geographic Area
is a grouping of postal codes (zip bundle) within a country for targeting usage
addMUTP Adds a secondary target profile.
applyDefaultTargetProfile Applies a default target profile to the specified object.
copyTargetProfile Copies a target profile.
createDefaultTargetProfile Creates a default target profile.
deleteDefaultTargetProfile Deletes a specified default target profile.
deleteMUTP Deletes a secondary target profile.
deleteTargetClickUrls
deleteTargetCreatives Delete targeted creative IDs.
flipCreativeDefault Changes the default creative status.
get Retrieves all the target profile objects for the specified target profile ID.
getAllCustomGeoAreas Returns all Custom Geographic Area objects for current entity
getAllSince Return all target profiles changed between a specified start_date and end_date.
getAvailableTargetings Returns an array of targeting types that apply to the given object.
getByObject Return target_profile and targetings objects by specified object.
getCustomGeoArea Returns Custom Geographic Area object for a given Custom Geographic Area id
getDefaultTargetProfiles Returns a list of default target profile IDs.
getGeoTargetingVersion Returns type of Geo targeting applied on owner
getMUTP Retrieve secondary target profiles
getTargetAdvertisers Returns an array of targeting rules by advertiser ID.
getTargetAges Returns an array of targeted ages.
getTargetASLs Returns an array of targeting ASLs.
getTargetBrowsers Returns an array of browser targeting IDs.
getTargetBuyerLineItems Returns an array of targeted advertiser line item IDs.
getTargetBuyers Returns an array of targeted advertiser IDs.
getTargetChannels Returns an array of included or excluded publisher channel IDs.
getTargetClickUrls Returns an array based on click URL targeting.
getTargetClickUrlsV2 Return an array of click URL targeting
getTargetContentCategories Returns an array of content categories
getTargetCreativeBeacons Returns an array of creative beacon IDs.
getTargetCreatives Returns an array of targeted creative IDs.
getTargetCreativeSpecs Returns an array of targeted creative specs. (deprecated)
getTargetCreativeTags Returns an array of creative tag IDs.
getTargetCSL Returns an array of targeting ASLs.
getTargetDayparts Returns an array of daypart targeting rules.
getTargetDealProperties Returns an array of targeting rules by deal properties.
getTargetFrequency Returns an array of frequency cap targeting settings: amount and time interval.
getTargetGender Returns an array of gender targeting.
getTargetGeography Returns an array of geographic targeting rules.
getTargetGeographyV2 Returns the list of targeted WOEIDs and CGA ids.
getTargetInventoryTypes Returns an array of targeting rules for the specified inventory type.
getTargetIsps Returns an array of commercial Internet Service Provider (ISP) IDs.
getTargetLanguages Returns an array of language IDs targeted to a browser.
getTargetNetspeeds Returns an array of netspeed (Internet connection speed) IDs.
getTargetOfferTypes Returns an array of offer type IDs.
getTargetPixels Returns an array of pixel targeting information.
getTargetPrivateMarketPlace Returns targeting rule by included or excluded Private Marketplace IDs.
getTargetPublishers Returns an array of entity IDs for a particular publisher or group of publishers.
getTargetQueryString Returns an array of query string targeting information.
getTargetRating Returns a maximum allowed rating.
getTargetSections Returns an array of targeting rules by included or excluded section IDs.
getTargetSellerLineItems Returns an array of targeted publisher line item IDs.
getTargetSizes Returns an array of included or excluded creative size IDs.
getTargetTechno Returns current techno targeting for the target profile,which is an array of
segment_hierarchy_id which corresponds to Carrier/OS/Browser/Device segments.
getTargetTransparency Returns an array of targeting Transparency.
getTargetUrls Returns an array based on URL targeting.
getTargetValidatedUrls Returns an array of targeting rules by validated URL (VURL).
getTargetVurlTags Returns an array of validated URL (VURLS) IDs.
getTargetWifi Returns true if Wifi is enabled for the target_profile. false otherwise.
listAllSince Return target profile IDs changed between a specified start_date and end_date.
listDefaultTargetProfiles Returns all target profile IDs by specified entity ID.
moveTargetClickUrls
overwriteDefaultTargetProfile Overwrites a default target profile.
resetTargeting Resets all targeting on the specified owner.
searchTargetClickUrlsV2 Return an array of click URL targeting
searchVurls Search for VURLs based on specified category, description, or other qualities.
setTargetAdvertisers Limits delivery to particular advertisers based on the specified advertiser ID.
148
Services
Requests
addApprovedCreatives
Input parameters:
Output parameters:
none
149
Services
addBannedCreatives
Input parameters:
Output parameters:
none
addCustomGeoArea
Accessible for all entity types
Input parameters:
Output parameters:
addMUTP
Adds secondary targeting to given target profile. See Multiple universal targeting profiles for more details. Note: You
must use Universal Targeting to set secondary target profiles. See Universal targeting: About for more details.
Input parameters:
string $token: This variable represents an active session token. See Using the target_profile_owner_type
and target_profile_owner_id variables for more details.
Output parameters:
applyDefaultTargetProfile
Input parameters:
150
Services
int $owner_id: Defines the owning object ID. See Using the target_profile_owner_type and
target_profile_owner_id variables for more details.
int $default_tp_id: Default target profile ID.
Output parameters:
copyTargetProfile
Creates a copy of a given target profile and assigns it to another target profile.
Input parameters:
Output parameters:
createDefaultTargetProfile
Copies a given target profile data to a new one, applies a given name to it, and creates a default target profile with the
copied data.
Input parameters:
Output parameters:
deleteDefaultTargetProfile
Input parameters:
Output parameters:
none
151
Services
deleteMUTP
Deletes a secondary target profile. See Multiple universal targeting profiles (MUTP) for more details. Note: You must
use Universal Targeting to set secondary target profiles. See Universal targeting: About for more details.
Input parameters:
Output parameters:
none
deleteTargetClickUrls
Accessible for all entity types
Input parameters:
Output parameters:
deleteTargetCreatives
Input parameters:
Output parameters:
flipCreativeDefault
In Universal Targeting, used to change the default ban/approve status for creatives. See Creative Reviewer: Overview
for more details.
152
Services
Input parameters:
Output parameters:
none
get
Retrieves all the target profile objects for the specified target profile ID.
Input parameters:
Output parameters:
getAllCustomGeoAreas (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
getAllSince (read-only)
Return target profile IDs changed between a specified start_date and end_date. Note: This method sets the start_date
= '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
153
Services
getAvailableTargetings (read-only)
Return an array of strings which represent the current targeting for the given object type and object ID. For example, if
this method was called as getAvailableTargetings(token_id, 'campaign', tp_id), it would return something like this:
array('channel', 'size', 'isp'), depending on what kind of targeting had been set.
Input parameters:
Output parameters:
getByObject
Return target_profile and targetings objects by specified entity, creative, campaign, or line_item.
Input parameters:
Output parameters:
getCustomGeoArea (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
getDefaultTargetProfiles
Input parameters:
154
Services
Output parameters:
getGeoTargetingVersion (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
getMUTP (read-only)
Retrieve secondary target profiles See Multiple universal targeting profiles for more details. Note: You must use
Universal Targeting to set secondary target profiles. See Universal targeting: About for more details.
readonly
Input parameters:
Output parameters:
getTargetAdvertisers (read-only)
available : line_item
Input parameters:
Output parameters:
boolean $advertiser_default: Set "true" to exclude or "false" to include particular advertiser IDs in the
$advertisers_ids array.
array_of_int $advertiser_ids: An array of advertiser IDs.
getTargetAges (read-only)
155
Services
Input parameters:
Output parameters:
boolean $age_default: default age Set "true" to exclude or "false" to include particular age IDs in the
$target_age array. See Using Boolean method_name_default variables for details.
array_of_int $target_age: An array of targeted ages.
getTargetASLs (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
getTargetBrowsers (read-only)
Returns an array of based on browser targeting. See Browser Enum for more information.
Input parameters:
Output parameters:
boolean $browser_default: Set "true" to exclude or "false" to include particular browser IDs in the
$browser_ids array. See Using Boolean method_name_default variables for details.
array_of_int $browser_ids: An array of browser IDs.
getTargetBuyerLineItems (read-only)
156
Services
Input parameters:
Output parameters:
boolean $buyer_line_item_default: Set "true" to exclude or "false" to include particular line item IDs in the
$line_items array. See Using Boolean method_name_default variables for details.
array_of_int $line_items: An array of line item IDs.
getTargetBuyers (read-only)
Input parameters:
Output parameters:
boolean $buyer_entity_default: Set "true" to exclude or "false" to include particular advertiser IDs in the
$buyer_ids array. See Using Boolean method_name_default variables for details.
array_of_int $buyer_ids: An array of buyer IDs.
getTargetChannels (read-only)
Returns an array of included or excluded publisher channel IDs. Channels are categories that describe the content of
publisher inventory, such as Entertainment, Real Estate, Gaming, Search and Shopping.
See Channel Enum for more information. Accessible for all entity types
Input parameters:
Output parameters:
boolean $channel_default: Set "true" to exclude or "false" to include particular publisher channel IDs in the
arrays. See Using Boolean method_name_default variables for details.
157
Services
getTargetClickUrls (read-only)
Input parameters:
Output parameters:
boolean $click_url_default: Set to "true" to exclude or "false" to include particular click URLs in the $urls
array. See Using Boolean method_name_default variables for details.
array_of_string $urls: An array of click URLs or click URL search patterns.
getTargetClickUrlsV2 (read-only)
Input parameters:
Output parameters:
getTargetContentCategories (read-only)
Input parameters:
158
Services
int $owner_id: Defines the owning object ID. See Using the target_profile_owner_type and
target_profile_owner_id variables for more details.
Output parameters:
boolean $require_all: Passes in simple Boolean "and" "or" expressions to include or exclude pixel IDs in the
$target_pixels array.
array_of_target_pixel $target_pixels: An array of targeted pixel objects.
string $logical_expression: This variable represents complex Boolean operators used to include or exclude
pixel IDs in the $target_pixels array.
getTargetCreativeBeacons (read-only)
See Targeting Creative Beacons Using the API for more information on targeting creative beacons.
Creative beacons targeting is available on owner_type 'entity' if the current entity is not enabled for Multiple
Universal target profile (STPs), and there are no default STP.
Input parameters:
Output parameters:
boolean $creative_beacon_default: Set "true" to exclude or "false" to include particular beacon IDs in the
$creative_beacons_id_list array.
array_of_int $creative_beacons_id_list: An array of creative beacon IDs.
getTargetCreatives (read-only)
Input parameters:
Output parameters:
boolean $creative_default: Set "true" to exclude or "false" to include particular creative IDs in the
$creative_ids array. See Using Boolean method_name_default variables for details.
array_of_int $creative_ids: Creative ID array.
159
Services
Input parameters:
Output parameters:
getTargetCreativeTags (read-only)
Returns an array of creative tag IDs that limit the delivery of creatives by one or more creative specs or themes. For
more details:
Creative tags targeting is available on owner_type 'entity' if the current entity is not enabled for Multiple
Universal target profile (STPs), and there are no STPs.
Input parameters:
Output parameters:
getTargetCSL (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
160
Services
getTargetDayparts (read-only)
Input parameters:
Output parameters:
getTargetDealProperties (read-only)
Returns an array of targeting rules by deal properties. A deal property is a type of pricing available for a campaign or
line item. Setting targeting by deal property will limit delivery of the targeted object to targets using the desired pricing.
For example, if you want to deliver to targets using CPC (cost-per-click) pricing, set the $allow_cpc property of
$deal_properties to true. See Pricing options for line items and campaigns for more details.
Input parameters:
Output parameters:
getTargetFrequency (read-only)
Returns an array of frequency cap targeting settings: amount and time interval. See Frequency capping for line items
for more details.
Input parameters:
Output parameters:
161
Services
getTargetGender (read-only)
Input parameters:
Output parameters:
getTargetGeography
Limits delivery to particular geographic areas (country, region, state, province, etc.) or from particular Designated
Marketing Area (DMA). Note: Selecting all DMAs is the same as targeting to the US only. See tutorial:
Country Enum
Region Enum
Msa Enum
This function is used only for any existing targeting profile with some old geo targeting already selected otherwise
setTargetGeographyV2 function will be used in all other cases which uses woeid and cga targeting. To shift from old
geo targeting to new woeid and cga targeting one just need to delete any existing old targeting and set the targeting
"show to all".
Input parameters:
Output parameters:
getTargetGeographyV2
162
Services
Input parameters:
Output parameters:
getTargetInventoryTypes (read-only)
Returns an array of targeting rules for the specified inventory type. See Inventory Type Enum for more information.
Input parameters:
Output parameters:
boolean $inventory_type_default: Set to "true" to exclude or "false" to include particular inventory type IDs
in the $inventory_type_ids array. See Using Boolean method_name_default variables for details.
array_of_int $inventory_type_ids: Arry of inventory type IDs.
getTargetIsps (read-only)
Returns an array of commercial Internet Service Provider (ISP) IDs. See Isp Enum for more information.
Input parameters:
Output parameters:
boolean $isp_default: Set "true" to exclude or "false" to include particular ISP IDs in the $isp_ids array. See
Using Boolean method_name_default variables for details.
array_of_int $isp_ids: An array of ISP IDs.
getTargetLanguages (read-only)
Returns an array of language IDs targeted to a browser. See Language Enum for more information.
163
Services
Input parameters:
Output parameters:
boolean $language_default: Set "true" to exclude or "false" to include particular language IDs in the
$language_ids array. See Using Boolean method_name_default variables for details.
array_of_int $language_ids: An array of language IDs.
getTargetNetspeeds (read-only)
Returns an array of netspeed (Internet connection speed) IDs. See Netspeed Enum for more information.
Input parameters:
Output parameters:
boolean $netspeed_default: Set "true" to exclude or "false" to include particular netspeeds in the
$netspeed_ids array. See Using Boolean method_name_default variables for details.
array_of_int $netspeed_ids: An array of netspeed IDs.
getTargetOfferTypes (read-only)
Offer type targeting is available on owner_type 'entity' if the current entity is not enabled for Multiple Universal
target profile (STPs), and there are no STPs.
Input parameters:
Output parameters:
boolean $offer_type_default: Set "true" to exclude or "false" to include particular offer type IDs in the
$offery_type_ids array. See Using Boolean method_name_default variables for details.
array_of_int $offer_type_ids: An array of offer type IDs.
164
Services
getTargetPixels (read-only)
Returns an array of pixel targeting information. Use the PixelService::setCreatives() function to bind a pixel to a group
of creatives. Note: This method uses Boolean expressions to determine the pixel combination included or excluded in
the $require_all variable. See Using logical expressions with select TargetProfileService methods for details. This call
can work in two modes: simple and advanced. The former mode requires only the first four parameters to be defined,
the latter - all but $query_string_option. $query_strings array defines strings to be used with either
$query_string_option (simple mode) or $query_string_logical_expression (advanced mode).
Since some combinations of AND, OR and NOT can lead to ambiguous cases, it is permitted to use parentheses to
clarify the order of operations.
Input parameters:
Output parameters:
boolean $require_all: Passes in simple Boolean "and" "or" expressions to include or exclude pixel IDs in the
$target_pixels array.
array_of_target_pixel $target_pixels: An array of targeted pixel objects.
string $logical_expression: This variable represents complex Boolean operators used to include or exclude
pixel IDs in the $target_pixels array.
getTargetPrivateMarketPlace (read-only)
Input parameters:
Output parameters:
boolean $pvt_marketplace_default: Set "true" to exclude or "false" to include particular pvt_marketplace Id.
See Using Boolean method_name_default variables for details.
array_of_int $pvt_marketplace_ids: An array of Private Marketplace IDs.
getTargetPublishers (read-only)
165
Services
Input parameters:
Output parameters:
boolean $publisher_default: Set "true" to exclude or "false" to include particular publishers in the
$publisher_entity_ids array. See Using Boolean method_name_default variables for details.
array_of_int $publisher_entity_ids: An array of publisher entity IDs.
getTargetQueryString (read-only)
Return the query strings targeting information. $query_strings array defines strings to be used with either
$query_string_option (simple mode) or $query_string_logical_expression (advanced mode).
See Using logical expressions with select TargetProfileService methods for more details.
available : line_item
Input parameters:
Output parameters:
getTargetRating (read-only)
Returns a maximum allowed rating. See Rating Enum for more information.
Input parameters:
Output parameters:
166
Services
getTargetSections (read-only)
Input parameters:
Output parameters:
boolean $section_default: Set "true" to exclude or "false" to include particular section IDs in the
$section_ids array. See Using Boolean method_name_default variables for details.
array_of_int $section_ids: An array of section IDs.
getTargetSellerLineItems (read-only)
Input parameters:
Output parameters:
boolean $seller_line_item_default: Set "true" to exclude or "false" to include particular publisher line item
IDs in the $line_items array. See Using Boolean method_name_default variables for details.
array_of_int $line_items: An array of of line item IDs.
getTargetSizes (read-only)
Returns an array of included or excluded creative size IDs. See Size Enum for more information.
Input parameters:
Output parameters:
boolean $size_default: Set "true" to exclude or "false" to include particular size IDs in the $size_ids array.
See Using Boolean method_name_default variables for details.
array_of_int $size_ids: An array of size IDs.
167
Services
getTargetTechno (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
getTargetTransparency (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
getTargetUrls (read-only)
Input parameters:
Output parameters:
boolean $url_default: Set to "true" to exclude or "false" to include particular URLs in the $urls array. See
Using Boolean method_name_default variables for details.
array_of_string $urls: An array of URLs or URL search patterns.
168
Services
getTargetValidatedUrls (read-only)
Input parameters:
Output parameters:
vurl_options $options: Set "true" to exclude or "false" to include particular VURL categories in the VURL
IDs array.
array_of_int $vurl_ids: An array of VURL IDs.
getTargetVurlTags (read-only)
Input parameters:
Output parameters:
getTargetWifi (read-only)
Accessible for all entity types
Input parameters:
Output parameters:
listAllSince (read-only)
169
Services
Return target profile IDs changed between a specified start_date and end_date. Note: This method sets the start_date
= '0000-00-00 00:00:00' and end_date = now by default. Restrict your date/time interval to 24 hours or less.
Input parameters:
Output parameters:
listDefaultTargetProfiles
Input parameters:
Output parameters:
moveTargetClickUrls
Accessible for all entity types
Input parameters:
Output parameters:
overwriteDefaultTargetProfile
overwriteDefaultTargetProfile:
Copies values from a given target profile to an existing default target profile.
Sets the target profile name.
Input parameters:
170
Services
Output parameters:
none
resetTargeting
Resets all targeting on the specified owner. Note: When the owner is a line item, this method can only be used to
delete target profiles on non-linked line items.
Input parameters:
Output parameters:
none
searchTargetClickUrlsV2 (read-only)
Input parameters:
Output parameters:
searchVurls (read-only)
Returns a list of VURLs filtered by vurl search options. To use this method:
Create a VURL search options object with the constraints of your search.
Pass it to the searchVurls method.
readonly
Input parameters:
171
Services
Output parameters:
setTargetAdvertisers
Limits delivery to particular advertisers based on the specified advertiser ID. Use setTargetAdvertisers to exclude any
advertiser in the Exchange that you never want to run through your inventory, such as a competing advertiser or an
advertiser that your company doesn't want to do business with.
available : line_item
Input parameters:
Output parameters:
none
setTargetAges
Input parameters:
Output parameters:
none
setTargetASLs
Accessible for all entity types
available : line_item,
Input parameters:
172
Services
Output parameters:
none
setTargetBrowsers
Limits to particular web browsers. See Browser Enum for more information.
Input parameters:
Output parameters:
none
setTargetBuyerLineItems
Input parameters:
Output parameters:
none
setTargetBuyers
173
Services
Input parameters:
Output parameters:
none
setTargetChannels
Limits delivery to particular publisher content channels. Channels are categories that describe the content of publisher
inventory, such as Entertainment, Real Estate, Gaming, Search and Shopping.
Option: Use the 2nd array to define exceptions to the default behavior set by $channel_default. For example, if
$channel_default is "false" channels specified in the 2nd array will always be excluded. Note: The that array always
overrides $channel_default treatment. See Channel Enum for more information. Accessible for all entity types
Input parameters:
Output parameters:
none
setTargetClickUrls
Limits delivery based on a particular click URL, groups of clickthrough URLs or clickthrough URL patterns (e.g.,
acme.com, "*cnn.com*").
Note:
Setting $click_url_default = false restricts delivery to creatives using the specified clickthrough URL only (not
recommended).
Limit patterns to 50 characters (max) and do not include any slashes after the domain.
Using * limits matching to "cnn.com" and "test.cnn.com", but not "cnn.com.org".
174
Services
Input parameters:
Output parameters:
none
setTargetClickUrlsV2
Limits delivery based on a particular click URL, groups of clickthrough URLs or clickthrough URL patterns (e.g.,
acme.com, "*cnn.com*").
Note:
Setting $click_url_default = false restricts delivery to creatives using the specified clickthrough URL only (not
recommended).
Setting $click_url_default = true restricts delivery to creatives except the specified clickthrough URL.
Limit patterns to 50 characters (max) and do not include any slashes after the domain.
Using * limits matching to "cnn.com", "*cnn*" and "test.cnn.com", but not "cnn.com.org" and "cnn.com/".
Input parameters:
Output parameters:
setTargetContentCategories
Limits delivery to supply matching the specified content categories. API signature is similar to
TargetProfileService::setTargetPixels(), content categories have to be used like public_segment_ids.
Input parameters:
175
Services
int $owner_id: Defines the owning object ID. See Using the target_profile_owner_type and
target_profile_owner_id variables for more details.
boolean $require_all: Passes in simple Boolean "and" "or" expressions to include or exclude pixels in the
$target_pixels array.
array_of_target_pixel $target_pixels: An array of targeted pixel objects.
string $logical_expression: Passes in complex Boolean operators to include or exclude pixel IDs in the
$target_pixels array. Logical Expressions may contain up to 28 unique pixel ids.
boolean $append: Set "true" to add target size settings on an existing profile. Set "false" to overwrite the
existing profile.
Output parameters:
none
setTargetCreativeBeacons
See Targeting Creative Beacons Using the API for more information on targeting creative beacons.
Creative beacons targeting is available on owner_type 'entity' if the current entity is not enabled for Multiple
Universal target profile (STPs), and there are no default STP.
Input parameters:
Output parameters:
none
setTargetCreatives
Input parameters:
Output parameters:
none
176
Services
setTargetCreativeSpecs (deprecated)
Limits by creative specs such as ActiveX, suggestive content, or third party tags.
Input parameters:
Output parameters:
none
setTargetCreativeTags
Limits delivery of creatives by one or more creative specs or themes. For more details:
Creative tags targeting is available on owner_type 'entity' if the current entity is not enabled for Multiple
Universal target profile (STPs), and there are no STPs.
Input parameters:
Output parameters:
none
setTargetCSL
Accessible for all entity types
available : line_item,
Input parameters:
177
Services
Output parameters:
none
setTargetDayparts
Limits delivery to particular days or parts of a day (daypart targeting). For example:
An advertiser can daypart target to show ads only during the hours that its call center is open.
A publisher can daypart target to set different pricing based on traffic patterns throughout the day, such as
morning, afternoon, and evening inventory.
Note: All daypart times are in the Eastern Time Zone (US), regardless of your network's default time zone. You will
need to convert the daypart time to EST to account for the difference. See Daypart targeting for more details.
Accessible for all entity types
Input parameters:
Output parameters:
none
setTargetDealProperties
Limits delivery by deal properties. A deal property is a type of pricing available for a campaign or line item. Setting
targeting by deal property will limit delivery of the targeted object to targets using the desired pricing. For example, if
you want to deliver to targets using CPC (cost-per-click) pricing, set the $allow_cpc property of $deal_properties to
true. See Pricing options for line items and campaigns for more details.
Input parameters:
Output parameters:
none
setTargetFrequency
Limits frequency to x ads in y minutes/hours/12 hours/days per user. See Frequency capping for line items for more
details.
178
Services
Input parameters:
Output parameters:
none
setTargetGender
Input parameters:
Output parameters:
none
setTargetGeography
Limits delivery to particular geographic areas (country, region, state, province, etc.) or from particular Designated
Marketing Area (DMA). Note: Selecting all DMAs is the same as targeting to the US only. See tutorial:
Country Enum
Region Enum
Msa Enum
This function is used only for any existing targeting profile with some old geo targeting already selected otherwise
setTargetGeographyV2 function will be used in all other cases which uses woeid and cga targeting. To shift from old
geo targeting to new woeid and cga targeting one just need to delete any existing old targeting and set the targeting
"show to all".
Input parameters:
179
Services
Output parameters:
none
setTargetGeographyV2
Limits delivery to particular Placetypes (i.e, countries, states, counties, metros and cities) represented by
WOEID(Where On Earth ID) and/or to particular Custom Geographic Areas(CGAs).
Input parameters:
Output parameters:
none
setTargetInventoryTypes
Limits delivery to a specified inventory type ID. See Inventory Type Enum for more information.
Input parameters:
Output parameters:
none
setTargetIsps
Limits delivery to particular commercial Internet service providers (ISPs). See Isp Enum for more information.
Input parameters:
180
Services
enum_target_profile_owner_type_ext $owner_type: Defines the object that owns the target profile. See
Using the target_profile_owner_type and target_profile_owner_id variables for more details.
int $owner_id: Defines the owning object ID. See Using the target_profile_owner_type and
target_profile_owner_id variables for more details.
boolean $isp_default: Set "true" to exclude or "false" to include particular ISP IDs in your targeting. See
Using Boolean method_name_default variables for details.
array_of_int $isp_ids: An array of ISP IDs.
boolean $append: Set "true" to add target size settings on an existing profile. Set "false" to overwrite the
existing profile.
Output parameters:
none
setTargetLanguages
Limits delivery to specified languages. User browser settings determine the user's language. For example, to target
English speaking users in Germany, set targeting rules with Germany as the geographic target and English as the
language. See Language Enum for more information.
Input parameters:
Output parameters:
none
setTargetNetspeeds
Limits delivery to particular Internet connection speeds (netspeed). See Netspeed Enum for more information.
Input parameters:
Output parameters:
none
setTargetOfferTypes
Limits delivery by offer types such as business, dating, giveaway, or shopping. Offer types describe the actual type of
offering that the advertised product or service represents. Offer types are distinct from and can be completely
unrelated to creative specs, which describe a creative's graphical content and details about its delivery. One or more
child offer types can be targeted. Targeting of parent offer type is not allowed. See Banning creatives using API for
181
Services
more details.
Offer type targeting is available on owner_type 'entity' if the current entity is not enabled for Multiple Universal
target profile (STPs), and there are no STPs.
Input parameters:
Output parameters:
none
setTargetPixels
Limits delivery to users who have already triggered one or more specified pixels. Use the PixelService::setCreatives()
function to bind a pixel to a group of creatives. See also Targeting users by pixels for more details. Note: This method
uses Boolean expressions to determine the pixel combination included or excluded in the $require_all variable. See
Using logical expressions with select TargetProfileService methods for details. This call can work in two modes:
simple and advanced. The former mode requires only four first parameters to be defined, the latter - all but
$require_all.
$require_all parameter defines an operation which will be applied to all array_of_target_pixel elements in simple
mode:
$require_all=true - AND
$require_all=false - OR
Logical operations serve to connect terms into expressions, where terms are defined in the following way:
id=pixel_idnN, where
pixel_id - pixel id
N - negation (0 or 1)
Since some combinations of AND, OR and NOT can lead to ambiguous cases, it is permitted to use parentheses to
clarify the order of operations.
Use id to denote the use of private segment id and pid for the use of public segment id.
182
Services
Input parameters:
Output parameters:
none
setTargetPrivateMarketPlace
available : line_item
Input parameters:
Output parameters:
none
setTargetPublishers
Input parameters:
Output parameters:
none
setTargetQueryString
183
Services
Tailors delivery according to criteria that the publisher passes in through query strings. These can be values like
gender, age, or other user characteristics. See Targeting users by query strings and Using logical expressions with
select TargetProfileService methods for more details.
Sets a targeting rule to limit delivery by the array of query string values. This call uses two modes: simple and
advanced. Simple mode requires only the first 5 parameters to be defined. Advanced mode requires all parameters
except $query_string_option. $query_strings array defines strings to be used with either $query_string_option
operation (simple mode) or $query_string_logical_expression (advanced mode).
available : line_item
Input parameters:
Output parameters:
none
setTargetRating
Limits delivery by MPAA (publisher section) ratings. Section ratings describe the sensitivity of a publisher's content.
Specify maximum allowable $rating. See Rating Enum for more information.
Input parameters:
Output parameters:
none
setTargetSections
Limits delivery to particular sections on publishers' sites based on the section ID.
Input parameters:
184
Services
boolean $section_default: Set "true" to exclude or "false" to include particular section IDs in your
targeting.For owner_type = 'entity' only exclude is allowed. See Using Boolean method_name_default
variables for details.
array_of_int $section_ids: An array of section IDs.
boolean $append: Set "true" to add target size settings on an existing profile. Set "false" to overwrite the
existing profile.
Output parameters:
none
setTargetSellerLineItems
Input parameters:
Output parameters:
none
setTargetSizes
Set a targeting rule to limit delivery by creative size. $size_default flag let you specify how to treat the elements of
$size_ids array. If it is set to:
true means: exclude the specified sizes, all others are included
false means: include the specified sizes, all others are excluded
See Size Enum for more information. Accessible for all entity types
Input parameters:
Output parameters:
none
setTargetTechno
Logical expression from techno attribute will be -> OR with in the category, AND across the categories, exclude
means NEGATE.
185
Services
Input parameters:
Output parameters:
none
setTargetTransparency
Accessible for all entity types
Input parameters:
Output parameters:
none
setTargetUrls
Limits delivery to particular URL addresses, such as acme.com or yourisp.net, or URL patterns, such as "*cnn.com*".
For example, targeting to "*cnn.com*" will limit matches to "cnn.com" and "test.cnn.com", but not "cnn.com.org".
Patterns cannot be longer than 50 characters and you should not include any slashes after the domain.
Input parameters:
Output parameters:
none
setTargetValidatedUrls
Limits delivery to URLs verified and classified by the Yahoo Ad Exchange Media Guard program. Validated URLs can
belong to a category (e.g. 'Social Networking'), but only to one category. VURLs also have 4 other properties: 'is
adware', 'is click fraud','is in RMX Top 100', and 'is in RMX Top 250'. See
186
Services
Input parameters:
Output parameters:
none
setTargetVurlTags
Limits delivery to particular validated URLs (VURLs) IDs. VURL targeting allows you to restrict the inventory where
your campaigns serve, based on their actual URLs or the content of their sites (as classified by the Exchange's Media
Guard program). Use VURL targeting in universal targeting to exclude VURLs across all your campaigns. You can
also include/exclude VURLs for individual campaigns in line item targeting. See VURL and URL targeting for more
details.
Input parameters:
Output parameters:
none
setTargetWifi
Accessible for all entity types
Input parameters:
Output parameters:
none
187
Services
updateTargetProfile
Input parameters:
Output parameters:
none
188
Data types
ad_tag_options
Used by the following call(s) and/or data type(s):
EntityService
getPubAdTags()
Fields Summary
$tag_type Ad tag type
$banners_size_ids Contains banners size IDs, see Size Table for additional information.
$ban_flash_ads
$do_not_bypass_blockers
$pub_query_string
$pub_redirect
$pub_redirect_encoded If this field is true then ad_tag_options::$pub_redirect field should be urlencoded.
$click_url
$click_url_encoded If this field is true then ad_tag_options::$click_url field should be urlencoded.
$pop_type if pop creative then what type
$pop_freq_times frequency cap for pops only, pop x times over y span of z units (example, only show pop
5 times every 2 hours)
$pop_freq_span frequency cap for pops only, pop x times over y span of z units (example, only show pop
5 times every 2 hours)
$pop_freq_unit frequency cap for pops only, pop x times over y span of z units (example, only show pop 5
times every 2 hours)
$pop_freq_suppress
$ad_resize
$ad_fixed
$pre_width
$pre_height
$interstitial_logo
$interstitial_title
$interstitial_bgcolor
$interstitial_textcolor
$interstitial_linkcolor
$interstitial_disappears
$secure_ad Set this to 1 if the Ad to be served, needs to be secured. A secure Ad is the one which uses
HTTPS protocol.
$vast_tag Complex data type to represent vast tag attributes.
Fields
enum_ad_tag_type $tag_type
Ad tag type
nillable
array_of_int $banners_size_ids
Contains banners size IDs, see Size Table for additional information.
nillable
boolean $ban_flash_ads
nillable
boolean $do_not_bypass_blockers
nillable
string $pub_query_string
nillable
189
Services
string $pub_redirect
nillable
boolean $pub_redirect_encoded
If this field is true then ad_tag_options::$pub_redirect field should be urlencoded.
nillable
string $click_url
nillable
boolean $click_url_encoded
If this field is true then ad_tag_options::$click_url field should be urlencoded.
nillable
enum_ad_pop_type $pop_type
if pop creative then what type
nillable
int $pop_freq_times
Default value: '1'
frequency cap for pops only, pop x times over y span of z units (example, only show pop 5 times every 2 hours)
int $pop_freq_span
Default value: '1'
frequency cap for pops only, pop x times over y span of z units (example, only show pop 5 times every 2 hours)
enum_ad_pop_freq_unit $pop_freq_unit
Default value: 'day(s)'
frequency cap for pops only, pop x times over y span of z units (example, only show pop 5 times every 2 hours)
boolean $pop_freq_suppress
Default value: '0'
boolean $ad_resize
nillable
boolean $ad_fixed
nillable
int $pre_width
nillable
int $pre_height
nillable
string $interstitial_logo
nillable
string $interstitial_title
190
Services
nillable
string $interstitial_bgcolor
Default value: 'white'
string $interstitial_textcolor
Default value: 'black'
string $interstitial_linkcolor
Default value: 'blue'
int $interstitial_disappears
Default value: '20'
boolean $secure_ad
Default value: '0'
Set this to 1 if the Ad to be served, needs to be secured. A secure Ad is the one which uses HTTPS protocol.
nillable
vast_tag $vast_tag
Complex data type to represent vast tag attributes.
adv_domain_blocklist
advertiser_domain data type
Fields Summary
$supplier_entity_id network/publisher ID
$buyer_entity_id network/advertiser ID
$adv_domain_id Domain id
$visibility Set "true" for public. Set "false" for private.
$lastupd
Fields
int $supplier_entity_id
network/publisher ID
size : 10
primary
int $buyer_entity_id
network/advertiser ID
size : 10
primary
int $adv_domain_id
Domain id
size : 10
primary
boolean $visibility
Default value: '0'
191
Services
dateTime $lastupd
Ignored on add and update.
advertiser_domain_blocklist_download
Used by the following call(s) and/or data type(s):
AdvertiserDomainService
downloadBlockList()
Fields Summary
$domain domain
$abids list of ABIDs (Advertiser Blocklist IDs).
Fields
string $domain
domain
array_of_string $abids
list of ABIDs (Advertiser Blocklist IDs).
advertiser_domain_blocklist
Used by the following call(s) and/or data type(s):
AdvertiserDomainService
setBlockList()
Fields Summary
$buyer_entity_id Buyer entity id
$domain_urls List of domain urls that are blocked for specific buyer.
$append Set "true" to append to existing blocklist. Set "false" to overwrite the existing blocklist.
Fields
int $buyer_entity_id
Buyer entity id
array_of_domain_url_data $domain_urls
List of domain urls that are blocked for specific buyer.
boolean $append
Set "true" to append to existing blocklist. Set "false" to overwrite the existing blocklist.
advertiser_domain
advertiser_domain data type
AdvertiserDomainService
192
Services
add()
getAll()
getAllSince()
getByDomainUrls()
getByIds()
search()
update()
Fields Summary
$industry_vertical_name Industry vertical name
$adv_domain_parent_brand_name advertiser domain parent brand name
$id advertiser domain ID
$name advertiser domain display name
$domain_url advertiser domain url
$industry_vertical_id Industry vertical id.
$is_active status of advertiser domain.
$adv_domain_parent_brand_id advertiser domain parent brand id.
$lastupd last updated time
Fields
string $industry_vertical_name
Industry vertical name
nillable
string $adv_domain_parent_brand_name
advertiser domain parent brand name
int $id
Ignored on add and update.
advertiser domain ID
size : 10
primary
string $name
Default value: ''
advertiser domain display name
size : 100
nillable
string $domain_url
advertiser domain url
size : 120
int $industry_vertical_id
Default value: '0'
Industry vertical id.
Industry vertical id. List of industry vertical ids can be obtained using AdvertiserDomainService::getIndustryVerticals().
To create a new industrial vertical name, send empty industry_vertical_id and industry_vertical_name that needs to be
created. In case both industry_vertical_id & industry_vertical_name are submitted, industry_vertical_name is ignored.
size : 8
nillable
boolean $is_active
Default value: '1'
status of advertiser domain.
193
Services
int $adv_domain_parent_brand_id
Default value: '0'
advertiser domain parent brand id.
advertiser domain parent brand id. List of advertiser domain parent ids can be obtained using
AdvertiserDomainService::getParentBrands(). To create a new advertiser domain parent, send empty
adv_domain_parent_brand_id and adv_domain_parent_brand_name that needs to be created. In case both
adv_domain_parent_brand_id & adv_domain_parent_brand_name are submitted, adv_domain_parent_brand_name
is ignored.
size : 8
nillable
dateTime $lastupd
Ignored on add and update.
last updated time
advertiser_domain_industry_vertical
advertiser_domain_industry_vertical data type
AdvertiserDomainService
getIndustryVerticals()
Fields Summary
$id id
$name name
Fields
int $id
Ignored on add and update.
id
size : 8
primary
string $name
name
size : 100
advertiser_domain_parent
advertiser_domain_parent data type
AdvertiserDomainService
getParentBrands()
Fields Summary
$id id
$name name
Fields
194
Services
int $id
Ignored on add and update.
id
size : 8
primary
string $name
name
size : 100
advertiser_domain_search_options
Used by the following call(s) and/or data type(s):
AdvertiserDomainService
search()
Fields Summary
$name_pattern name pattern
$domain_url_pattern domain url pattern
$parent_brand_pattern parent pattern
$industry_vertical_pattern industry_vericals
$status status.
Fields
string $name_pattern
name pattern
nillable
string $domain_url_pattern
domain url pattern
nillable
string $parent_brand_pattern
parent pattern
nillable
string $industry_vertical_pattern
industry_vericals
nillable
enum_advertiser_domain_search_status $status
status.
status can be one of ('active','inactive' or 'all'). See valid types in Advertiser Domain Search Status Enum
advertiser_list
advertiser data type
195
Services
buying_terms_managed_demand
$managed_advertisers
demand
$advertisers
managed_demand
$managed_advertisers
preferred_terms_demand
$advertisers
Fields Summary
$advertisers Advertisers.
$advertiser_custom_groups Custom groups of advertisers.
$include Flag include is set "true" to include or "false" to exclude particular publishers in the $publishers
and $advertiser_custom_groups arrays.
Fields
array_of_id_name $advertisers
Advertisers.
array_of_id_name $advertiser_custom_groups
Custom groups of advertisers.
boolean $include
Flag include is set "true" to include or "false" to exclude particular publishers in the $publishers and
$advertiser_custom_groups arrays.
advertiser_section_list
Used by the following call(s) and/or data type(s):
SitelistService
createASL()
createASLs()
getASL()
getAllASL()
updateASL()
updateASLs()
Fields Summary
$id ID. Autoset on Sitelist creation.
$name Description of Sitelist.
$owner_id Sitelist owner id
$gt_ids array of global templates associated with the ASL
$sections array of sections
$locked locked status of the ASL
$active Sitelist active flag.
$created_on Sitelist creation time.
$type Sitelist owner type
$notes additional information
$lastupd Sitelist last updated time.
$category Sitelist category
$remove_sections array of sections to remove
Fields
int $id
Ignored on add and update.
ID. Autoset on Sitelist creation.
size : 10
primary
196
Services
string $name
Description of Sitelist.
size : 255
int $owner_id
Sitelist owner id
size : 10
array_of_int $gt_ids
array of global templates associated with the ASL
array_of_int $sections
array of sections
boolean $locked
locked status of the ASL
boolean $active
Default value: '1'
Sitelist active flag.
dateTime $created_on
Ignored on add and update.
Sitelist creation time.
enum_sitelist_type $type
Ignored on update.
Sitelist owner type
string $notes
additional information
size : 1000
dateTime $lastupd
Ignored on add and update.
Sitelist last updated time.
enum_sitelist_category $category
Ignored on update.
Default value: 'display'
Sitelist category
array_of_int $remove_sections
array of sections to remove
adware_section_params
adware_section_params data type.
Fields Summary
$section_id
$section_code
$site_id
$site_code
197
Services
$entity_id
$entity_code
$network_entity_id
Fields
int $section_id
string $section_code
int $site_id
string $site_code
int $entity_id
string $entity_code
int $network_entity_id
age
vurl_data type
Fields Summary
$age
Fields
int $age
beacon_search_options
Used by the following call(s) and/or data type(s):
DictionaryService
getCreativeBeaconList()
Fields Summary
$beacon_ids Beacon ID array
$vendor_name_pattern Vendor name pattern
$is_unresolved_domain To filter unresolved vendor domains
$starts_with_non_alphabetic To filter vendor names starting with numeric/other
Fields
array_of_int $beacon_ids
Beacon ID array
nillable
198
Services
string $vendor_name_pattern
Vendor name pattern
Vendor name pattern - search pattern. Leading and/or trailing wild cards (*) can be added to get results for vendor
names matching the string provided. Possible patterns are:
'Adtegrity': matches exact vendor 'Adtegrity'
'Ad*': matches vendors starting with 'Ad'. Example - Adtegrity, !AdReactor, !AdReady, !AdBrite etc.
nillable
boolean $is_unresolved_domain
To filter unresolved vendor domains
nillable
boolean $starts_with_non_alphabetic
To filter vendor names starting with numeric/other
nillable
blocklist_getall
blocklist data type
DemandBlocklistService
quickSearch()
SupplyBlocklistService
quickSearch()
Fields Summary
$id Blocklist id.
$name Blocklist name.
$description Blocklist description.
$entity_id Owner entity ID
$entity_name Name of owner entity.
$creative_control creative_control 'block','block_till_review' or 'allow_till_review'. Available only for demand
blocklist service.
$created_by_contact_id Contact id who created blocklist.
$created_by_contact_name Name of contact who created blocklist.
$modified_by_contact_id Contact id who modified blocklist.
$modified_by_contact_name Name of contact who modified blocklist.
$active Blocklist activity flag.
$created_on Blocklist created on date/time.
$lastupd Blocklist last updated date/time.
Fields
int $id
Blocklist id.
string $name
Blocklist name.
199
Services
string $description
Blocklist description.
int $entity_id
Owner entity ID
string $entity_name
Name of owner entity.
enum_creative_control $creative_control
creative_control 'block','block_till_review' or 'allow_till_review'. Available only for demand blocklist service.
int $created_by_contact_id
Contact id who created blocklist.
string $created_by_contact_name
Name of contact who created blocklist.
int $modified_by_contact_id
Contact id who modified blocklist.
string $modified_by_contact_name
Name of contact who modified blocklist.
boolean $active
Default value: '0'
Blocklist activity flag.
dateTime $created_on
Ignored on add and update.
Blocklist created on date/time.
dateTime $lastupd
Ignored on add and update.
Blocklist last updated date/time.
blocklist_search_options
blocklist data type
DemandBlocklistService
getAllBlocklists()
SupplyBlocklistService
getAllBlocklists()
Fields Summary
$ids Array of demand/supply blocklist ids.
$names Array of demand/supply blocklist names.
$descriptions Array of demand/supply blocklist descriptions.
$creative_control Parameter to search by creative_control 'block_till_review' or 'allow_till_review'.
Available only for demand blocklist service.
$contact_ids Array of contact ids.
$advertiser_ids Array of advertiser ids.
$publisher_ids Array of publisher ids.
$is_active Parameter to search by status.By default will return both 'active' and 'inactive'.
200
Services
Fields
array_of_int $ids
Array of demand/supply blocklist ids.
array_of_string $names
Array of demand/supply blocklist names.
array_of_string $descriptions
Array of demand/supply blocklist descriptions.
enum_creative_control $creative_control
Parameter to search by creative_control 'block_till_review' or 'allow_till_review'. Available only for demand blocklist
service.
array_of_int $contact_ids
Array of contact ids.
array_of_int $advertiser_ids
Array of advertiser ids.
array_of_int $publisher_ids
Array of publisher ids.
int $is_active
Parameter to search by status.By default will return both 'active' and 'inactive'.
bought_segment
Used by the following call(s) and/or data type(s):
PixelService
getAllBoughtSegments()
Fields Summary
$public_segment_id Public segment id.
$name Name of the segment.
$owner_id Id of the entity sharing the segment.
$owner_name Name of the entity sharing the segment.
$network_ids List of network ids that segment share seller has chosen to limit targeting to. If empty, buyer
is allowed to target the segment share to any network.
Fields
int $public_segment_id
Public segment id.
string $name
Name of the segment.
int $owner_id
Id of the entity sharing the segment.
string $owner_name
Name of the entity sharing the segment.
201
Services
array_of_int $network_ids
List of network ids that segment share seller has chosen to limit targeting to. If empty, buyer is allowed to target the
segment share to any network.
browser
See Browser Enum for more information.
DictionaryService
getBrowsers()
Fields Summary
$id browser ID
$name browser name
Fields
int $id
browser ID
size : 3
primary
string $name
browser name
size : 50
buying_terms
buying_terms data type
BuyingTermsService
add()
getAllBuyingTerms()
getAllSince()
getByObjectId()
update()
Fields Summary
$id Buying terms ID.
$name Buying terms name.
$description Buying terms description.
$entity_id Owner entity ID.
$entity_name Name of owner entity.
$buying_terms_managed_demand Complex data type to represent managed advertiser attributes.
$buying_terms_supply Complex data type to represent supply attributes.
$revenue_share Revenue that the buyer seat is willing to pass to the seller.
$bid_multiplier Bid multiplier. It can have values between 0 and 2. Value 1 is invalid for this field. Fields
revenue_share and bid_multiplier are mutually exclusive.
$created_by_contact_id Contact id who created buying terms.
$created_by_contact_name Name of contact who created rule.
$modified_by_contact_id Contact id who modified buying terms.
$modified_by_contact_name Name of contact who modified rule.
$active Buying terms activity flag.
$created_on Buying terms created on date/time.
$lastupd Buying terms last updated date/time.
202
Services
Fields
int $id
Ignored on update.
Buying terms ID.
primary
string $name
Buying terms name.
string $description
Buying terms description.
int $entity_id
Ignored on add and update.
Owner entity ID.
string $entity_name
Name of owner entity.
buying_terms_managed_demand $buying_terms_managed_demand
Complex data type to represent managed advertiser attributes.
buying_terms_supply $buying_terms_supply
Complex data type to represent supply attributes.
float $revenue_share
Revenue that the buyer seat is willing to pass to the seller.
float $bid_multiplier
Bid multiplier. It can have values between 0 and 2. Value 1 is invalid for this field. Fields revenue_share and
bid_multiplier are mutually exclusive.
int $created_by_contact_id
Contact id who created buying terms.
string $created_by_contact_name
Name of contact who created rule.
int $modified_by_contact_id
Contact id who modified buying terms.
string $modified_by_contact_name
Name of contact who modified rule.
boolean $active
Default value: '0'
Buying terms activity flag.
dateTime $created_on
Ignored on add and update.
Buying terms created on date/time.
dateTime $lastupd
Ignored on add and update.
Buying terms last updated date/time.
203
Services
buying_terms_managed_demand
buying data type
buying_terms
$buying_terms_managed_demand
Fields Summary
$buying_technology Array of buying technology RTBD, Hosted.
$managed_advertisers Managed advertisers.
$line_items Line items.
$deal_properties Deal properties.
$creative_size_ids Creative size ids.
Fields
array_of_enum_buying_technology $buying_technology
Array of buying technology RTBD, Hosted.
advertiser_list $managed_advertisers
Managed advertisers.
rule_attribute $line_items
Line items.
rule_deal_properties $deal_properties
Deal properties.
rule_attribute $creative_size_ids
Creative size ids.
buying_terms_supply
buying data type
buying_terms
$buying_terms_supply
Fields Summary
$marketplace Revenue share rule is applicable only on Trading pit marketplace. Bid multiplier rule can be
added on any combination of Trading Pit, Network of network, Intra Network(Managed).
$selling_technology Array of selling technology. Allowed values are 'RTBS','Hosted'. See Selling
Technology Enum for valid values.
$publishers Publishers.
$woeids Woeids.
$cga_ids Custom geo area ids.
$channels Channels.
$private_marketplace Private Marketplace.
$sections Managed publisher sections can be added on bid multiplier rule.
Fields
array_of_enum_buying_selling_marketplace $marketplace
204
Services
Revenue share rule is applicable only on Trading pit marketplace. Bid multiplier rule can be added on any combination
of Trading Pit, Network of network, Intra Network(Managed).
array_of_enum_selling_technology $selling_technology
Array of selling technology. Allowed values are 'RTBS','Hosted'. See Selling Technology Enum for valid values.
publisher_list $publishers
Publishers.
rule_attribute $woeids
Woeids.
rule_attribute $cga_ids
Custom geo area ids.
rule_attribute $channels
Channels.
rule_attribute $private_marketplace
Private Marketplace.
rule_attribute $sections
Managed publisher sections can be added on bid multiplier rule.
campaign_goal
Used by the following call(s) and/or data type(s):
campaign
$campaign_goals
Fields Summary
$conversion_id
$goal_amount Goal amount. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency
specified by the owning entity's currency_id.
Fields
int $conversion_id
size : 8
primary
float $goal_amount
Goal amount. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency specified by the owning entity's
currency_id.
size : 15,4
nillable
campaign
Used by the following call(s) and/or data type(s):
CampaignService
add()
205
Services
get()
getAll()
getAllSince()
getByCreative()
getByEntity()
getByLineItem()
update()
line_item
$campaign
Fields Summary
$id Campaign ID. Autoset on campaign creation by CampaignService::add().
$advertiser_entity_id ID of advertiser, campaign belongs to.
$target_profile_id ID of target profile, attached to campaign. Can be set by
CampaignService::addTargetProfile().
$description Client's description of campaign.
$active Campaign activity flag.
$delivery_rules_id Delivery rules ID. Autoset by the server when creating a new campaign.
$exchange_rate
$cpc_target Goal towards an effective CPC or click-through rate.
$campaign_goals Note: If $cpc_target and $campaign_goals are null, $learn_budget is set to NULL.
$learn_imps_per_creative_per_section
$learn_actions_per_creative_per_section
$learn_spend_per_creative_per_section
$code Code of campaign specified by client
$click_url_override Default click URL: this URL will only be used if creative is set to use default click URL
(i.e., by setting use_campaign_click_url)
$priority Campaign priority.
$start_time Start date and time (UTC) for campaign. If not set, current time is assumed.
$end_time End date and time (UTC) for line item, campaign or creative. If not set, object isn't trafficking.
$budget Budget by currency. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency
specified by the owning entity's currency_id. If not set, unlimited budget is assumed.
$delivery_type Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are
listed in Delivery Type Enum.
$delivery_cap Max value for currency-capped delivery methods. For fixed-rate, this is in USD; for
dynamic-rate, this is in the currency specified by the owning entity's currency_id.
$imp_budget Budget by impressions
$imp_delivery_type Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are
listed in Delivery Type Enum.
$imp_delivery_cap Max value for impression capped delivery methods
$learn_budget
$learn_delivery_type The complete list of enum values you can see at learn_delivery_type enum page, at
run time you can get all of them using DictionaryService.getEnumValues(token, 'learn_delivery_type').
$learn_delivery_cap
$smooth When set to true, delivers budget/imps evenly over remainder of campaign or within caps
(hourly/daily/weekly).
$tz_to_show Specifies the time zone to use for start and end flight dates. See Flight dates for more
details.
$first_ran_date
$last_ran_date
$lastupd
Fields
int $id
Ignored on add and update.
Campaign ID. Autoset on campaign creation by CampaignService::add().
size : 10
primary
int $advertiser_entity_id
Ignored on update.
ID of advertiser, campaign belongs to.
size : 10
206
Services
int $target_profile_id
Ignored on add and update.
ID of target profile, attached to campaign. Can be set by CampaignService::addTargetProfile().
size : 8
nillable
string $description
Default value: 'default description'
Client's description of campaign.
size : 255
boolean $active
Default value: '0'
Campaign activity flag.
int $delivery_rules_id
Ignored on add and update.
Delivery rules ID. Autoset by the server when creating a new campaign.
size : 10
nillable
float $exchange_rate
Ignored on add and update.
size : 10,4
float $cpc_target
Goal towards an effective CPC or click-through rate.
Note: If $cpc_target and $campaign_goals are null, $learn_budget is set to NULL. See Pricing options for advertiser
line items and campaigns for details.
size : 15,4
nillable
array_of_campaign_goal $campaign_goals
Note: If $cpc_target and $campaign_goals are null, $learn_budget is set to NULL.
See Pricing options for advertiser line items and campaigns for details.
nillable
int $learn_imps_per_creative_per_section
Default value: '2000'
size : 10
float $learn_actions_per_creative_per_section
Default value: '5'
float $learn_spend_per_creative_per_section
Default value: '5'
string $code
Code of campaign specified by client
size : 255
nillable
207
Services
string $click_url_override
Default click URL: this URL will only be used if creative is set to use default click URL (i.e., by setting
use_campaign_click_url)
size : 500
nillable
enum_priority $priority
Default value: 'Normal'
Campaign priority.
dateTime $start_time
Start date and time (UTC) for campaign. If not set, current time is assumed.
nillable
object : delivery_rules
dateTime $end_time
End date and time (UTC) for line item, campaign or creative. If not set, object isn't trafficking.
nillable
object : delivery_rules
float $budget
Budget by currency. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency specified by the owning
entity's currency_id. If not set, unlimited budget is assumed.
nillable
object : delivery_rules
string $delivery_type
Default value: 'ASAP'
Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are listed in Delivery Type Enum.
The complete list of enum values you can see at delivery_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'delivery_type').
enum : delivery_type
object : delivery_rules
float $delivery_cap
Max value for currency-capped delivery methods. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency
specified by the owning entity's currency_id.
nillable
object : delivery_rules
int $imp_budget
Budget by impressions
nillable
object : delivery_rules
string $imp_delivery_type
Default value: 'ASAP'
Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are listed in Delivery Type Enum.
The complete list of enum values you can see at imp_delivery_type enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'imp_delivery_type').
enum : imp_delivery_type
object : delivery_rules
float $imp_delivery_cap
208
Services
nillable
object : delivery_rules
int $learn_budget
nillable
object : delivery_rules
string $learn_delivery_type
Default value: 'ASAP'
The complete list of enum values you can see at learn_delivery_type enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'learn_delivery_type').
enum : learn_delivery_type
object : delivery_rules
float $learn_delivery_cap
nillable
object : delivery_rules
boolean $smooth
Default value: '1'
When set to true, delivers budget/imps evenly over remainder of campaign or within caps (hourly/daily/weekly).
object : delivery_rules
string $tz_to_show
Default value: 'America/New_York'
Specifies the time zone to use for start and end flight dates. See Flight dates for more details.
object : delivery_rules
dateTime $first_ran_date
Ignored on add and update.
dateTime $last_ran_date
Ignored on add and update.
dateTime $lastupd
Ignored on add and update.
can_status
Used by the following call(s) and/or data type(s):
EntityService
getCANStatus()
setCANStatus()
Fields Summary
$entity_id Network or Publisher id
$can_status_flag CAN status flag to set your CAN status here. Default is Opting out of CAN.
$can_privacy_page_link Link to the Network's Privacy Policy page. To be set only if can_status_flag is
opt_in__ngd_overlay_notice or opt_in__ngd_non_overlay_notice
$can_text_id Language ID for the CAN marker The complete list of enum values you can see at
can_text_id enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'can_text_id').
209
Services
Fields
int $entity_id
Network or Publisher id
size : 10
primary
string $can_status_flag
CAN status flag to set your CAN status here. Default is Opting out of CAN.
The complete list of enum values you can see at can_status_flag enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'can_status_flag').
enum : can_status_flag
string $can_privacy_page_link
Link to the Network's Privacy Policy page. To be set only if can_status_flag is opt_in__ngd_overlay_notice or
opt_in__ngd_non_overlay_notice
size : 80
nillable
int $can_text_id
Language ID for the CAN marker The complete list of enum values you can see at can_text_id enum page, at run time
you can get all of them using DictionaryService.getEnumValues(token, 'can_text_id').
size : 5
enum : can_text_id
ccp_creative_search_options
Fields Summary
$size_ids show only creatives which sizes listed in the array
$advertiser_ids show only creatives which belongs to the advertisers listed in the array
$region_ids show only creatives with the following region IDs
$creatives_visibility show either 'all', 'approved' or 'banned' creatives.
$recent_days_number show only creatives which were added in the last few days
$filtered_creative_ids the list of creative IDs that are going to be removed from a search result
$url_pattern Show only creatives whose $media_url elements match $url_pattern.
$offer_type_ids show only creatives which offer_type_ids are listed in the array
$creative_ids the list of creative IDs that are going to be added to a search result
$include_creative_options all the creatives which do not match this creative specs will not be included in a
search result
$exclude_creative_options all the creatives which match this creative specs will not be included in a
search result
$target_profile_id current target profile id
$entity_id entity id (default is currently logged in entity) for which the list of creatives will be returned
$line_item_id line item id; instead of specifying an entity id you can fill this field and get the list of creatives
that are served at that corresponding level
$is_reviewed Show reviewed creatives
$is_unreviewed Show un-reviewed creatives
$needs_further_review Show creatives that require further review
$reviewer_contact_ids If searching creative is_reviewed and/or need_further_review then also filter by
reviewer contact
$review_start Review start time
$review_end Review end time
$media_types Media type of content
$third_party_types Third paty type
$include_tags all the creatives which do not match these creative tags will not be included in a search
result
$exclude_tags all the creatives which match these creative tags will not be included in a search result
$include_beacons all the creatives which do not match these creative beacons will not be included in a
search result
210
Services
$exclude_beacons all the creatives which match these creative beacons will not be included in a search
result
$source_type show either 'all', 'rtb' or 'non_rtb' creatives.
$creative_codes all the creatives which do not belong to any of these code strings will not be included in a
search result
$create_date_start Start date of creation date range
$create_date_end End date of creation date range
$sort_order Sort order by date specifying "ascending" or "descending".
Fields
array_of_int $size_ids
show only creatives which sizes listed in the array
nillable
array_of_int $advertiser_ids
show only creatives which belongs to the advertisers listed in the array
nillable
array_of_int $region_ids
show only creatives with the following region IDs
nillable
enum_visibility_scope $creatives_visibility
Default value: 'all'
show either 'all', 'approved' or 'banned' creatives.
int $recent_days_number
show only creatives which were added in the last few days
nillable
array_of_int $filtered_creative_ids
the list of creative IDs that are going to be removed from a search result
nillable
string $url_pattern
Show only creatives whose $media_url elements match $url_pattern.
$url_pattern should be a valid URL of the form http://content.yieldmanager.com/$path, where $path is what is actually
matched against the creative_content, specifically the $media_url. Note that $path is matched as a substring of
$media_url (i.e., the matching pattern is created by adding wildcards to the head and tail of $path). For example, the
$url_pattern 'http://content.yieldmanager.com/atoms/12' would find all creatives whose $media_url matches
'%atoms/12%'.
nillable
array_of_int $offer_type_ids
show only creatives which offer_type_ids are listed in the array
nillable
array_of_int $creative_ids
the list of creative IDs that are going to be added to a search result
nillable
creative_options $include_creative_options
all the creatives which do not match this creative specs will not be included in a search result
211
Services
nillable
creative_options $exclude_creative_options
all the creatives which match this creative specs will not be included in a search result
nillable
int $target_profile_id
current target profile id
nillable
int $entity_id
entity id (default is currently logged in entity) for which the list of creatives will be returned
nillable
int $line_item_id
line item id; instead of specifying an entity id you can fill this field and get the list of creatives that are served at that
corresponding level
nillable
boolean $is_reviewed
Default value: '1'
Show reviewed creatives
boolean $is_unreviewed
Default value: '1'
Show un-reviewed creatives
boolean $needs_further_review
Default value: '1'
Show creatives that require further review
array_of_int $reviewer_contact_ids
If searching creative is_reviewed and/or need_further_review then also filter by reviewer contact
nillable
string $review_start
Review start time
If searching creative is_reviewed and/or need_further_review then also filter by review datetime
nillable
string $review_end
Review end time
If searching creative is_reviewed and/or need_further_review then also filter by review datetime
nillable
array_of_enum_creative_search_media_type $media_types
Media type of content
nillable
array_of_enum_creative_search_third_party_type $third_party_types
Third paty type
212
Services
nillable
array_of_int $include_tags
all the creatives which do not match these creative tags will not be included in a search result
nillable
array_of_int $exclude_tags
all the creatives which match these creative tags will not be included in a search result
nillable
array_of_int $include_beacons
all the creatives which do not match these creative beacons will not be included in a search result
nillable
array_of_int $exclude_beacons
all the creatives which match these creative beacons will not be included in a search result
nillable
enum_creative_search_source_type $source_type
Default value: 'all'
show either 'all', 'rtb' or 'non_rtb' creatives.
array_of_string $creative_codes
all the creatives which do not belong to any of these code strings will not be included in a search result
nillable
string $create_date_start
Start date of creation date range
nillable
string $create_date_end
End date of creation date range
nillable
string $sort_order
Sort order by date specifying "ascending" or "descending".
nillable
channel
See Channel Enum for more information.
DictionaryService
getChannels()
Fields Summary
$id channel ID
$name channel name
$long_description channel description
213
Services
$media_guard_only
Fields
int $id
channel ID
size : 10
primary
string $name
channel name
size : 255
string $long_description
channel description
size : 255
boolean $media_guard_only
richmedia_creative_attributes
click_url_data
Fields Summary
$id
$tests_number
$url
Fields
int $id
int $tests_number
string $url
click_url
Fields Summary
$id click_url ID. Autoset on click_url creation.
$is_creative_click_url is creative click url
$is_tracker_url is piggyback url
$is_campaign_override_url is campaign click url
$is_banned is banned
$is_discovered is discovered
$domain domain for the url
$url_md5 md5 of url
214
Services
Fields
int $id
Ignored on add and update.
click_url ID. Autoset on click_url creation.
size : 10
primary
boolean $is_creative_click_url
Default value: '0'
is creative click url
boolean $is_tracker_url
Default value: '0'
is piggyback url
boolean $is_campaign_override_url
Default value: '0'
is campaign click url
boolean $is_banned
Default value: '0'
is banned
boolean $is_discovered
Default value: '0'
is discovered
string $domain
Ignored on update.
domain for the url
size : 255
nillable
string $url_md5
Ignored on update.
md5 of url
nillable
int $risk_score
Default value: 0
risk score
size : 10
string $review_state
Review state The complete list of enum values you can see at review_state enum page, at run time you can get all of
them using DictionaryService.getEnumValues(token, 'review_state').
enum : review_state
215
Services
dateTime $created_on
Ignored on add and update.
url creation time. Autoset
dateTime $last_review_completed_on
Ignored on add and update.
last review completion time. Autoset
string $url
click url
dateTime $lastupd
Ignored on add and update.
nillable
comment
Used by the following call(s) and/or data type(s):
creative_comments
$comments
Fields Summary
$comment Comment.
$created_on Creative comment date specified in yyyy-mm-dd hh:mm:ss format.
Fields
string $comment
Comment.
string $created_on
Creative comment date specified in yyyy-mm-dd hh:mm:ss format.
contact
Used by the following call(s) and/or data type(s):
ContactService
add()
get()
getAll()
getAllSince()
getByEntity()
getSelf()
update()
EntityService
add()
getOfficialContacts()
entity_data
$contact
entity_official_contacts
$account_managers
$business_contacts
$finance_contacts
$operations_contacts
$sales_persons
$technical_contacts
$trafficker_persons
216
Services
publisher_data
$contact
Fields Summary
$id Contact ID.
$prefix Should be one of these values: Mr or Ms.
$first_name The first name for the account
$last_name The last name for the account
$title The title for the account
$department The name of the department, the account belongs to
$company The name of the company, the account belongs to
$phone_main The contact phone number
$phone_mobile The contact mobile phone number
$fax The contact fax number
$address_id Address ID
$active Contact activity flag
$email_notifications The email notification flag
$email The email of the company, the account belongs to
$entity_id The ID of the entity, the account belongs to
$role_id The role ID.
$username The username for the account
$api_user Defines whether a user has access to API.
$is_support_contact
$lastupd
$can_manage_contacts User able to edit contact info
$relationship_type_id For internal use only.
$ycrm_contact_id For internal use only.
$locale_id The locale ID.
Fields
int $id
Ignored on add and update.
Contact ID.
size : 10
primary
string $prefix
Ignored on add and update.
Should be one of these values: Mr or Ms.
size : 50
string $first_name
The first name for the account
size : 50
nillable
string $last_name
The last name for the account
size : 50
nillable
string $title
The title for the account
size : 50
string $department
The name of the department, the account belongs to
size : 50
217
Services
string $company
The name of the company, the account belongs to
size : 100
string $phone_main
The contact phone number
size : 20
string $phone_mobile
The contact mobile phone number
size : 20
string $fax
The contact fax number
size : 20
int $address_id
Ignored on add and update.
Address ID
size : 10
int $active
Contact activity flag
size : 1
int $email_notifications
Ignored on add and update.
The email notification flag
size : 4
string $email
The email of the company, the account belongs to
size : 255
int $entity_id
Ignored on update.
The ID of the entity, the account belongs to
size : 10
int $role_id
The role ID.
The complete list of enum values you can see at role enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'role').
size : 10
enum : role
string $username
The username for the account
size : 50
218
Services
boolean $api_user
Default value: '1'
Defines whether a user has access to API.
boolean $is_support_contact
Default value: '0'
dateTime $lastupd
Ignored on add and update.
boolean $can_manage_contacts
User able to edit contact info
string $relationship_type_id
Default value: 1
For internal use only.
size : 3
nillable
string $ycrm_contact_id
Default value: NULL
For internal use only.
size : 15
nillable
int $locale_id
The locale ID.
size : 5
nillable
content_buyer_contact
Used by the following call(s) and/or data type(s):
PixelService
getAvailableContentCategoriesBuyers()
Fields Summary
$entity_id Entity id of content category buyer.
$company_name Company name of content category buyer.
$company_website Company website of content category buyer.
$contact_email Contact email of content category buyer.
Fields
int $entity_id
Entity id of content category buyer.
string $company_name
Company name of content category buyer.
string $company_website
Company website of content category buyer.
219
Services
string $contact_email
Contact email of content category buyer.
content_seller_contact
Used by the following call(s) and/or data type(s):
PixelService
getContentCategoryOwner()
Fields Summary
$entity_id Content seller's entity id
$company_name Content seller's company name
$contact_email Content seller's contact email
$content_category_name Name of the segment
Fields
int $entity_id
Content seller's entity id
string $company_name
Content seller's company name
string $contact_email
Content seller's contact email
string $content_category_name
Name of the segment
content_vendor_salt
content_vendor_salt type
EntityService
getContentVendorUrlHashSalt()
Fields Summary
$salt_name the salt name
$encrypted_salt the encrytped salt value
$start_time the time that the salt start to use
$expiration_time the time that the salt will be expired
Fields
string $salt_name
Ignored on add and update.
the salt name
string $encrypted_salt
Ignored on add and update.
the encrytped salt value
string $start_time
Ignored on add and update.
220
Services
string $expiration_time
Ignored on add and update.
the time that the salt will be expired
contract_history_item
Fields Summary
$insertion_order Contract history insertion order
$line_items Contract history line items corresponding to the insertion order
Fields
insertion_order $insertion_order
Ignored on add and update.
Contract history insertion order
The point of the contract history is to be able to see if a network rejects a publisher in the past.
array_of_line_item $line_items
Ignored on add and update.
Contract history line items corresponding to the insertion order
contracting_entity
contracting_entity data type.
Fields Summary
$id Contracting entity ID.
$name Contracting entity name.
Fields
int $id
Ignored on add and update.
Contracting entity ID.
size : 10
primary
string $name
Contracting entity name.
size : 255
country_group
See Country Group Enum for more information.
DictionaryService
getCountryGroups()
221
Services
Fields Summary
$id country group ID
$name country group name
$daily_volume country daily volume
$daily_revenue country daily revenue, in USD
Fields
int $id
country group ID
size : 10
primary
string $name
country group name
size : 50
int $daily_volume
country daily volume
size : 20
float $daily_revenue
country daily revenue, in USD
country
See Country Enum for more information.
DictionaryService
getCountries()
Fields Summary
$id country ID
$name country name
$code country code
$continent_id country continent ID
$country_group_id country group ID
Fields
int $id
country ID
size : 5
primary
string $name
country name
size : 50
string $code
country code
size : 2
222
Services
int $continent_id
country continent ID
size : 10
int $country_group_id
country group ID
size : 10
creative_attachment
Used by the following call(s) and/or data type(s):
CreativeService
addAttachCreatives()
Fields Summary
$creative Contains the creative object.
$line_item_id Line item ID.
Fields
creative $creative
Contains the creative object.
int $line_item_id
Line item ID.
creative_beacon_list_item
Used by the following call(s) and/or data type(s):
DictionaryService
getCreativeBeaconList()
Fields Summary
$id Creative beacon ID
$vendor Creative beacon vendor
$description Description
$unresolved_beacon_domain Unresolved beacon domain - Flag that indicates if the beacon's domain
resolved to a vendor
Fields
int $id
Ignored on add and update.
Creative beacon ID
size : 5
primary
string $vendor
Creative beacon vendor
string $description
Description
223
Services
boolean $unresolved_beacon_domain
Default value: '0'
Unresolved beacon domain - Flag that indicates if the beacon's domain resolved to a vendor
creative_classification_status
Used by the following call(s) and/or data type(s):
CreativeService
getClassificationReport()
Fields Summary
$creative_id creative id.
$classification_review_status Creative classification review status.
Fields
int $creative_id
creative id.
string $classification_review_status
Creative classification review status.
creative_comment_search_options
Used by the following call(s) and/or data type(s):
CreativeService
getCreativeComments()
Fields Summary
$entity_id Entity ID of the Reviewer.
$start_date Creative review Start date specified in yyyy-mm-dd hh:mm:ss format.
$end_date Creative review End date Specified in yyyy-mm-dd hh:mm:ss format
Fields
int $entity_id
Entity ID of the Reviewer.
dateTime $start_date
Creative review Start date specified in yyyy-mm-dd hh:mm:ss format.
dateTime $end_date
Creative review End date Specified in yyyy-mm-dd hh:mm:ss format
creative_comments
Used by the following call(s) and/or data type(s):
creative_publisher_comments
$all_comments
Fields Summary
224
Services
$entity_id The Entity ID of the network who has provided the comment.
$comments The array of comments object containing each comment along with the timestamp sorted from
latest to oldest.
$total_count The total number of comments from the publisher against the given creative ID.
Fields
int $entity_id
The Entity ID of the network who has provided the comment.
array_of_comment $comments
Default value: NULL
The array of comments object containing each comment along with the timestamp sorted from latest to oldest.
int $total_count
Default value: 0
The total number of comments from the publisher against the given creative ID.
creative_content_expanded
Macro-substituted contents of a creative.
Fields Summary
$media_type_id content media type.
$expanded_content creative expanded content
Fields
int $media_type_id
content media type.
size : 10
primary
string $expanded_content
creative expanded content
creative_content
Content may be either written in content field or client may be redirected to media_url to get content.
creative
$contents
placement_creative
$contents
Fields Summary
$media_type content media type. See Media Type Enum for more information.
$media_url redirect URL to get the content
$content creative content
$hash the hash of the content
$file_size the size of the content
$atom_id the id of the atom
$view_tracker
Fields
225
Services
string $media_type
content media type. See Media Type Enum for more information.
The complete list of enum values you can see at media_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'media_type').
enum : media_type
primary
string $media_url
redirect URL to get the content
size : 10000
string $content
creative content
string $hash
the hash of the content
int $file_size
the size of the content
size : 10
nillable
int $atom_id
Ignored on add and update.
the id of the atom
size : 10
string $view_tracker
Ignored on add and update.
nillable
creative_custom_object
Fields Summary
$id Creative ID.
$description Creative Description.
$advertisers Advertiser Id and Name
$beacons Beacon id and Name
$reviewer Name of reviewer
$created_date Creative creation time.
Fields
int $id
Ignored on add and update.
Creative ID.
primary
string $description
Creative Description.
id_name $advertisers
226
Services
array_of_id_name $beacons
Beacon id and Name
string $reviewer
Name of reviewer
dateTime $created_date
Ignored on add and update.
Creative creation time.
creative_further_comment
Fields Summary
$creative_id Creative_ID
$contact_id Entity ID
$comment Comments message
$created_on Created on Date
$contact_name Contact name of the Reviewer
$comment_type Comment type Advertiser/Internal
Fields
int $creative_id
Ignored on add and update.
Creative_ID
int $contact_id
Ignored on add and update.
Entity ID
string $comment
Ignored on add and update.
Comments message
string $created_on
Ignored on add and update.
Created on Date
string $contact_name
Ignored on add and update.
Contact name of the Reviewer
string $comment_type
Ignored on add and update.
Comment type Advertiser/Internal
creative
Used by the following call(s) and/or data type(s):
CreativeService
add()
addAttach()
addCreatives()
227
Services
get()
getAll()
getAllSince()
getByCampaign()
getByEntity()
getByLineItem()
search()
update()
PixelService
getAttachedCreatives()
ccp_creative_search_options
$exclude_creative_options
$include_creative_options
creative_attachment
$creative
creative_publisher_comments
$all_comments
creative_search_options
$exclude_creative_options
$include_creative_options
creative_with_review_status
$creative
demand
$creative_tags
placement
$creative
placement_creative
$contents
preferred_terms_demand
$creative_tags
targetings
$CreativeSpecs
Fields Summary
$richmedia_creative_attribute Rich media creative attributes. Special attributes for rich media creatives
like expandable, floating, polite download and others.
$exclude_from_can Clear Add Notice (CAN) Buyer (Advertiser) control at creative level. Only valid if the
creative type is 'file' This will exclude the creative from CAN, overriding the entity level setting. This is only
relevant if the entity has opted in for the CAN.
$self_classification_tags Creative Specs and Themes provided by advertiser.
$id Creative ID. Autoset on creative creation by CreativeService::add() or CreativeService::addCreatives().
$code
$advertiser_entity_id ID of advertiser the creative belongs to.
$active Creative activity flag.
$is_audited Shows if object has been audited by Media Guard.
$description Client's description of creative.
$adapt_media_hex
$adapt_click_hex
$pop_types Type of pop, see Pop Types Enum for valid values.
$size_id ID of creative (width, length) pair, see Size Enum for valid values.
$is_pending
$created_on Creative creation time. Autoset by CampaignService::addCreative().
$height Creative height, required for pop (size_id = 0); must be > 0 and <= 10000.
$width Creative width, required for pop (size_id = 0); must be > 0 and <= 10000.
$beacon_conversion_id ID of beacon switched by this creative. See Yahoo Ad Exchange Knowledge
Base for details.
$original_tag
$can_track_clicks This is a Boolean that must be true in order for click tracking to function.
$menubar If TRUE, pop window for creative has title
$resizable If TRUE, pop window for creative is resizable
$scrollbars If TRUE, pop window for creative has scrollbars
$status
$toolbar If TRUE, pop window for creative has toolbar
$flash_loop If TRUE, flash creative loops
$flash_bgcolor Background color for flash
$flash_clicktag
$is_third_party If TRUE, the creative is treated as third party one
$third_party_type Third party tag type. value is set depending on creative_content.content value, checked
at insert & update
$is_ssl Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
$is_distracting Creative theme. See Creative themes for details.
$is_suggestive Creative theme. See Creative themes for details.
228
Services
Fields
richmedia_creative_attributes $richmedia_creative_attribute
Rich media creative attributes. Special attributes for rich media creatives like expandable, floating, polite download
and others.
This field is deprecated. Use Creative Tag IDs in creative::$self_classification_tags to associate rich media attributes.
deprecated
boolean $exclude_from_can
Default value: '0'
Clear Add Notice (CAN) Buyer (Advertiser) control at creative level. Only valid if the creative type is 'file' This will
exclude the creative from CAN, overriding the entity level setting. This is only relevant if the entity has opted in for the
CAN.
229
Services
array_of_int $self_classification_tags
Creative Specs and Themes provided by advertiser.
Creative specs describe the physical and behavioral aspects of the creative, such as audio, active x, or
popups.
Creative theme is related to the content of a creative, such as political, religious, or violent.
Use self_classification_tags array to pass the list of Tag IDs to classify creative.
Self Classification tags are the ones which have primary_category as 'Self Classification' and
secondary_category as 'Creative Specs' or 'Creative Themes'. For example, Tag 229 (Flashing images - 15
secs or less) is a self classification tag.
A tertiary_category is a logical grouping of creative specs or themes, which along with 'enable_multiselect'
determine if one or more tags from the same group can be set.
See Creative Tagging and Classification using API for more information on creative tags.
int $id
Ignored on add and update.
Creative ID. Autoset on creative creation by CreativeService::add() or CreativeService::addCreatives().
size : 10
primary
string $code
size : 100
nillable
int $advertiser_entity_id
Ignored on update.
ID of advertiser the creative belongs to.
size : 10
boolean $active
Default value: '1'
Creative activity flag.
boolean $is_audited
Default value: '0'
Shows if object has been audited by Media Guard.
This field is deprecated. Media Guard will not audit creatives to associate creative specs/themes. Refer Creative
specs, Creative themes for more details
deprecated
string $description
Client's description of creative.
size : 255
string $adapt_media_hex
size : 255
nillable
230
Services
string $adapt_click_hex
size : 255
nillable
enum_pop_types $pop_types
Default value: '0'
Type of pop, see Pop Types Enum for valid values.
int $size_id
Default value: '0'
ID of creative (width, length) pair, see Size Enum for valid values.
Please note that size id provided in Linear Video creative will be ignored.
The complete list of enum values you can see at size enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'size').
size : 10
enum : size
boolean $is_pending
Ignored on add and update.
dateTime $created_on
Ignored on add and update.
Creative creation time. Autoset by CampaignService::addCreative().
int $height
Creative height, required for pop (size_id = 0); must be > 0 and <= 10000.
int $width
Creative width, required for pop (size_id = 0); must be > 0 and <= 10000.
int $beacon_conversion_id
ID of beacon switched by this creative. See Yahoo Ad Exchange Knowledge Base for details.
size : 8
string $original_tag
boolean $can_track_clicks
Default value: '0'
This is a Boolean that must be true in order for click tracking to function.
When you use the My Yieldmanager UI to add clickable creatives, the UI asks you to manually test the creative to be
sure that click tracking is working properly. Once that testing has been completed successfully, the UI automatically
sets the $can_track_clicks on the creative. However, this testing mechanism is not available via the API, so you must
set this flag manually. Keep in mind that setting this flag will affect the way your ads are served; we strongly
recommend that, before setting $can_track_clicks, you have used the UI to test the clickability of a creative that is
representative of your creative object.
boolean $menubar
If TRUE, pop window for creative has title
boolean $resizable
If TRUE, pop window for creative is resizable
boolean $scrollbars
If TRUE, pop window for creative has scrollbars
231
Services
boolean $status
boolean $toolbar
If TRUE, pop window for creative has toolbar
boolean $flash_loop
If TRUE, flash creative loops
string $flash_bgcolor
Background color for flash
size : 10
string $flash_clicktag
size : 30
boolean $is_third_party
If TRUE, the creative is treated as third party one
This field is readonly to the API user, updated by Creative Tester. Use CreativeService::getCreativeTags() to get all
the tags associated with creative by 'Creative Tester' and 'Self classification'.
enum_creative_third_party_types $third_party_type
Ignored on add and update.
Third party tag type. value is set depending on creative_content.content value, checked at insert & update
nillable
boolean $is_ssl
Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
boolean $is_distracting
Creative theme. See Creative themes for details.
This field is deprecated. Use corresponding Creative Tag ID (ID: 229) in creative::$self_classification_tags to
associate creative themes for creative
deprecated
boolean $is_suggestive
Creative theme. See Creative themes for details.
This field is deprecated. Use corresponding Creative Tag ID (ID: 230) in creative::$self_classification_tags to
associate creative themes for creative
deprecated
boolean $is_violent
Creative theme. See Creative themes for details.
This field is deprecated. Use corresponding Creative Tag ID (ID: 231) in creative::$self_classification_tags to
associate creative themes for creative
deprecated
boolean $is_textlink
Creative spec. See Creative specs for details.
232
Services
This field is readonly to the API user, updated by Creative Tester. Use CreativeService::getCreativeTags() to get all
the tags associated with creative by 'Creative Tester' and 'Self classification'.
deprecated
boolean $has_active_x
Creative spec. See Creative specs for details.
This field is readonly to the API user, updated by Creative Tester. Use CreativeService::getCreativeTags() to get all
the tags associated with creative by 'Creative Tester' and 'Self classification'
deprecated
boolean $has_exit_pop
Creative spec. See Creative specs for details.
This field is readonly to the API user, updated by Creative Tester. Use CreativeService::getCreativeTags() to get all
the tags associated with creative by 'Creative Tester' and 'Self classification'
deprecated
string $pop_window_title
Title of pop window for the creative.
size : 100
boolean $banner_opens_pop
Creative spec. See Creative specs for details.
This field is readonly to the API user, updated by Creative Tester. Use CreativeService::getCreativeTags() to get all
the tags associated with creative by 'Creative Tester' and 'Self classification'
boolean $flash_has_embedded_url
int $offer_type_id
Creative's offer type. See Offer Type table for additional information. See also Creative offer types for details.
The complete list of enum values you can see at offer_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'offer_type').
size : 10
enum : offer_type
string $click_url
Creative's click url. Creative must be clickable to use it. See Yahoo Ad Exchange Knowledge Base for details.
nillable
boolean $has_video_or_rich_media
Creative spec. See Creative specs for details.
This field is deprecated. Use corresponding Creative Tag ID (ID: 233) in creative::$self_classification_tags to
associate creative specs for creative
deprecated
boolean $is_deceptive
Creative theme. See Creative themes for details.
This field is deprecated. Use corresponding Creative Tag ID (ID: 234) in creative::$self_classification_tags to
associate creative themes for creative
deprecated
233
Services
boolean $is_political
Creative theme. See Creative themes for details.
This field is deprecated. Use corresponding Creative Tag ID (ID: 235) in creative::$self_classification_tags to
associate creative themes for creative
deprecated
string $audio_type
Default value: 'none'
Creative spec. See Creative specs for details.
This field is deprecated. Use corresponding Creative Tag ID (IDs: 241, 242) in creative::$self_classification_tags to
associate creative specs for creative
The complete list of enum values you can see at audio_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'audio_type').
deprecated
enum : audio_type
int $target_profile_id
Ignored on add and update.
ID of target profile, attached to creative. Can be set by CreativeService::addTargetProfile().
size : 8
nillable
int $delivery_rules_id
Ignored on add and update.
Delivery rules ID. Autoset by the server when creating a new creative.
size : 10
nillable
boolean $initiates_pop
If TRUE, YAX server initiates pop window at the client' side before pop creative delivery. See Yahoo Ad Exchange
Knowledge Base for details.
boolean $is_web_site_pop
Creative spec. See Creative specs for details.
This field is readonly to the API user, updated by Creative Tester. Use CreativeService::getCreativeTags() to get all
the tags associated with creative by 'Creative Tester' and 'Self classification'
deprecated
boolean $no_iframes
If TRUE, tag code doesn't create IFRAME
int $is_pre_audited
Ignored on add and update.
size : 1
nillable
int $last_audited_by_contact_id
Ignored on add and update.
size : 10
nillable
dateTime $last_human_audit
Ignored on add and update.
234
Services
nillable
dateTime $last_automated_audit
Ignored on add and update.
nillable
enum_creative_type $creative_type
Ignored on update.
Creative type.
int $pop_expand_to_full_window
Default value: '0'
size : 1
int $use_campaign_click_url
Default value: '0'
size : 1
enum_priority $priority
Default value: 'Normal'
Campaign priority.
array_of_creative_content $contents
custom_settings $custom_settings
nillable
int $imp_budget
Budget by impressions
nillable
object : delivery_rules
string $imp_delivery_type
Default value: 'ASAP'
Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are listed in Delivery Type Enum.
The complete list of enum values you can see at imp_delivery_type enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'imp_delivery_type').
enum : imp_delivery_type
object : delivery_rules
float $imp_delivery_cap
Max value for impression-capped delivery methods.
nillable
object : delivery_rules
int $is_bcm_upload
Default value: '0'
size : 1
string $view_tracker
Allows clients to run agency deals by trafficking image and flash creative directly along with a 3rd-party
impression-tracking (view tracker) pixel. We store the URL of the impression-tracking pixel in view_tracker field.
235
Services
size : 255
nillable
dateTime $first_ran_date
Ignored on add and update.
dateTime $last_ran_date
Ignored on add and update.
boolean $needs_arbitration
Ignored on add and update.
boolean $addressbar
If TRUE, pop window for creative has address bar
int $ad_size_in_bytes
Ignored on add and update.
size : 11
nillable
dateTime $lastupd
Ignored on add and update.
nillable
int $language_id
Id of language creative_tag
The complete list of enum values you can see at creative_tag_language enum page, at run time you can get all of
them using DictionaryService.getEnumValues(token, 'creative_tag_language').
enum : creative_tag_language
int $ad_vendor_id
Ad vendor ID. For internal use only. Do not use.
field : ad_vendor_id
object : db_creative_ad_vendor
nillable
boolean $is_rtb
Default value: '0'
For RTB creative
boolean $is_3pi
Default value: '0'
string $classification_review_status
Ignored on add and update.
Default value: 'not-reviewed'
Creative classification review status, see valid types in Creative Classification Review Status Enum.
The complete list of enum values you can see at creative_classification_review_status enum page, at run time you
can get all of them using DictionaryService.getEnumValues(token, 'creative_classification_review_status').
nillable
enum : creative_classification_review_status
video_creative $video_creative
Complex data type to represent video creative attributes.
236
Services
creative_lineitem
Used by the following call(s) and/or data type(s):
LineItemService
addCreatives()
Fields Summary
$creative_id Creative ID.
$line_item_id Line item ID.
Fields
int $creative_id
Creative ID.
int $line_item_id
Line item ID.
creative_macro
See Creative Macro Enum for more information.
DictionaryService
getCreativeMacro()
Fields Summary
$id
$macro
$description
Fields
int $id
Ignored on add and update.
size : 10
primary
string $macro
size : 100
string $description
size : 255
nillable
creative_options
Used by the following call(s) and/or data type(s):
ccp_creative_search_options
237
Services
$exclude_creative_options
$include_creative_options
creative_search_options
$exclude_creative_options
$include_creative_options
Fields Summary
$is_distracting Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
$has_active_x Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
$is_suggestive Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
$is_violent Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
$is_deceptive Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
$has_video_or_rich_media Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
$is_political Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
$audio_type Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
$is_web_site_pop Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
$is_textlink Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
$banner_opens_pop
$has_exit_pop Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
Fields
boolean $is_distracting
Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
boolean $has_active_x
Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
boolean $is_suggestive
Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
boolean $is_violent
Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
boolean $is_deceptive
Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
boolean $has_video_or_rich_media
Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
boolean $is_political
Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
string $audio_type
Default value: 'none'
Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
The complete list of enum values you can see at audio_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'audio_type').
enum : audio_type
boolean $is_web_site_pop
Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
boolean $is_textlink
Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
boolean $banner_opens_pop
238
Services
boolean $has_exit_pop
Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
creative_owner_data
Fields Summary
$id
$advertiser_entity_id
$tests_number
$is_rtb
Fields
int $id
int $advertiser_entity_id
int $tests_number
int $is_rtb
creative_properties
properties data type
demand
$creative_tags
preferred_terms_demand
$creative_tags
Fields Summary
$creative_specs Creative specs.
$creative_themes Creative themes.
$creative_languages Creative languages.
$creative_beacons Creative beacons.
$include Include is set "true" to include or "false" to exclude particular segments specified in
$creative_specs, $creative_themes, $creative_beacons, $creative_languages arrays.
Fields
array_of_id_name $creative_specs
Creative specs.
array_of_id_name $creative_themes
Creative themes.
array_of_id_name $creative_languages
Creative languages.
array_of_id_name $creative_beacons
Creative beacons.
boolean $include
239
Services
Include is set "true" to include or "false" to exclude particular segments specified in $creative_specs,
$creative_themes, $creative_beacons, $creative_languages arrays.
creative_publisher_comments
Used by the following call(s) and/or data type(s):
CreativeService
getCreativeComments()
Fields Summary
$creative_id Creative ID for which the comments are fetched.
$all_comments Comments from each publisher for the queried creative ID
Fields
int $creative_id
Creative ID for which the comments are fetched.
array_of_creative_comments $all_comments
Comments from each publisher for the queried creative ID
creative_reviewer
Fields Summary
$contact_id Contact_ID
$reviewer_name Reviewer Name
Fields
int $contact_id
Ignored on add and update.
Contact_ID
string $reviewer_name
Ignored on add and update.
Reviewer Name
creative_review_options
This file defines creative_review_options data type
Fields Summary
$demand_blocklist_id Parameter to filter by demand blocklist id.
$creative_ids array of creative ids.
$review_status Parameter to filter by creative status 'unreviewed', 'review-further', 'approved', 'banned' .
$start_date Creative review Start date specified in yyyy-mm-dd hh:mm:ss format.
$end_date Creative review End date Specified in yyyy-mm-dd hh:mm:ss format
Fields
int $demand_blocklist_id
Parameter to filter by demand blocklist id.
240
Services
array_of_int $creative_ids
array of creative ids.
enum_review_status $review_status
Default value: 'unreviewed'
Parameter to filter by creative status 'unreviewed', 'review-further', 'approved', 'banned' .
dateTime $start_date
Creative review Start date specified in yyyy-mm-dd hh:mm:ss format.
dateTime $end_date
Creative review End date Specified in yyyy-mm-dd hh:mm:ss format
creative_search_options
Used by the following call(s) and/or data type(s):
CreativeService
search()
Fields Summary
$size_ids show only creatives which sizes listed in the array
$advertiser_ids show only creatives which belongs to the advertisers listed in the array
$region_ids show only creatives with the following region IDs
$creatives_visibility show either 'all', 'approved' or 'banned' creatives.
$recent_days_number show only creatives which were added in the last few days
$filtered_creative_ids the list of creative IDs that are going to be removed from a search result
$url_pattern Show only creatives whose $media_url elements match $url_pattern.
$offer_type_ids show only creatives which offer_type_ids are listed in the array
$creative_ids the list of creative IDs that are going to be added to a search result
$include_creative_options all the creatives which do not match this creative specs will not be included in a
search result
$exclude_creative_options all the creatives which match this creative specs will not be included in a
search result
$target_profile_id current target profile id
$entity_id entity id (default is currently logged in entity) for which the list of creatives will be returned
$line_item_id line item id; instead of specifying an entity id you can fill this field and get the list of creatives
that are served at that corresponding level
$is_reviewed Show reviewed creatives
$is_unreviewed Show un-reviewed creatives
$needs_further_review Show creatives that require further review
$reviewer_contact_ids If searching creative is_reviewed and/or need_further_review then also filter by
reviewer contact
$review_start Review start time
$review_end Review end time
$media_types Media type of content
$third_party_types Third paty type
$include_tags all the creatives which do not match these creative tags will not be included in a search
result
$exclude_tags all the creatives which match these creative tags will not be included in a search result
$include_beacons all the creatives which do not match these creative beacons will not be included in a
search result
$exclude_beacons all the creatives which match these creative beacons will not be included in a search
result
$source_type show either 'all', 'rtb' or 'non_rtb' creatives.
$creative_codes all the creatives which do not belong to any of these code strings will not be included in a
search result
Fields
array_of_int $size_ids
show only creatives which sizes listed in the array
nillable
241
Services
array_of_int $advertiser_ids
show only creatives which belongs to the advertisers listed in the array
nillable
array_of_int $region_ids
show only creatives with the following region IDs
nillable
enum_visibility_scope $creatives_visibility
Default value: 'all'
show either 'all', 'approved' or 'banned' creatives.
int $recent_days_number
show only creatives which were added in the last few days
nillable
array_of_int $filtered_creative_ids
the list of creative IDs that are going to be removed from a search result
nillable
string $url_pattern
Show only creatives whose $media_url elements match $url_pattern.
$url_pattern should be a valid URL of the form http://content.yieldmanager.com/$path, where $path is what is actually
matched against the creative_content, specifically the $media_url. Note that $path is matched as a substring of
$media_url (i.e., the matching pattern is created by adding wildcards to the head and tail of $path). For example, the
$url_pattern 'http://content.yieldmanager.com/atoms/12' would find all creatives whose $media_url matches
'%atoms/12%'.
nillable
array_of_int $offer_type_ids
show only creatives which offer_type_ids are listed in the array
nillable
array_of_int $creative_ids
the list of creative IDs that are going to be added to a search result
nillable
creative_options $include_creative_options
all the creatives which do not match this creative specs will not be included in a search result
nillable
creative_options $exclude_creative_options
all the creatives which match this creative specs will not be included in a search result
nillable
int $target_profile_id
current target profile id
nillable
int $entity_id
entity id (default is currently logged in entity) for which the list of creatives will be returned
242
Services
nillable
int $line_item_id
line item id; instead of specifying an entity id you can fill this field and get the list of creatives that are served at that
corresponding level
nillable
boolean $is_reviewed
Default value: '1'
Show reviewed creatives
boolean $is_unreviewed
Default value: '1'
Show un-reviewed creatives
boolean $needs_further_review
Default value: '1'
Show creatives that require further review
array_of_int $reviewer_contact_ids
If searching creative is_reviewed and/or need_further_review then also filter by reviewer contact
nillable
string $review_start
Review start time
If searching creative is_reviewed and/or need_further_review then also filter by review datetime
nillable
string $review_end
Review end time
If searching creative is_reviewed and/or need_further_review then also filter by review datetime
nillable
array_of_enum_creative_search_media_type $media_types
Media type of content
nillable
array_of_enum_creative_search_third_party_type $third_party_types
Third paty type
nillable
array_of_int $include_tags
all the creatives which do not match these creative tags will not be included in a search result
nillable
array_of_int $exclude_tags
all the creatives which match these creative tags will not be included in a search result
nillable
array_of_int $include_beacons
all the creatives which do not match these creative beacons will not be included in a search result
243
Services
nillable
array_of_int $exclude_beacons
all the creatives which match these creative beacons will not be included in a search result
nillable
enum_creative_search_source_type $source_type
Default value: 'all'
show either 'all', 'rtb' or 'non_rtb' creatives.
array_of_string $creative_codes
all the creatives which do not belong to any of these code strings will not be included in a search result
nillable
creative_search_result
Used by the following call(s) and/or data type(s):
DemandBlocklistService
searchCreatives()
Fields Summary
$id Creative ID.
$description Creative Description.
$advertiser Advertiser Id and Name
$beacons Beacon id and Name.
$size_id Size ID.
$height Creative size height.
$width Creative size width.
$file_size Creative file size in KB.
$media_type Creative content media type. See Media Type Enum for more information.
$offer_type Creative offer type.
$reviewed_by Reviewer contact Id and Name.
$reviewed_date Creative review date and time
$review_status Creative review status.
$review_comments Creative further review comments
$click_url Creative click URL.
$created_date Creative creation time.
$source_type Creative source type.
Fields
int $id
Ignored on add and update.
Creative ID.
primary
string $description
Creative Description.
id_name $advertiser
Advertiser Id and Name
array_of_id_name $beacons
Beacon id and Name.
int $size_id
244
Services
Size ID.
int $height
Creative size height.
int $width
Creative size width.
int $file_size
Creative file size in KB.
enum_media_type $media_type
Creative content media type. See Media Type Enum for more information.
The complete list of enum values you can see at media_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'media_type').
enum : media_type
id_name $offer_type
Creative offer type.
id_name $reviewed_by
Reviewer contact Id and Name.
dateTime $reviewed_date
Creative review date and time
enum_review_status $review_status
Creative review status.
The complete list of enum values you can see at review_status enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'review_status').
enum : review_status
array_of_string $review_comments
Creative further review comments
string $click_url
Creative click URL.
dateTime $created_date
Ignored on add and update.
Creative creation time.
enum_creative_search_source_type $source_type
Creative source type.
creative_specs
Used by the following call(s) and/or data type(s):
CreativeService
getCreativeSpecs()
TargetProfileService
getTargetCreativeSpecs()
setTargetCreativeSpecs()
245
Services
targetings
$CreativeSpecs
Fields Summary
$id creative spec ID
$allow_third_party_tags third party tags flag
$allow_distracting distracting flag
$allow_active_x active x flag
$allow_cpc cpc flag
$allow_cpa cpa flag
$allow_discretionary discretionary flag
$allow_third_party_numbers third party numbers flag
$max_days_since_adjustment max days since adjustment flag
$allow_suggestive suggestive flag
$allow_violent violent flag
$allow_cpm cpm flag
$allow_roi_target roi target flag
$allow_deceptive deceptive flag
$allow_video_and_rich_media video and rich media flag
$allow_political political flag
$allow_audio_type audio type flag
$allow_web_site_pop web site pop flag
$allow_textlink textlink flag
$allow_unaudited unaudited flag
$allow_banner_opens_pop banner opens pop flag
$allow_exit_pop exit pop flag
$allow_meets_msn_specs meets msn specs flag
$allow_meets_yahoo_specs meets yahoo specs flag
Fields
int $id
creative spec ID
size : 10
primary
boolean $allow_third_party_tags
Default value: 1
third party tags flag
boolean $allow_distracting
Default value: 1
distracting flag
boolean $allow_active_x
Default value: 1
active x flag
boolean $allow_cpc
Default value: 1
cpc flag
boolean $allow_cpa
Default value: 1
cpa flag
boolean $allow_discretionary
Default value: 1
discretionary flag
boolean $allow_third_party_numbers
Default value: 1
246
Services
int $max_days_since_adjustment
Default value: 7
max days since adjustment flag
size : 11
int $allow_suggestive
Default value: 1
suggestive flag
size : 4
int $allow_violent
Default value: 1
violent flag
size : 4
boolean $allow_cpm
Default value: 1
cpm flag
boolean $allow_roi_target
Default value: 1
roi target flag
boolean $allow_deceptive
Default value: 1
deceptive flag
boolean $allow_video_and_rich_media
Default value: 1
video and rich media flag
boolean $allow_political
Default value: 1
political flag
string $allow_audio_type
Default value: 'any'
audio type flag
The complete list of enum values you can see at spec_audio_type enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'spec_audio_type').
enum : spec_audio_type
boolean $allow_web_site_pop
Default value: 1
web site pop flag
boolean $allow_textlink
Default value: 1
textlink flag
boolean $allow_unaudited
Default value: 1
unaudited flag
247
Services
boolean $allow_banner_opens_pop
Default value: 1
banner opens pop flag
boolean $allow_exit_pop
Default value: 1
exit pop flag
boolean $allow_meets_msn_specs
Default value: 1
meets msn specs flag
boolean $allow_meets_yahoo_specs
Default value: 1
meets yahoo specs flag
creative_tag_list_item
See Creative Tag List Enum for more information.
DictionaryService
getCreativeTagList()
Fields Summary
$id
$primary_category Primary category: This represents the source of the tag. Creative tags with
primary_category "Self Classification" are provided by advertiser on creative upload or edit, while "Creative
Tester" tags are assigned by automated 'Creative Tester'.
$secondary_category Secondary category: This designates a tag as a creative spec or theme. Creative
specs describe the physical and behavioral aspects of the creative, such as audio, active x, or popups.
Creative themes is related to the content of a creative such as political, religious or violent.
$tertiary_category Tertiary category: This is a logical grouping of creative specs or themes.
$tag
$entity_id
$is_media_guard For identification of the tag as internal or external. 1: external , 0 : internal use.
$ui_order
$is_enabled
$expiration_age
$description tag description
$enable_multiselect 'enable_multiselect' determines if one or more tags can be set within the same
tertiary_category for creative self classification.
Fields
int $id
size : 5
primary
string $primary_category
Primary category: This represents the source of the tag. Creative tags with primary_category "Self Classification" are
provided by advertiser on creative upload or edit, while "Creative Tester" tags are assigned by automated 'Creative
Tester'.
size : 100
string $secondary_category
Secondary category: This designates a tag as a creative spec or theme. Creative specs describe the physical and
behavioral aspects of the creative, such as audio, active x, or popups. Creative themes is related to the content of a
creative such as political, religious or violent.
248
Services
size : 255
string $tertiary_category
Tertiary category: This is a logical grouping of creative specs or themes.
size : 100
string $tag
size : 255
int $entity_id
size : 10
nillable
int $is_media_guard
For identification of the tag as internal or external. 1: external , 0 : internal use.
size : 1
float $ui_order
deprecated
nillable
boolean $is_enabled
int $expiration_age
Ignored on add and update.
Default value: '0'
size : 5
string $description
tag description
nillable
int $enable_multiselect
Ignored on add and update.
'enable_multiselect' determines if one or more tags can be set within the same tertiary_category for creative self
classification.
size : 3
creative_with_review_status
Used by the following call(s) and/or data type(s):
CreativeService
getByIntCode()
getByIntCodes()
Fields Summary
$creative Contains the creative object.
$creative_status The review status of the creative.
249
Services
$status_reason Reason for creative review status. NULL if creative status 'reviewPassed'.
Fields
creative $creative
Contains the creative object.
enum_creative_status $creative_status
The review status of the creative.
string $status_reason
Default value: NULL
Reason for creative review status. NULL if creative status 'reviewPassed'.
ct_report_result
Fields Summary
$url
$result
$exception_detail
$exception_text
$item_id
Fields
string $url
boolean $result
exception_detail $exception_detail
string $exception_text
int $item_id
currency
See Currency Enum for more information.
DictionaryService
getCurrencies()
Fields Summary
$id Currency ID
$name Currency name
$symbol Currency symbol
$abbreviation Currency abbreviation
$decimals Currency decimals
$current_exchange_rate Current currency rate of exchange - latest exchange rate available
$exchange_rate_as_of Date and time from which currency exchange rate is set
Fields
250
Services
int $id
Ignored on add and update.
Currency ID
size : 3
primary
string $name
Ignored on add and update.
Currency name
size : 50
string $symbol
Ignored on add and update.
Currency symbol
size : 10
string $abbreviation
Ignored on add and update.
Currency abbreviation
size : 3
int $decimals
Ignored on add and update.
Currency decimals
size : 3
float $current_exchange_rate
Ignored on add and update.
Current currency rate of exchange - latest exchange rate available
size : 10,4
dateTime $exchange_rate_as_of
Ignored on add and update.
Date and time from which currency exchange rate is set
custom_creative
Used by the following call(s) and/or data type(s):
custom_settings
$custom_creative
Fields Summary
$custom_creative_code Custom creative type
Fields
enum_custom_creative_type $custom_creative_code
Custom creative type
251
Services
custom_geo_area
Used by the following call(s) and/or data type(s):
TargetProfileService
addCustomGeoArea()
getAllCustomGeoAreas()
getCustomGeoArea()
Fields Summary
$postal_codes Array of postal_code
$id Custom geo area ID
$entity_id Entity ID
$name Custom geo area name
$active Active flag
$country_woeid Country WOEID to which the CGA belongs
$description Custom geo area description
$created_on
$lastupd
Fields
array_of_string $postal_codes
Array of postal_code
int $id
Ignored on add and update.
Custom geo area ID
size : 10
primary
int $entity_id
Ignored on add and update.
Entity ID
size : 10
string $name
Custom geo area name
size : 255
int $active
Ignored on add and update.
Active flag
size : 3
int $country_woeid
Ignored on update.
Country WOEID to which the CGA belongs
size : 10
string $description
Custom geo area description
size : 255
dateTime $created_on
Ignored on add and update.
252
Services
nillable
dateTime $lastupd
Ignored on add and update.
custom_settings
Used by the following call(s) and/or data type(s):
creative
$custom_settings
placement_creative
$custom_settings
Fields Summary
$custom_creative
Fields
custom_creative $custom_creative
nillable
data_buyer_contact
Used by the following call(s) and/or data type(s):
PixelService
getAvailableSegmentBuyers()
Fields Summary
$entity_id Entity id of segment buyer.
$company_name Company name of segment buyer.
$company_website Company website of segment buyer.
$contact_email Contact email of segment buyer.
Fields
int $entity_id
Entity id of segment buyer.
string $company_name
Company name of segment buyer.
string $company_website
Company website of segment buyer.
string $contact_email
Contact email of segment buyer.
data_seller_contact
Used by the following call(s) and/or data type(s):
253
Services
PixelService
getSegmentOwner()
Fields Summary
$entity_id Data seller's entity id
$company_name Data seller's company name
$contact_email Data seller's contact email
$segment_name Name of the segment
Fields
int $entity_id
Data seller's entity id
string $company_name
Data seller's company name
string $contact_email
Data seller's contact email
string $segment_name
Name of the segment
date_imps
Used by the following call(s) and/or data type(s):
AdjustmentService
getImpsByDates()
Fields Summary
$date Date
$imps Imps number
Fields
date $date
Date
int $imps
Imps number
date_range
This file defines date_range data type
dbl_creative_search_options
$created_between
$reviewed_between
Fields Summary
$start_date Start Date and time
$end_date End Date and time
254
Services
Fields
dateTime $start_date
Start Date and time
nillable
dateTime $end_date
End Date and time
nillable
daypart
Used by the following call(s) and/or data type(s):
TargetProfileService
getTargetDayparts()
TargetProfileService::getTargetDaypartsDepr()
setTargetDayparts()
TargetProfileService::setTargetDaypartsDepr()
rule_dayparts
$daypart_list
target_daypart
$dayparts
Fields Summary
$day_id Day number from 1 for Sunday till 7 for Saturday
$start_time Start time in hours (0..23) for targeting
$end_time End time in hours (0..23) for targeting
Fields
int $day_id
Day number from 1 for Sunday till 7 for Saturday
The complete list of enum values you can see at day enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'day').
enum : day
int $start_time
Start time in hours (0..23) for targeting
int $end_time
End time in hours (0..23) for targeting
dbl_creative_search_options
This file defines dbl_creative_search_options data type
DemandBlocklistService
searchCreatives()
Fields Summary
$creative_ids Show only creatives which are listed in the array
255
Services
Fields
array_of_int $creative_ids
Show only creatives which are listed in the array
nillable
array_of_enum_review_status $review_status
Default value: 'unreviewed'
Parameter to filter by creative status 'unreviewed', 'review_further', 'approved', 'banned' creatives.
date_range $reviewed_between
Show creative reviewed between specified date and time range.
nillable
object : date_range
array_of_int $reviewer_contact_ids
Show only creatives which $reviewer_contact_ids listed in the array.
nillable
enum_creative_search_source_type $source_type
Default value: 'all'
Show either 'all', 'rtb' or 'non_rtb' creatives.
array_of_int $advertiser_ids
Show only creatives which belongs to the advertisers listed in the array.
Advertiser IDs: Managed advertisers IDs of current network or network IDs of any other network.
nillable
date_range $created_between
Show creative created between specified date and time range.
nillable
object : date_range
array_of_int $offer_type_ids
Show only creatives which offer_type_ids are listed in the array.
nillable
array_of_enum_media_type $media_type
Show only creatives which media_type listed in the array. See Media Type Enum for more information.
The complete list of enum values you can see at 4_enum_media_type .pkg, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'media_type ').
nillable
256
Services
enum : media_type
array_of_int $size_ids
Show only creatives which sizes listed in the array.
nillable
deal_properties
Used by the following call(s) and/or data type(s):
TargetProfileService
getTargetDealProperties()
TargetProfileService::getTargetDealPropertiesDepr()
setTargetDealProperties()
TargetProfileService::setTargetDealPropertiesDepr()
targetings
$DealProperties
Fields Summary
$allow_cpa if true, CPA pricing is allowed
$allow_cpc if true, CPC pricing is allowed
$allow_cpm if true, CPM pricing is allowed
$allow_discretionary if true, discretionary pricing is allowed
$allow_roi_target if true, return on investment target is allowed
$allow_third_party_numbers if true, third party numbers are allowed
Fields
boolean $allow_cpa
if true, CPA pricing is allowed
boolean $allow_cpc
if true, CPC pricing is allowed
boolean $allow_cpm
if true, CPM pricing is allowed
boolean $allow_discretionary
if true, discretionary pricing is allowed
boolean $allow_roi_target
if true, return on investment target is allowed
boolean $allow_third_party_numbers
if true, third party numbers are allowed
default_target_profile
Used by the following call(s) and/or data type(s):
TargetProfileService
getDefaultTargetProfiles()
Fields Summary
$id Target profile ID. Autoset on creation.
$active Target profile activity flag.
257
Services
Fields
int $id
Target profile ID. Autoset on creation.
primary
boolean $active
Default value: 1
Target profile activity flag.
string $name
Default value: 'No Name Set'
Name of the target profile
string $default_profile_name
Name of target profile if it is default
nillable
demand_blocklist
blocklist data type
DemandBlocklistService
add()
getAllBlocklists()
getAllSince()
getByObjectId()
update()
Fields Summary
$id Demand blocklist id.
$name Demand blocklist name.
$description Demand blocklist description.
$entity_id Owner entity ID
$entity_name Name of owner entity.
$managed_supply Complex data type to represent managed supply attributes.
$block_demand Complex data type to represent demand attributes.
$creative_control Creative_control 'block','block_till_review','allow_till_review'
$last_creative_reviewer_details Complex data type to represent last creative reviewer details.
$created_by_contact_id Contact id who created demand blocklist.
$created_by_contact_name Name of contact who created rule.
$modified_by_contact_id Contact id who modified demand blocklist.
$modified_by_contact_name Name of contact who modified rule.
$active Demand blocklist activity flag.
$created_on Demand blocklist created on date/time.
$lastupd Demand blocklist last updated date/time.
Fields
int $id
Ignored on update.
Demand blocklist id.
primary
258
Services
string $name
Demand blocklist name.
string $description
Demand blocklist description.
int $entity_id
Ignored on add and update.
Owner entity ID
string $entity_name
Name of owner entity.
managed_supply $managed_supply
Complex data type to represent managed supply attributes.
demand $block_demand
Complex data type to represent demand attributes.
enum_creative_control $creative_control
Default value: 'block'
Creative_control 'block','block_till_review','allow_till_review'
last_creative_reviewer_details $last_creative_reviewer_details
Ignored on add and update.
Complex data type to represent last creative reviewer details.
int $created_by_contact_id
Ignored on add and update.
Contact id who created demand blocklist.
string $created_by_contact_name
Name of contact who created rule.
int $modified_by_contact_id
Ignored on add and update.
Contact id who modified demand blocklist.
string $modified_by_contact_name
Name of contact who modified rule.
boolean $active
Default value: '0'
Demand blocklist activity flag.
dateTime $created_on
Ignored on add and update.
Demand blocklist created on date/time.
dateTime $lastupd
Ignored on add and update.
Demand blocklist last updated date/time.
259
Services
demand
demand data type
demand_blocklist
$block_demand
Fields Summary
$marketplace Demand rule applicable on Trading Pit, Netwrok of network, Intra Network(Managed
Advertiser) or any combination of these. See Buying Selling Marketplace Enum for valid values.
$buying_technology Array of buying technology 'RTBD', 'Hosted'. See Buying Technology Enum for valid
values.
$advertisers Advertiser ids.
$deal_properties Deal properties.
$creative_tags Creative tag ids for creative_specs, creative_themes, creative_languages,
creative_beacons.
$click_urls Click Urls.
$offer_types Offer types.
Fields
array_of_enum_buying_selling_marketplace $marketplace
Demand rule applicable on Trading Pit, Netwrok of network, Intra Network(Managed Advertiser) or any combination of
these. See Buying Selling Marketplace Enum for valid values.
array_of_enum_buying_technology $buying_technology
Array of buying technology 'RTBD', 'Hosted'. See Buying Technology Enum for valid values.
advertiser_list $advertisers
Advertiser ids.
rule_deal_properties $deal_properties
Deal properties.
creative_properties $creative_tags
Creative tag ids for creative_specs, creative_themes, creative_languages, creative_beacons.
rule_attribute_names $click_urls
Click Urls.
rule_attribute $offer_types
Offer types.
domain_url_data
Used by the following call(s) and/or data type(s):
AdvertiserDomainService
getBlockList()
advertiser_domain_blocklist
$domain_urls
Fields Summary
$url Value "NULL" selected as excluded domain url means that every demand needs to come with a valid
advertiser domain.
$visibility Set "true" for public. Set "false" for private.
260
Services
Fields
string $url
Value "NULL" selected as excluded domain url means that every demand needs to come with a valid advertiser
domain.
nillable
boolean $visibility
Default value: '0'
Set "true" for public. Set "false" for private.
dxr_migration_reports
Used by the following call(s) and/or data type(s):
InsertionOrderService
dxrMigrationStatus()
Fields Summary
$new_io_id Id of new insertion order copied from old one.
$migration_map_url URL to migration map report
$targeting_map_url URL to targeting map report
Fields
int $new_io_id
Id of new insertion order copied from old one.
string $migration_map_url
URL to migration map report
string $targeting_map_url
URL to targeting map report
e
$expandable_final_height
in file p159.php, variable richmedia_creative_attributes::$expandable_final_height
Expandable Final Height
$expandable_final_width
in file p159.php, variable richmedia_creative_attributes::$expandable_final_width
Expandable Final Width
top
i
$is_expandable
in file p159.php, variable richmedia_creative_attributes::$is_expandable
Is Expandable Creative
$is_floating
in file p159.php, variable richmedia_creative_attributes::$is_floating
Is Floating Creative
261
Services
$is_other
in file p159.php, variable richmedia_creative_attributes::$is_other
Does creative belong to any other rich media category?
$is_polite_download
in file p159.php, variable richmedia_creative_attributes::$is_polite_download
Is Polite Download
$is_video
in file p159.php, variable richmedia_creative_attributes::$is_video
Is Flash Video
top
p
p159.php
procedural page p159.php
top
r
richmedia_creative_attributes
in file p159.php, class richmedia_creative_attributes
Used by the following call(s) and/or data type(s):
creative
$richmedia_creative_attribute
top
entity_broker_fee
Used by the following call(s) and/or data type(s):
marketplace_settings
$intra_network_fee
Fields Summary
$fee_calculation_type The complete list of enum values you can see at intra_seat_fee_calculation_type
enum page, at run time you can get all of them using DictionaryService.getEnumValues(token,
'intra_seat_fee_calculation_type').
$fee_type The complete list of enum values you can see at fee_type enum page, at run time you can get
all of them using DictionaryService.getEnumValues(token, 'fee_type').
$forex_currency_id
$amount amount
$min_cpm_fee
Fields
string $fee_calculation_type
Default value: 'Post auction'
The complete list of enum values you can see at intra_seat_fee_calculation_type enum page, at run time you can get
all of them using DictionaryService.getEnumValues(token, 'intra_seat_fee_calculation_type').
enum : intra_seat_fee_calculation_type
string $fee_type
Default value: 'Flat CPM'
The complete list of enum values you can see at fee_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'fee_type').
enum : fee_type
int $forex_currency_id
Ignored on add and update.
Default value: 153
262
Services
size : 3
float $amount
Default value: 0.0
amount
size : 10,5
float $min_cpm_fee
Default value: '0'
entity_data
Used by the following call(s) and/or data type(s):
EntityService
addEx()
Fields Summary
$entity contains the entity object
$contact contains the contact object
$create_site_section site and section creation flag
$site contains the site object
$section contains the section object
$create_io_li insertion order and line item creation flag
$insertion_order contains the insertion order object
$line_item contains the line item object
Fields
entity $entity
contains the entity object
contact $contact
contains the contact object
boolean $create_site_section
site and section creation flag
site $site
contains the site object
section $section
contains the section object
boolean $create_io_li
insertion order and line item creation flag
insertion_order $insertion_order
contains the insertion order object
line_item $line_item
contains the line item object
263
Services
entity
Used by the following call(s) and/or data type(s):
EntityService
add()
get()
getAll()
getAllSince()
getByShellId()
update()
entity_data
$entity
link_data
$entity
marketplace_settings
$intra_network_fee
publisher_data
$entity
Fields Summary
$id entity ID
$entity_type entity type (Publisher, Advertiser, Network)
$secondary_entity_type secondary entity type.
$business_type business type
$managing_entity_id managing entity ID. For using network's serving domain publisher should set the
network as its managing entity.
$name entity name
$active activity flag
$comment additional information
$currency_id the currency ID the entity pay/get paid in. See Currency table for additional information.
$exchange_rate exchange rate of the currency (if not in dollars)
$created_on the entity creation time
$created_by_contact_id the entity creator contact id
$referral_source_id
$notes additional information
$no_imps_month
$applied_on applying time
$default_site_id default site ID
$uses_site_codes allows to use site codes
$account_manager_id account manager ID
$trafficker_contact_id trafficker contact ID
$sales_region_id
$serving_domain default serving domain ad to be served from
$simple_trafficking
$uses_managed_entity_codes
$default_managed_entity_id default managed entity ID
$managed_entity_code
$time_zone the entity time zone
$timezone_id the entity time zone id
$sections_share_channels
$pub_learn_percentage
$serving_name
$default_publisher_billing_code
$adserver_profile_id
$is_linkable
$language_id Language ID. See Language table for additional information.
$target_profile_id entity target profile ID
$content_domain
$log_predict_stats
$network_only_linking
$can_create_managed_pubs can the entity create managed publishers
$allow_rmxd
$business_contact_id business contact ID
$operations_contact_id operations contact ID
$technical_contact_id technical contact ID
$lastupd
$address1 the first line of the publisher's address
$address2 the second line of the publisher's address
$city the entity city
$region_id The publisher region ID. See Region table for additional information.
264
Services
Fields
int $id
Ignored on add and update.
entity ID
size : 10
primary
string $entity_type
Ignored on update.
entity type (Publisher, Advertiser, Network)
The complete list of enum values you can see at entity_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'entity_type').
enum : entity_type
string $secondary_entity_type
Ignored on update.
secondary entity type.
The complete list of enum values you can see at secondary_entity_type enum page, at run time you can get all of
them using DictionaryService.getEnumValues(token, 'secondary_entity_type').
enum : secondary_entity_type
string $business_type
business type
The complete list of enum values you can see at business_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'business_type').
enum : business_type
265
Services
int $managing_entity_id
Ignored on update.
managing entity ID. For using network's serving domain publisher should set the network as its managing entity.
size : 10
string $name
entity name
size : 100
boolean $active
Default value: '1'
activity flag
string $comment
additional information
size : 255
int $currency_id
Ignored on update.
Default value: '1'
the currency ID the entity pay/get paid in. See Currency table for additional information.
The complete list of enum values you can see at currency enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'currency').
size : 3
enum : currency
float $exchange_rate
Ignored on add and update.
Default value: '1.0'
exchange rate of the currency (if not in dollars)
size : 10,4
dateTime $created_on
Ignored on add and update.
the entity creation time
int $created_by_contact_id
Ignored on add and update.
the entity creator contact id
size : 10
int $referral_source_id
size : 10
string $notes
additional information
int $no_imps_month
Ignored by: Advertiser
size : 15
dateTime $applied_on
Ignored on add and update.
266
Services
applying time
int $default_site_id
Ignored by: Advertiser
Default value: '0'
default site ID
size : 10
boolean $uses_site_codes
Ignored by: Advertiser
allows to use site codes
int $account_manager_id
account manager ID
size : 5
int $trafficker_contact_id
trafficker contact ID
size : 10
int $sales_region_id
size : 10
string $serving_domain
Ignored on add and update.
default serving domain ad to be served from
size : 50
int $simple_trafficking
Ignored by: Publisher
size : 3
boolean $uses_managed_entity_codes
Ignored by: Advertiser
int $default_managed_entity_id
default managed entity ID
size : 10
string $managed_entity_code
size : 50
string $time_zone
Ignored on add and update.
the entity time zone
size : 255
int $timezone_id
Default value: '1'
the entity time zone id
size : 3
267
Services
int $sections_share_channels
Ignored on add and update.
size : 1
int $pub_learn_percentage
Ignored by: Advertiser
Default value: '5'
size : 6
string $serving_name
Ignored by: Publisher
Default value: 'Yahoo Ad Exchange'
size : 255
string $default_publisher_billing_code
Ignored by: Publisher
size : 255
int $adserver_profile_id
size : 11
int $is_linkable
size : 1
int $language_id
Language ID. See Language table for additional information.
The complete list of enum values you can see at language enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'language').
size : 10
enum : language
int $target_profile_id
entity target profile ID
size : 8
string $content_domain
size : 50
int $log_predict_stats
size : 1
boolean $network_only_linking
boolean $can_create_managed_pubs
can the entity create managed publishers
boolean $allow_rmxd
int $business_contact_id
268
Services
business contact ID
size : 10
int $operations_contact_id
Ignored on add and update.
operations contact ID
size : 10
int $technical_contact_id
Ignored on add and update.
technical contact ID
size : 10
dateTime $lastupd
Ignored on add and update.
string $address1
Allowed to update by: Advertiser
the first line of the publisher's address
object : db_address
string $address2
Allowed to update by: Advertiser
the second line of the publisher's address
object : db_address
string $city
Allowed to update by: Advertiser
the entity city
object : db_address
int $region_id
Allowed to update by: Advertiser
Default value: '52'
The publisher region ID. See Region table for additional information.
The complete list of enum values you can see at region enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'region').
object : db_address
enum : region
string $zip
Allowed to update by: Advertiser
the publisher postal code
object : db_address
int $country_id
Allowed to update by: Advertiser
Default value: '1'
the publisher country ID. See Country table for additional information.
The complete list of enum values you can see at country enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'country').
object : db_address
enum : country
269
Services
int $finance_office_currency_id
Allowed to update by: Advertiser
Default value: '1'
size : 3
field : currency_id
object : db_finance_office
string $finance_office_billing_name
Ignored by: Advertiser
Allowed to update by: Publisher
size : 55
field : billing_name
object : db_finance_office
int $finance_contact_id
Allowed to update by: Advertiser
Default value: '0'
field : finance_contact_id
object : db_finance_office
string $entity_metadata_notes
nillable
field : notes
object : db_entity_metadata
string $integration_code
Ignored on add and update.
integration code
Once integration code has been set it allows you to lookup up for advertisers with that code. Please keep in mind that
content of this field cannot be set by PublisherService::add() and PublisherService::update() calls. To that end use
PublisherService::setIntegrationCode().
int $use_all_delivery_priorities
field : use_all_delivery_priorities
object : db_entity_custom_settings
int $allow_insert_objects_per_day
Ignored on add and update.
field : allow_insert_objects_per_day
object : db_entity_custom_settings
int $creative_tag_language_id
Ignored on update.
Language creative tag id
The complete list of enum values you can see at creative_tag_language enum page, at run time you can get all of
them using DictionaryService.getEnumValues(token, 'creative_tag_language').
size : 3
nillable
enum : creative_tag_language
string $shell_id
Default value: NULL
size : 19,0
nillable
270
Services
string $joliet_id
Default value: NULL
For internal use only.
size : 15
nillable
boolean $accepts_links
Default value: '1'
accepts links
boolean $can_see_reports
Default value: '1'
can see reports
string $age_querystring_key
Default value: NULL
age query string key
size : 20
nillable
string $year_of_birth_querystring_key
Default value: NULL
year of birth query string key
size : 20
nillable
string $gender_querystring_key
Default value: NULL
gender query string key
size : 20
nillable
string $gender_male_querystring_val
Default value: NULL
gender male query string value
size : 10
nillable
string $gender_female_querystring_val
Default value: NULL
gender female query string value
size : 10
nillable
int $adx_buyer_visibility_default
Default value: '1'
size : 1
int $content_buyer_visibility_default
Default value: '1'
Denote if Content Category buyer is by default visble to sellers.
size : 1
271
Services
boolean $is_rtbs
Ignored on update.
Can not be set for Advertiser
boolean $is_rtbd
Ignored on update.
Can not be set for Publisher
boolean $enable_rtbd
Default value: '0'
Can not be set for Advertiser
boolean $enable_rtbs
Default value: '0'
Can not be set for Publisher
float $default_seller_reserve_price
Default value: NULL
Default seller reserve price. Review Reserve Price and Setting reserve price using API in the Yield Manager
Knowledge Base for details on Reserve Price.
size : 17,5
nillable
boolean $allow_segment_selling
Default value: '0'
For internal use only
nillable
boolean $allow_segment_buying
Default value: '0'
For internal use only
nillable
boolean $allow_content_selling
Default value: '0'
For internal use only
nillable
boolean $allow_content_buying
Default value: '0'
For internal use only
nillable
entity_info
Used by the following call(s) and/or data type(s):
EntityService
getAdvByName()
getByIds()
getNetByName()
Fields Summary
$id Entity ID
$name Entity name
272
Services
Fields
int $id
Entity ID
string $name
Entity name
string $type
Entity Type (Publisher, Advertiser, Network)
entity_official_contacts
Fields Summary
$account_managers Account Managers array
$trafficker_persons Trafficker Persons array
$sales_persons Sales Persons array
$finance_contacts Finance Contacts array
$business_contacts Business Contacts array
$operations_contacts Operations Contacts array
$technical_contacts Technical Contacts array
Fields
array_of_contact $account_managers
Account Managers array
array_of_contact $trafficker_persons
Trafficker Persons array
array_of_contact $sales_persons
Sales Persons array
array_of_contact $finance_contacts
Finance Contacts array
array_of_contact $business_contacts
Business Contacts array
array_of_contact $operations_contacts
Operations Contacts array
array_of_contact $technical_contacts
Technical Contacts array
entity_shell
Used by the following call(s) and/or data type(s):
EntityService
getMapByShellIds()
Fields Summary
273
Services
$entity_id entity ID
$shell_id shell entity ID
Fields
int $entity_id
entity ID
string $shell_id
shell entity ID
exception_detail
Used by the following call(s) and/or data type(s):
ct_report_result
$exception_detail
multiple_data_response
$exception_detail
multiple_data_result
$exception_detail
multiple_result
$exception_detail
Fields Summary
$code data object code
$field_names
$solution
Fields
string $code
data object code
array_of_string $field_names
string $solution
ex_entity_ids
Used by the following call(s) and/or data type(s):
EntityService
addEx()
Fields Summary
$entity_id entity ID
$contact_id contact ID
$site_id site ID
$section_id section ID
$insertion_order_id insertion order ID
$line_item_id line item ID
Fields
int $entity_id
entity ID
274
Services
int $contact_id
contact ID
int $site_id
site ID
int $section_id
section ID
int $insertion_order_id
insertion order ID
int $line_item_id
line item ID
flash_info
Fields Summary
$is_high_risk
$click_tags
$click_urls
$file_size
$ad_height
$ad_width
$contains_audio
Fields
boolean $is_high_risk
array_of_string $click_tags
array_of_string $click_urls
int $file_size
int $ad_height
int $ad_width
boolean $contains_audio
gender
Used by the following call(s) and/or data type(s):
managed_supply
$gender
preferred_terms_managed_supply
$gender
supply
$gender
Fields Summary
275
Services
Fields
boolean $include_male_gender
Male gender.
display
boolean $include_female_gender
Female gender.
boolean $include_unknown_gender
Gender information is not available.
gender_target
Used by the following call(s) and/or data type(s):
TargetProfileService
getTargetGender()
TargetProfileService::getTargetGenderDepr()
setTargetGender()
TargetProfileService::setTargetGenderDepr()
Fields Summary
$include_male_gender show or not to show creatives to users of a male gender
$include_female_gender show or not to show creatives to users of a female gender
$include_unknown_gender show or not to show creatives to users when gender information is not
available
Fields
boolean $include_male_gender
show or not to show creatives to users of a male gender
boolean $include_female_gender
show or not to show creatives to users of a female gender
boolean $include_unknown_gender
show or not to show creatives to users when gender information is not available
get_ivc_hidden_params
This file defines ivc_hidden_params data type
DictionaryService
getIVCHiddenParameters()
Fields Summary
$control_type IVC profile control type.
$description Control type description
$hidden_parameters IVC hidden parameters for control types macro, rtbd, targeting.
276
Services
Fields
string $control_type
IVC profile control type.
string $description
Control type description
array_of_ivc_hidden_params_details $hidden_parameters
IVC hidden parameters for control types macro, rtbd, targeting.
getrtbdadminqpsresp
Fields Summary
$advertiserId Advertiser entity id
$region Region to which qps setting belongs to
$currentTime Current time as seen by the service
$qps Query Per Second (QPS) value
$lastUpdateTime Timestamp the object was last updated
Fields
int $advertiserId
Ignored on add and update.
Advertiser entity id
primary
string $region
Region to which qps setting belongs to
The complete list of enum values you can see at rtbd_region enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'rtbd_region').
enum : rtbd_region
primary
dateTime $currentTime
Ignored on add and update.
Current time as seen by the service
nillable
float $qps
Query Per Second (QPS) value
dateTime $lastUpdateTime
Ignored on add and update.
Timestamp the object was last updated
nillable
getrtbdqpsresp
Used by the following call(s) and/or data type(s):
RtbdService
277
Services
getQPS()
Fields Summary
$advertiserId Advertiser entity id
$region Region to which qps setting belongs to
$timeWindowLength Number of minutes QPS setting will be valid, starting from now. Default is "-1", and it
means qps setting will be valid forever
$lastUpdateTime Timestamp the object was last updated
$currentTime Current time as seen by the service
$qps Query Per Second (QPS) value
$windowExpirationTime qps expiration time based on time_window_length value
Fields
int $advertiserId
Ignored on add and update.
Advertiser entity id
primary
string $region
Region to which qps setting belongs to
The complete list of enum values you can see at rtbd_region enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'rtbd_region').
enum : rtbd_region
primary
int $timeWindowLength
Default value: '-1'
Number of minutes QPS setting will be valid, starting from now. Default is "-1", and it means qps setting will be valid
forever
dateTime $lastUpdateTime
Ignored on add and update.
Timestamp the object was last updated
nillable
dateTime $currentTime
Ignored on add and update.
Current time as seen by the service
nillable
float $qps
Query Per Second (QPS) value
dateTime $windowExpirationTime
Ignored on add and update.
qps expiration time based on time_window_length value
nillable
global_template
Used by the following call(s) and/or data type(s):
SitelistService
createGT()
278
Services
createGTs()
getAllGT()
getGT()
updateGT()
updateGTs()
Fields Summary
$id ID. Autoset on Sitelist creation.
$name Description of Sitelist.
$owner_id Sitelist owner id
$type Sitelist owner type
$active Sitelist active flag.
$locked Sitelist locked flag.
$created_on Sitelist creation time.
$sections section_custom_group sections
$notes additional information
$lastupd Sitelist last updated time.
$category Sitelist category
Fields
int $id
Ignored on add and update.
ID. Autoset on Sitelist creation.
size : 10
primary
string $name
Description of Sitelist.
size : 255
int $owner_id
Sitelist owner id
size : 10
enum_sitelist_type $type
Ignored on update.
Sitelist owner type
boolean $active
Default value: '1'
Sitelist active flag.
boolean $locked
Default value: '0'
Sitelist locked flag.
dateTime $created_on
Ignored on add and update.
Sitelist creation time.
array_of_int $sections
section_custom_group sections
string $notes
additional information
size : 1000
279
Services
dateTime $lastupd
Ignored on add and update.
Sitelist last updated time.
enum_sitelist_category $category
Ignored on update.
Default value: 'display'
Sitelist category
id_name
id data type
advertiser_list
$advertiser_custom_groups
$advertisers
creative_custom_object
$advertisers
$beacons
creative_properties
$creative_beacons
$creative_languages
$creative_specs
$creative_themes
creative_search_result
$advertiser
$beacons
$offer_type
$reviewed_by
publisher_list
$publisher_custom_groups
$publishers
rule_attribute
$id_name_list
trading_pit_creative_properties
$creative_beacons
$creative_languages
$creative_policy_tags
$creative_specs
$creative_themes
Fields Summary
$id Object id.
$name Object name.
Fields
int $id
Object id.
string $name
Ignored on add and update.
Object name.
insertion_order
Used by the following call(s) and/or data type(s):
InsertionOrderService
add()
280
Services
get()
getAll()
getAllSince()
getByBuyer()
getByBuyers()
getBySeller()
getBySellers()
update()
contract_history_item
$insertion_order
entity_data
$insertion_order
publisher_data
$insertion_order
Fields Summary
$billing_entity_id Entity ID of the managed advertiser under the buyer seat. See Brand level billing for
details.
$id Insertion order ID. Autoset on creation.
$description Client's description of insertion order.
$buyer_entity_id ID of buyer (advertiser or network).
$seller_entity_id ID of seller (network or publisher).
$bill_pricing_type Bill pricing type
$bill_amount Bill amount
$buyer_approved
$seller_approved
$buyer_auto_approval
$seller_auto_approval
$date_created Autoset at the call of InsertionOrderService::add() function
$date_approved
$po
$comment Any type of comments
$buyer_notes
$seller_notes
$seller_contact_id
$buyer_contact_id
$billing_contact_id
$exchange_rate
$payment_terms_days
$buyer_trafficker_id
$buyer_po_number
$internal_io_number
$invoice_remarks
$buyer_billing_code
$seller_billing_code
$linking_status Linking status.
$target_profile_id Target profile ID.
$lastupd
$payment_method_id Payment method id
$force_use_third_party_numbers Force billing on Third Party Numbers.
$budget Budget amount in currency. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency
specified by the owning entity's currency_id. If not set, unlimited budget is supposed.
$delivery_type Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are
listed in Delivery Type Enum.
$delivery_cap Max value for currency-capped delivery methods. For fixed-rate, this is in USD; for
dynamic-rate, this is in the currency specified by the owning entity's currency_id.
$imp_budget Budget by impressions
$imp_delivery_type Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are
listed in Imp Delivery Type Enum.
$imp_delivery_cap Max value for impression-capped delivery methods
$smooth When set to true, delivers budget/imps evenly or within caps (hourly/daily/weekly).
$booking_country_id For internal use only.
$use_ruby_billing For internal use only.
$advertiser_name For internal use only.
$ycrm_io_id For internal use only.
$advertiser_joliet_id For internal use only.
$discount_code For internal use only.
$buyer_sales_region_id For internal use only.
$seller_sales_region_id For internal use only.
$default_enable_rtbd
$default_enable_rtbs
$sfdc_comment
281
Services
Fields
int $billing_entity_id
Ignored on update.
Entity ID of the managed advertiser under the buyer seat. See Brand level billing for details.
int $id
Ignored on add and update.
Insertion order ID. Autoset on creation.
size : 10
primary
string $description
Default value: 'default description'
Client's description of insertion order.
size : 255
int $buyer_entity_id
Ignored on update.
ID of buyer (advertiser or network).
size : 10
int $seller_entity_id
Ignored on update.
ID of seller (network or publisher).
size : 10
string $bill_pricing_type
Default value: NULL
Bill pricing type
The complete list of enum values you can see at bill_pricing_type enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'bill_pricing_type').
nillable
enum : bill_pricing_type
float $bill_amount
Default value: '0'
Bill amount
size : 17,5
nillable
boolean $buyer_approved
Default value: '0'
boolean $seller_approved
Default value: '0'
boolean $buyer_auto_approval
Default value: '0'
boolean $seller_auto_approval
Default value: '0'
282
Services
dateTime $date_created
Ignored on add and update.
Autoset at the call of InsertionOrderService::add() function
nillable
dateTime $date_approved
nillable
string $po
size : 20
nillable
string $comment
Any type of comments
nillable
string $buyer_notes
nillable
string $seller_notes
nillable
int $seller_contact_id
size : 10
nillable
int $buyer_contact_id
size : 10
nillable
int $billing_contact_id
size : 10
nillable
float $exchange_rate
Ignored on add and update.
Default value: '1'
size : 10,4
int $payment_terms_days
Default value: '45'
size : 4
int $buyer_trafficker_id
size : 11
nillable
string $buyer_po_number
283
Services
size : 255
nillable
string $internal_io_number
size : 255
nillable
string $invoice_remarks
nillable
string $buyer_billing_code
size : 255
string $seller_billing_code
size : 255
string $linking_status
Ignored on add and update.
Default value: ''
Linking status.
The complete list of enum values you can see at linking_status enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'linking_status').
enum : linking_status
int $target_profile_id
Ignored on add and update.
Target profile ID.
size : 8
nillable
dateTime $lastupd
Ignored on add and update.
int $payment_method_id
Default value: '1'
Payment method id
size : 2
boolean $force_use_third_party_numbers
Default value: '0'
Force billing on Third Party Numbers.
float $budget
Budget amount in currency. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency specified by the
owning entity's currency_id. If not set, unlimited budget is supposed.
nillable
object : delivery_rules
enum_delivery_type $delivery_type
Default value: 'ASAP'
Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are listed in Delivery Type Enum.
284
Services
object : delivery_rules
float $delivery_cap
Max value for currency-capped delivery methods. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency
specified by the owning entity's currency_id.
nillable
object : delivery_rules
int $imp_budget
Budget by impressions
nillable
object : delivery_rules
enum_imp_delivery_type $imp_delivery_type
Default value: 'ASAP'
Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are listed in Imp Delivery Type
Enum.
object : delivery_rules
float $imp_delivery_cap
Max value for impression-capped delivery methods
nillable
object : delivery_rules
boolean $smooth
When set to true, delivers budget/imps evenly or within caps (hourly/daily/weekly).
object : delivery_rules
int $booking_country_id
Default value: NULL
For internal use only.
size : 11
nillable
int $use_ruby_billing
Default value: 0
For internal use only.
size : 1
string $advertiser_name
Default value: NULL
For internal use only.
size : 100
nillable
string $ycrm_io_id
Default value: NULL
For internal use only.
size : 30
nillable
string $advertiser_joliet_id
Default value: NULL
For internal use only.
285
Services
size : 15
nillable
float $discount_code
Default value: NULL
For internal use only.
nillable
int $buyer_sales_region_id
Default value: NULL
For internal use only.
size : 5
nillable
int $seller_sales_region_id
Default value: NULL
For internal use only.
size : 5
nillable
int $default_enable_rtbd
Default value: 0
size : 1
int $default_enable_rtbs
Default value: 0
size : 1
string $sfdc_comment
object : insertion_order_ext
inventory_media_type
See Inventory Media Type Enum for more information.
DictionaryService
getLineItemInventoryMediaType()
Fields Summary
$id Inventory media type id
$inventory_media_type Inventory media type
Fields
int $id
Inventory media type id
size : 3
primary
string $inventory_media_type
Inventory media type
286
Services
size : 255
inventory_type
See Inventory Type Enum for more information.
DictionaryService
getInventoryTypes()
Fields Summary
$id inventory type ID
$name inventory type name
Fields
int $id
inventory type ID
size : 10
primary
string $name
inventory type name
size : 50
inventory_visibility_controls
This file defines inventory_visibility_controls data type
InventoryVisibilityControlsService
add()
addProfiles()
get()
getProfiles()
update()
updateProfiles()
Fields Summary
$description IVC profile description
$buyer_entity_ids Advertiser entity ids on which publisher control mask is set. Value 0 in this array will set
publisher control mask globally i.e. at network level.
$hidden_params Parameters to be masked.
$top_level_domains Top level domains.
$profile_id IVC profile id
$owner_type Owner type
$owner_id Owner Id
$created_on Pub control mask creation time
$lastupd Pub control mask last update time
Fields
string $description
IVC profile description
nillable
287
Services
array_of_int $buyer_entity_ids
Advertiser entity ids on which publisher control mask is set. Value 0 in this array will set publisher control mask
globally i.e. at network level.
ivc_hidden_params $hidden_params
Parameters to be masked.
nillable
array_of_string $top_level_domains
Top level domains.
int $profile_id
Ignored on add and update.
IVC profile id
size : 10
primary
string $owner_type
Ignored on update.
Default value: 'entity'
Owner type
The complete list of enum values you can see at pub_control_owner_type enum page, at run time you can get all of
them using DictionaryService.getEnumValues(token, 'pub_control_owner_type').
enum : pub_control_owner_type
primary
int $owner_id
Ignored on update.
Owner Id
size : 10
primary
dateTime $created_on
Ignored on add and update.
Pub control mask creation time
dateTime $lastupd
Ignored on add and update.
Pub control mask last update time
isp
See Isp Enum for more information.
DictionaryService
getIsps()
Fields Summary
$id isp ID
$name isp name
Fields
288
Services
int $id
isp ID
size : 10
primary
string $name
isp name
size : 50
ivc_hidden_params_details
This file defines ivc_hidden_params data type
get_ivc_hidden_params
$hidden_parameters
Fields Summary
$parameter IVC hidden parameter name in database.
$display_name Display name of IVC hidden parameter.
Fields
string $parameter
IVC hidden parameter name in database.
string $display_name
Display name of IVC hidden parameter.
The complete list of enum values you can see at 4_enum_pub_control_param .pkg, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'pub_control_param ').
enum : pub_control_param
ivc_hidden_params
This file defines ivc_hidden_params data type
get_ivc_hidden_params
$hidden_parameters
inventory_visibility_controls
$hidden_params
Fields Summary
$macro_hidden_params IVC hidden parameter for control type 'macro'
$rtbd_hidden_params IVC hidden parameter for control type 'rtbd'
$targeting_hidden_params IVC hidden parameter for control type 'targeting'
Fields
macro_hidden_params $macro_hidden_params
IVC hidden parameter for control type 'macro'
nillable
289
Services
rtbd_hidden_params $rtbd_hidden_params
IVC hidden parameter for control type 'rtbd'
nillable
targeting_hidden_params $targeting_hidden_params
IVC hidden parameter for control type 'targeting'
nillable
language
See Language Enum for more information.
DictionaryService
getLanguages()
Fields Summary
$id language ID
$name language name
$iso_code language ISO code
Fields
int $id
language ID
size : 10
primary
string $name
language name
size : 50
string $iso_code
language ISO code
size : 2
last_creative_reviewer_details
Used by the following call(s) and/or data type(s):
demand_blocklist
$last_creative_reviewer_details
Fields Summary
$id contact id
$name contact name
$reviewed_on reviewed time.
$review_type Review type (approved, banned, review_further);
Fields
int $id
contact id
290
Services
string $name
contact name
dateTime $reviewed_on
reviewed time.
enum_review_status $review_type
Review type (approved, banned, review_further);
learn_type
See Learn Type Enum for more information.
DictionaryService
getLearnTypes()
Fields Summary
$id learn type ID
$name learn type name
Fields
int $id
learn type ID
size : 10
primary
string $name
learn type name
size : 50
line_item_adjustment
This file defines line_item_adjustment data type
AdjustmentService
get()
getAll()
getAllByLineItem()
getByBuyer()
getCreatedByDates()
set()
Fields Summary
$id Adjusted period's id
$line_item_id Line item id
$ymd_start Start date of adjusted period
$ymd_end End date of adjusted period
$value Value of adjusted period
$units Units of adjusted period
$adjustor_msg Adjustment message
$status Adjustment's status
$credit_comments Credit request, reason for credit comments
291
Services
Fields
int $id
Ignored on add and update.
Adjusted period's id
size : 10
primary
int $line_item_id
Ignored on add and update.
Default value: 0
Line item id
size : 10
date $ymd_start
Default value: 0000-00-00
Start date of adjusted period
date $ymd_end
Default value: 0000-00-00
End date of adjusted period
float $value
Default value: 0
Value of adjusted period
string $units
Default value: 'revenue'
Units of adjusted period
The complete list of enum values you can see at adjustments_units enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'adjustments_units').
nillable
enum : adjustments_units
string $adjustor_msg
Adjustment message
string $status
Default value: 'new'
Adjustment's status
The complete list of enum values you can see at adjustments_status enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'adjustments_status').
enum : adjustments_status
string $credit_comments
Ignored on add and update.
Default value: null
Credit request, reason for credit comments
nillable
292
Services
line_item_goal
Fields Summary
$conversion_id
$goal_amount Goal amount. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency
specified by the owning entity's currency_id.
Fields
int $conversion_id
size : 8
primary
float $goal_amount
Goal amount. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency specified by the owning entity's
currency_id.
size : 15,4
nillable
line_item
Used by the following call(s) and/or data type(s):
LineItemService
add()
get()
getAll()
getAllSince()
getByBuyer()
getByCampaign()
getByCreative()
getByInsertionOrder()
LineItemService::getByOrderDepr()
getBySeller()
setBillingStatus()
update()
contract_history_item
$line_items
entity_data
$line_item
placement
$line_item
publisher_data
$line_item
Fields Summary
$learning_slider Learning slider for line items with dynamic pricing and CPC or CPA target. Use learnin
slider to set learning preferences: Value ranges from 0 to 100, where 0 = least learning, 100 = most learning
Learn more for higher accuracy and delivery at a higher cost.
$delivery_clicks delivery clicks, can be set with only CPC pricing, with delivery type hourly/daily/monthly.
Valid types are listed in Delivery Type Enum.
$marketplace Parameters that need to select line item marketplace('trading_pit','network_of_network').
Available only for managed advertiser Line item.
$campaign Line item's campaign.
$suspended Line item suspended flag.
$id Line item ID. Autoset on creation.
$description Client's description of line item.
$comment Any type of comment
$insertion_order_id ID of insertion order, attached to campaign. Can be set by LineItemService::add()
function.
$pricing_type Pricing type, see valid types in Pricing Type Enum.
$amount Amount in currency for the pricing type. For fixed-rate, this is in USD; for dynamic-rate, this is in
the currency specified by the owning entity's currency_id.
293
Services
$bill_pricing_type Bill pricing type, see valid types in Bill Pricing Type Enum.
$bill_amount Bill amount in currency for the pricing type. For fixed-rate, this is in USD; for dynamic-rate,
this is in the currency specified by the owning entity's currency_id.
$active Line item activity flag.
$seller_approved seller approval flag
$buyer_approved buyer approval flag
$target_profile_id Target profile ID.
$delivery_rules_id Delivery rules ID. Autoset by the server when creating a new line item.
$delivery_adjustment Used only for discretionary pricing type and if use_third_party_numbers set to TRUE
to optimize and deliver effectively (fill in percentage). See Yahoo Ad Exchange Knowledge Base for details.
$use_third_party_numbers Used only for discretionary pricing type and if use_third_party_numbers set to
TRUE to optimize and deliver effectively. See Yahoo Ad Exchange Knowledge Base for details.
$show_advertisers
$show_creatives
$show_offer_types
$show_creative_specs
$show_deal_properties
$conversion_id For CPA line items only.
$do_price_reduction For dynamic and second price CPC line items only. Default value of this field for
dynamic line items is 1. For second price CPC line items default value is 0.See Using the line_item data type
to set up dynamic pricing options for details.
$always_bid_the_maximum Specify 'true' for Dynamic Pricing Option "Win at all costs". For more
information refer to KB Article: https://kb.yieldmanager.com/article.php?id=259
$is_hard_target Set to TRUE for CPC or CPA targeted line items. See Yahoo Ad Exchange Knowledge
Base for details.
$buyer_sales_region_id
$created_on
$seller_sales_region_id
$minimum_ecpm
$using_minimum_seller_ecpm
$buyer_minimum_profit_ecpm
$seller_maximum_adjustment_percentage
$buyer_maximum_discrepancy_percentage
$buyer_code
$buyer_code2
$seller_code
$priority Line item priority.
$allow_size_promotion
$start_time Start date and time (UTC) for line item, campaign or creative. If not set, current time is
assumed.
$end_time Line item end date and time (UTC).
$budget Budget by currency. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency
specified by the owning entity's currency_id. If not set, unlimited budget is assumed. If set then it has to be
non-zero.
$delivery_type Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are
listed in Delivery Type Enum.
$delivery_cap Max value for currency-capped delivery methods. For fixed-rate, this is in USD; for
dynamic-rate, this is in the currency specified by the owning entity's currency_id.
$imp_budget Budget by impressions
$imp_delivery_type Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are
listed in Delivery Type Enum.
$imp_delivery_cap Max value for impression capped delivery methods
$tz_to_show Specifies the time zone to use for start and end flight dates. See Flight dates for more
details.
$smooth When set to true, delivers budget/imps evenly over remainder of campaign or within caps
(hourly/daily/weekly).
$convert_cpx_to_dcpm Convert CPX to dCPM pricing
$allow_convert_cpx_to_dcpm Allow convert CPX to dCPM pricing
$first_ran_date
$last_ran_date
$roi_modifier Line Item ROI modifier
$broker_fee_type Broker fee type
$broker_fee_amount Broker fee amount
$discretionary_cpm Discretionary cpm
$ecpm_calculation_method Ecpm calculation method
$ym_numbers_difference Ym numbers difference, field value NOT returned.
$effective_price Effective price
$lastupd
$line_item_goals Line item's goals
$show_to_linked_sellers Flag to select one of showing mode
$is_rtbs
$is_rtbd
$enable_rtbd
294
Services
$enable_rtbs
$seller_reserve_price Seller reserve price. Review Reserve Price and Setting reserve price using API in
the Yield Manager Knowledge Base for details on Reserve Price.
$exempt_from_io_freq_cap If set to 1, the insertion_order frequency cap target constraint will not be
applicable to this line_item.
$type_id Line Item type id for Display or Video see Media Type Table for additional information.
Fields
float $learning_slider
Learning slider for line items with dynamic pricing and CPC or CPA target. Use learnin slider to set learning
preferences: Value ranges from 0 to 100, where 0 = least learning, 100 = most learning Learn more for higher
accuracy and delivery at a higher cost.
Learn less to spend less, but with lower accuracy and delivery.
nillable
int $delivery_clicks
delivery clicks, can be set with only CPC pricing, with delivery type hourly/daily/monthly. Valid types are listed in
Delivery Type Enum.
nillable
array_of_enum_marketplace $marketplace
Parameters that need to select line item marketplace('trading_pit','network_of_network'). Available only for managed
advertiser Line item.
campaign $campaign
Line item's campaign.
Campaign object associated with line item, it can be used in add/update operation to update the value of campaign.
object : campaign
boolean $suspended
Ignored on add and update.
Line item suspended flag.
int $id
Ignored on add and update.
Line item ID. Autoset on creation.
size : 10
primary
string $description
Default value: 'default description'
Client's description of line item.
size : 255
string $comment
Any type of comment
size : 1000
nillable
int $insertion_order_id
Ignored on update.
ID of insertion order, attached to campaign. Can be set by LineItemService::add() function.
size : 10
295
Services
string $pricing_type
Default value: 'CPM'
Pricing type, see valid types in Pricing Type Enum.
The complete list of enum values you can see at pricing_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'pricing_type').
enum : pricing_type
float $amount
Default value: '0'
Amount in currency for the pricing type. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency specified
by the owning entity's currency_id.
size : 17,5
string $bill_pricing_type
Default value: NULL
Bill pricing type, see valid types in Bill Pricing Type Enum.
The complete list of enum values you can see at bill_pricing_type enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'bill_pricing_type').
enum : bill_pricing_type
float $bill_amount
Default value: '0'
Bill amount in currency for the pricing type. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency
specified by the owning entity's currency_id.
size : 17,5
boolean $active
Default value: '0'
Line item activity flag.
boolean $seller_approved
Default value: '0'
seller approval flag
boolean $buyer_approved
Default value: '0'
buyer approval flag
int $target_profile_id
Ignored on add and update.
Target profile ID.
size : 8
nillable
int $delivery_rules_id
Ignored on add and update.
Delivery rules ID. Autoset by the server when creating a new line item.
size : 10
nillable
int $delivery_adjustment
Used only for discretionary pricing type and if use_third_party_numbers set to TRUE to optimize and deliver effectively
(fill in percentage). See Yahoo Ad Exchange Knowledge Base for details.
Please take into account that this field is connected to 'higher/lower than YM values' field in UI, the next logic is
followed: if you enter 40% and pick 'lower than YM numbers' the number save in delivery_adjustment is 100% - 40% =
296
Services
60%, if you enter 150% and pick 'higher than YM numbers' the number save in delivery_adjustment is 100% + 150% =
250% (value 100 is 100%)
size : 10,5
nillable
boolean $use_third_party_numbers
Default value: '0'
Used only for discretionary pricing type and if use_third_party_numbers set to TRUE to optimize and deliver
effectively. See Yahoo Ad Exchange Knowledge Base for details.
boolean $show_advertisers
Default value: '0'
boolean $show_creatives
Default value: '0'
boolean $show_offer_types
Default value: '0'
boolean $show_creative_specs
Default value: '0'
boolean $show_deal_properties
Default value: '0'
int $conversion_id
Default value: '0'
For CPA line items only.
size : 8
boolean $do_price_reduction
Default value: '1'
For dynamic and second price CPC line items only. Default value of this field for dynamic line items is 1. For second
price CPC line items default value is 0.See Using the line_item data type to set up dynamic pricing options for details.
boolean $always_bid_the_maximum
Default value: '0'
Specify 'true' for Dynamic Pricing Option "Win at all costs". For more information refer to KB Article:
https://kb.yieldmanager.com/article.php?id=259
boolean $is_hard_target
Default value: '1'
Set to TRUE for CPC or CPA targeted line items. See Yahoo Ad Exchange Knowledge Base for details.
int $buyer_sales_region_id
size : 5
nillable
dateTime $created_on
Ignored on update.
nillable
int $seller_sales_region_id
size : 5
nillable
297
Services
float $minimum_ecpm
Default value: 0
boolean $using_minimum_seller_ecpm
Default value: '0'
float $buyer_minimum_profit_ecpm
Default value: NULL
float $seller_maximum_adjustment_percentage
Ignored on add and update.
size : 10,5
float $buyer_maximum_discrepancy_percentage
Ignored on add and update.
size : 10,5
string $buyer_code
size : 16
nillable
string $buyer_code2
size : 16
nillable
string $seller_code
size : 16
nillable
enum_priority $priority
Default value: 'Normal' Please see Delivery priority options for assistance with setting priority correctly for your line
item(s).
Line item priority.
boolean $allow_size_promotion
Default value: '1'
dateTime $start_time
Start date and time (UTC) for line item, campaign or creative. If not set, current time is assumed.
nillable
object : delivery_rules
dateTime $end_time
Line item end date and time (UTC).
If you leave this field unset or set it to null, it is equal to "never" value in UI. If you want to prevent a line item from
being trafficked, this field should be set to today and active to 0.
nillable
object : delivery_rules
float $budget
Budget by currency. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency specified by the owning
entity's currency_id. If not set, unlimited budget is assumed. If set then it has to be non-zero.
298
Services
nillable
object : delivery_rules
string $delivery_type
Default value: 'ASAP'
Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are listed in Delivery Type Enum.
The complete list of enum values you can see at delivery_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'delivery_type').
enum : delivery_type
object : delivery_rules
float $delivery_cap
Max value for currency-capped delivery methods. For fixed-rate, this is in USD; for dynamic-rate, this is in the currency
specified by the owning entity's currency_id.
nillable
object : delivery_rules
int $imp_budget
Budget by impressions
nillable
object : delivery_rules
string $imp_delivery_type
Default value: 'ASAP'
Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are listed in Delivery Type Enum.
The complete list of enum values you can see at imp_delivery_type enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'imp_delivery_type').
enum : imp_delivery_type
object : delivery_rules
float $imp_delivery_cap
Max value for impression capped delivery methods
nillable
object : delivery_rules
string $tz_to_show
Default value: 'America/New_York'
Specifies the time zone to use for start and end flight dates. See Flight dates for more details.
object : delivery_rules
boolean $smooth
Default value: '1'
When set to true, delivers budget/imps evenly over remainder of campaign or within caps (hourly/daily/weekly).
object : delivery_rules
boolean $convert_cpx_to_dcpm
Default value: '0'
Convert CPX to dCPM pricing
boolean $allow_convert_cpx_to_dcpm
Default value: '0'
Allow convert CPX to dCPM pricing
299
Services
dateTime $first_ran_date
Ignored on add and update.
dateTime $last_ran_date
Ignored on add and update.
float $roi_modifier
Default value: '100'
Line Item ROI modifier
string $broker_fee_type
Default value: 'Percent'
Broker fee type
The complete list of enum values you can see at fee_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'fee_type').
field : fee_type
enum : fee_type
object : line_item_broker
float $broker_fee_amount
Broker fee amount
size : 17,5
nillable
field : amount
object : line_item_broker
float $discretionary_cpm
Default value: null
Discretionary cpm
size : 17,5
nillable
string $ecpm_calculation_method
Ignored on add and update.
Default value: '3-day'
Ecpm calculation method
enum_ym_numbers_difference $ym_numbers_difference
Default value: NULL
Ym numbers difference, field value NOT returned.
Setting lower/higher modifies the value of delivery_adjustment (please check delivery_adjustment field docs)
nillable
float $effective_price
Ignored on add and update.
Effective price
dateTime $lastupd
Ignored on add and update.
array_of_line_item_goal $line_item_goals
Line item's goals
nillable
field : campaign_goals
object : campaign
300
Services
string $show_to_linked_sellers
Default value: 'All Publishers'
Flag to select one of showing mode
The complete list of enum values you can see at line_item_show_to_linked_sellers enum page, at run time you can
get all of them using DictionaryService.getEnumValues(token, 'line_item_show_to_linked_sellers').
size : 1
enum : line_item_show_to_linked_sellers
boolean $is_rtbs
Default value: 0
boolean $is_rtbd
Default value: 0
boolean $enable_rtbd
Default value: 0
boolean $enable_rtbs
Default value: 0
float $seller_reserve_price
Default value: NULL
Seller reserve price. Review Reserve Price and Setting reserve price using API in the Yield Manager Knowledge Base
for details on Reserve Price.
size : 17,5
boolean $exempt_from_io_freq_cap
Default value: NULL
If set to 1, the insertion_order frequency cap target constraint will not be applicable to this line_item.
int $type_id
Default value: 1
Line Item type id for Display or Video see Media Type Table for additional information.
link_data
Used by the following call(s) and/or data type(s):
LinkingService
getAllLinks()
getAppliedLinks()
getLinkData()
getLinkableEntityData()
getLinkedEntityData()
getNonlinkedEntityData()
getProposedLinks()
Fields Summary
$id link data object ID
$entity contains the entity object
$linking_profile contains the linking profile
$ratings contains the average rating values
$user_ratings contains the average rating values made by requester if there is an approved link
$sections contains the array of sections
$billing_entity_id Entity ID of the managed advertiser under the buyer seat. Applicable when sending the
billing links, otherwise zero. See Brand level billing for additional details.
$link_status Status of the link
$insertion_order_id Insertion order ID.
301
Services
Fields
int $id
Ignored on add and update.
link data object ID
entity $entity
Ignored on add and update.
contains the entity object
linking_profile $linking_profile
Ignored on add and update.
contains the linking profile
linking_rating $ratings
Ignored on add and update.
contains the average rating values
linking_rating $user_ratings
Ignored on add and update.
contains the average rating values made by requester if there is an approved link
array_of_string $sections
Ignored on add and update.
contains the array of sections
int $billing_entity_id
Ignored on update.
Entity ID of the managed advertiser under the buyer seat. Applicable when sending the billing links, otherwise zero.
See Brand level billing for additional details.
string $link_status
Ignored on add and update.
Status of the link
int $insertion_order_id
Ignored on add and update.
Insertion order ID.
linked_entities_info
Used by the following call(s) and/or data type(s):
InsertionOrderService
getLinkedInfo()
Fields Summary
$buyer_entity_id Entity ID of buyer (advertiser or network).
$buyer_name Name of buyer (advertiser or network).
$seller_entity_id Entity ID of seller (network or publisher).
$seller_name Name of seller (network or publisher).
$seller_integration_code
$buyer_integration_code
$billing_entity_id Entity ID of the managed advertiser under the buyer seat. See Brand level billing for
details.
Fields
302
Services
int $buyer_entity_id
Entity ID of buyer (advertiser or network).
string $buyer_name
Name of buyer (advertiser or network).
int $seller_entity_id
Entity ID of seller (network or publisher).
string $seller_name
Name of seller (network or publisher).
string $seller_integration_code
string $buyer_integration_code
int $billing_entity_id
Entity ID of the managed advertiser under the buyer seat. See Brand level billing for details.
linking_profile
Used by the following call(s) and/or data type(s):
LinkingService
addProfile()
getProfile()
updateProfile()
link_data
$linking_profile
Fields Summary
$entity_id entity ID
$company_name the company name
$description additional information
$iso_adv advertiser Independent Sales Organization
$iso_pub publisher Independent Sales Organization
$logo_url
$avg_rating the average rating value
$status
$adv_contact_id the advertiser contact ID
$pub_contact_id the publisher contact ID
$date_created the creation date
$revenue_share the amount of revenue share
$minimum_payout the minimum payout
$company_website the company website
$pub_contact_email_address
$payment_terms
$payment_methods
$rmxd_pub_contact_email
Fields
int $entity_id
entity ID
size : 10
primary
string $company_name
the company name
303
Services
size : 100
string $description
additional information
string $iso_adv
advertiser Independent Sales Organization
nillable
string $iso_pub
publisher Independent Sales Organization
nillable
string $logo_url
size : 127
nillable
float $avg_rating
Default value: '0'
the average rating value
boolean $status
Default value: '1'
int $adv_contact_id
the advertiser contact ID
size : 10
nillable
int $pub_contact_id
the publisher contact ID
size : 10
nillable
dateTime $date_created
Ignored on add and update.
the creation date
float $revenue_share
Default value: '0'
the amount of revenue share
float $minimum_payout
Default value: '0'
the minimum payout
string $company_website
the company website
size : 255
nillable
string $pub_contact_email_address
Ignored on add and update.
304
Services
nillable
int $payment_terms
size : 6
nillable
array_of_payment_method $payment_methods
nillable
string $rmxd_pub_contact_email
size : 50
nillable
linking_rating
Used by the following call(s) and/or data type(s):
link_data
$ratings
$user_ratings
Fields Summary
$overall the average value of common rating
$trust the average value of trust rating
$cpm the average value of cpm rating
$timely_payout the average value of timely payout rating
$support the average value of support rating
Fields
float $overall
Ignored on add and update.
the average value of common rating
float $trust
the average value of trust rating
float $cpm
the average value of cpm rating
float $timely_payout
the average value of timely payout rating
float $support
the average value of support rating
305
Services
login_options
Used by the following call(s) and/or data type(s):
ContactService
login()
Fields Summary
$errors_level errors level
$use_master_db use master db for reads (always)
$language_code The complete list of enum values you can see at language_iso_code enum page, at run
time you can get all of them using DictionaryService.getEnumValues(token, 'language_iso_code').
$multiple_sessions This flag is relevant only when this login would cause the entity's limit on maximum
concurrent sessions to be exceeded. Specifically, it controls login's behavior with respect to other currently
active API user sessions.
Fields
enum_errors_level $errors_level
Default value: 'throw_errors'
errors level
boolean $use_master_db
Default value: false
use master db for reads (always)
string $language_code
Default value: 'en'
The complete list of enum values you can see at language_iso_code enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'language_iso_code').
enum : language_iso_code
boolean $multiple_sessions
Default value: false if entity is limited to 1 concurrent session, else true
This flag is relevant only when this login would cause the entity's limit on maximum concurrent sessions to be
exceeded. Specifically, it controls login's behavior with respect to other currently active API user sessions.
If false, and this login would cause the entity's limit on maximum concurrent sessions to be exceeded, then login will
first logout all (and only) API sessions belonging to the same contact, and then will create a new session. All the
sessions owned by other contacts of the same entity will remain untouched and other contacts may continue to use
them.
If true, and this login would cause the entity's limit on maximum concurrent sessions to be exceeded, then login will
fail. For this reason, it is important that customers using this flag be sure to call logout to close all sessions that were
created by their API client program. Otherwise, currently open sessions will remain active and count towards your
entity's limit on maximum concurrent sessions, thus blocking other API client programs that run under your entity.
Contact API Support at yax-api@yahoo-inc.com if you need to increase your entity's limit on maximum concurrent
sessions.
macro_hidden_params
This file defines ivc_hidden_params data type
ivc_hidden_params
$macro_hidden_params
Fields Summary
306
Services
Fields
boolean $channels
Default value: '0'
IVC hidden parameter for channels.
boolean $url
Default value: '0'
IVC hidden parameter for URL.
boolean $publisher_id
Default value: '0'
IVC hidden parameter for publisher ID.
boolean $section_id
Default value: '0'
IVC hidden parameter for section ID.
boolean $section_code
Default value: '0'
IVC hidden parameter for section code.
boolean $site_id
Default value: '0'
IVC hidden parameter for site ID.
boolean $age
Default value: '0'
IVC hidden parameter for age.
boolean $gender
Default value: '0'
IVC hidden parameter for gender.
boolean $ip
Default value: '0'
IVC hidden parameter for IP.
boolean $content_segments
Default value: '0'
IVC hidden parameter for content segments.
managed_demand
managed data type
307
Services
supply_blocklist
$managed_demand
Fields Summary
$buying_technology Array of buying technology RTBD, Hosted.
$managed_advertisers Managed advertisers.
$deal_properties Deal properties.
Fields
array_of_enum_buying_technology $buying_technology
Array of buying technology RTBD, Hosted.
advertiser_list $managed_advertisers
Managed advertisers.
rule_deal_properties $deal_properties
Deal properties.
managed_supply
managed data type
demand_blocklist
$managed_supply
Fields Summary
$managed_publishers Managed publishers.
$sections Sections.
$sizes Sizes.
$woeids Woeids.
$cga_ids Custom geo area ids.
$devices Devices.
$browsers Browsers.
$operating_systems Operating systems.
$carrier_isp Carrier ISP.
$channels Channels.
$selling_technology Array of selling technology RTBS, Hosted
$gender Gender - Male, female, unknown.
$ages Ages to included or excluded.
Fields
publisher_list $managed_publishers
Managed publishers.
rule_attribute $sections
Sections.
rule_attribute $sizes
Sizes.
rule_attribute $woeids
Woeids.
rule_attribute $cga_ids
Custom geo area ids.
308
Services
rule_attribute $devices
Devices.
rule_attribute $browsers
Browsers.
rule_attribute $operating_systems
Operating systems.
rule_attribute $carrier_isp
Carrier ISP.
rule_attribute $channels
Channels.
array_of_enum_selling_technology $selling_technology
Array of selling technology RTBS, Hosted
gender $gender
Gender - Male, female, unknown.
rule_attribute_ids $ages
Ages to included or excluded.
managing_entity_ids
managing_entity_ids data type.
Fields Summary
$entity_id
$managing_entity_name
$managing_entity_id
Fields
int $entity_id
string $managing_entity_name
nillable
int $managing_entity_id
nillable
marketplace_settings
Fields Summary
$trading_pit_buyer Indicates if the seat is in Trading pit as buyer
$trading_pit_seller Indicates if the seat is in Trading pit as seller
$network_of_network Indicates if the seat is NoN (ie, linked) marketplace
$trading_pit_rev_cap Trading pit Max supply limits. Unlimited if null.
$trading_pit_spend_cap Trading pit Max demand limits. Unlimited if null.
$trading_pit_active Indicates if the seat is active for transactions on Trading pit
309
Services
Fields
boolean $trading_pit_buyer
Default value: '0'
Indicates if the seat is in Trading pit as buyer
boolean $trading_pit_seller
Default value: '0'
Indicates if the seat is in Trading pit as seller
boolean $network_of_network
Default value: '0'
Indicates if the seat is NoN (ie, linked) marketplace
float $trading_pit_rev_cap
Trading pit Max supply limits. Unlimited if null.
nillable
float $trading_pit_spend_cap
Trading pit Max demand limits. Unlimited if null.
nillable
boolean $trading_pit_active
Default value: '0'
Indicates if the seat is active for transactions on Trading pit
array_of_tp_billing_entity_preferences $buyer_tpbe_prefs
Buyer TPBE preferences
array_of_tp_billing_entity_preferences $seller_tpbe_prefs
Seller TPBE preferences
entity_broker_fee $intra_network_fee
Intra network fee
array_of_tiered_rev_share $buyer_tiered_rev_share
Buyer tiered rev share.
array_of_tiered_rev_share $seller_tiered_rev_share
Seller tiered rev share.
int $entity_id
Ignored on update.
Entity ID of the seat
310
Services
size : 10
primary
float $trading_pit_supply_fee_amount
Default value: 0.0
Trading pit supply fee - rev share or flat ecpm. Rev share supported as of now.
size : 7,4
float $trading_pit_demand_fee_amount
Default value: 0.0
Trading pit demand fee - rev share or flat ecpm. Rev share supported as of now.
size : 7,4
int $trading_pit_buyer_contracting_entity_id
Contracting Entity ID of the buyer seat
size : 10
int $trading_pit_seller_contracting_entity_id
Contracting Entity ID of the seller seat
size : 10
boolean $set_buyer_tiered_rev_share
Default value: '0'
Flag to indicate tiered rev share is set up for buyer.
boolean $set_seller_tiered_rev_share
Default value: '0'
Flag to indicate tiered rev share is set up for seller.
media_type
See Media Type Enum for more information.
DictionaryService
getMediaTypes()
Fields Summary
$id media type ID
$description media type description
Fields
int $id
media type ID
size : 5
primary
string $description
media type description
size : 50
311
Services
mg_label_mapping
Used by the following call(s) and/or data type(s):
DictionaryService
getMGLabelMappings()
Fields Summary
$creative_tag_id
$adult_or_suggestive
$distracting_or_flashing
$deceptive
$drugs_or_alcohol
$gambling
$profanity_or_violence
$crude
$opencat
$always_banned
Fields
int $creative_tag_id
size : 5
primary
boolean $adult_or_suggestive
boolean $distracting_or_flashing
boolean $deceptive
boolean $drugs_or_alcohol
boolean $gambling
boolean $profanity_or_violence
int $crude
size : 1
boolean $opencat
boolean $always_banned
mime_type
See 4_enum_video_mime_type.pkg for more information.
Fields Summary
$id Mime type ID
$mime_type mime type name
$video_type video type name
Fields
312
Services
int $id
Mime type ID
size : 3
primary
string $mime_type
mime type name
size : 30
string $video_type
video type name
size : 100
msa
See Msa Enum for more information.
DictionaryService
getMsas()
Fields Summary
$id msa ID
$name msa name
$country_id msa country ID
$region_ids The list of regions attached to the MSA.
Fields
int $id
msa ID
size : 5
primary
string $name
msa name
size : 50
int $country_id
msa country ID
size : 5
array_of_int $region_ids
The list of regions attached to the MSA.
multiple_data_response
multiple_data_response data type
PixelService
313
Services
getShareForSegments()
SegmentService
getAncestorsInfo()
getAncestorsPublicInfo()
getDescendantsPublicInfo()
Fields Summary
$resultIDs array of identifiers to specific response objects
$result
$exception_detail
$exception_text
$item_id
Fields
array_of_int $resultIDs
array of identifiers to specific response objects
boolean $result
exception_detail $exception_detail
string $exception_text
int $item_id
multiple_data_result
Used by the following call(s) and/or data type(s):
AdvertiserDomainService
add()
delete()
deleteByUrls()
update()
CampaignService
addCreatives()
deleteCampaigns()
CreativeService
addAttach()
addAttachCreatives()
addCreatives()
deleteCreatives()
triggerCreativeTest()
EntityService
deleteAllPublisherControls()
deleteEntities()
setAllPublisherControls()
InsertionOrderService
deleteInsertionOrders()
InventoryVisibilityControlsService
addProfiles()
deleteProfiles()
updateProfiles()
LineItemService
addCreatives()
deleteLineItems()
NotificationService
NotificationService::validateTMReport()
PassbackService
activatePassbacks()
deactivatePassbacks()
deletePassbacks()
314
Services
PixelService
deletePixels()
PublisherReservePriceService
addProfiles()
deleteProfiles()
updateProfiles()
ReportService
addSegmentReportVisibility()
updateSegmentReportVisibility()
SiteService
deleteAllPublisherControls()
setAllPublisherControls()
SitelistService
createASLs()
createGTs()
updateASLs()
updateGTs()
Fields Summary
$result
$exception_detail
$exception_text
$item_id
Fields
boolean $result
exception_detail $exception_detail
string $exception_text
int $item_id
multiple_result
Used by the following call(s) and/or data type(s):
TargetProfileService
deleteTargetClickUrls()
deleteTargetCreatives()
setTargetClickUrlsV2()
Fields Summary
$result
$exception_detail
$exception_text
$item
Fields
int $result
exception_detail $exception_detail
string $exception_text
string $item
315
Services
netspeed
See Netspeed Enum for more information.
DictionaryService
getNetspeeds()
Fields Summary
$id netspeed ID
$name netspeed name
Fields
int $id
netspeed ID
size : 5
primary
string $name
netspeed name
size : 50
notice
Used by the following call(s) and/or data type(s):
NotificationService
getNotices()
Fields Summary
$id The id of the notification message
$head The head of the notification message
$body The text of the notification message
Fields
int $id
Ignored on add and update.
The id of the notification message
string $head
Ignored on add and update.
The head of the notification message
string $body
Ignored on add and update.
The text of the notification message
316
Services
offer_type
See Offer Type Enum for more information.
DictionaryService
getOfferTypes()
Fields Summary
$id offer type ID
$parent_id Parent offer type ID. Offer types are organized in 2 level hierarchy. This field indicates the
parent offer type id.
$description offer type description
$long_description offer type long description
Fields
int $id
offer type ID
size : 10
primary
int $parent_id
Default value: NULL
Parent offer type ID. Offer types are organized in 2 level hierarchy. This field indicates the parent offer type id.
The value is null if the offer type is first level, and non-null for 2nd level offer type.
size : 10
string $description
offer type description
size : 255
string $long_description
offer type long description
size : 255
optimization_config
See Browser Enum for more information.
Fields Summary
$bucketId optimization_config object bucketId
$paraNameId optimization_config object paraNameId
$bucketStart optimization_config object bucket start time
$bucketEnd optimization_config object bucket end time
$paraValue optimization_config object para value
Fields
int $bucketId
Ignored on add and update.
optimization_config object bucketId
size : 10
primary
317
Services
int $paraNameId
Ignored on add and update.
optimization_config object paraNameId
size : 4
primary
dateTime $bucketStart
Ignored on add and update.
optimization_config object bucket start time
primary
dateTime $bucketEnd
Ignored on add and update.
optimization_config object bucket end time
primary
string $paraValue
optimization_config object para value
size : 64
optimization_para_name
See Browser Enum for more information.
Fields Summary
$id optimization_para_name ID
$paraName optimization_para_name object paraName
$description optimization_para_name object description
Fields
int $id
Ignored on add and update.
optimization_para_name ID
size : 4
primary
string $paraName
Default value: 'paraname'
optimization_para_name object paraName
size : 32
string $description
Default value: 'default description'
optimization_para_name object description
size : 64
passback
Used by the following call(s) and/or data type(s):
PassbackService
318
Services
add()
get()
getAll()
update()
Fields Summary
$id ID. Autoset on passback creation.
$owner_type Passback owner type
$passback_type Passback type
$owner_id Passback owner id
$size_id Passback size id
$is_secure Passback secure
$content Passback content
$description Description of passback.
$media_type content media type. See Media Type Enum for more information.
$media_url redirect URL to get the content
$active Passback active flag.
$entity_id entity id associated with the passback.
$created_on Passback creation time.
Fields
int $id
Ignored on add and update.
ID. Autoset on passback creation.
size : 10
primary
enum_passback_creative_owner_type $owner_type
Ignored on update.
Passback owner type
enum_passback_creative_type $passback_type
Passback type
array_of_int $owner_id
Passback owner id
int $size_id
Passback size id
boolean $is_secure
Passback secure
string $content
Passback content
string $description
Description of passback.
string $media_type
content media type. See Media Type Enum for more information.
The complete list of enum values you can see at media_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'media_type').
enum : media_type
string $media_url
redirect URL to get the content
319
Services
boolean $active
Default value: '1'
Passback active flag.
int $entity_id
Ignored on update.
entity id associated with the passback.
size : 10
dateTime $created_on
Ignored on add and update.
Passback creation time.
payment_method
Used by the following call(s) and/or data type(s):
linking_profile
$payment_methods
Fields Summary
$id payment method ID
$description payment method description
Fields
int $id
payment method ID
size : 2
primary
string $description
payment method description
size : 100
piggyback_pixel
Used by the following call(s) and/or data type(s):
PixelService
addPiggybackPixel()
getAllPiggybackPixelsSince()
getPiggybackPixels()
Fields Summary
$id
$entity_id The entity ID the pixel is bound to.
$pixel_redirect_url URL which will be used when a conversion is triggered
$pixel_type type of the pixel.
$lastupd
Fields
int $id
Ignored on add and update.
320
Services
size : 10
primary
int $entity_id
Ignored on update.
The entity ID the pixel is bound to.
size : 10
nillable
string $pixel_redirect_url
URL which will be used when a conversion is triggered
size : 255
string $pixel_type
type of the pixel.
The complete list of enum values you can see at pixel_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'pixel_type').
enum : pixel_type
dateTime $lastupd
Ignored on add and update.
nillable
pixel
Used by the following call(s) and/or data type(s):
CreativeService
getAttachedSegments()
PixelService
add()
get()
getAll()
getAllSince()
getByEntity()
getByLineItem()
getSegments()
update()
Fields Summary
$is_network_wide Set to 1 if pixel is network-wide
$id pixel ID
$public_segment_id public segment ID
$name pixel name
$integration_code integration code - once an integration code has been set it allows you to lookup up for
pixels with that code
$active Active flag. Deactivating any segment pixel that you have shared via Audience Share will remove
the corresponding segment shares, and thus will deactivate any line items -- except your own -- that are
targeting this pixel and notify their owners. See Sharing or unsharing segments in the Audience marketplace
for details.
$repeat_ignore_interval repeat ignore interval
$post_click_interval post click interval
$post_view_interval post view interval
$segment_duration Segment duration
$include_by_default included by default flag
$advertiser_entity_id advertiser entity id the pixel is bound to
$exchange_rate exchange rate of the currency (if not in dollars)
321
Services
Fields
int $is_network_wide
Ignored on add and update.
Set to 1 if pixel is network-wide
int $id
Ignored on add and update.
pixel ID
size : 8
primary
int $public_segment_id
Ignored on add and update.
Default value: null
public segment ID
size : 8
nillable
string $name
pixel name
size : 255
string $integration_code
integration code - once an integration code has been set it allows you to lookup up for pixels with that code
boolean $active
Active flag. Deactivating any segment pixel that you have shared via Audience Share will remove the corresponding
segment shares, and thus will deactivate any line items -- except your own -- that are targeting this pixel and notify
their owners. See Sharing or unsharing segments in the Audience marketplace for details.
int $repeat_ignore_interval
Default value: '0'
repeat ignore interval
size : 10
int $post_click_interval
post click interval
size : 11
nillable
int $post_view_interval
322
Services
size : 11
nillable
int $segment_duration
Default value: 0
Segment duration
This field's purpose - pixel expiration/duration period if pixel type is segment. It can be set for segment pixels only.
Pixel treated as as segment when post_click_interval = 0 and post_view_interval = 0. Valid range is 0..2 years (value
is stored in seconds, so the valid range is 0..63072000)
size : 8
nillable
boolean $include_by_default
included by default flag
int $advertiser_entity_id
Ignored on update.
advertiser entity id the pixel is bound to
size : 10
float $exchange_rate
Ignored on update.
Default value: '1'
exchange rate of the currency (if not in dollars)
size : 10,4
enum_trigger_pixel_type $pixel_type
Default value: NULL
Pixel type
List of possible values: "Segment" is equal to post_click_interval is 0 and post_view_interval is 0 "Post-view" is equal
to post_click_interval is 0 and post_view_interval > 0 or NULL "Post-click" is equal to post_click_interval > 0 or NULL
and post_view_interval is 0 "Post-view and/or Post-click" in other cases
nillable
dateTime $created_on
Ignored on update.
Conversion creation time. Autoset by API.
nillable
dateTime $lastupd
Ignored on add and update.
nillable
string $hybrid_trigger_type
Default value: 'none'
Indicate what kind of hybrid pixel current pixel is
323
Services
The complete list of enum values you can see at hybrid_trigger_type enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'hybrid_trigger_type').
enum : hybrid_trigger_type
string $property_flags
Default value: null
Indicate Property flags. ('no_frequency_data','no_recency_data','adcall_ingest_allowed') This field should be set only
for Y!'s BTRE segments.
int $segment_type_id
Ignored on update.
Default value: NULL
Segment type id. See valid types in Segment Type Enum. Applicable only when $pixel_type = 'Segment'.
The complete list of enum values you can see at 4_enum_segment_type, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'segment_type ').
size : 3
enum : segment_type
nillable
int $segment_manager_entity_id
Ignored on update.
Default value: NULL
Segment manager entity id. Applicable only when $pixel_type = 'Segment'.
size : 10
nillable
pixel_pair
Used by the following call(s) and/or data type(s):
SegmentDefinitionService
add()
Fields Summary
$private_segment_id Private segment id.
$public_segment_id Public segment id. Available to both Audience Manager buyers/sellers. Should be
used in buyer/seller communications.
Fields
int $private_segment_id
Private segment id.
nillable
int $public_segment_id
Public segment id. Available to both Audience Manager buyers/sellers. Should be used in buyer/seller
communications.
pixel_tag_params
Used by the following call(s) and/or data type(s):
PixelService
getPixelTags()
324
Services
Fields Summary
$advertiser_id
$conversion_ids
$conversion_tag_type
$secure_pixel
Fields
int $advertiser_id
array_of_int $conversion_ids
enum_conversion_tag_type $conversion_tag_type
Default value: 'img'
boolean $secure_pixel
Default value: '0'
placement_creative
Used by the following call(s) and/or data type(s):
PlacementService
PlacementService::addCreative()
Fields Summary
$tag
$media_type
$pop_types
$menubar
$resizable
$scrollbars
$status
$toolbar
$addressbar
$pop_expand_to_full_window
$pop_height
$pop_width
$pop_window_title
$is_third_party
$creative_type
$clickthrough_url
$id Creative ID. Autoset on creative creation by CreativeService::add() or CreativeService::addCreatives().
$code
$advertiser_entity_id ID of advertiser the creative belongs to.
$active Creative activity flag.
$is_audited Shows if object has been audited by Media Guard.
$description Client's description of creative.
$adapt_media_hex
$adapt_click_hex
$size_id ID of creative (width, length) pair, see Size Enum for valid values.
$is_pending
$created_on Creative creation time. Autoset by CampaignService::addCreative().
$height Creative height, required for pop (size_id = 0); must be > 0 and <= 10000.
$width Creative width, required for pop (size_id = 0); must be > 0 and <= 10000.
$beacon_conversion_id ID of beacon switched by this creative. See Yahoo Ad Exchange Knowledge
Base for details.
$original_tag
$can_track_clicks This is a Boolean that must be true in order for click tracking to function.
$flash_loop If TRUE, flash creative loops
$flash_bgcolor Background color for flash
$flash_clicktag
325
Services
$third_party_type Third party tag type. value is set depending on creative_content.content value, checked
at insert & update
$is_ssl Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
$is_distracting Creative theme. See Creative themes for details.
$is_suggestive Creative theme. See Creative themes for details.
$is_violent Creative theme. See Creative themes for details.
$is_textlink Creative spec. See Creative specs for details.
$has_active_x Creative spec. See Creative specs for details.
$has_exit_pop Creative spec. See Creative specs for details.
$banner_opens_pop Creative spec. See Creative specs for details.
$flash_has_embedded_url
$offer_type_id Creative's offer type. See Offer Type table for additional information. See also Creative
offer types for details.
$click_url Creative's click url. Creative must be clickable to use it. See Yahoo Ad Exchange Knowledge
Base for details.
$has_video_or_rich_media Creative spec. See Creative specs for details.
$is_deceptive Creative theme. See Creative themes for details.
$is_political Creative theme. See Creative themes for details.
$audio_type Creative spec. See Creative specs for details.
$target_profile_id ID of target profile, attached to creative. Can be set by
CreativeService::addTargetProfile().
$delivery_rules_id Delivery rules ID. Autoset by the server when creating a new creative.
$initiates_pop If TRUE, YAX server initiates pop window at the client' side before pop creative delivery.
See Yahoo Ad Exchange Knowledge Base for details.
$is_web_site_pop Creative spec. See Creative specs for details.
$no_iframes If TRUE, tag code doesn't create IFRAME
$is_pre_audited
$last_audited_by_contact_id
$last_human_audit
$last_automated_audit
$use_campaign_click_url
$priority Campaign priority.
$contents
$custom_settings
$imp_budget Budget by impressions
$imp_delivery_type Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are
listed in Delivery Type Enum.
$imp_delivery_cap Max value for impression-capped delivery methods.
$is_bcm_upload
$view_tracker Allows clients to run agency deals by trafficking image and flash creative directly along with
a 3rd-party impression-tracking (view tracker) pixel. We store the URL of the impression-tracking pixel in
view_tracker field.
$first_ran_date
$last_ran_date
$needs_arbitration
$ad_size_in_bytes
$lastupd
$language_id Id of language creative_tag
$ad_vendor_id Ad vendor ID. For internal use only. Do not use.
$is_rtb For RTB creative
$is_3pi
$classification_review_status Creative classification review status, see valid types in Creative
Classification Review Status Enum.
$video_creative Complex data type to represent video creative attributes.
Fields
string $tag
nillable
string $media_type
nillable
int $pop_types
size : 11
nillable
326
Services
int $menubar
Default value: '0'
size : 1
int $resizable
Default value: '0'
size : 1
int $scrollbars
Default value: '0'
size : 1
int $status
Default value: '0'
size : 1
int $toolbar
Default value: '0'
size : 1
int $addressbar
Default value: '0'
size : 1
int $pop_expand_to_full_window
Default value: '0'
size : 1
int $pop_height
size : 11
nillable
int $pop_width
size : 11
nillable
string $pop_window_title
size : 100
nillable
int $is_third_party
Default value: '0'
size : 4
string $creative_type
nillable
string $clickthrough_url
Default value: '0'
327
Services
int $id
Ignored on add and update.
Creative ID. Autoset on creative creation by CreativeService::add() or CreativeService::addCreatives().
size : 10
primary
string $code
size : 100
nillable
int $advertiser_entity_id
Ignored on update.
ID of advertiser the creative belongs to.
size : 10
boolean $active
Default value: '1'
Creative activity flag.
boolean $is_audited
Default value: '0'
Shows if object has been audited by Media Guard.
This field is deprecated. Media Guard will not audit creatives to associate creative specs/themes. Refer Creative
specs, Creative themes for more details
deprecated
string $description
Client's description of creative.
size : 255
string $adapt_media_hex
size : 255
nillable
string $adapt_click_hex
size : 255
nillable
int $size_id
Default value: '0'
ID of creative (width, length) pair, see Size Enum for valid values.
Please note that size id provided in Linear Video creative will be ignored.
The complete list of enum values you can see at size enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'size').
size : 10
enum : size
328
Services
boolean $is_pending
Ignored on add and update.
dateTime $created_on
Ignored on add and update.
Creative creation time. Autoset by CampaignService::addCreative().
int $height
Creative height, required for pop (size_id = 0); must be > 0 and <= 10000.
int $width
Creative width, required for pop (size_id = 0); must be > 0 and <= 10000.
int $beacon_conversion_id
ID of beacon switched by this creative. See Yahoo Ad Exchange Knowledge Base for details.
size : 8
string $original_tag
boolean $can_track_clicks
Default value: '0'
This is a Boolean that must be true in order for click tracking to function.
When you use the My Yieldmanager UI to add clickable creatives, the UI asks you to manually test the creative to be
sure that click tracking is working properly. Once that testing has been completed successfully, the UI automatically
sets the $can_track_clicks on the creative. However, this testing mechanism is not available via the API, so you must
set this flag manually. Keep in mind that setting this flag will affect the way your ads are served; we strongly
recommend that, before setting $can_track_clicks, you have used the UI to test the clickability of a creative that is
representative of your creative object.
boolean $flash_loop
If TRUE, flash creative loops
string $flash_bgcolor
Background color for flash
size : 10
string $flash_clicktag
size : 30
enum_creative_third_party_types $third_party_type
Ignored on add and update.
Third party tag type. value is set depending on creative_content.content value, checked at insert & update
nillable
boolean $is_ssl
Creative spec. See Yahoo Ad Exchange Knowledge Base for details.
boolean $is_distracting
Creative theme. See Creative themes for details.
This field is deprecated. Use corresponding Creative Tag ID (ID: 229) in creative::$self_classification_tags to
associate creative themes for creative
deprecated
329
Services
boolean $is_suggestive
Creative theme. See Creative themes for details.
This field is deprecated. Use corresponding Creative Tag ID (ID: 230) in creative::$self_classification_tags to
associate creative themes for creative
deprecated
boolean $is_violent
Creative theme. See Creative themes for details.
This field is deprecated. Use corresponding Creative Tag ID (ID: 231) in creative::$self_classification_tags to
associate creative themes for creative
deprecated
boolean $is_textlink
Creative spec. See Creative specs for details.
This field is readonly to the API user, updated by Creative Tester. Use CreativeService::getCreativeTags() to get all
the tags associated with creative by 'Creative Tester' and 'Self classification'.
deprecated
boolean $has_active_x
Creative spec. See Creative specs for details.
This field is readonly to the API user, updated by Creative Tester. Use CreativeService::getCreativeTags() to get all
the tags associated with creative by 'Creative Tester' and 'Self classification'
deprecated
boolean $has_exit_pop
Creative spec. See Creative specs for details.
This field is readonly to the API user, updated by Creative Tester. Use CreativeService::getCreativeTags() to get all
the tags associated with creative by 'Creative Tester' and 'Self classification'
deprecated
boolean $banner_opens_pop
Creative spec. See Creative specs for details.
This field is readonly to the API user, updated by Creative Tester. Use CreativeService::getCreativeTags() to get all
the tags associated with creative by 'Creative Tester' and 'Self classification'
boolean $flash_has_embedded_url
int $offer_type_id
Creative's offer type. See Offer Type table for additional information. See also Creative offer types for details.
The complete list of enum values you can see at offer_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'offer_type').
size : 10
enum : offer_type
string $click_url
Creative's click url. Creative must be clickable to use it. See Yahoo Ad Exchange Knowledge Base for details.
nillable
boolean $has_video_or_rich_media
Creative spec. See Creative specs for details.
330
Services
This field is deprecated. Use corresponding Creative Tag ID (ID: 233) in creative::$self_classification_tags to
associate creative specs for creative
deprecated
boolean $is_deceptive
Creative theme. See Creative themes for details.
This field is deprecated. Use corresponding Creative Tag ID (ID: 234) in creative::$self_classification_tags to
associate creative themes for creative
deprecated
boolean $is_political
Creative theme. See Creative themes for details.
This field is deprecated. Use corresponding Creative Tag ID (ID: 235) in creative::$self_classification_tags to
associate creative themes for creative
deprecated
string $audio_type
Default value: 'none'
Creative spec. See Creative specs for details.
This field is deprecated. Use corresponding Creative Tag ID (IDs: 241, 242) in creative::$self_classification_tags to
associate creative specs for creative
The complete list of enum values you can see at audio_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'audio_type').
deprecated
enum : audio_type
int $target_profile_id
Ignored on add and update.
ID of target profile, attached to creative. Can be set by CreativeService::addTargetProfile().
size : 8
nillable
int $delivery_rules_id
Ignored on add and update.
Delivery rules ID. Autoset by the server when creating a new creative.
size : 10
nillable
boolean $initiates_pop
If TRUE, YAX server initiates pop window at the client' side before pop creative delivery. See Yahoo Ad Exchange
Knowledge Base for details.
boolean $is_web_site_pop
Creative spec. See Creative specs for details.
This field is readonly to the API user, updated by Creative Tester. Use CreativeService::getCreativeTags() to get all
the tags associated with creative by 'Creative Tester' and 'Self classification'
deprecated
boolean $no_iframes
If TRUE, tag code doesn't create IFRAME
331
Services
int $is_pre_audited
Ignored on add and update.
size : 1
nillable
int $last_audited_by_contact_id
Ignored on add and update.
size : 10
nillable
dateTime $last_human_audit
Ignored on add and update.
nillable
dateTime $last_automated_audit
Ignored on add and update.
nillable
int $use_campaign_click_url
Default value: '0'
size : 1
enum_priority $priority
Default value: 'Normal'
Campaign priority.
array_of_creative_content $contents
custom_settings $custom_settings
nillable
int $imp_budget
Budget by impressions
nillable
object : delivery_rules
string $imp_delivery_type
Default value: 'ASAP'
Delivery method, may be set to ASAP, Even, hourly/daily/monthly cap. Valid types are listed in Delivery Type Enum.
The complete list of enum values you can see at imp_delivery_type enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'imp_delivery_type').
enum : imp_delivery_type
object : delivery_rules
float $imp_delivery_cap
Max value for impression-capped delivery methods.
nillable
object : delivery_rules
int $is_bcm_upload
Default value: '0'
332
Services
size : 1
string $view_tracker
Allows clients to run agency deals by trafficking image and flash creative directly along with a 3rd-party
impression-tracking (view tracker) pixel. We store the URL of the impression-tracking pixel in view_tracker field.
size : 255
nillable
dateTime $first_ran_date
Ignored on add and update.
dateTime $last_ran_date
Ignored on add and update.
boolean $needs_arbitration
Ignored on add and update.
int $ad_size_in_bytes
Ignored on add and update.
size : 11
nillable
dateTime $lastupd
Ignored on add and update.
nillable
int $language_id
Id of language creative_tag
The complete list of enum values you can see at creative_tag_language enum page, at run time you can get all of
them using DictionaryService.getEnumValues(token, 'creative_tag_language').
enum : creative_tag_language
int $ad_vendor_id
Ad vendor ID. For internal use only. Do not use.
field : ad_vendor_id
object : db_creative_ad_vendor
nillable
boolean $is_rtb
Default value: '0'
For RTB creative
boolean $is_3pi
Default value: '0'
string $classification_review_status
Ignored on add and update.
Default value: 'not-reviewed'
Creative classification review status, see valid types in Creative Classification Review Status Enum.
The complete list of enum values you can see at creative_classification_review_status enum page, at run time you
can get all of them using DictionaryService.getEnumValues(token, 'creative_classification_review_status').
nillable
enum : creative_classification_review_status
333
Services
video_creative $video_creative
Complex data type to represent video creative attributes.
placement
Used by the following call(s) and/or data type(s):
PlacementService
PlacementService::get()
PlacementService::getByInsertionOrder()
Fields Summary
$id placement ID
$name placement line item description
$price placement line item amount, in USD
$size_id placement creative size ID
$tag placement creative content
$geo_target placement geography target information
$section_target placement section target information
$frequency_target placement frequency target information
$enabled placement line item activity flag
$line_item placement line item
$creative placement creative
Fields
int $id
Ignored on add and update.
placement ID
primary
string $name
placement line item description
float $price
placement line item amount, in USD
int $size_id
placement creative size ID
string $tag
placement creative content
target_geography $geo_target
placement geography target information
target_section $section_target
placement section target information
target_frequency $frequency_target
placement frequency target information
boolean $enabled
placement line item activity flag
line_item $line_item
placement line item
334
Services
creative $creative
placement creative
pop_type
See Pop Types Enum for more information.
DictionaryService
getPopTypes()
Fields Summary
$id pop type ID
$name pop type name
Fields
int $id
pop type ID
size : 3
primary
string $name
pop type name
size : 50
postal_code
Used by the following call(s) and/or data type(s):
target_woeid_cga
$postal_codes
Fields Summary
$woeid WOEID
$postal_code Postal code
$iso Country ISO
Fields
int $woeid
Ignored on add and update.
WOEID
size : 10
primary
string $postal_code
Postal code
size : 10
string $iso
Country ISO
size : 2
335
Services
postal_codes
Used by the following call(s) and/or data type(s):
TargetProfileService
getTargetGeographyV2()
setTargetGeographyV2()
target_woeid_cga
$postal_codes
Fields Summary
$country_code The Country Code for the targeted Postal Codes.
$postal_codes The array of postal codes for the corresponding country.
Fields
string $country_code
The Country Code for the targeted Postal Codes.
array_of_string $postal_codes
Default value: NULL
The array of postal codes for the corresponding country.
preferred_terms_demand
preferred_terms_demand data type
preferred_terms
$preferred_terms_demand
Fields Summary
$marketplace Demand rule applicable on Trading Pit, Netwrok of network, Intra Network(Managed
Advertiser) or any combination of these. See Buying Selling Marketplace Enum for valid values.
$buying_technology Array of buying technology 'RTBD', 'Hosted'. See Buying Technology Enum for valid
values.
$advertisers Advertiser ids.
$deal_properties Deal properties.
$creative_tags Creative tag ids for creative_specs, creative_themes, creative_languages,
creative_beacons.
$click_urls Click Urls.
$offer_types Offer types.
Fields
array_of_enum_buying_selling_marketplace $marketplace
Demand rule applicable on Trading Pit, Netwrok of network, Intra Network(Managed Advertiser) or any combination of
these. See Buying Selling Marketplace Enum for valid values.
array_of_enum_buying_technology $buying_technology
Array of buying technology 'RTBD', 'Hosted'. See Buying Technology Enum for valid values.
advertiser_list $advertisers
Advertiser ids.
rule_deal_properties $deal_properties
Deal properties.
336
Services
creative_properties $creative_tags
Creative tag ids for creative_specs, creative_themes, creative_languages, creative_beacons.
rule_attribute_names $click_urls
Click Urls.
rule_attribute $offer_types
Offer types.
preferred_terms_getall
preferred data type
PreferredTermsService
getPartialPreferredTermObject()
quickSearch()
Fields Summary
$id Preferred terms id.
$name Preferred terms name.
$description Preferred terms description.
$entity_id Owner entity ID
$entity_name Name of owner entity.
$pvt_marketplace_id Private Marketplace id.
$is_pvt_marketplace Is Private Marketplace.
$markup Field markup introduces bias on bids for certain slices of demand.
$created_by_contact_id Contact id who created Preferred terms.
$created_by_contact_name Name of contact who created Preferred terms.
$modified_by_contact_id Contact id who modified Preferred terms.
$modified_by_contact_name Name of contact who modified Preferred terms.
$active Preferred terms activity flag.
$created_on Preferred terms created on date/time.
$lastupd Preferred terms last updated date/time.
Fields
int $id
Preferred terms id.
string $name
Preferred terms name.
string $description
Preferred terms description.
int $entity_id
Owner entity ID
string $entity_name
Name of owner entity.
int $pvt_marketplace_id
Ignored on add and update.
Default value: '0'
Private Marketplace id.
337
Services
boolean $is_pvt_marketplace
Default value: '0'
Is Private Marketplace.
float $markup
Default value: '0.000'
Field markup introduces bias on bids for certain slices of demand.
int $created_by_contact_id
Contact id who created Preferred terms.
string $created_by_contact_name
Name of contact who created Preferred terms.
int $modified_by_contact_id
Contact id who modified Preferred terms.
string $modified_by_contact_name
Name of contact who modified Preferred terms.
boolean $active
Default value: '0'
Preferred terms activity flag.
dateTime $created_on
Ignored on add and update.
Preferred terms created on date/time.
dateTime $lastupd
Ignored on add and update.
Preferred terms last updated date/time.
preferred_terms
preferred_terms data type
PreferredTermsService
add()
getAllPreferredTerms()
getAllSince()
getByObjectId()
update()
Fields Summary
$id Preferred Terms id.
$name Preferred Terms name.
$description Preferred Terms description.
$entity_id Owner entity ID
$entity_name Name of owner entity.
$preferred_terms_managed_supply Complex data type to represent managed supply attributes.
$preferred_terms_demand Complex data type to represent demand attributes.
$priority Preferred Terms priority.
$reserve_price Reserve price. It should be greater than 0.
$forex_currency_id Forex Currency Id
$is_pvt_marketplace Is Private Marketplace.
$pvt_marketplace_controls Complex data type to represent deal controls.
$pvt_marketplace_id Private Marketplace id.
$markup Field markup introduces bias on bids for certain slices of demand.
338
Services
Fields
int $id
Ignored on update.
Preferred Terms id.
primary
string $name
Preferred Terms name.
string $description
Preferred Terms description.
int $entity_id
Ignored on add and update.
Owner entity ID
string $entity_name
Name of owner entity.
preferred_terms_managed_supply $preferred_terms_managed_supply
Complex data type to represent managed supply attributes.
preferred_terms_demand $preferred_terms_demand
Complex data type to represent demand attributes.
enum_preferred_terms_priority $priority
Default value: 'Normal' Please see the Exchange Knowledge base article on preferred terms priority options for more
information.
Preferred Terms priority.
float $reserve_price
Reserve price. It should be greater than 0.
int $forex_currency_id
Ignored on add and update.
Forex Currency Id
boolean $is_pvt_marketplace
Default value: '0'
Is Private Marketplace.
private_marketplace_controls $pvt_marketplace_controls
Complex data type to represent deal controls.
int $pvt_marketplace_id
Ignored on add and update.
Default value: '0'
Private Marketplace id.
primary
339
Services
float $markup
Default value: '0.000'
Field markup introduces bias on bids for certain slices of demand.
int $created_by_contact_id
Ignored on add and update.
Contact id who created Preferred Terms.
string $created_by_contact_name
Name of contact who created Preferred terms.
int $modified_by_contact_id
Ignored on add and update.
Contact id who modified Preferred Terms.
string $modified_by_contact_name
Name of contact who modified Preferred terms.
boolean $active
Default value: '0'
Preferred Terms activity flag.
dateTime $created_on
Ignored on add and update.
Preferred Terms created on date/time.
dateTime $lastupd
Ignored on add and update.
Preferred Terms last updated date/time.
preferred_terms_managed_supply
preferred_terms_managed_supply data type
preferred_terms
$preferred_terms_managed_supply
Fields Summary
$managed_publishers Managed publishers.
$sections Sections.
$seller_line_items Publisher LineItems.
$channels Channels.
$urls URLs.
$inventory_types Section inventory type. See valid types in Inventory Type Enum
$sizes Sizes.
$woeids Woeids.
$cga_ids Custom geo area ids.
$dayparts Dayparts
$devices Devices.
$browsers Browsers.
$operating_systems Operating systems.
$carrier_isp Carrier ISP.
$selling_technology Array of selling technology RTBS, Hosted
$gender Gender - Male, female, unknown.
$ages Ages to included or excluded.
$vurls Vurls.
$segment_ids Segments.
Fields
340
Services
publisher_list $managed_publishers
Managed publishers.
rule_attribute $sections
Sections.
rule_attribute $seller_line_items
Publisher LineItems.
rule_attribute $channels
Channels.
rule_attribute_names $urls
URLs.
rule_attribute $inventory_types
Section inventory type. See valid types in Inventory Type Enum
rule_attribute $sizes
Sizes.
rule_attribute $woeids
Woeids.
rule_attribute $cga_ids
Custom geo area ids.
rule_dayparts $dayparts
Dayparts
rule_attribute $devices
Devices.
rule_attribute $browsers
Browsers.
rule_attribute $operating_systems
Operating systems.
rule_attribute $carrier_isp
Carrier ISP.
array_of_enum_selling_technology $selling_technology
Array of selling technology RTBS, Hosted
gender $gender
Gender - Male, female, unknown.
rule_attribute_ids $ages
Ages to included or excluded.
rule_vurl_data $vurls
Vurls.
rule_attribute $segment_ids
341
Services
Segments.
preferred_terms_search_options
preferred data type
PreferredTermsService
getAllPreferredTerms()
getPartialPreferredTermObject()
Fields Summary
$ids Array of preferred terms ids.
$names Array of preferred terms names.
$descriptions Array of preferred terms descriptions.
$contact_ids Array of contact ids.
$advertiser_ids Array of advertiser ids.
$publisher_ids Array of publisher ids.
$is_active Parameter to search by status.By default will return both 'active' and 'inactive'.
Fields
array_of_int $ids
Array of preferred terms ids.
array_of_string $names
Array of preferred terms names.
array_of_string $descriptions
Array of preferred terms descriptions.
array_of_int $contact_ids
Array of contact ids.
array_of_int $advertiser_ids
Array of advertiser ids.
array_of_int $publisher_ids
Array of publisher ids.
int $is_active
Parameter to search by status.By default will return both 'active' and 'inactive'.
private_marketplace_controls
private_marketplace_controls data type
preferred_terms
$pvt_marketplace_controls
Fields Summary
$share_through_rtb_bids Flag to send DealId as part of the RTB request.
$share_reserve_price Flag to send ReservePrice as part of the RTB request.
$allow_bid_in_open_auction Flag to allow if the bidder can bid outside the deal.
342
Services
Fields
boolean $share_through_rtb_bids
Default value: '0'
Flag to send DealId as part of the RTB request.
boolean $share_reserve_price
Default value: '0'
Flag to send ReservePrice as part of the RTB request.
boolean $allow_bid_in_open_auction
Default value: '0'
Flag to allow if the bidder can bid outside the deal.
private_marketplace
Used by the following call(s) and/or data type(s):
preferred_terms
$pvt_marketplace_controls
Fields Summary
$id Private Marketplace ID.
$name Private Marketplace name.
$description Private Marketplace description.
$selling_rule_id Selling Rule ID.
$active Active / inactive flag. Only active profiles will be taken by cache gen.
$lastupd Private Marketplace last updated date/time.
$is_deleted Shows if object is deleted.
$share_through_rtb_bids Flag to send DealId as part of the RTB request.
$share_reserve_price Flag to send ReservePrice as part of the RTB request.
$allows_double_dipping Flag to allow if the bidder can bid outside the deal.
Fields
int $id
Ignored on add and update.
Private Marketplace ID.
size : 8
primary
string $name
Private Marketplace name.
size : 50
string $description
Private Marketplace description.
size : 255
int $selling_rule_id
Selling Rule ID.
size : 8
boolean $active
Active / inactive flag. Only active profiles will be taken by cache gen.
343
Services
dateTime $lastupd
Ignored on add and update.
Private Marketplace last updated date/time.
boolean $is_deleted
Ignored on add and update.
Default value: '0'
Shows if object is deleted.
boolean $share_through_rtb_bids
Default value: '0'
Flag to send DealId as part of the RTB request.
boolean $share_reserve_price
Default value: '0'
Flag to send ReservePrice as part of the RTB request.
boolean $allows_double_dipping
Default value: '0'
Flag to allow if the bidder can bid outside the deal.
publisher_control_data
This file defines publisher_control_data data type
EntityService
getPublisherControls()
SiteService
getPublisherControls()
Fields Summary
$type control type (macro, rtbd)
$hidden_params parameters that need to hide(channels, url, publisher_id, section_id, section_code,
site_id)
$owner_type Owner type
$owner_id Owner Id
$buyer_entity_id Buyer entity id
$created_on Pub control mask creation time
$lastupd Pub control mask last update time
Fields
string $type
Default value: 'rtbd'
control type (macro, rtbd)
The complete list of enum values you can see at 4_enum_pub_control_type .pkg, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'pub_control_type ').
enum : pub_control_type
array_of_enum_pub_control_param $hidden_params
parameters that need to hide(channels, url, publisher_id, section_id, section_code, site_id)
nillable
string $owner_type
Default value: 'entity'
Owner type
344
Services
The complete list of enum values you can see at pub_control_owner_type enum page, at run time you can get all of
them using DictionaryService.getEnumValues(token, 'pub_control_owner_type').
enum : pub_control_owner_type
primary
int $owner_id
Owner Id
size : 10
primary
int $buyer_entity_id
Default value: 0
Buyer entity id
size : 10
primary
dateTime $created_on
Ignored on add and update.
Pub control mask creation time
dateTime $lastupd
Ignored on add and update.
Pub control mask last update time
publisher_control_masks
This file defines publisher_control_masks data type that is used in bulk operations
EntityService
deleteAllPublisherControls()
getAllPublisherControls()
setAllPublisherControls()
SiteService
deleteAllPublisherControls()
getAllPublisherControls()
setAllPublisherControls()
Fields Summary
$type control type (all, macro, rtbd)
$hidden_params parameters that need to hide(channels, url, publisher_id, section_id, section_code,
site_id, age, gender, ip)
$buyer_entity_ids Array of advertisers to which publisher control masks will be applied
Fields
string $type
Default value: 'all'
control type (all, macro, rtbd)
The complete list of enum values you can see at 4_enum_pub_control_type .pkg, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'pub_control_type ').
enum : pub_control_type
array_of_enum_pub_control_param $hidden_params
parameters that need to hide(channels, url, publisher_id, section_id, section_code, site_id, age, gender, ip)
345
Services
nillable
array_of_int $buyer_entity_ids
Array of advertisers to which publisher control masks will be applied
publisher_data
Fields Summary
$publisher contains the publisher object
$entity contains the entity object
$contact contains the contact object
$create_site_section site and section creation flag
$site contains the site object
$section contains the section object
$create_io_li insertion order and line item creation flag
$insertion_order contains the insertion order object
$line_item contains the line item object
Fields
publisher $publisher
Ignored on add and update.
contains the publisher object
deprecated
entity $entity
contains the entity object
contact $contact
contains the contact object
boolean $create_site_section
site and section creation flag
site $site
contains the site object
section $section
contains the section object
boolean $create_io_li
insertion order and line item creation flag
insertion_order $insertion_order
contains the insertion order object
line_item $line_item
contains the line item object
publisher_list
publisher data type
346
Services
buying_terms_supply
$publishers
managed_supply
$managed_publishers
preferred_terms_managed_supply
$managed_publishers
supply
$publishers
Fields Summary
$publishers Publishers.
$publisher_custom_groups Custom groups of publishers.
$include Flag include is set "true" to include or "false" to exclude particular publishers in the $publishers
and $publisher_custom_groups arrays.
Fields
array_of_id_name $publishers
Publishers.
array_of_id_name $publisher_custom_groups
Custom groups of publishers.
boolean $include
Flag include is set "true" to include or "false" to exclude particular publishers in the $publishers and
$publisher_custom_groups arrays.
publisher_reserve_price_profile
This file defines publisher reserve price profile data type
PublisherReservePriceService
add()
addProfiles()
get()
getAll()
update()
updateProfiles()
Fields Summary
$section_ids Array of section ids belonging to same publisher entity id. Reserve price applicable on given
section ids. Not allowed for network level entity.
$demand_types Demand types.If demand_type is passed as empty it will apply to all types of
demands.See Demand Type Enum for valid values.
$buyer_entity_ids Array of buyer entity ids.
$segment_ids Array of segment ids.
$woeids Array of WOEIDs.
$cga_ids Array of custom geographic area ids.
$size_ids Array of size ids.
$creative_tag_ids Array of creative tag ids. Currently richmedia tags are available(Tag ids : 233, 281, 283,
297).
$device_ids Array of device ids. Available devices are 'PC' and 'Mobile'.
$id Reserve price profile id.
$description Reserve price description. If it is not provided by user, default description will be added as
'Reserve price for entity $entity_id'. Description should not be greater than 50 characters.
$entity_id Entity id. Reserve price applicable on given entity id. Should be 'Publisher' or 'Network' entity id.
$price Seller reserve price. Reserve price should be greater than 0.
$forex_currency_id Forex currency id.
$mark_up Mark up [Not operational].
$active Flag indicates if reserve price profile is active.
$lastupd
347
Services
Fields
array_of_int $section_ids
Array of section ids belonging to same publisher entity id. Reserve price applicable on given section ids. Not allowed
for network level entity.
array_of_enum_demand_type $demand_types
Default value: ''
Demand types.If demand_type is passed as empty it will apply to all types of demands.See Demand Type Enum for
valid values.
array_of_int $buyer_entity_ids
Array of buyer entity ids.
array_of_int $segment_ids
Array of segment ids.
array_of_int $woeids
Array of WOEIDs.
array_of_int $cga_ids
Array of custom geographic area ids.
array_of_int $size_ids
Array of size ids.
array_of_int $creative_tag_ids
Array of creative tag ids. Currently richmedia tags are available(Tag ids : 233, 281, 283, 297).
array_of_int $device_ids
Array of device ids. Available devices are 'PC' and 'Mobile'.
int $id
Ignored on add and update.
Reserve price profile id.
size : 8
primary
string $description
Reserve price description. If it is not provided by user, default description will be added as 'Reserve price for entity
$entity_id'. Description should not be greater than 50 characters.
size : 255
int $entity_id
Ignored on update.
Entity id. Reserve price applicable on given entity id. Should be 'Publisher' or 'Network' entity id.
size : 8
float $price
Seller reserve price. Reserve price should be greater than 0.
int $forex_currency_id
Ignored on add and update.
Forex currency id.
size : 3
348
Services
float $mark_up
Ignored on add and update.
Mark up [Not operational].
size : 17,5
boolean $active
Default value: '1'
Flag indicates if reserve price profile is active.
dateTime $lastupd
Ignored on add and update.
pv_section_data
Fields Summary
$section_id Section id
$time_offset
Fields
int $section_id
Section id
dateTime $time_offset
pvt_marketplace
private_marketplace data type
EntityService
getEligiblePrivateMarketPlaces()
Fields Summary
$id Private Marketplace id.
$name Private Marketplace name.
$active Private Marketplace active status.
$seller_entity_id Owner entity ID
$seller_entity_name Owner entity name
$reserve_price Reserve Price
Fields
int $id
Ignored on add and update.
Private Marketplace id.
primary
string $name
Ignored on add and update.
Private Marketplace name.
boolean $active
Ignored on add and update.
349
Services
int $seller_entity_id
Ignored on add and update.
Owner entity ID
string $seller_entity_name
Ignored on add and update.
Owner entity name
float $reserve_price
Ignored on add and update.
Reserve Price
quicksearch_result
This file contains quicksearch_result data type
SearchService
quickSearch()
Fields Summary
$owner_entity_id
$owner_entity_name
$owner_entity_type entity type (Publisher, Advertiser, Network)
$object_type object type
$object_id
$object_name
$owner_additional_type owned additional entity type (Publisher, Advertiser, Network)
Fields
int $owner_entity_id
string $owner_entity_name
string $owner_entity_type
entity type (Publisher, Advertiser, Network)
The complete list of enum values you can see at entity_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'entity_type').
enum : entity_type
string $object_type
object type
The complete list of enum values you can see at quicksearch_object_type enum page, at run time you can get all of
them using DictionaryService.getEnumValues(token, 'quicksearch_object_type').
enum : quicksearch_object_type
int $object_id
string $object_name
350
Services
string $owner_additional_type
owned additional entity type (Publisher, Advertiser, Network)
The complete list of enum values you can see at entity_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'entity_type').
enum : entity_type
quota
Used by the following call(s) and/or data type(s):
QuotaService
getQuotaByCmdGroup()
getQuotaByServiceByMethod()
Fields Summary
$entity_id Entity ID for which quota limit is set. For internal use only.
$service Service name for which quota limit is set. Included in
QuotaService::getQuotaByServiceByMethod() output only.
$method Service method for which quota limit is set. Included in
QuotaService::getQuotaByServiceByMethod() output only.
$limit Allocated limit.
$used Quota used so far. Included in QuotaService::getQuotaByServiceByMethod() output only.
$cmdgroup_name Name of the command group.
$time_zone Time zone that a given entity is configured with. For internal use only.
$type Quota type
Fields
int $entity_id
Ignored on add and update.
Entity ID for which quota limit is set. For internal use only.
string $service
Ignored on add and update.
Service name for which quota limit is set. Included in QuotaService::getQuotaByServiceByMethod() output only.
string $method
Ignored on add and update.
Service method for which quota limit is set. Included in QuotaService::getQuotaByServiceByMethod() output
only.
int $limit
Ignored on add and update.
Allocated limit.
int $used
Ignored on add and update.
Quota used so far. Included in QuotaService::getQuotaByServiceByMethod() output only.
string $cmdgroup_name
Ignored on add and update.
Name of the command group.
string $time_zone
Ignored on add and update.
Time zone that a given entity is configured with. For internal use only.
351
Services
string $type
Ignored on add and update.
Quota type
The complete list of enum values you can see at quota_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'quota_type').
enum : quota_type
rating_options
See Rating Enum for more information.
LinkingService
setRating()
Fields Summary
$entity_id ID of the entity this ratings belongs to
$overall overall rating (1..5)
$trust trust rating (1..5)
$cpm cpm rating (1..5)
$timely_payout timely payout rating (1..5)
$support support rating (1..5)
$comment additional information
Fields
int $entity_id
ID of the entity this ratings belongs to
int $overall
overall rating (1..5)
int $trust
trust rating (1..5)
int $cpm
cpm rating (1..5)
int $timely_payout
timely payout rating (1..5)
int $support
support rating (1..5)
string $comment
additional information
region
See Region Enum for more information.
DictionaryService
getRegions()
352
Services
Fields Summary
$id region ID
$name region name
$code region code
$country_id region country ID
$has_tz region time zone flag
$std_offset daylight save time offset
$timezone region time zone
$msa_ids The list of MSA attached to the region.
Fields
int $id
region ID
size : 5
primary
string $name
region name
size : 50
string $code
region code
size : 2
int $country_id
region country ID
size : 5
int $has_tz
region time zone flag
size : 4
int $std_offset
daylight save time offset
size : 11
string $timezone
region time zone
size : 100
array_of_int $msa_ids
The list of MSA attached to the region.
reserve_price_buyer_entity
Fields Summary
$reserve_price_profile_id Reserve price profile id.
$buyer_entity_id Buyer entity id.
$demand_type Demand types.If demand_type is passed as empty it will apply to all types of demands.See
Demand Type Enum for valid values.
353
Services
Fields
int $reserve_price_profile_id
Reserve price profile id.
size : 8
primary
int $buyer_entity_id
Buyer entity id.
size : 10
primary
enum_demand_type $demand_type
Default value: ''
Demand types.If demand_type is passed as empty it will apply to all types of demands.See Demand Type Enum for
valid values.
primary
reserve_price_filter_options
Used by the following call(s) and/or data type(s):
PublisherReservePriceService
getAll()
richmedia_creative_attributes
Used by the following call(s) and/or data type(s):
creative
$richmedia_creative_attribute
Fields Summary
$is_expandable Is Expandable Creative
$is_floating Is Floating Creative
$is_polite_download Is Polite Download
$is_video Is Flash Video
$is_other Does creative belong to any other rich media category?
$expandable_final_width Expandable Final Width
$expandable_final_height Expandable Final Height
Fields
boolean $is_expandable
Default value: '0'
Is Expandable Creative
boolean $is_floating
Default value: '0'
Is Floating Creative
boolean $is_polite_download
Default value: '0'
Is Polite Download
354
Services
boolean $is_video
Default value: '0'
Is Flash Video
boolean $is_other
Default value: '0'
Does creative belong to any other rich media category?
int $expandable_final_width
Expandable Final Width
size : 10
nillable
int $expandable_final_height
Expandable Final Height
size : 10
nillable
role
See Role Enum for more information.
DictionaryService
getRoles()
Fields Summary
$id
$description
Fields
int $id
size : 10
primary
string $description
size : 255
rtbdadminqps
Fields Summary
$advertiserId Advertiser entity id
$region Region to which qps setting belongs to
$qps Query Per Second (QPS) value
Fields
int $advertiserId
Ignored on add and update.
Advertiser entity id
primary
355
Services
string $region
Region to which qps setting belongs to
The complete list of enum values you can see at rtbd_region enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'rtbd_region').
enum : rtbd_region
primary
float $qps
Query Per Second (QPS) value
rtbdbidurl
Used by the following call(s) and/or data type(s):
RtbdService
getBidURL()
setBidURL()
Fields Summary
$advertiserId Advertiser entity id
$region Region to which BidUrl setting belongs to
$bidUrl Url where bid is to be sent at the time of Ad call
$bidApiVersion The API version used The complete list of enum values you can see at bid_api_version
enum page, at run time you can get all of them using DictionaryService.getEnumValues(token,
'bid_api_version').
$bidTransportFormat Format in which bid is to be sent The complete list of enum values you can see at
bid_transport_format enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'bid_transport_format').
$bidTransferEncoding Encoding in which bid is to be sent The complete list of enum values you can see at
bid_transfer_encoding enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'bid_transfer_encoding').
Fields
int $advertiserId
Ignored on add and update.
Advertiser entity id
primary
string $region
Region to which BidUrl setting belongs to
The complete list of enum values you can see at rtbd_region enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'rtbd_region').
enum : rtbd_region
primary
string $bidUrl
Url where bid is to be sent at the time of Ad call
int $bidApiVersion
The API version used The complete list of enum values you can see at bid_api_version enum page, at run time you
can get all of them using DictionaryService.getEnumValues(token, 'bid_api_version').
nillable
enum : bid_api_version
356
Services
string $bidTransportFormat
Default value: 'xml'
Format in which bid is to be sent The complete list of enum values you can see at bid_transport_format enum page, at
run time you can get all of them using DictionaryService.getEnumValues(token, 'bid_transport_format').
enum : bid_transport_format
string $bidTransferEncoding
Default value: 'uncompressed'
Encoding in which bid is to be sent The complete list of enum values you can see at bid_transfer_encoding enum
page, at run time you can get all of them using DictionaryService.getEnumValues(token,
'bid_transfer_encoding').
enum : bid_transfer_encoding
rtbdfailurereport
Used by the following call(s) and/or data type(s):
RtbdService
getFailureReport()
Fields Summary
$advertiserId Advertiser entity id
$beginTime The start time for the reporting item, eg. 2011-10-31 00:00
$endTime The end time for the reporting item, ie. 2011-10-31 00:30
$bidUrl URL where the bid request send to
$bidErrorType The failure error code
$bidErrorName The failure error string
$numOfFailedRequests The number of failed requests.
Fields
int $advertiserId
Ignored on add and update.
Advertiser entity id
primary
dateTime $beginTime
Ignored on add and update.
The start time for the reporting item, eg. 2011-10-31 00:00
nillable
dateTime $endTime
Ignored on add and update.
The end time for the reporting item, ie. 2011-10-31 00:30
nillable
string $bidUrl
URL where the bid request send to
string $bidErrorType
The failure error code
string $bidErrorName
The failure error string
357
Services
int $numOfFailedRequests
The number of failed requests.
rtbd_hidden_params
This file defines ivc_hidden_params data type
ivc_hidden_params
$rtbd_hidden_params
Fields Summary
$channels IVC hidden parameter for channels
$url IVC hidden parameter for URL
$publisher_id IVC hidden parameter for publisher ID
$section_id IVC hidden parameter for section ID
$section_code IVC hidden parameter for section code
$site_id IVC hidden parameter for site ID
$age IVC hidden parameter for age
$gender IVC hidden parameter for gender
$ip IVC hidden parameter for IP Address
$content_segments IVC hidden parameter for content segments
$ip_based_location IVC hidden parameter for IP-based location
$lat_long_based_location IVC hidden parameter for Lat/Long-based location
$sub_domain IVC hidden parameter for Sub domain.
$puburl_hash IVC hidden parameter for Pub Url Hash.
$appid_appname IVC hidden parameter for appId/appName.
$device_id IVC hidden parameter for Device Id.
$inventory_type IVC hidden parameter for Inventory Type.
Fields
boolean $channels
Default value: '0'
IVC hidden parameter for channels
boolean $url
Default value: '0'
IVC hidden parameter for URL
boolean $publisher_id
Default value: '0'
IVC hidden parameter for publisher ID
boolean $section_id
Default value: '0'
IVC hidden parameter for section ID
boolean $section_code
Default value: '0'
IVC hidden parameter for section code
boolean $site_id
Default value: '0'
IVC hidden parameter for site ID
boolean $age
Default value: '0'
IVC hidden parameter for age
358
Services
boolean $gender
Default value: '0'
IVC hidden parameter for gender
boolean $ip
Default value: '0'
IVC hidden parameter for IP Address
boolean $content_segments
Default value: '0'
IVC hidden parameter for content segments
boolean $ip_based_location
Default value: '0'
IVC hidden parameter for IP-based location
boolean $lat_long_based_location
Default value: '0'
IVC hidden parameter for Lat/Long-based location
boolean $sub_domain
Default value: '0'
IVC hidden parameter for Sub domain.
boolean $puburl_hash
Default value: '0'
IVC hidden parameter for Pub Url Hash.
boolean $appid_appname
Default value: '0'
IVC hidden parameter for appId/appName.
boolean $device_id
Default value: '0'
IVC hidden parameter for Device Id.
boolean $inventory_type
Default value: '0'
IVC hidden parameter for Inventory Type.
rtbdqps
Used by the following call(s) and/or data type(s):
RtbdService
setQPS()
Fields Summary
$advertiserId Advertiser entity id
$region Region to which qps setting belongs to
$timeWindowLength Number of minutes QPS setting will be valid, starting from now. Default is "-1", and it
means qps setting will be valid forever
$qps Query Per Second (QPS) value
Fields
int $advertiserId
Ignored on add and update.
359
Services
Advertiser entity id
primary
string $region
Region to which qps setting belongs to
The complete list of enum values you can see at rtbd_region enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'rtbd_region').
enum : rtbd_region
primary
int $timeWindowLength
Default value: '-1'
Number of minutes QPS setting will be valid, starting from now. Default is "-1", and it means qps setting will be valid
forever
float $qps
Query Per Second (QPS) value
rtbdrecenttrafficreport
Used by the following call(s) and/or data type(s):
RtbdService
getRecentTrafficReport()
Fields Summary
$advertiserId Advertiser entity id
$region Region to which qps setting belongs to
$beginTime The start time for the reporting item, eg. 2011-10-31 00:00
$endTime The end time for the reporting item, ie. 2011-10-31 00:30
$averageQPS Sliding window aggregate to estimate QPS to advertiser observed over time window
(end_time - begin_time).
$requestsSent The total number of requests sent to this advertiser over time window.
$requestsSuccessful The total number of successful requests sent to this advertiser over time window.
$requestsSuccessfulLatency The measured latency between requests successfully sent and responses
received from the advertiser.
$requestsTimedOut Number of requests that were sent to this advertiser but were discarded because a
response was not received in the allocated time.
$requestsWithError Number of requests that were not successfully processed due to an error condition
(eg. network failure, advertiser server 404, etc.)
Fields
int $advertiserId
Ignored on add and update.
Advertiser entity id
primary
string $region
Region to which qps setting belongs to
The complete list of enum values you can see at rtbd_region enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'rtbd_region').
enum : rtbd_region
primary
360
Services
dateTime $beginTime
Ignored on add and update.
The start time for the reporting item, eg. 2011-10-31 00:00
nillable
dateTime $endTime
Ignored on add and update.
The end time for the reporting item, ie. 2011-10-31 00:30
nillable
float $averageQPS
Sliding window aggregate to estimate QPS to advertiser observed over time window (end_time - begin_time).
int $requestsSent
The total number of requests sent to this advertiser over time window.
int $requestsSuccessful
The total number of successful requests sent to this advertiser over time window.
float $requestsSuccessfulLatency
The measured latency between requests successfully sent and responses received from the advertiser.
int $requestsTimedOut
Number of requests that were sent to this advertiser but were discarded because a response was not received in the
allocated time.
int $requestsWithError
Number of requests that were not successfully processed due to an error condition (eg. network failure, advertiser
server 404, etc.)
rtbdsuccessreport
Used by the following call(s) and/or data type(s):
RtbdService
getSuccessReport()
Fields Summary
$advertiserId Advertiser entity id
$beginTime The start time for the reporting item, eg. 2011-10-31 00:00
$endTime The end time for the reporting item, ie. 2011-10-31 00:30
$bidUrl URL where the bid request send to
$totalBidRequests total number of requests sent to the advertiser.
$numOfSuccessfulRequests The total number of requests with response received from advertiser.
$measuredLatency The measured latency between requests successfully sent and responses received
from the advertiser.
Fields
int $advertiserId
Ignored on add and update.
Advertiser entity id
primary
dateTime $beginTime
Ignored on add and update.
361
Services
The start time for the reporting item, eg. 2011-10-31 00:00
nillable
dateTime $endTime
Ignored on add and update.
The end time for the reporting item, ie. 2011-10-31 00:30
nillable
string $bidUrl
URL where the bid request send to
int $totalBidRequests
total number of requests sent to the advertiser.
int $numOfSuccessfulRequests
The total number of requests with response received from advertiser.
float $measuredLatency
The measured latency between requests successfully sent and responses received from the advertiser.
rule_attribute
rule data type
buying_terms_managed_demand
$creative_size_ids
$line_items
buying_terms_supply
$cga_ids
$channels
$private_marketplace
$sections
$woeids
demand
$click_urls
$offer_types
managed_supply
$ages
$browsers
$carrier_isp
$cga_ids
$channels
$devices
$operating_systems
$sections
$sizes
$woeids
preferred_terms_demand
$click_urls
$offer_types
preferred_terms_managed_supply
$ages
$browsers
$carrier_isp
$cga_ids
$channels
$devices
$inventory_types
$operating_systems
$sections
$segment_ids
362
Services
$seller_line_items
$sizes
$urls
$woeids
supply
$ages
$cga_ids
$channels
$sections
$urls
$woeids
trading_pit_demand
$click_urls
$offer_types
trading_pit_supply
$ages
$urls
$woeids
Fields Summary
$id_name_list Array of ids, names of different attributes.
$include Set flag include to "true" to include or "false" to exclude the ids provided in $id_name_list.
Fields
array_of_id_name $id_name_list
Array of ids, names of different attributes.
boolean $include
Set flag include to "true" to include or "false" to exclude the ids provided in $id_name_list.
rule_attribute_ids
rule data type
managed_supply
$ages
preferred_terms_managed_supply
$ages
supply
$ages
trading_pit_supply
$ages
Fields Summary
$ids Array of integers.
$include Include is set "true" to include or "false" to exclude particular data specified in $ids array.
Fields
array_of_int $ids
Array of integers.
boolean $include
Include is set "true" to include or "false" to exclude particular data specified in $ids array.
363
Services
rule_attribute_names
rule data type
demand
$click_urls
preferred_terms_demand
$click_urls
preferred_terms_managed_supply
$urls
supply
$urls
trading_pit_demand
$click_urls
trading_pit_supply
$urls
Fields Summary
$names Array of strings.
$include Include is set "true" to include or "false" to exclude particular data specified in $names array.
Fields
array_of_string $names
Array of strings.
boolean $include
Include is set "true" to include or "false" to exclude particular data specified in $names array.
rule_dayparts
rule data type
preferred_terms_managed_supply
$dayparts
Fields Summary
$relative_time_region_id ID of a region targeting is relative to (0 - relative to user's time, otherwise relative
to the region specified by this ID)
$daypart_list Array of daypart targeting.
Fields
int $relative_time_region_id
ID of a region targeting is relative to (0 - relative to user's time, otherwise relative to the region specified by this ID)
array_of_daypart $daypart_list
Array of daypart targeting.
rule_deal_properties
Used by the following call(s) and/or data type(s):
buying_terms_managed_demand
$deal_properties
364
Services
demand
$deal_properties
managed_demand
$deal_properties
preferred_terms_demand
$deal_properties
Fields Summary
$allow_cpa if true, CPA pricing is allowed
$allow_cpc if true, CPC pricing is allowed
$allow_cpm if true, CPM pricing is allowed
Fields
boolean $allow_cpa
if true, CPA pricing is allowed
boolean $allow_cpc
if true, CPC pricing is allowed
boolean $allow_cpm
if true, CPM pricing is allowed
rule_getall
rule data type
BuyingTermsService
quickSearch()
Fields Summary
$id ID.
$name Name.
$description Description.
$entity_id Owner entity ID
$entity_name Name of owner entity.
$created_by_contact_id Contact id who created rule.
$created_by_contact_name Name of contact who created rule.
$modified_by_contact_id Contact id who modified rule.
$modified_by_contact_name Name of contact who modified rule.
$bid_multiplier Bid multiplier.
$active Rule activity flag.
$created_on Rule created on date/time.
$lastupd Rule last updated date/time.
Fields
int $id
ID.
string $name
Name.
string $description
Description.
int $entity_id
Owner entity ID
365
Services
string $entity_name
Name of owner entity.
int $created_by_contact_id
Contact id who created rule.
string $created_by_contact_name
Name of contact who created rule.
int $modified_by_contact_id
Contact id who modified rule.
string $modified_by_contact_name
Name of contact who modified rule.
float $bid_multiplier
Bid multiplier.
boolean $active
Default value: '0'
Rule activity flag.
dateTime $created_on
Ignored on add and update.
Rule created on date/time.
dateTime $lastupd
Ignored on add and update.
Rule last updated date/time.
rule_search_options
rule data type
BuyingTermsService
getAllBuyingTerms()
Fields Summary
$ids Array of ids.
$names Array of names.
$descriptions Array of descriptions.
$contact_ids Array of contact ids.
$advertiser_ids Array of advertiser ids.
$publisher_ids Array of publisher ids.
$is_active Parameter to search by status.By default will return both 'active' and 'inactive'.
Fields
array_of_int $ids
Array of ids.
array_of_string $names
Array of names.
array_of_string $descriptions
366
Services
Array of descriptions.
array_of_int $contact_ids
Array of contact ids.
array_of_int $advertiser_ids
Array of advertiser ids.
array_of_int $publisher_ids
Array of publisher ids.
int $is_active
Parameter to search by status.By default will return both 'active' and 'inactive'.
rule_vurl_data
rule_vurl_data data type
preferred_terms_managed_supply
$vurls
supply
$vurls
trading_pit_supply
$vurls
Fields Summary
$vurl_count Returns total count of VURLs for rule are included or excluded.
$include Indicate if VURL is included or excluded. Set to "true" for include and "false" for exclude.
Fields
int $vurl_count
Ignored on add and update.
Returns total count of VURLs for rule are included or excluded.
boolean $include
Ignored on add and update.
Indicate if VURL is included or excluded. Set to "true" for include and "false" for exclude.
sales_region
Used by the following call(s) and/or data type(s):
EntityService
getAllSalesRegions()
LineItemService
getSalesRegionsByEntity()
Fields Summary
$id sales region ID
$entity_id entity ID
$name sales region name
Fields
367
Services
int $id
Ignored on add and update.
sales region ID
size : 10
primary
int $entity_id
entity ID
size : 10
string $name
sales region name
size : 255
search_data
Used by the following call(s) and/or data type(s):
SearchService
search()
Fields Summary
$field_name
$field_value
$exact_match
Fields
string $field_name
string $field_value
boolean $exact_match
Default value: '1'
section_custom_group
Fields Summary
$id ID. Autoset on Sitelist creation.
$name Description of Sitelist.
$owner_id Sitelist owner id
$type Sitelist owner type
$active Sitelist active flag.
$locked Sitelist locked flag.
$created_on Sitelist creation time.
$notes additional information
$lastupd Sitelist last updated time.
$category Sitelist category
Fields
int $id
Ignored on add and update.
ID. Autoset on Sitelist creation.
368
Services
size : 10
primary
string $name
Description of Sitelist.
size : 255
int $owner_id
Sitelist owner id
size : 10
enum_sitelist_type $type
Ignored on update.
Sitelist owner type
boolean $active
Default value: '1'
Sitelist active flag.
boolean $locked
Default value: '0'
Sitelist locked flag.
dateTime $created_on
Ignored on add and update.
Sitelist creation time.
string $notes
additional information
size : 1000
dateTime $lastupd
Ignored on add and update.
Sitelist last updated time.
enum_sitelist_category $category
Ignored on update.
Default value: 'display'
Sitelist category
section
Used by the following call(s) and/or data type(s):
SectionService
add()
get()
getAll()
getAllSince()
getByEntity()
getBySite()
update()
entity_data
$section
publisher_data
$section
369
Services
Fields Summary
$is_kids_directed Flag that indicates 'Under-13 Kids Directed'.
$accept_stream_ads Flag that indicates 'accept stream ads'.
$id Site ID. Autoset on creation by SectionService::add()
$description Section description
$site_id ID of site, the section belongs to. Set by SiteService::addSection()
$active Section activity flag.
$code Section code. May be used if site::$uses_section_codes set to TRUE
$mpaa_rating Section MPAA rating. See valid ratings in Rating Enum
$inventory_type_id Section inventory type. See valid types in Inventory Type Enum
$url Section URL.
$registered_urls Section registered URLs.
$discovered_urls Section discovered URLs.
$beacon_conversion_id ID of beacon switched by this section. See Yahoo Ad Exchange Knowledge Base
for details.
$channels The list of channel IDs of the section.
$is_click_fraud Clickfraud activity flag.
$lastupd
$policy_violation Policy violation flag Only 'Policy violation detector' user can change this field
$vurl_id
Fields
boolean $is_kids_directed
Default value: 0
Flag that indicates 'Under-13 Kids Directed'.
boolean $accept_stream_ads
Default value: 0
Flag that indicates 'accept stream ads'.
int $id
Ignored on add and update.
Site ID. Autoset on creation by SectionService::add()
size : 10
primary
string $description
Default value: 'default description'
Section description
size : 50
int $site_id
Ignored on update.
ID of site, the section belongs to. Set by SiteService::addSection()
size : 10
boolean $active
Default value: '1'
Section activity flag.
string $code
Section code. May be used if site::$uses_section_codes set to TRUE
size : 32
nillable
string $mpaa_rating
Default value: 'Unknown'
Section MPAA rating. See valid ratings in Rating Enum
370
Services
The complete list of enum values you can see at rating enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'rating').
enum : rating
int $inventory_type_id
Section inventory type. See valid types in Inventory Type Enum
The complete list of enum values you can see at inventory_type enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'inventory_type').
size : 10
enum : inventory_type
string $url
Section URL.
size : 255
array_of_section_url $registered_urls
Section registered URLs.
array_of_section_url $discovered_urls
Section discovered URLs.
int $beacon_conversion_id
ID of beacon switched by this section. See Yahoo Ad Exchange Knowledge Base for details.
size : 8
nillable
array_of_int $channels
The list of channel IDs of the section.
The complete list of channels you can see at Channel Enum page.
NOTE: The IASH categories have been made available on the Exchange for purposes of convenience. Individual
IASH networks are solely responsible for managing and categorizing their inventory according to and complying with
IASH code of conduct.
boolean $is_click_fraud
Ignored on add and update.
Clickfraud activity flag.
dateTime $lastupd
Ignored on add and update.
boolean $policy_violation
Default value: 0
Policy violation flag Only 'Policy violation detector' user can change this field
private
string $vurl_id
Ignored on add and update.
size : 10
371
Services
section_url
section_url type
section
$discovered_urls
$registered_urls
Fields Summary
$url url.
$verified the url is verified
Fields
string $url
url.
size : 255
primary
boolean $verified
Ignored on add and update.
the url is verified
nillable
section_urls
Used by the following call(s) and/or data type(s):
NotificationService
NotificationService::setAdwareSections()
NotificationService::setPolicyViolationSections()
Fields Summary
$section_id Section id
$section_urls URLs corresponding to section id
Fields
int $section_id
Section id
array_of_string $section_urls
URLs corresponding to section id
segment_attributes
Used by the following call(s) and/or data type(s):
SegmentDefinitionService
add()
get()
update()
Fields Summary
372
Services
Fields
srt_segment_attributes $srt_segment_attributes
SRT segment attributes
nillable
segment_contributor
Used by the following call(s) and/or data type(s):
PixelService
addSegmentContributor()
getSegmentContributor()
Fields Summary
$id Segment Contributor ID
$entity_id Entity ID
$pub_value Unique ID that you specify to identify a publisher. Must be unique for the specified $entity_id.
Must be alphanumeric.
Fields
int $id
Ignored on add and update.
Segment Contributor ID
size : 10
primary
int $entity_id
Entity ID
string $pub_value
Unique ID that you specify to identify a publisher. Must be unique for the specified $entity_id. Must be alphanumeric.
size : 100
segment
segment data type
SegmentService
add()
get()
getAll()
getAncestorsInfo()
getChildSegments()
syncSegments()
update()
Fields Summary
$id Segment ID
$public_segment_id public segment ID
$name Segment name
373
Services
$integration_code integration code - once an integration code has been set it allows you to lookup up for
segment with that code
$active Active flag. Deactivating any segment pixel that you have shared via Audience Share will remove
the corresponding segment shares, and thus will deactivate any line items -- except your own -- that are
targeting this pixel and notify their owners. See Sharing or unsharing segments in the Audience marketplace
for details.
$repeat_ignore_interval repeat ignore interval
$post_click_interval post click interval
$post_view_interval post view interval
$segment_duration Segment duration
$include_by_default included by default flag
$advertiser_entity_id advertiser entity id the pixel is bound to
$exchange_rate exchange rate of the currency (if not in dollars)
$is_deleted shows if object is deleted
$created_on Conversion creation time. Autoset by API.
$lastupd
$hybrid_trigger_type Indicate what kind of hybrid pixel current pixel is
$property_flags Indicate Property flags. ('no_frequency_data','no_recency_data') This field should be set
only for Y!'s BTRE segments.
$segment_type_id Segment type id. See valid types in Segment Type Enum. Applicable only when
$pixel_type = 'Segment'.
$segment_manager_entity_id Segment manager entity id. Applicable only when $pixel_type = 'Segment'.
$parent_external_segment_id This field can be used to denote the hierarchy in case of heirarchy
maintained externally.
$parent_segment_id If parent_segment_id is set parent_external_segment_id is ignored..
$no_of_children Segment No Of children
$external_segment_id API users needs to set this if the hierarchy is maintained externally.
$segment_dimension Represents root of the tree in case particular segment has multiple sub trees. For
eg: device,os,browser in case tts v2 segments
$display_name Represents the last part of the segment name i.e. without the hierarchy
Fields
int $id
Ignored on add and update.
Segment ID
primary
int $public_segment_id
Ignored on add and update.
Default value: null
public segment ID
nillable
string $name
Segment name
string $integration_code
integration code - once an integration code has been set it allows you to lookup up for segment with that code
boolean $active
Active flag. Deactivating any segment pixel that you have shared via Audience Share will remove the corresponding
segment shares, and thus will deactivate any line items -- except your own -- that are targeting this pixel and notify
their owners. See Sharing or unsharing segments in the Audience marketplace for details.
int $repeat_ignore_interval
Default value: '0'
repeat ignore interval
int $post_click_interval
post click interval
374
Services
nillable
int $post_view_interval
post view interval
nillable
int $segment_duration
Default value: 0
Segment duration
This field's purpose - pixel expiration/duration period if pixel type is segment. It can be set for segment pixels only.
Pixel treated as as segment when post_click_interval = 0 and post_view_interval = 0. Valid range is 0..2 years (value
is stored in seconds, so the valid range is 0..63072000)
nillable
boolean $include_by_default
included by default flag
int $advertiser_entity_id
Ignored on update.
advertiser entity id the pixel is bound to
float $exchange_rate
Ignored on update.
Default value: '1'
exchange rate of the currency (if not in dollars)
boolean $is_deleted
Default value: '0'
shows if object is deleted
dateTime $created_on
Ignored on update.
Conversion creation time. Autoset by API.
nillable
dateTime $lastupd
Ignored on add and update.
nillable
string $hybrid_trigger_type
Default value: 'none'
Indicate what kind of hybrid pixel current pixel is
The complete list of enum values you can see at hybrid_trigger_type enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'hybrid_trigger_type').
enum : hybrid_trigger_type
375
Services
string $property_flags
Default value: null
Indicate Property flags. ('no_frequency_data','no_recency_data') This field should be set only for Y!'s BTRE segments.
int $segment_type_id
Ignored on update.
Default value: NULL
Segment type id. See valid types in Segment Type Enum. Applicable only when $pixel_type = 'Segment'.
The complete list of enum values you can see at 4_enum_segment_type, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'segment_type ').
enum : segment_type
nillable
int $segment_manager_entity_id
Ignored on update.
Default value: NULL
Segment manager entity id. Applicable only when $pixel_type = 'Segment'.
nillable
int $parent_external_segment_id
Default value: NULL
This field can be used to denote the hierarchy in case of heirarchy maintained externally.
nillable
int $parent_segment_id
Default value: NULL
If parent_segment_id is set parent_external_segment_id is ignored..
nillable
int $no_of_children
Segment No Of children
int $external_segment_id
API users needs to set this if the hierarchy is maintained externally.
size : 8
string $segment_dimension
Represents root of the tree in case particular segment has multiple sub trees. For eg: device,os,browser in case tts v2
segments
The complete list of enum values you can see at segment_dimension enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'segment_dimension').
enum : segment_dimension
string $display_name
Represents the last part of the segment name i.e. without the hierarchy
size : 50
segment_public_info
segment_public_info data type
376
Services
SegmentService
getAncestorsPublicInfo()
getDescendantsPublicInfo()
Fields Summary
$public_segment_id public segment ID
$name Segment name
$is_deleted shows if object is deleted
$active Active flag.
$parent_public_segment_id parent public segment ID
Fields
int $public_segment_id
Ignored on add and update.
Default value: null
public segment ID
nillable
string $name
Segment name
boolean $is_deleted
Default value: '0'
shows if object is deleted
boolean $active
Active flag.
int $parent_public_segment_id
Ignored on add and update.
Default value: null
parent public segment ID
nillable
segment_report_visibility
This file contains segment report visibility data type that will be used as part of segment visiblity control
ReportService
addSegmentReportVisibility()
getSegmentReportVisibility()
updateSegmentReportVisibility()
Fields Summary
$buyer_id identifiers of the buyer
$seller_id identifiers of the seller
$show_impressions Denotes if buyer can see the impressions related reports
$show_conversions Denotes if buyer can see the conversions related reports
$show_clicks Denotes if buyer can see the clicks related reports
$show_revenue Denotes if buyer can see the revenue related reports
$show_click_through_rate Denotes if buyer can see the CTR related reports
$show_conversion_rate Denotes if buyer can see the conversion rate related reports
$lastupd
Fields
377
Services
int $buyer_id
identifiers of the buyer
primary
int $seller_id
identifiers of the seller
primary
boolean $show_impressions
Default value: true
Denotes if buyer can see the impressions related reports
boolean $show_conversions
Default value: true
Denotes if buyer can see the conversions related reports
boolean $show_clicks
Default value: true
Denotes if buyer can see the clicks related reports
boolean $show_revenue
Default value: true
Denotes if buyer can see the revenue related reports
boolean $show_click_through_rate
Default value: true
Denotes if buyer can see the CTR related reports
boolean $show_conversion_rate
Default value: true
Denotes if buyer can see the conversion rate related reports
dateTime $lastupd
Ignored on add and update.
nillable
private
segment_search_options
Used by the following call(s) and/or data type(s):
PixelService
getSegments()
Fields Summary
$pixel_ids Pixel ids
$pixel_name_pattern Pixel name pattern
Fields
array_of_int $pixel_ids
Pixel ids
nillable
378
Services
string $pixel_name_pattern
Pixel name pattern
Pixel name pattern - search pattern. Leading and/or trailing wild cards (*) can be added to get results for Pixel names
matching the string provided.
nillable
segment_share
Used by the following call(s) and/or data type(s):
PixelService
addSegmentShares()
getSegmentShares()
getShareForSegments()
syncSegmentShares()
Fields Summary
$public_segment_id Public segment id. Available to both Audience Manager buyers/sellers. Should be
used in buyer/seller communications.
$network_ids Seller entity ids to which this segment's targeting is restricted. I.e., this segment may only be
targeted to these sellers. If not set, buyer can target this segment share on any network. Note: Current
implementation allows segment owner to restrict only to their own network.
$targeted_line_items Array of line items that are currently targeting this segment.
$id Segment share id.
$private_segment_id Actual segment id, private to segment's owner. Only available to Audience Manager
sellers.
$buyer_entity_id Data buyer entity id.
Fields
int $public_segment_id
Ignored on add and update.
Public segment id. Available to both Audience Manager buyers/sellers. Should be used in buyer/seller
communications.
nillable
array_of_int $network_ids
Seller entity ids to which this segment's targeting is restricted. I.e., this segment may only be targeted to these sellers.
If not set, buyer can target this segment share on any network. Note: Current implementation allows segment owner to
restrict only to their own network.
array_of_int $targeted_line_items
Ignored on add and update.
Array of line items that are currently targeting this segment.
int $id
Ignored on add and update.
Segment share id.
size : 8
primary
int $private_segment_id
Default value: '0'
Actual segment id, private to segment's owner. Only available to Audience Manager sellers.
size : 8
field : conversion_id
object : segment_share
379
Services
int $buyer_entity_id
Default value: '0'
Data buyer entity id.
size : 10
field : adx_buyer_entity_id
object : segment_share
segment_share_info
segment_share_info data type
Fields Summary
$buyer_id identifiers of the buyer
$segment_id identifiers of the segment
$public_segment_id public identifiers of the segment
$segment_name name of the segment
$buyer_name name of the buyer
Fields
int $buyer_id
identifiers of the buyer
int $segment_id
identifiers of the segment
int $public_segment_id
public identifiers of the segment
string $segment_name
name of the segment
string $buyer_name
name of the buyer
served_domain_data
Fields Summary
$domain_url domain url
$network_entity_id network_entity_id
$publisher_entity_id publisher_entity_id
Fields
string $domain_url
domain url
int $network_entity_id
network_entity_id
int $publisher_entity_id
publisher_entity_id
380
Services
session
Used by the following call(s) and/or data type(s):
ContactService
getActiveSessions()
Fields Summary
$token session token
$creation_time Creation time
$modification_time Modification time
$ip_address Numeric network address in network byte order. Use a standard inet_ntoa function to convert
to the dotted-quad representation of the address as a string.
$contact_id contact id
Fields
string $token
session token
dateTime $creation_time
Creation time
dateTime $modification_time
Modification time
string $ip_address
Numeric network address in network byte order. Use a standard inet_ntoa function to convert to the dotted-quad
representation of the address as a string.
int $contact_id
contact id
site
Used by the following call(s) and/or data type(s):
SiteService
add()
get()
getAll()
getAllSince()
getByEntity()
SiteService::getByPublisherDepr()
update()
entity_data
$site
publisher_data
$site
Fields Summary
$id Site ID. Autoset on creation by SiteService::add()
$description Site description
$publisher_entity_id ID of publisher, the site belongs to. Set by PublisherService::addSite()
$active Site activity flag.
$default_section_id ID of site default section
$uses_section_codes If TRUE, section code may be used in a tag if $default_section_id is specified.
$site_url
$code Site code. May be used if publisher::$uses_site_codes set to TRUE
$sections_share_channels
$vurl_id
$lastupd
381
Services
Fields
int $id
Ignored on add and update.
Site ID. Autoset on creation by SiteService::add()
size : 10
primary
string $description
Default value: 'default description'
Site description
size : 50
int $publisher_entity_id
Ignored on update.
ID of publisher, the site belongs to. Set by PublisherService::addSite()
size : 10
boolean $active
Default value: '1'
Site activity flag.
int $default_section_id
Default value: '0'
ID of site default section
size : 10
boolean $uses_section_codes
Default value: '0'
If TRUE, section code may be used in a tag if $default_section_id is specified.
string $site_url
size : 255
string $code
Site code. May be used if publisher::$uses_site_codes set to TRUE
size : 32
nillable
int $sections_share_channels
Ignored on add and update.
Default value: '1'
size : 1
string $vurl_id
Ignored on add and update.
size : 10
dateTime $lastupd
Ignored on add and update.
382
Services
size_data
This file defines size_data data type
Fields Summary
$serial_no external serial number
$width size width
$height size height
$network_learn_price size network_learn_price
$size_code size size_code
$daily_volume size daily_volume
$daily_revenue size daily_revenue
$description size description
Fields
int $serial_no
external serial number
int $width
size width
int $height
size height
float $network_learn_price
size network_learn_price
string $size_code
size size_code
int $daily_volume
size daily_volume
float $daily_revenue
size daily_revenue
string $description
size description
size
See Size Enum for more information on the Size enum.
DictionaryService
getSizes()
Fields Summary
$id size ID
$width size width
$height size height
$network_learn_price network learn price, in USD
$daily_volume size daily volume
$daily_revenue size daily revenue, in USD
$description size description
383
Services
Fields
int $id
size ID
size : 10
primary
int $width
size width
size : 8
int $height
size height
size : 8
float $network_learn_price
network learn price, in USD
int $daily_volume
size daily volume
size : 20
float $daily_revenue
size daily revenue, in USD
string $description
size description
size : 255
srt_segment_attributes
Used by the following call(s) and/or data type(s):
segment_attributes
$srt_segment_attributes
Fields Summary
$linguistic_market Linguistic market. See valid types in Srt Linguistic Markets Enum. Once
$linguistic_market has been set for a segment. It cannot be changed.
$match_type Match type. See valid types in Srt Match Type Enum
$recency_in_days Recency in days. See valid types in Srt Recency In Days Enum
Fields
enum_srt_linguistic_markets $linguistic_market
Linguistic market. See valid types in Srt Linguistic Markets Enum. Once $linguistic_market has been set for a
segment. It cannot be changed.
enum_srt_match_type $match_type
Match type. See valid types in Srt Match Type Enum
enum_srt_recency_in_days $recency_in_days
Recency in days. See valid types in Srt Recency In Days Enum
384
Services
srt_segment_report
Used by the following call(s) and/or data type(s):
SegmentDefinitionService
srtKeywordsReport()
Fields Summary
$keyword SRT keyword
$match_type Match type for keyword 'exact' or 'broad'. Notes: empty string in the case of unattributed
impressions, clicks, and conversions where keyword will be listed as 'unattributed'. Broad match contribution
to the segment performance will be listed as a single row with match_type of 'broad' and empty keyword
string.
$impressions The number of impressions.
$clicks The number of clicks.
$conversions The number of conversions.
Fields
string $keyword
SRT keyword
string $match_type
Match type for keyword 'exact' or 'broad'. Notes: empty string in the case of unattributed impressions, clicks, and
conversions where keyword will be listed as 'unattributed'. Broad match contribution to the segment performance will
be listed as a single row with match_type of 'broad' and empty keyword string.
int $impressions
The number of impressions.
int $clicks
The number of clicks.
int $conversions
The number of conversions.
srt_segment_status
Used by the following call(s) and/or data type(s):
SegmentDefinitionService
srtKeywordsGet()
Fields Summary
$keyword SRT keyword
$status Keyword status
Fields
string $keyword
SRT keyword
enum_srt_keyword_status $status
Keyword status
385
Services
supply_blocklist
supply_blocklist data type
SupplyBlocklistService
add()
getAllBlocklists()
getAllSince()
getByObjectId()
update()
Fields Summary
$id Supply blocklist ID.
$name Supply block list name.
$description Supply block list description.
$entity_id Owner entity ID.
$entity_name Name of owner entity.
$managed_demand Complex data type to represent managed advertiser attributes.
$block_supply Complex data type to represent supply attributes.
$created_by_contact_id Contact id who created supply blocklist.
$created_by_contact_name Name of contact who created rule.
$modified_by_contact_id Contact id who modified supply blocklist.
$modified_by_contact_name Name of contact who modified rule.
$active Supply blocklist activity flag.
$created_on Supply blocklist created on date/time.
$lastupd Supply blocklist last updated date/time.
Fields
int $id
Ignored on update.
Supply blocklist ID.
primary
string $name
Supply block list name.
string $description
Supply block list description.
int $entity_id
Ignored on add and update.
Owner entity ID.
string $entity_name
Name of owner entity.
managed_demand $managed_demand
Complex data type to represent managed advertiser attributes.
supply $block_supply
Complex data type to represent supply attributes.
int $created_by_contact_id
Contact id who created supply blocklist.
string $created_by_contact_name
Name of contact who created rule.
386
Services
int $modified_by_contact_id
Contact id who modified supply blocklist.
string $modified_by_contact_name
Name of contact who modified rule.
boolean $active
Default value: '0'
Supply blocklist activity flag.
dateTime $created_on
Ignored on add and update.
Supply blocklist created on date/time.
dateTime $lastupd
Ignored on add and update.
Supply blocklist last updated date/time.
supply
supply data type
supply_blocklist
$block_supply
Fields Summary
$marketplace Supply rule applicable on Trading Pit, Network of network, Intra Network(Managed) or any
combination of these. See Buying Selling Marketplace Enum for valid values.
$selling_technology Array of selling technology. Allowed values are 'RTBS','Hosted'. See Selling
Technology Enum for valid values.
$publishers Publishers.
$woeids Woeids.
$cga_ids Custom geo area ids.
$sections Sections.
$channels Channels.
$urls URLs.
$ages Ages.
$gender Gender.
$vurls Vurls.
Fields
array_of_enum_buying_selling_marketplace $marketplace
Supply rule applicable on Trading Pit, Network of network, Intra Network(Managed) or any combination of these. See
Buying Selling Marketplace Enum for valid values.
array_of_enum_selling_technology $selling_technology
Array of selling technology. Allowed values are 'RTBS','Hosted'. See Selling Technology Enum for valid values.
publisher_list $publishers
Publishers.
rule_attribute $woeids
Woeids.
rule_attribute $cga_ids
Custom geo area ids.
387
Services
rule_attribute $sections
Sections.
rule_attribute $channels
Channels.
rule_attribute_names $urls
URLs.
rule_attribute_ids $ages
Ages.
gender $gender
Gender.
rule_vurl_data $vurls
Vurls.
supported_locale
Used by the following call(s) and/or data type(s):
DictionaryService
getSupportedLocales()
Fields Summary
$id Locale ID
$locale Locale name
$description Locale description
Fields
int $id
Locale ID
size : 5
primary
string $locale
Locale name
size : 100
string $description
Locale description
supporting_file
Used by the following call(s) and/or data type(s):
CreativeService
addSupportingFiles()
PlacementService
PlacementService::addCreative()
Fields Summary
388
Services
Fields
string $filename
the file name of the ad to be uploaded
binary $data
the actual binary data of the ad to be uploaded
sync_segment_response
sync_segment_response data type
SegmentService
syncSegments()
Fields Summary
$result status of the operation
$sync_result enum of (created/updated/deleted/unchanged) to be used incase of $result is true
$external_segment_id for mapping to the input request
$segment_id id of segment thats created/modified
$error_message to be used in case result is false
Fields
boolean $result
status of the operation
string $sync_result
enum of (created/updated/deleted/unchanged) to be used incase of $result is true
The complete list of enum values you can see at sync_result enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'sync_result').
enum : sync_result
int $external_segment_id
for mapping to the input request
int $segment_id
id of segment thats created/modified
string $error_message
to be used in case result is false
tag_emails
Fields Summary
$tag_id
$emails
Fields
389
Services
int $tag_id
array_of_string $emails
target_advertiser_entity
Used by the following call(s) and/or data type(s):
targetings
$Advertisers
Fields Summary
$advertiser_default
$advertiser_ids
Fields
boolean $advertiser_default
array_of_int $advertiser_ids
target_age
Used by the following call(s) and/or data type(s):
targetings
$Ages
Fields Summary
$age_default Default age
$target_age Target ages
Fields
boolean $age_default
Default age
array_of_int $target_age
Target ages
target_asl
Fields Summary
$section_group_ids section group id list
Fields
array_of_int $section_group_ids
section group id list
390
Services
target_browser
Used by the following call(s) and/or data type(s):
targetings
$Browsers
Fields Summary
$browser_default
$browser_ids List of browser's ids
Fields
boolean $browser_default
array_of_int $browser_ids
List of browser's ids
target_buyer_entity
Used by the following call(s) and/or data type(s):
targetings
$Buyers
Fields Summary
$buyer_entity_default
$buyer_ids List of buyer entity ids
Fields
boolean $buyer_entity_default
array_of_int $buyer_ids
List of buyer entity ids
target_buyer_line_item
Used by the following call(s) and/or data type(s):
targetings
$BuyerLineItems
Fields Summary
$buyer_line_item_default Default treatment flag
$line_items Array if line item ids
Fields
boolean $buyer_line_item_default
Default treatment flag
array_of_int $line_items
Array if line item ids
391
Services
target_cga
Fields Summary
$target_cga Target CGA
$cga_ids List of cgas
Fields
boolean $target_cga
Target CGA
array_of_int $cga_ids
List of cgas
target_channel
NOTE: Inventory classified with one of the IASH categories does not automatically imply that the inventory is in fact
IASH compliant or that Yahoo Ad Exchange is making any representations or warranties about the IASH status of
such inventory. The IASH categories have been made available on the Exchange for purposes of convenience.
Individual IASH networks are solely responsible for managing and categorizing their inventory according to and
complying with IASH code of conduct. Targeting to both an IASH channel and a non-IASH channel may result in only
the non-IASH channel being targeted.
targetings
$Channels
Fields Summary
$channel_default Default treatment flag
$include_channel_ids List of included channel ids
$exclude_channel_ids List of excluded channel ids
Fields
boolean $channel_default
Default treatment flag
array_of_int $include_channel_ids
List of included channel ids
array_of_int $exclude_channel_ids
List of excluded channel ids
target_click_url
Used by the following call(s) and/or data type(s):
targetings
$ClickUrls
Fields Summary
$click_url_default
$urls List of URL patterns in effect
Fields
392
Services
boolean $click_url_default
array_of_string $urls
List of URL patterns in effect
target_click_url_object
Fields Summary
$click_url_default
$urls List of URL patterns in effect
$total_count
Fields
string $click_url_default
array_of_string $urls
List of URL patterns in effect
int $total_count
target_click_url_v2
Fields Summary
$click_url_default
$urls List of URL patterns in effect
$total_count
Fields
boolean $click_url_default
array_of_string $urls
List of URL patterns in effect
int $total_count
target_country
Fields Summary
$country_include Country include
$country_id List of countries id
Fields
boolean $country_include
Country include
array_of_int $country_id
List of countries id
393
Services
target_creative_beacon
Used by the following call(s) and/or data type(s):
targetings
$CreativeBeacons
Fields Summary
$creative_beacon_default
$creative_beacon_id Creative beacons list
Fields
boolean $creative_beacon_default
array_of_int $creative_beacon_id
Creative beacons list
target_creative
Used by the following call(s) and/or data type(s):
targetings
$CreativeBeacons
$CreativeTags
$Creatives
Fields Summary
$creative_default Creative default
$creative_ids Creative id list
Fields
boolean $creative_default
Creative default
array_of_int $creative_ids
Creative id list
target_creative_tag
Used by the following call(s) and/or data type(s):
targetings
$CreativeTags
Fields Summary
$creative_tag_id Creative tags list
Fields
array_of_int $creative_tag_id
Creative tags list
394
Services
target_csl
Fields Summary
$section_ids section group id list
Fields
array_of_int $section_ids
section group id list
target_daypart
Used by the following call(s) and/or data type(s):
targetings
$Dayparts
Fields Summary
$relative_time_region_id ID of a region targeting is relative to (0 - relative to user's time, otherwise relative
to the region specified by this ID)
$dayparts List of dayparts when creative may be shown
Fields
int $relative_time_region_id
ID of a region targeting is relative to (0 - relative to user's time, otherwise relative to the region specified by this ID)
array_of_daypart $dayparts
List of dayparts when creative may be shown
target_frequency
Used by the following call(s) and/or data type(s):
placement
$frequency_target
targetings
$Frequency
Fields Summary
$frequency
$period
Fields
int $frequency
nillable
int $period
nillable
395
Services
target_gender
Used by the following call(s) and/or data type(s):
targetings
$Gender
Fields Summary
$include_male_gender show or not to show creatives to users of a male gender
$include_female_gender show or not to show creatives to users of a female gender
$include_unknown_gender show or not to show creatives to users when gender information is not
available
Fields
boolean $include_male_gender
show or not to show creatives to users of a male gender
boolean $include_female_gender
show or not to show creatives to users of a female gender
boolean $include_unknown_gender
show or not to show creatives to users when gender information is not available
target_geography
Used by the following call(s) and/or data type(s):
placement
$geo_target
targetings
$Geography
Fields Summary
$use_regions Switch between country & region or DMA usage
$country_ids List of country ids
$region_ids List of region ids
$dma_ids List of DMA ids
Fields
boolean $use_regions
Switch between country & region or DMA usage
array_of_int $country_ids
List of country ids
array_of_int $region_ids
List of region ids
array_of_int $dma_ids
List of DMA ids
396
Services
targeting_hidden_params
This file defines ivc_hidden_params data type
ivc_hidden_params
$targeting_hidden_params
Fields Summary
$url IVC hidden parameter for URL
$content_segments IVC hidden parameter for content segments
$sub_domain IVC hidden parameter for Sub domain.
Fields
boolean $url
Default value: '0'
IVC hidden parameter for URL
boolean $content_segments
Default value: '0'
IVC hidden parameter for content segments
boolean $sub_domain
Default value: '0'
IVC hidden parameter for Sub domain.
targetings
Used by the following call(s) and/or data type(s):
TargetProfileService
get()
getByObject()
Fields Summary
$Sizes List of creative sizes
$Sections List of sections
$Languages List of languags
$Netspeeds list of netspeeds
$InventoryTypes List of inventory types
$Publishers List of publisher entitys
$Urls List of URL patterns in effect
$ClickUrls List of click URL patterns in effect
$Browsers List of browsers
$Isps List of ISPs
$Channels List of excluded channels
$Rating Target rating
$Frequency Target Frequency
$Geography Targeting rules on region, country and msa
$GeographyV2 Targeting rules on woeid and cga
$Gender Object of target_gender
$Dayparts List of dayparts when creative may be shown
$Pixels Objects of target_pixel
$QueryString Query string
$VurlTags List of validated url tags
$ValidatedUrls List of validated urls
$Advertisers List of entity ids
$DealProperties Object of deal properties
$Ages List of target ages
$CreativeTags Creative tags list
$CreativeBeacons Creative beacon list
$CreativeSpecs Creative specs object
397
Services
Fields
target_size $Sizes
List of creative sizes
nillable
target_section $Sections
List of sections
nillable
target_language $Languages
List of languags
nillable
target_netspeed $Netspeeds
list of netspeeds
nillable
target_inventory_type $InventoryTypes
List of inventory types
nillable
target_publisher_entity $Publishers
List of publisher entitys
nillable
target_url $Urls
List of URL patterns in effect
nillable
target_click_url $ClickUrls
List of click URL patterns in effect
nillable
target_browser $Browsers
List of browsers
nillable
target_isp $Isps
List of ISPs
nillable
target_channel $Channels
List of excluded channels
nillable
398
Services
target_rating $Rating
Target rating
target_frequency $Frequency
Target Frequency
target_geography $Geography
Targeting rules on region, country and msa
nillable
target_woeid_cga $GeographyV2
Targeting rules on woeid and cga
nillable
target_gender $Gender
Object of target_gender
nillable
target_daypart $Dayparts
List of dayparts when creative may be shown
nillable
target_pixels $Pixels
Objects of target_pixel
from : conversion
nillable
target_querystring $QueryString
Query string
nillable
target_vurl_tag $VurlTags
List of validated url tags
nillable
target_vurl $ValidatedUrls
List of validated urls
nillable
target_advertiser_entity $Advertisers
List of entity ids
nillable
deal_properties $DealProperties
Object of deal properties
nillable
target_age $Ages
List of target ages
nillable
399
Services
target_creative_tag $CreativeTags
Creative tags list
nillable
target_creative_beacon $CreativeBeacons
Creative beacon list
nillable
creative_specs $CreativeSpecs
Creative specs object
nillable
target_creative $Creatives
Creatives list
nillable
target_buyer_line_item $BuyerLineItems
Array of buyer line items
nillable
target_seller_line_item $SellerLineItems
Array of seller line items
nillable
target_offer_type $OfferTypes
List of offer types
nillable
target_buyer_entity $Buyers
List of buyer entities
nillable
target_inventory_media_type
Fields Summary
$inventory_media_type_default
$inventory_media_type_ids List of inventory media type's ids
Fields
boolean $inventory_media_type_default
array_of_int $inventory_media_type_ids
List of inventory media type's ids
400
Services
target_inventory_type
Used by the following call(s) and/or data type(s):
targetings
$InventoryTypes
Fields Summary
$inventory_type_default
$inventory_type_ids List of inventory type's ids
Fields
boolean $inventory_type_default
array_of_int $inventory_type_ids
List of inventory type's ids
target_isp
Used by the following call(s) and/or data type(s):
targetings
$Isps
Fields Summary
$isp_default
$isp_ids List of ISP's ids
Fields
boolean $isp_default
array_of_int $isp_ids
List of ISP's ids
target_language
Used by the following call(s) and/or data type(s):
targetings
$Languages
Fields Summary
$language_default
$language_ids List of language ids
Fields
boolean $language_default
array_of_int $language_ids
List of language ids
401
Services
target_mobile_carrier_data
Used by the following call(s) and/or data type(s):
DictionaryService
getMobileCarriers()
Fields Summary
$mobile_id mobile id
$country country
$carrier carrier
Fields
int $mobile_id
mobile id
nillable
string $country
country
nillable
string $carrier
carrier
nillable
target_mobile_os_data
Used by the following call(s) and/or data type(s):
DictionaryService
getMobileOSs()
Fields Summary
$mobile_id mobile id
$os os
Fields
int $mobile_id
mobile id
nillable
string $os
os
nillable
target_netspeed
Used by the following call(s) and/or data type(s):
targetings
$Netspeeds
402
Services
Fields Summary
$netspeed_default
$netspeed_ids List of netspeed ids
Fields
boolean $netspeed_default
array_of_int $netspeed_ids
List of netspeed ids
target_offer_type
Used by the following call(s) and/or data type(s):
targetings
$OfferTypes
Fields Summary
$offer_type_default Default treatment flag
$offer_type_ids List of creative size's ids
Fields
boolean $offer_type_default
Default treatment flag
array_of_int $offer_type_ids
List of creative size's ids
target_pixel
Used by the following call(s) and/or data type(s):
TargetProfileService
getTargetContentCategories()
getTargetPixels()
setTargetContentCategories()
setTargetPixels()
target_pixels
$target_pixels
targetings
$Pixels
Fields Summary
$conversion_id Conversion ID. Should be empty if this segment does not belong to you.
$public_segment_id Public segment ID
$negated If true, limits delivery to users who have not seen the pixel. Otherwise, to users who have seen
the pixel.
$seconds_since_conversion If given, limits delivery to users who have seen/not seen the pixel (depending
on $negated) within this time interval (in seconds).
$frequency_min If given, limits delivery to users who have seen/not seen the pixel (depending on
$negated) at least this number of times (Min: 0, Max: 255).
Fields
int $conversion_id
403
Services
Conversion ID. Should be empty if this segment does not belong to you.
nillable
int $public_segment_id
Public segment ID
boolean $negated
Default value: '0'
If true, limits delivery to users who have not seen the pixel. Otherwise, to users who have seen the pixel.
int $seconds_since_conversion
If given, limits delivery to users who have seen/not seen the pixel (depending on $negated) within this time interval (in
seconds).
nillable
int $frequency_min
If given, limits delivery to users who have seen/not seen the pixel (depending on $negated) at least this number of
times (Min: 0, Max: 255).
nillable
target_pixels
Used by the following call(s) and/or data type(s):
targetings
$Pixels
Fields Summary
$require_all if true - limiting delivery only to those who have seen the pixel, false - otherwise
$target_pixels
$logical_expression Logical expression
Fields
boolean $require_all
if true - limiting delivery only to those who have seen the pixel, false - otherwise
array_of_target_pixel $target_pixels
string $logical_expression
Logical expression
target_profile
Used by the following call(s) and/or data type(s):
TargetProfileService
get()
getAllSince()
getByObject()
updateTargetProfile()
Fields Summary
404
Services
$creative_beacon_default
$id
$name
$entity_id
$time_relative_to The complete list of enum values you can see at time_relative_to enum page, at run
time you can get all of them using DictionaryService.getEnumValues(token, 'time_relative_to').
$relative_time_region_id The complete list of enum values you can see at region enum page, at run time
you can get all of them using DictionaryService.getEnumValues(token, 'region').
$time_include
$country_include
$section_default
$gmt_offset
$target_msa
$target_woeid
$target_cga
$show_to_unknown
$age_default
$netspeed_default
$seller_entity_default
$browser_default
$size_default
$active
$created_on
$lastupd
$language_default
$channel_default
$inventory_type_default
$offer_type_default
$max_mpaa_rating The complete list of enum values you can see at max_rating enum page, at run time
you can get all of them using DictionaryService.getEnumValues(token, 'max_rating').
$creative_specs_id
$buyer_entity_default
$creative_default
$frequency_period
$frequency_exposures
$isp_default
$url_default
$click_url_default
$click_url_rtbd_default
$click_url_hosted_default
$line_item_default
$buyer_line_item_default
$seller_line_item_default
$site_default
$querystring_default
$require_all_querystrings
$querystring_logic_expression
$require_all_conversions
$pixel_logic_expression
$vurl_default
$vurl_category_default
$require_audited_vurl
$no_adware
$no_click_fraud For configuring VURL targets.Set to 0 will serve to the URLs of sites with suspicious
traffic.
$rmx_100_only
$rmx_250_only
$advertiser_default
$include_male_gender
$include_female_gender
$include_unknown_gender
$no_foreign_language_vurls
$approved_vurls_only
$active_vurls_only
$is_default
$default_profile_name Name of target profile if it is default
$creative_tag_default
$pvt_marketplace_default
$inventory_media_type_default
$transparency_default
Fields
405
Services
boolean $creative_beacon_default
Default value: 1
int $id
size : 8
primary
string $name
Default value: 'No Name Set'
size : 255
int $entity_id
size : 10
string $time_relative_to
Default value: 'User'
The complete list of enum values you can see at time_relative_to enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'time_relative_to').
enum : time_relative_to
int $relative_time_region_id
Default value: 34
The complete list of enum values you can see at region enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'region').
size : 5
enum : region
boolean $time_include
Default value: 0
boolean $country_include
Default value: 0
boolean $section_default
Default value: 1
int $gmt_offset
Default value: 0
size : 9
boolean $target_msa
Default value: 0
boolean $target_woeid
Default value: 0
boolean $target_cga
Default value: 0
boolean $show_to_unknown
Default value: 1
406
Services
boolean $age_default
Default value: 1
boolean $netspeed_default
Default value: 1
boolean $seller_entity_default
Default value: 1
boolean $browser_default
Default value: 1
boolean $size_default
Default value: 1
boolean $active
Default value: 1
dateTime $created_on
Ignored on update.
nillable
dateTime $lastupd
Ignored on add and update.
nillable
boolean $language_default
Default value: 1
boolean $channel_default
Default value: 1
boolean $inventory_type_default
Default value: 1
boolean $offer_type_default
Default value: 1
string $max_mpaa_rating
Default value: 'Any'
The complete list of enum values you can see at max_rating enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'max_rating').
enum : max_rating
int $creative_specs_id
Default value: NULL
size : 10
nillable
boolean $buyer_entity_default
Default value: 1
boolean $creative_default
Default value: 1
407
Services
int $frequency_period
Default value: 0
size : 11
nillable
int $frequency_exposures
Default value: 0
size : 9
nillable
boolean $isp_default
Default value: 1
boolean $url_default
Default value: 1
boolean $click_url_default
Default value: 1
boolean $click_url_rtbd_default
Default value: 1
boolean $click_url_hosted_default
Default value: 1
boolean $line_item_default
Default value: 1
boolean $buyer_line_item_default
Default value: 1
boolean $seller_line_item_default
Default value: 1
boolean $site_default
Default value: 1
boolean $querystring_default
Default value: 1
boolean $require_all_querystrings
Default value: 0
string $querystring_logic_expression
Default value: NULL
size : 1024
boolean $require_all_conversions
Default value: 1
string $pixel_logic_expression
Default value: NULL
size : 1024
408
Services
boolean $vurl_default
Default value: 1
boolean $vurl_category_default
Default value: 1
boolean $require_audited_vurl
Default value: 0
boolean $no_adware
Default value: 0
boolean $no_click_fraud
Default value: 0
For configuring VURL targets.Set to 0 will serve to the URLs of sites with suspicious traffic.
boolean $rmx_100_only
Default value: 0
boolean $rmx_250_only
Default value: 0
boolean $advertiser_default
Default value: 1
boolean $include_male_gender
Default value: 1
boolean $include_female_gender
Default value: 1
boolean $include_unknown_gender
Default value: 1
boolean $no_foreign_language_vurls
Default value: 0
boolean $approved_vurls_only
Default value: 0
boolean $active_vurls_only
Default value: 0
int $is_default
Ignored on add and update.
size : 1
nillable
string $default_profile_name
Name of target profile if it is default
size : 127
nillable
409
Services
boolean $creative_tag_default
Ignored on add and update.
Default value: 1
boolean $pvt_marketplace_default
Default value: 1
boolean $inventory_media_type_default
Default value: 2
boolean $transparency_default
Default value: 2
target_publisher_entity
Used by the following call(s) and/or data type(s):
targetings
$Publishers
Fields Summary
$seller_entity_default
$publisher_entity_ids List of publisher entity ids
Fields
boolean $seller_entity_default
array_of_int $publisher_entity_ids
List of publisher entity ids
target_pvt_marketplace
Fields Summary
$pvt_marketplace_default Default
$pvt_marketplace_ids Target Private Markeplaces
Fields
boolean $pvt_marketplace_default
Default
array_of_int $pvt_marketplace_ids
Target Private Markeplaces
target_querystring
Used by the following call(s) and/or data type(s):
targetings
$QueryString
Fields Summary
410
Services
Fields
enum_query_string_option $query_string_option
Query string option
array_of_string $query_strings
string $query_string_logical_expression
target_rating
Used by the following call(s) and/or data type(s):
targetings
$Rating
Fields Summary
$max_mpaa_rating Maximum allowed rating
Fields
string $max_mpaa_rating
Maximum allowed rating
target_section
Used by the following call(s) and/or data type(s):
placement
$section_target
targetings
$Sections
Fields Summary
$section_default this flag let you specify how to treat the elements of section_ids array. If it is set to true -
not listed sections are allowed, false - not listed sections are forbidden.
$section_ids the array of section IDs
Fields
boolean $section_default
this flag let you specify how to treat the elements of section_ids array. If it is set to true - not listed sections are
allowed, false - not listed sections are forbidden.
array_of_int $section_ids
the array of section IDs
411
Services
target_seller_line_item
Used by the following call(s) and/or data type(s):
targetings
$SellerLineItems
Fields Summary
$seller_line_item_default Default treatment flag
$line_items Array if line item ids
Fields
boolean $seller_line_item_default
Default treatment flag
array_of_int $line_items
Array if line item ids
target_size
Used by the following call(s) and/or data type(s):
targetings
$Sizes
Fields Summary
$size_default Target profile size_default
$size_ids List of creative size's ids
Fields
boolean $size_default
Target profile size_default
array_of_int $size_ids
List of creative size's ids
target_transparency
Fields Summary
$transparency_default
$transparency_ids transparency id
Fields
boolean $transparency_default
array_of_int $transparency_ids
transparency id
412
Services
target_url
Used by the following call(s) and/or data type(s):
targetings
$Urls
Fields Summary
$url_default
$urls List of URL patterns in effect
Fields
boolean $url_default
array_of_string $urls
List of URL patterns in effect
target_vurl
Used by the following call(s) and/or data type(s):
targetings
$ValidatedUrls
$VurlTags
Fields Summary
$options
$vurl_ids
Fields
vurl_options $options
array_of_int $vurl_ids
target_vurl_tag
Used by the following call(s) and/or data type(s):
targetings
$VurlTags
Fields Summary
$vurl_tag_ids
Fields
array_of_int $vurl_tag_ids
413
Services
target_woeid_cga
Used by the following call(s) and/or data type(s):
targetings
$GeographyV2
Fields Summary
$woeids List of woeids
$cga_ids List of cga ids
$postal_codes List of postal_codes object
Fields
array_of_int $woeids
List of woeids
array_of_int $cga_ids
List of cga ids
array_of_postal_codes $postal_codes
List of postal_codes object
target_woeid
Used by the following call(s) and/or data type(s):
targetings
$GeographyV2
Fields Summary
$target_woeid Target Woeid
$woeids List of woeids
Fields
boolean $target_woeid
Target Woeid
array_of_int $woeids
List of woeids
techno_data
techno_data data type
DictionaryService
getTechnoDimensions()
getTechnoIds()
Fields Summary
$techno_id Techno id
$parent_techno_id This field can be used to denote the hierarchy.
$name Techo name
$display_name Techno display name
414
Services
Fields
int $techno_id
Techno id
int $parent_techno_id
This field can be used to denote the hierarchy.
string $name
Techo name
string $display_name
Techno display name
tiered_rev_share
This file defines tiered rev share type
marketplace_settings
$buyer_tiered_rev_share
$seller_tiered_rev_share
Fields Summary
$monthly_revenue Monthly revenue for buyer/seller seat.
$rev_share Revenue share for buyer/seller seat.
Fields
int $monthly_revenue
Monthly revenue for buyer/seller seat.
float $rev_share
Revenue share for buyer/seller seat.
tpbe_currency
Used by the following call(s) and/or data type(s):
trading_pit_billing_entity
$tpbe_currency
Fields Summary
$forex_currency_id Forex Currency id
$name Currency name.
$symbol currency symbol.
Fields
int $forex_currency_id
Forex Currency id
string $name
Currency name.
415
Services
string $symbol
currency symbol.
tp_billing_entity_preferences
id data type
marketplace_settings
$buyer_tpbe_prefs
$seller_tpbe_prefs
Fields Summary
$tpbe_id TPBE ID.
$preference_order Preferences order - 1, 2, 3, 4, 5. 1 - highest. 5 - lowest.
$forex_currency_id Forex currency id - preferred currency of business with TPBE
$active Active flag
Fields
int $tpbe_id
TPBE ID.
size : 2
primary
int $preference_order
Default value: '1'
Preferences order - 1, 2, 3, 4, 5. 1 - highest. 5 - lowest.
size : 1
int $forex_currency_id
Default value: '153'
Forex currency id - preferred currency of business with TPBE
size : 3
boolean $active
Default value: '1'
Active flag
trading_pit_billing_entity
trading_pit_billing_entity data type.
Fields Summary
$id Trading pit Billing Entity id
$name Billing Entity Name.
$tpbe_currency Trading pit Billing entity Currency
Fields
int $id
Ignored on add and update.
Trading pit Billing Entity id
primary
416
Services
string $name
Billing Entity Name.
array_of_tpbe_currency $tpbe_currency
Trading pit Billing entity Currency
trading_pit_blocklist
trading data type
Fields Summary
$id Exchange wide blocklist id for trading pit.
$name Trading pit blocklist name.
$description Trading pit blocklist description.
$entity_id Owner entity ID
$entity_name Name of owner entity.
$supply Complex data type to represent supply attributes.
$demand Complex data type to represent demand attributes.
$created_by_contact_id Contact id who created trading pit blocklist.
$created_by_contact_name Name of contact who created rule.
$modified_by_contact_id Contact id who modified trading pit blocklist.
$modified_by_contact_name Name of contact who modified rule.
$active Trading pit blocklist activity flag.
$created_on Trading pit blocklist created on date/time.
$lastupd Trading pit blocklist last updated date/time.
Fields
int $id
Ignored on update.
Exchange wide blocklist id for trading pit.
primary
string $name
Trading pit blocklist name.
string $description
Trading pit blocklist description.
int $entity_id
Ignored on add and update.
Owner entity ID
string $entity_name
Name of owner entity.
trading_pit_supply $supply
Complex data type to represent supply attributes.
trading_pit_demand $demand
Complex data type to represent demand attributes.
int $created_by_contact_id
Ignored on add and update.
Contact id who created trading pit blocklist.
string $created_by_contact_name
417
Services
int $modified_by_contact_id
Ignored on add and update.
Contact id who modified trading pit blocklist.
string $modified_by_contact_name
Name of contact who modified rule.
boolean $active
Default value: '0'
Trading pit blocklist activity flag.
dateTime $created_on
Ignored on add and update.
Trading pit blocklist created on date/time.
dateTime $lastupd
Ignored on add and update.
Trading pit blocklist last updated date/time.
trading_pit_creative_properties
trading data type
trading_pit_demand
$creative_tags
Fields Summary
$creative_policy_tags Creative policy tags.
$creative_specs Creative specs.
$creative_themes Creative themes.
$creative_languages Creative languages.
$creative_beacons Creative beacons.
$include Include is set "true" to include or "false" to exclude particular segments specified in
$creative_specs, $creative_themes, $creative_beacons, $creative_languages arrays.
Fields
array_of_id_name $creative_policy_tags
Creative policy tags.
array_of_id_name $creative_specs
Creative specs.
array_of_id_name $creative_themes
Creative themes.
array_of_id_name $creative_languages
Creative languages.
array_of_id_name $creative_beacons
Creative beacons.
boolean $include
418
Services
Include is set "true" to include or "false" to exclude particular segments specified in $creative_specs,
$creative_themes, $creative_beacons, $creative_languages arrays.
trading_pit_demand
trading data type
trading_pit_blocklist
$demand
Fields Summary
$buying_technology Array of buying technology 'RTBD', 'Hosted'. See Buying Technology Enum for valid
values.
$creative_tags Creative tag ids for creative_specs, creative_themes, creative_languages,
creative_beacons.
$click_urls Click Urls.
$offer_types Offer types.
Fields
array_of_enum_buying_technology $buying_technology
Array of buying technology 'RTBD', 'Hosted'. See Buying Technology Enum for valid values.
trading_pit_creative_properties $creative_tags
Creative tag ids for creative_specs, creative_themes, creative_languages, creative_beacons.
rule_attribute_names $click_urls
Click Urls.
rule_attribute $offer_types
Offer types.
trading_pit_supply
trading data type
trading_pit_blocklist
$supply
Fields Summary
$selling_technology Array of selling technology. Allowed values are 'RTBS','Hosted'. See Selling
Technology Enum for valid values.
$woeids Woeids.
$urls URLs.
$ages Ages.
$vurls Vurls.
Fields
array_of_enum_selling_technology $selling_technology
Array of selling technology. Allowed values are 'RTBS','Hosted'. See Selling Technology Enum for valid values.
rule_attribute $woeids
Woeids.
419
Services
rule_attribute_names $urls
URLs.
rule_attribute_ids $ages
Ages.
rule_vurl_data $vurls
Vurls.
traf_monitor_alert
Used by the following call(s) and/or data type(s):
NotificationService
addTMAlert()
getAllTMAlerts()
getTMAlert()
updateTMAlert()
Fields Summary
$id Alert ID
$name Alert name
$description Alert description
$entity_id Entity ID, the alert belong to.
$contact_id Contact ID
$active Activity flag
$domain Domain
$use_all_objects Use all objects
$use_all_objects_secondary Use all objects (secondary) should be used only in case of arbitrage
$min_imps Minimum imps
$max_imps Maximum imps
$min_volume Minimum volume
$max_volume Maximum volume
$pct_decrease PCT decrease
$pct_increase PCT increase
$min_losses_pct min_losses_pct
$sigma_multiplier Sigma multiplier
$metric_type Metric type
$is_daily Daily alert
$is_hourly Hourly alert
$min_metric_value Minimum metric value
$max_metric_value Maximum metric value
$version Version
$analysis_scheme Analysis Scheme
$selected_entity_ids Selected Entities IDs should be set/get from traf_monitor_alert_entity table
$selected_entity_ids_secondary Selected Entities IDs Secondary will be filled only in case of arbitrage
should be set/get from traf_monitor_alert_entity table
$emails Emails should be set/get from traf_monitor_alert_email table
$tm_environment TM Environment (Q/A, Production, Test), Could be set only by traffic monitor
$selected_line_item_ids Line Items IDs should be set/get from traf_monitor_alert_line_item table
Fields
int $id
Ignored on add and update.
Alert ID
size : 10
primary
string $name
Alert name
size : 50
420
Services
string $description
Alert description
size : 255
nillable
int $entity_id
Ignored on update.
Entity ID, the alert belong to.
size : 10
int $contact_id
Ignored on update.
Contact ID
size : 10
boolean $active
Default value: '1'
Activity flag
string $domain
Domain
The complete list of enum values you can see at tma_domain enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'tma_domain').
enum : tma_domain
boolean $use_all_objects
Default value: '0'
Use all objects
boolean $use_all_objects_secondary
Default value: '0'
Use all objects (secondary) should be used only in case of arbitrage
int $min_imps
Default value: '0'
Minimum imps
size : 10
int $max_imps
Default value: '0'
Maximum imps
size : 10
float $min_volume
Minimum volume
nillable
float $max_volume
Maximum volume
nillable
float $pct_decrease
PCT decrease
421
Services
nillable
float $pct_increase
PCT increase
nillable
float $min_losses_pct
Default value: NULL
min_losses_pct
nillable
float $sigma_multiplier
Sigma multiplier
nillable
string $metric_type
Metric type
The complete list of enum values you can see at tma_metric_type enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'tma_metric_type').
enum : tma_metric_type
boolean $is_daily
Default value: '0'
Daily alert
boolean $is_hourly
Default value: '0'
Hourly alert
float $min_metric_value
Minimum metric value
nillable
float $max_metric_value
Maximum metric value
nillable
int $version
Default value: '1'
Version
size : 6
int $analysis_scheme
Default value: '1'
Analysis Scheme
size : 6
nillable
array_of_int $selected_entity_ids
Selected Entities IDs should be set/get from traf_monitor_alert_entity table
array_of_int $selected_entity_ids_secondary
422
Services
Selected Entities IDs Secondary will be filled only in case of arbitrage should be set/get from traf_monitor_alert_entity
table
array_of_string $emails
Emails should be set/get from traf_monitor_alert_email table
string $tm_environment
TM Environment (Q/A, Production, Test), Could be set only by traffic monitor
The complete list of enum values you can see at tma_tm_environment enum page, at run time you can get all of them
using DictionaryService.getEnumValues(token, 'tma_tm_environment').
enum : tma_tm_environment
array_of_int $selected_line_item_ids
Line Items IDs should be set/get from traf_monitor_alert_line_item table
url
vurl_data type
Fields Summary
$url
Fields
string $url
valid_vurl
valid_vurl data type
vurl_data
$valid_urls_data
Fields Summary
$id Vurl id.
$url Vurl.
Fields
int $id
Vurl id.
string $url
Vurl.
vast_tag
Used by the following call(s) and/or data type(s):
ad_tag_options
423
Services
$vast_tag
Fields Summary
$vast_verstion VAST version number "2" or "3"
$vast_type_id VAST Type Id see VAST Type Table for additional information.
$vast_placement_type_id Placement type ID see Placement Type Table for additional information.
$min_duration Minimum duration of the video
$max_duration Maximum duration of the video
Fields
int $vast_verstion
VAST version number "2" or "3"
int $vast_type_id
VAST Type Id see VAST Type Table for additional information.
int $vast_placement_type_id
Placement type ID see Placement Type Table for additional information.
int $min_duration
Minimum duration of the video
int $max_duration
Maximum duration of the video
video_api_framework
See Video Api Framework Type Enum for more information.
Fields Summary
$id Video api frameworke ID
$video_api_framework Video api framework type
Fields
int $id
Video api frameworke ID
size : 3
primary
string $video_api_framework
Video api framework type
size : 30
video_creative
Used by the following call(s) and/or data type(s):
creative
$video_creative
placement_creative
$video_creative
424
Services
Fields Summary
$vast_ad_tag_uri Identifying vast tag from a secondary ad server for wrapper Ad
$video_vast_type_id Video vast type ID see VAST Type Table for additional information.
$duration Media duration in seconds
$version
$video_placement_type_id Placement type ID see Placement Type Table for additional information.
Fields
string $vast_ad_tag_uri
Identifying vast tag from a secondary ad server for wrapper Ad
size : 10000
int $video_vast_type_id
Video vast type ID see VAST Type Table for additional information.
size : 3
int $duration
Media duration in seconds
size : 10
string $version
size : 5,3
int $video_placement_type_id
Placement type ID see Placement Type Table for additional information.
size : 3
video_delivery
See Video Delivery Type Enum for more information.
Fields Summary
$id Video delivery ID
$video_delivery Video delivery type
Fields
int $id
Video delivery ID
size : 3
primary
string $video_delivery
Video delivery type
size : 100
425
Services
video_placement_type
See Video Placement Type Enum for more information.
DictionaryService
getVideoPlacementType()
Fields Summary
$id Video placement ID
$placement_type Video Placement Type
Fields
int $id
Video placement ID
size : 3
primary
string $placement_type
Video Placement Type
size : 100
video_vast_type
See Video Vast Type Enum for more information.
DictionaryService
getVideoVastType()
Fields Summary
$id Video vast type ID
$video_vast_type video vast type
Fields
int $id
Video vast type ID
size : 3
primary
string $video_vast_type
video vast type
size : 100
vurl_category
See Vurl Category Enum for more information.
DictionaryService
426
Services
getVurlCategories()
TargetProfileService
TargetProfileService::getVurlCategoriesDepr()
Fields Summary
$id category ID
$name category name
Fields
int $id
Ignored on add and update.
category ID
size : 10
primary
string $name
category name
size : 64
vurl_data
vurl_data type
DictionaryService
validateVurls()
Fields Summary
$valid_urls_data Valid url data.
$invalid_urls Invalid url.
Fields
array_of_valid_vurl $valid_urls_data
Valid url data.
array_of_string $invalid_urls
Invalid url.
vurl_get_data
vurl_get_data data type
PreferredTermsService
getVurls()
SupplyBlocklistService
getVurls()
Fields Summary
$id Vurl ID.
$vurl Vurl.
$is_selected Is select valid url.
427
Services
Fields
int $id
Ignored on add and update.
Vurl ID.
string $vurl
Vurl.
boolean $is_selected
Is select valid url.
vurl
Used by the following call(s) and/or data type(s):
TargetProfileService
searchVurls()
target_vurl
$options
Fields Summary
$id validated URL ID
$active activity flag
$url URL string
$vurl_category_id category ID this vurl object belongs to
$is_rmx_100 rmx top 100 property
$is_rmx_250 rmx top 250 property
$is_adware adware property
$is_click_fraud click fraud property
$is_audited audited property
$description vurl object description
$vurl_parent_id parent ID
$foreign_lang foreign language property
$minimum_brandsafe_level minimum brandsafe level
$created_by Created by The complete list of enum values you can see at created_by enum page, at run
time you can get all of them using DictionaryService.getEnumValues(token, 'created_by').
Fields
int $id
Ignored on add and update.
validated URL ID
size : 10
primary
boolean $active
Default value: '0'
activity flag
string $url
Default value: ''
URL string
size : 160
int $vurl_category_id
Default value: '0'
category ID this vurl object belongs to
428
Services
size : 10
boolean $is_rmx_100
Default value: '0'
rmx top 100 property
boolean $is_rmx_250
Default value: '0'
rmx top 250 property
boolean $is_adware
Default value: '0'
adware property
boolean $is_click_fraud
Default value: '0'
click fraud property
boolean $is_audited
Default value: '0'
audited property
string $description
Default value: ''
vurl object description
size : 128
int $vurl_parent_id
Default value: '0'
parent ID
size : 10
boolean $foreign_lang
Default value: '0'
foreign language property
enum_minimum_brandsafe_level $minimum_brandsafe_level
Default value: '0'
minimum brandsafe level
string $created_by
Created by The complete list of enum values you can see at created_by enum page, at run time you can get all of
them using DictionaryService.getEnumValues(token, 'created_by').
enum : created_by
vurl_options
Used by the following call(s) and/or data type(s):
TargetProfileService
getTargetValidatedUrls()
TargetProfileService::getTargetValidatedUrlsDepr()
setTargetValidatedUrls()
target_vurl
$options
429
Services
Fields Summary
$vurl_default this flag let you specify how to treat the elements of $vurl_ids array for the
setTargetValidatedUrls and getTargetValidatedUrls calls.
$vurl_category_default default category
$require_audited_vurl is audited vurl required
$rmx_100_only rmx top 100 property
$rmx_250_only rmx top 250 property
$no_adware adware property
$no_click_fraud click fraud property
$no_foreign_language foreign language property
$no_banned banned property
$no_inactive inactive property
$banned_vurl_categories the list of banned vurl categories
Fields
boolean $vurl_default
Default value: '1'
this flag let you specify how to treat the elements of $vurl_ids array for the setTargetValidatedUrls and
getTargetValidatedUrls calls.
boolean $vurl_category_default
Default value: '1'
default category
boolean $require_audited_vurl
Default value: '0'
is audited vurl required
boolean $rmx_100_only
Default value: '0'
rmx top 100 property
boolean $rmx_250_only
Default value: '0'
rmx top 250 property
boolean $no_adware
Default value: '0'
adware property
boolean $no_click_fraud
Default value: '0'
click fraud property
boolean $no_foreign_language
foreign language property
boolean $no_banned
banned property
boolean $no_inactive
inactive property
array_of_int $banned_vurl_categories
the list of banned vurl categories
430
Services
vurl_search_options
Used by the following call(s) and/or data type(s):
TargetProfileService
searchVurls()
Fields Summary
$ids seek only with given ids
$pattern search pattern
$description search description pattern
$parent
$category_ids seek only among the following categories
$rmx_100_only seek only with rmx top 100 property
$rmx_250_only seek only with rmx top 250 property
$is_adware seek only with adware property
$is_click_fraud seek only with click fraud property
$is_audited seek only with audited property
$is_foreign_language seek only with foreign language property
$is_active seek only among active objects
$minimum_brandsafe_levels seek only with minimum_brandsafe_level in
Fields
array_of_int $ids
seek only with given ids
nillable
string $pattern
Default value: 'a*'
search pattern
nillable
string $description
search description pattern
nillable
string $parent
nillable
array_of_int $category_ids
seek only among the following categories
nillable
boolean $rmx_100_only
seek only with rmx top 100 property
nillable
boolean $rmx_250_only
seek only with rmx top 250 property
nillable
boolean $is_adware
seek only with adware property
nillable
431
Services
boolean $is_click_fraud
seek only with click fraud property
nillable
boolean $is_audited
seek only with audited property
nillable
boolean $is_foreign_language
seek only with foreign language property
nillable
boolean $is_active
seek only among active objects
nillable
array_of_enum_minimum_brandsafe_level $minimum_brandsafe_levels
seek only with minimum_brandsafe_level in
nillable
vurl_tag_list
See Vurl Tag Enum for more information.
DictionaryService
getVurlTags()
Fields Summary
$id
$primary_category
$secondary_category
$tertiary_category
$tag
$entity_id
$is_media_guard
$ui_order
$is_enabled
$brandsafe_level
$lastupd
Fields
int $id
Ignored on add and update.
size : 10
primary
string $primary_category
Ignored on add and update.
size : 100
432
Services
string $secondary_category
Ignored on add and update.
size : 100
string $tertiary_category
Ignored on add and update.
size : 100
string $tag
Ignored on add and update.
size : 255
int $entity_id
Ignored on add and update.
size : 10
int $is_media_guard
Ignored on add and update.
size : 1
float $ui_order
Ignored on add and update.
int $is_enabled
Ignored on add and update.
size : 1
int $brandsafe_level
Ignored on add and update.
size : 6
dateTime $lastupd
Ignored on add and update.
woeid
Used by the following call(s) and/or data type(s):
DictionaryService
getWoeidDetails()
Fields Summary
$woeid Woe ID
$level Level
$parent_woeid Parent WOEID
$parent_woeid2 Parent WOEID2
$description Description
$iso Country ISO
$display_name Display name
$exposed Flag to indicate if the woeid id exposed for targeting
$legacy Determines if it is a legacy geo entity
$breadcrumb Breadcrumb
433
Services
Fields
int $woeid
Ignored on add and update.
Woe ID
size : 10
primary
int $level
Ignored on add and update.
Level
The complete list of enum values you can see at woeid_level enum page, at run time you can get all of them using
DictionaryService.getEnumValues(token, 'woeid_level').
enum : woeid_level
int $parent_woeid
Ignored on add and update.
Parent WOEID
size : 10
int $parent_woeid2
Ignored on add and update.
Parent WOEID2
size : 10
string $description
Ignored on add and update.
Description
size : 255
string $iso
Ignored on add and update.
Country ISO
size : 2
string $display_name
Ignored on add and update.
Display name
size : 100
int $exposed
Ignored on add and update.
Flag to indicate if the woeid id exposed for targeting
size : 3
int $legacy
Ignored on add and update.
Determines if it is a legacy geo entity
size : 3
string $breadcrumb
Ignored on add and update.
Breadcrumb
434
Services
woeid_search_result
This file contains woeid_search_result data type
SearchService
searchWoeids()
Fields Summary
$woeid
$description
Fields
int $woeid
string $description
435