Browse the help center

Change the network's system preferences

Changes only the settings the call names and leaves every other one as it is, so a client that knows one setting does not have to send the rest.

Reference
POST https://YOUR-NETWORK-DOMAIN/rest-api/system-preferences.do

Changes only the settings the call names and leaves every other one as it is, so a client that knows one setting does not have to send the rest. Each one is checked the way the console checks it, and a call that fails a check changes nothing at all. A setting that could not be applied is named in ignoredFields, with the reason in ignoredFieldReasons -- a GDPR consent rule sent while the policy is DEFAULT is the usual one, because the policy decides whether those rules are used. Changing a limit or a GDPR rule takes effect for ad serving within a minute, when the caches reload. Requires the System Preferences console permission.

Form Params

actionCustomParameterLogEnabled boolean

Log the custom parameters a conversion carried

true

customParametersPassingStrategy string

Whether a creative is given the custom parameters of the request: OFF, ON, or PER_ENTITY (per campaign)

PER_ENTITY

cookieLogEnabled boolean

Log the cookies an ad request carried

false

cookieCollectingEnabledDefault boolean

Whether a new placement collects cookies by default

true

maxAllowedFileSize integer

Largest creative file, in bytes (1-2147483647)

204800

maxAllowedVideoFileSize integer

Largest video file, in bytes (1-2147483647)

20971520

heavyCreativeWarnings boolean

Warn when a creative is heavier than the limits below

true

heavyCreativeLimitKb integer

Heavy-creative limit for non-IAB sizes, in KB (1-1048576)

300

heavyVideoLimitMb integer

Heavy-creative limit for video, in MB (1-10240)

10

uniqueUserCountingSpan integer

How long one visitor counts as the same unique user, in hours

24

impressionDelayInterval integer

Seconds to wait before an impression counts

0

locationSourceDB string

Which database turns an address into a location: SYSTEM_DEFAULT, IP_2_LOCATION or MAX_MIND

IP_2_LOCATION

domainExtractionStrategy string

How the page domain is read: NONE, or REFERER with the parameter below

REFERER

domainExtractionParam string

With REFERER: the query parameter the domain is taken from

utm_source

dailyAnalyticsRequestsLimit integer

Analytics requests one account may run a day, 0 for no limit

1000

dailyAnalyticsDataRecordsLimit integer

Rows one analytics request may return, 0 for no limit

100000

csvExportLimit integer

Rows a CSV export may hold; leave it out to keep the current one

500000

xlsxExportLimit integer

Rows an XLSX export may hold

100000

pdfExportLimit integer

Rows a PDF export may hold

50000

htmlExportLimit integer

Rows an HTML export may hold

50000

jsonExportLimit integer

Rows a JSON export may hold

100000

compressReport boolean

Compress an export before sending it

true

analyticsDateFormat string

Date format of analytics reports: DEFAULT (dd-MM-yyyy) or US_FORMAT (MM-dd-yyyy)

DEFAULT

troubleshootLogSizeLimitMb integer

Largest troubleshoot log, in MB (0-1048576)

1024

aiChatMonthlyLimitUsd string

What the in-product AI assistant may cost this network a month, in USD; empty for the platform default

50

gdprPolicy string

GDPR policy: DEFAULT serves as usual, REQUIRE_IAB_CONSENT applies the consent rules below

REQUIRE_IAB_CONSENT

gdprRestriction string

What happens without consent: NOT_SERVE, RESTRICT_UID, RESTRICT_ALL or RESTRICT_ALL_AND_DATA_PROCESSING

NOT_SERVE

gdprIabVendorId integer

The IAB Global Vendor List id consent is checked for; required under REQUIRE_IAB_CONSENT

849

gdprRestrictMediation boolean

Apply the restriction to mediation partners as well

false

gdprCheckDisclosedVendors boolean

Require the vendor to be in the consent string's disclosed vendors

false

gdprCmpListVerificationEnabled boolean

Check the CMP against the IAB Global CMP List

false

gdprTcfPolicyVersionCheckEnabled boolean

Refuse a consent string below the TCF policy version floor

false

gdprMinTcfPolicyVersion integer

The TCF policy version floor, 2-10

4

gdprGpcOptOutEnabled boolean

Treat a Global Privacy Control signal as an opt-out

true

gdprPassPrivacySignalsToDsps boolean

Pass the privacy signals on to the DSPs in a bid request

true

Responses

200

{success, changed:[...], ignoredFields:[...], ignoredFieldReasons:{...}}

400

A value is outside the range the console allows, or a rule it enforces is broken

401

Authentication error

403

The caller does not hold the System Preferences permission

Please disable Adblock
Are you using adblock? Disable it and reload the page to proceed to the destination page.

A registration has already been submitted from this page. Please try again in 10 minutes.