Search for ad sets based on provided criteria.
This returns the full configuration of ad sets matching those criteria.
Field projection can be used if only a subset of fields is required, instead of the full configuration.
If specific fields are precised in the user prompt, use meta.fields field projection in order to query only the value of these fields, else, provide every field.
Multiple filters are combined with an implicit AND operation.
Identifiers are string-encoded integers; invalid values are ignored.
If no filter is provided (both arrays are null or empty), the search returns all accessible campaigns.
{"docsConfig":{"theme":"aspen","$schema":"https://mintlify.com/docs.json","name":"Criteo Docs","colors":{"primary":"#FE5001","light":"#FE5001","dark":"#FE5001"},"logo":{"light":"https://mintcdn.com/criteo-e1682996/oGhV8AgFf1afoax4/logo/light.svg?fit=max\u0026auto=format\u0026n=oGhV8AgFf1afoax4\u0026q=85\u0026s=25bacaf5d815bd4242b98ca759ed086c","dark":"https://mintcdn.com/criteo-e1682996/oGhV8AgFf1afoax4/logo/dark.svg?fit=max\u0026auto=format\u0026n=oGhV8AgFf1afoax4\u0026q=85\u0026s=28cba1b2ef8d4354739c680b8335cc7c"},"favicon":"https://mintcdn.com/criteo-e1682996/-a_Zn-jb9gMTKnuK/favicon.png?fit=max\u0026auto=format\u0026n=-a_Zn-jb9gMTKnuK\u0026q=85\u0026s=6d00e60b5acc0fba4fca5c228132809a","appearance":{"default":"light"},"background":{"decoration":"gradient"},"navbar":{"links":[{"href":"https://status.criteo.com/","label":"Status"},{"href":"https://partners.criteo.com/","label":"Partner Portal"}],"primary":{"type":"button","label":"Contact Sales","href":"https://www.criteo.com/talk-to-an-expert/"}},"fonts":{"heading":{"family":"Graphik LC Web","source":"https://www.criteo.com/wp-content/themes/criteo2017/fonts/graphik-lc/Graphik-Semibold-Cy-Web.woff2","format":"woff2"},"body":{"family":"Graphik LC Web","source":"https://criteo.com/wp-content/themes/criteo2017/fonts/graphik-lc/Graphik-Regular-Cy-Web.woff2","format":"woff2"}},"styling":{"eyebrows":"breadcrumbs","latex":true},"integrations":{"heap":{"appId":"305485844"}},"contextual":{"options":["copy","view","chatgpt","claude","vscode","grok"],"display":"header"},"navigation":{"global":{},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"criteo-e1682996","hasAudioNarration":false,"actualSubdomain":"criteo-e1682996","customDomains":["developers.criteo.com"],"gitSource":{"type":"github","owner":"criteo","repo":"public-api-doc","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6aeb374452472789d84d6acf","collectionId":"0afc50d4-934f-4959-a402-4ceb22855589","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6aeb374452472789d84d6acf"},"feedback":{"thumbs":true,"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6aeb49acf633c70e99a5a142","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"API Reference","count":1601},{"language":"default","tag":"Marketing Solutions API","count":1398},{"language":"default","tag":"Retail Media API","count":1058},{"language":"default","tag":"Campaign","count":670},{"language":"default","tag":"Guides","count":658},{"language":"default","tag":"Guides for Retail Media API","count":274},{"language":"default","tag":"Audience","count":226},{"language":"default","tag":"Marketing Solutions Endpoints","count":200},{"language":"default","tag":"Analytics","count":191},{"language":"default","tag":"Creative","count":161}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":true,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"starterQuestions":[{"_id":"69c3ab31b75fcc3c3b4cdb3d","deploymentId":"69b6cc72b519f361e0c30b32","questionText":"How do I get started with Onsite Display campaigns?","status":"active","generatedBy":"manual","createdAt":"2026-03-25T09:30:25.685Z","updatedAt":"2026-03-25T09:30:25.685Z","__v":0},{"_id":"69c3ab1fb75fcc3c3b4cdafb","deploymentId":"69b6cc72b519f361e0c30b32","questionText":"How do I get started with Sponsored Products campaigns?","status":"active","generatedBy":"manual","createdAt":"2026-03-25T09:30:07.459Z","updatedAt":"2026-03-25T09:30:07.459Z","__v":0}],"googleFontsInlined":false},"customCss":[{"filePath":"styles.css","content":"@media (width >= 768px){footer .md\\:truncate{text-overflow:ellipsis;white-space:wrap!important;overflow:visible!important}}"}],"page":{"pagePath":"marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch","slug":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch","pageMetadata":{"title":"/2026-07/marketing-solutions/ad-sets/search","description":"Search for ad sets based on provided criteria.\r\nThis returns the full configuration of ad sets matching those criteria.\r\nField projection can be used if only a subset of fields is required, instead of the full configuration.\r\n \r\nIf specific fields are precised in the user prompt, use meta.fields field projection in order to query only the value of these fields, else, provide every field.","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/ad-sets/search","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Search for ad sets based on provided criteria.\\r\\nThis returns the full configuration of ad sets matching those criteria.\\r\\nField projection can be used if only a subset of fields is required, instead of the full configuration.\"\n }), \"\\n\", _jsx(_components.p, {\n children: \"If specific fields are precised in the user prompt, use meta.fields field projection in order to query only the value of these fields, else, provide every field.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"/2026-07/marketing-solutions/ad-sets/search","description":"Search for ad sets based on provided criteria.\r\nThis returns the full configuration of ad sets matching those criteria.\r\nField projection can be used if only a subset of fields is required, instead of the full configuration.\r\n \r\nIf specific fields are precised in the user prompt, use meta.fields field projection in order to query only the value of these fields, else, provide every field.","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/ad-sets/search","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Campaign"],"summary":"/2026-07/marketing-solutions/ad-sets/search","description":"Search for ad sets based on provided criteria.\r\nThis returns the full configuration of ad sets matching those criteria.\r\nField projection can be used if only a subset of fields is required, instead of the full configuration.\r\n \r\nIf specific fields are precised in the user prompt, use meta.fields field projection in order to query only the value of these fields, else, provide every field.","operationId":"SearchAdSets","requestBody":"4e53769e-7071-4161-ab83-b2f73edb26e9","responses":{"200":"46b80a41-aa9f-4f6a-a0bb-dd5b2c0eceda"},"security":["7b203994-853e-4aac-a373-2c94f05e8349"],"method":"post","type":"path","servers":["150d8545-65e0-447e-8e47-18aa9fd99d7d"],"path":"/2026-07/marketing-solutions/ad-sets/search","baseUrlOptions":["https://api.criteo.com"],"title":"/2026-07/marketing-solutions/ad-sets/search","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"filters":{"type":"object","properties":{"adSetIds":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"filters.adSetIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Ad set ids to filter on. Ids are string-encoded integers.","uniqueKey":"filters.adSetIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Ad set ids to filter on. Ids are string-encoded integers.","uniqueKey":"filters.adSetIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.adSetIds","typeLabel":"string[] | null"},"advertiserIds":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"filters.advertiserIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Advertiser ids which ad sets belongs to (indirectly via their marketing campaign).\r\nIds are string-encoded integers.","uniqueKey":"filters.advertiserIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Advertiser ids which ad sets belongs to (indirectly via their marketing campaign).\r\nIds are string-encoded integers.","uniqueKey":"filters.advertiserIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.advertiserIds","typeLabel":"string[] | null"},"campaignIds":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"filters.campaignIds.oneOf.0.items.[INDEX]","typeLabel":"string"},"description":"Campaign ids to filter on. Ids are string-encoded integers.","uniqueKey":"filters.campaignIds.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"description":"Campaign ids to filter on. Ids are string-encoded integers.","uniqueKey":"filters.campaignIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"filters.campaignIds","typeLabel":"string[] | null"}},"description":"Filter on ad set ids.\r\n \r\nMultiple filters are combined with an implicit AND operation.\r\nIdentifiers are string-encoded integers; invalid values are ignored.\r\nIf no filter is provided (both arrays are null or empty), the search returns all accessible campaigns.","uniqueKey":"filters","typeLabel":"object"},"meta":{"type":"object","properties":{"fields":{"oneOf":[{"type":"array","items":{"enum":["Name","AdvertiserId","DatasetId","CampaignId","DestinationEnvironment","Objective","Schedule","Bidding","Targeting","Budget","MediaType","VideoChannel","AttributionConfiguration"],"type":"string","description":"Fields that can be projected when searching ad sets.\r\n \r\nPossible values:\r\n- Name\r\n- AdvertiserId\r\n- DatasetId\r\n- CampaignId\r\n- DestinationEnvironment\r\n- Objective\r\n- Schedule\r\n- Bidding\r\n- Targeting\r\n- Budget\r\n- MediaType\r\n- VideoChannel\r\n- AttributionConfiguration","uniqueKey":"meta.fields.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"List of fields to include in the response. If null or omitted, all fields are returned.\r\nWhen only a subset of fields is projected, non-projected fields will have default values (e.g. null, 0, or enum defaults) which may not reflect the actual ad set state. Do not interpret non-projected fields as meaningful data.","uniqueKey":"meta.fields.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","items":{"enum":["Name","AdvertiserId","DatasetId","CampaignId","DestinationEnvironment","Objective","Schedule","Bidding","Targeting","Budget","MediaType","VideoChannel","AttributionConfiguration"],"type":"string","description":"Fields that can be projected when searching ad sets.\r\n \r\nPossible values:\r\n- Name\r\n- AdvertiserId\r\n- DatasetId\r\n- CampaignId\r\n- DestinationEnvironment\r\n- Objective\r\n- Schedule\r\n- Bidding\r\n- Targeting\r\n- Budget\r\n- MediaType\r\n- VideoChannel\r\n- AttributionConfiguration"},"description":"List of fields to include in the response. If null or omitted, all fields are returned.\r\nWhen only a subset of fields is projected, non-projected fields will have default values (e.g. null, 0, or enum defaults) which may not reflect the actual ad set state. Do not interpret non-projected fields as meaningful data.","uniqueKey":"meta.fields.oneOf.1","typeLabel":"null"}],"uniqueKey":"meta.fields","typeLabel":"enum\u003cstring>[] | null"}},"description":"Optional metadata for searching ad sets","uniqueKey":"meta","typeLabel":"object"}},"description":"request payload of the search endpoint","example":{"filters":{"advertiserIds":["12345"]}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"filters":{"advertiserIds":["12345"]}}}},"exampleType":"generated"}},"x-bodyName":"request","exampleType":"generated"},"responses":{"46b80a41-aa9f-4f6a-a0bb-dd5b2c0eceda":{"description":"data for the ad sets","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"type":"array","items":{"oneOf":[{"type":"object","properties":{"attributes":{"oneOf":[{"type":"object","properties":{"adSetType":{"oneOf":[{"enum":["standard","appRetargeting","unknown"],"type":"string","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.adSetType.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["standard","appRetargeting","unknown"],"type":"null","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.adSetType.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.adSetType","typeLabel":"enum\u003cstring> | null"},"advertiserId":{"oneOf":[{"type":"string","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.advertiserId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.advertiserId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.advertiserId","typeLabel":"string | null"},"attributionConfiguration":{"oneOf":[{"type":"object","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.attributionConfiguration.oneOf.0.attributionMethod.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.attributionConfiguration.oneOf.0.attributionMethod.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.attributionConfiguration.oneOf.0.attributionMethod","typeLabel":"enum\u003cstring> | null"},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.attributionConfiguration.oneOf.0.lookbackWindow.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.attributionConfiguration.oneOf.0.lookbackWindow.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.attributionConfiguration.oneOf.0.lookbackWindow","typeLabel":"enum\u003cstring> | null"}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.attributionConfiguration.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.attributionConfiguration.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.attributionConfiguration","typeLabel":"object | null"},"bidding":{"oneOf":[{"type":"object","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.bidding.oneOf.0.bidAmount.oneOf.0","typeLabel":"number\u003cdouble>"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.bidding.oneOf.0.bidAmount.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.bidding.oneOf.0.bidAmount","typeLabel":"number\u003cdouble> | null"},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.bidding.oneOf.0.costController.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.bidding.oneOf.0.costController.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.bidding.oneOf.0.costController","typeLabel":"enum\u003cstring> | null"}},"description":"Ad set bidding read configuration.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.bidding.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.bidding.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.bidding","typeLabel":"object | null"},"budget":{"oneOf":[{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetAmount.oneOf.0","typeLabel":"number\u003cdouble>"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetAmount.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetAmount","typeLabel":"number\u003cdouble> | null"},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests).","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetDeliverySmoothing.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests).","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetDeliverySmoothing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetDeliverySmoothing","typeLabel":"enum\u003cstring> | null"},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\".","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetDeliveryWeek.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\".","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetDeliveryWeek.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetDeliveryWeek","typeLabel":"enum\u003cstring> | null"},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\").","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetRenewal.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\").","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetRenewal.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetRenewal","typeLabel":"enum\u003cstring> | null"},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetStrategy.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetStrategy.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.budgetStrategy","typeLabel":"enum\u003cstring> | null"},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.pacingBehavior.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.pacingBehavior.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0.pacingBehavior","typeLabel":"enum\u003cstring> | null"}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\".","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\".","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.budget","typeLabel":"object | null"},"campaignId":{"oneOf":[{"type":"string","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.campaignId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.campaignId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.campaignId","typeLabel":"string | null"},"datasetId":{"oneOf":[{"type":"string","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.datasetId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.datasetId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.datasetId","typeLabel":"string | null"},"destinationEnvironment":{"oneOf":[{"enum":["undefined","web","app"],"type":"string","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.destinationEnvironment.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["undefined","web","app"],"type":"null","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.destinationEnvironment.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.destinationEnvironment","typeLabel":"enum\u003cstring> | null"},"mediaType":{"oneOf":[{"enum":["display","video"],"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.mediaType.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["display","video"],"type":"null","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.mediaType.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.mediaType","typeLabel":"enum\u003cstring> | null"},"name":{"oneOf":[{"type":"string","description":"Name of the ad set","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"Name of the ad set","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.name","typeLabel":"string | null"},"objective":{"oneOf":[{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"string","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.objective.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"null","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.objective.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.objective","typeLabel":"enum\u003cstring> | null"},"schedule":{"oneOf":[{"type":"object","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.activationStatus.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.activationStatus.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.activationStatus","typeLabel":"enum\u003cstring> | null"},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.deliveryStatus.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.deliveryStatus.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.deliveryStatus","typeLabel":"enum\u003cstring> | null"},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.endDate.oneOf.0.value.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.endDate.oneOf.0.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.endDate.oneOf.0.value","typeLabel":"string\u003cdate-time> | null"}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.endDate.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.endDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.endDate","typeLabel":"object | null"},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.startDate.oneOf.0.value.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.startDate.oneOf.0.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.startDate.oneOf.0.value","typeLabel":"string\u003cdate-time> | null"}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.startDate.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.startDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0.startDate","typeLabel":"object | null"}},"description":"Ad set schedule read model","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.schedule","typeLabel":"object | null"},"scheduledBudgets":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetAmount.oneOf.0","typeLabel":"number\u003cdouble>"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetAmount.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetAmount","typeLabel":"number\u003cdouble> | null"},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests).","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetDeliverySmoothing.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests).","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetDeliverySmoothing.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetDeliverySmoothing","typeLabel":"enum\u003cstring> | null"},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\".","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetDeliveryWeek.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\".","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetDeliveryWeek.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetDeliveryWeek","typeLabel":"enum\u003cstring> | null"},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\").","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetRenewal.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\").","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetRenewal.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetRenewal","typeLabel":"enum\u003cstring> | null"},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetStrategy.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetStrategy.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].budgetStrategy","typeLabel":"enum\u003cstring> | null"},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Identifier of the scheduled budget.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].id","typeLabel":"string | null"},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].pacingBehavior.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].pacingBehavior.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].pacingBehavior","typeLabel":"enum\u003cstring> | null"},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].startDate.oneOf.0","typeLabel":"string\u003cdate>"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].startDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX].startDate","typeLabel":"string\u003cdate> | null"}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."},"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.scheduledBudgets","typeLabel":"object[] | null"},"serverToServerTrackings":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.serverToServerTrackings.oneOf.0.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.serverToServerTrackings.oneOf.0.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.serverToServerTrackings.oneOf.0.items.[INDEX].url","typeLabel":"string | null"}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.serverToServerTrackings.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.serverToServerTrackings.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.serverToServerTrackings.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.serverToServerTrackings","typeLabel":"object[] | null"},"targeting":{"oneOf":[{"type":"object","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.0.devices.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.0.devices.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.0.devices.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.0.devices","typeLabel":"enum\u003cstring>[] | null"},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.0.environments.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.0.environments.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.0.environments.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.0.environments","typeLabel":"enum\u003cstring>[] | null"},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.0.operatingSystems.oneOf.0.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.0.operatingSystems.oneOf.0","typeLabel":"enum\u003cstring>[]"},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.0.operatingSystems.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.0.operatingSystems","typeLabel":"enum\u003cstring>[] | null"}},"description":"Delivery limitations for an ad set.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.deliveryLimitations","typeLabel":"object | null"},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.frequencyCapping.oneOf.0.value.oneOf.0.frequency.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.frequencyCapping.oneOf.0.value.oneOf.0.frequency.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.frequencyCapping.oneOf.0.value.oneOf.0.frequency","typeLabel":"enum\u003cstring> | null"},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.frequencyCapping.oneOf.0.value.oneOf.0.maximumImpressions.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.frequencyCapping.oneOf.0.value.oneOf.0.maximumImpressions.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.frequencyCapping.oneOf.0.value.oneOf.0.maximumImpressions","typeLabel":"integer\u003cint32> | null"}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.frequencyCapping.oneOf.0.value.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.frequencyCapping.oneOf.0.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.frequencyCapping.oneOf.0.value","typeLabel":"object | null"}},"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.frequencyCapping.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}},"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.frequencyCapping.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.frequencyCapping","typeLabel":"object | null"},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.countries.oneOf.0.value.oneOf.0.operand","typeLabel":"enum\u003cstring>"},"values":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.countries.oneOf.0.value.oneOf.0.values.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.countries.oneOf.0.value.oneOf.0.values.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.countries.oneOf.0.value.oneOf.0.values.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.countries.oneOf.0.value.oneOf.0.values","typeLabel":"string[] | null"}},"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.countries.oneOf.0.value.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.countries.oneOf.0.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.countries.oneOf.0.value","typeLabel":"object | null"}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.countries.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.countries.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.countries","typeLabel":"object | null"},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.subdivisions.oneOf.0.value.oneOf.0.operand","typeLabel":"enum\u003cstring>"},"values":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.subdivisions.oneOf.0.value.oneOf.0.values.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.subdivisions.oneOf.0.value.oneOf.0.values.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.subdivisions.oneOf.0.value.oneOf.0.values.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.subdivisions.oneOf.0.value.oneOf.0.values","typeLabel":"string[] | null"}},"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.subdivisions.oneOf.0.value.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.subdivisions.oneOf.0.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.subdivisions.oneOf.0.value","typeLabel":"object | null"}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.subdivisions.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.subdivisions.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.subdivisions","typeLabel":"object | null"},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.zipCodes.oneOf.0.value.oneOf.0.operand","typeLabel":"enum\u003cstring>"},"values":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.zipCodes.oneOf.0.value.oneOf.0.values.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.zipCodes.oneOf.0.value.oneOf.0.values.oneOf.0","typeLabel":"string[]"},{"type":"null","items":{"type":"string"},"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.zipCodes.oneOf.0.value.oneOf.0.values.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.zipCodes.oneOf.0.value.oneOf.0.values","typeLabel":"string[] | null"}},"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.zipCodes.oneOf.0.value.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.zipCodes.oneOf.0.value.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.zipCodes.oneOf.0.value","typeLabel":"object | null"}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.zipCodes.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.zipCodes.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0.zipCodes","typeLabel":"object | null"}},"description":"Ad set geolocation options.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0.geoLocation","typeLabel":"object | null"}},"description":"ad set targeting model","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.targeting","typeLabel":"object | null"},"videoChannel":{"oneOf":[{"enum":["olv","ctv"],"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.videoChannel.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["olv","ctv"],"type":"null","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.videoChannel.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0.videoChannel","typeLabel":"enum\u003cstring> | null"}},"description":"Ad set read model.\r\n \r\nThe ad set is the configuration unit that defines ads delivery. Its binds together the objective, budget,\r\nscheduling, targeting options and ads.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"adSetType":{"oneOf":[{"enum":["standard","appRetargeting","unknown"],"type":"string","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."},{"enum":["standard","appRetargeting","unknown"],"type":"null","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."}]},"advertiserId":{"oneOf":[{"type":"string","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."},{"type":"null","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."}]},"attributionConfiguration":{"oneOf":[{"type":"object","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."},{"type":"null","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."}]},"bidding":{"oneOf":[{"type":"object","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."},{"type":"null","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."}]},"budget":{"oneOf":[{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."},{"type":"null","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."}]},"campaignId":{"oneOf":[{"type":"string","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."},{"type":"null","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."}]},"datasetId":{"oneOf":[{"type":"string","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."},{"type":"null","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."}]},"destinationEnvironment":{"oneOf":[{"enum":["undefined","web","app"],"type":"string","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"},{"enum":["undefined","web","app"],"type":"null","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"}]},"mediaType":{"oneOf":[{"enum":["display","video"],"type":"string"},{"enum":["display","video"],"type":"null"}]},"name":{"oneOf":[{"type":"string","description":"Name of the ad set"},{"type":"null","description":"Name of the ad set"}]},"objective":{"oneOf":[{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"string","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"},{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"null","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"}]},"schedule":{"oneOf":[{"type":"object","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"},{"type":"null","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"}]},"scheduledBudgets":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}},{"type":"null","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}}]},"serverToServerTrackings":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."},{"type":"null","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."}]},"targeting":{"oneOf":[{"type":"object","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"},{"type":"null","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"}]},"videoChannel":{"oneOf":[{"enum":["olv","ctv"],"type":"string"},{"enum":["olv","ctv"],"type":"null"}]}},"description":"Ad set read model.\r\n \r\nThe ad set is the configuration unit that defines ads delivery. Its binds together the objective, budget,\r\nscheduling, targeting options and ads.","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.attributes","typeLabel":"object | null"},"id":{"oneOf":[{"type":"string","description":"Id of the entity","readOnly":true,"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Id of the entity","readOnly":true,"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.id","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","readOnly":true,"example":"ReadAdSetV26Q1","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.type.oneOf.0","typeLabel":"string"},{"type":"null","readOnly":true,"example":"ReadAdSetV26Q1","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0.type","typeLabel":"string | null"}},"description":"read model data for resources","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.0","typeLabel":"object"},{"type":"null","properties":{"attributes":{"oneOf":[{"type":"object","properties":{"adSetType":{"oneOf":[{"enum":["standard","appRetargeting","unknown"],"type":"string","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."},{"enum":["standard","appRetargeting","unknown"],"type":"null","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."}]},"advertiserId":{"oneOf":[{"type":"string","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."},{"type":"null","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."}]},"attributionConfiguration":{"oneOf":[{"type":"object","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."},{"type":"null","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."}]},"bidding":{"oneOf":[{"type":"object","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."},{"type":"null","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."}]},"budget":{"oneOf":[{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."},{"type":"null","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."}]},"campaignId":{"oneOf":[{"type":"string","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."},{"type":"null","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."}]},"datasetId":{"oneOf":[{"type":"string","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."},{"type":"null","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."}]},"destinationEnvironment":{"oneOf":[{"enum":["undefined","web","app"],"type":"string","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"},{"enum":["undefined","web","app"],"type":"null","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"}]},"mediaType":{"oneOf":[{"enum":["display","video"],"type":"string"},{"enum":["display","video"],"type":"null"}]},"name":{"oneOf":[{"type":"string","description":"Name of the ad set"},{"type":"null","description":"Name of the ad set"}]},"objective":{"oneOf":[{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"string","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"},{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"null","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"}]},"schedule":{"oneOf":[{"type":"object","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"},{"type":"null","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"}]},"scheduledBudgets":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}},{"type":"null","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}}]},"serverToServerTrackings":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."},{"type":"null","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."}]},"targeting":{"oneOf":[{"type":"object","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"},{"type":"null","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"}]},"videoChannel":{"oneOf":[{"enum":["olv","ctv"],"type":"string"},{"enum":["olv","ctv"],"type":"null"}]}},"description":"Ad set read model.\r\n \r\nThe ad set is the configuration unit that defines ads delivery. Its binds together the objective, budget,\r\nscheduling, targeting options and ads."},{"type":"null","properties":{"adSetType":{"oneOf":[{"enum":["standard","appRetargeting","unknown"],"type":"string","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."},{"enum":["standard","appRetargeting","unknown"],"type":"null","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."}]},"advertiserId":{"oneOf":[{"type":"string","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."},{"type":"null","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."}]},"attributionConfiguration":{"oneOf":[{"type":"object","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."},{"type":"null","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."}]},"bidding":{"oneOf":[{"type":"object","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."},{"type":"null","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."}]},"budget":{"oneOf":[{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."},{"type":"null","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."}]},"campaignId":{"oneOf":[{"type":"string","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."},{"type":"null","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."}]},"datasetId":{"oneOf":[{"type":"string","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."},{"type":"null","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."}]},"destinationEnvironment":{"oneOf":[{"enum":["undefined","web","app"],"type":"string","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"},{"enum":["undefined","web","app"],"type":"null","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"}]},"mediaType":{"oneOf":[{"enum":["display","video"],"type":"string"},{"enum":["display","video"],"type":"null"}]},"name":{"oneOf":[{"type":"string","description":"Name of the ad set"},{"type":"null","description":"Name of the ad set"}]},"objective":{"oneOf":[{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"string","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"},{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"null","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"}]},"schedule":{"oneOf":[{"type":"object","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"},{"type":"null","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"}]},"scheduledBudgets":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}},{"type":"null","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}}]},"serverToServerTrackings":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."},{"type":"null","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."}]},"targeting":{"oneOf":[{"type":"object","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"},{"type":"null","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"}]},"videoChannel":{"oneOf":[{"enum":["olv","ctv"],"type":"string"},{"enum":["olv","ctv"],"type":"null"}]}},"description":"Ad set read model.\r\n \r\nThe ad set is the configuration unit that defines ads delivery. Its binds together the objective, budget,\r\nscheduling, targeting options and ads."}]},"id":{"oneOf":[{"type":"string","description":"Id of the entity","readOnly":true},{"type":"null","description":"Id of the entity","readOnly":true}]},"type":{"oneOf":[{"type":"string","readOnly":true,"example":"ReadAdSetV26Q1"},{"type":"null","readOnly":true,"example":"ReadAdSetV26Q1"}]}},"description":"read model data for resources","uniqueKey":"data.oneOf.0.items.[INDEX].oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX]","typeLabel":"object | null"},"readOnly":true,"uniqueKey":"data.oneOf.0","typeLabel":"(object | null)[]"},{"type":"null","items":{"oneOf":[{"type":"object","properties":{"attributes":{"oneOf":[{"type":"object","properties":{"adSetType":{"oneOf":[{"enum":["standard","appRetargeting","unknown"],"type":"string","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."},{"enum":["standard","appRetargeting","unknown"],"type":"null","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."}]},"advertiserId":{"oneOf":[{"type":"string","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."},{"type":"null","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."}]},"attributionConfiguration":{"oneOf":[{"type":"object","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."},{"type":"null","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."}]},"bidding":{"oneOf":[{"type":"object","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."},{"type":"null","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."}]},"budget":{"oneOf":[{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."},{"type":"null","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."}]},"campaignId":{"oneOf":[{"type":"string","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."},{"type":"null","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."}]},"datasetId":{"oneOf":[{"type":"string","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."},{"type":"null","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."}]},"destinationEnvironment":{"oneOf":[{"enum":["undefined","web","app"],"type":"string","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"},{"enum":["undefined","web","app"],"type":"null","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"}]},"mediaType":{"oneOf":[{"enum":["display","video"],"type":"string"},{"enum":["display","video"],"type":"null"}]},"name":{"oneOf":[{"type":"string","description":"Name of the ad set"},{"type":"null","description":"Name of the ad set"}]},"objective":{"oneOf":[{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"string","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"},{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"null","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"}]},"schedule":{"oneOf":[{"type":"object","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"},{"type":"null","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"}]},"scheduledBudgets":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}},{"type":"null","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}}]},"serverToServerTrackings":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."},{"type":"null","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."}]},"targeting":{"oneOf":[{"type":"object","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"},{"type":"null","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"}]},"videoChannel":{"oneOf":[{"enum":["olv","ctv"],"type":"string"},{"enum":["olv","ctv"],"type":"null"}]}},"description":"Ad set read model.\r\n \r\nThe ad set is the configuration unit that defines ads delivery. Its binds together the objective, budget,\r\nscheduling, targeting options and ads."},{"type":"null","properties":{"adSetType":{"oneOf":[{"enum":["standard","appRetargeting","unknown"],"type":"string","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."},{"enum":["standard","appRetargeting","unknown"],"type":"null","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."}]},"advertiserId":{"oneOf":[{"type":"string","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."},{"type":"null","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."}]},"attributionConfiguration":{"oneOf":[{"type":"object","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."},{"type":"null","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."}]},"bidding":{"oneOf":[{"type":"object","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."},{"type":"null","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."}]},"budget":{"oneOf":[{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."},{"type":"null","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."}]},"campaignId":{"oneOf":[{"type":"string","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."},{"type":"null","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."}]},"datasetId":{"oneOf":[{"type":"string","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."},{"type":"null","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."}]},"destinationEnvironment":{"oneOf":[{"enum":["undefined","web","app"],"type":"string","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"},{"enum":["undefined","web","app"],"type":"null","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"}]},"mediaType":{"oneOf":[{"enum":["display","video"],"type":"string"},{"enum":["display","video"],"type":"null"}]},"name":{"oneOf":[{"type":"string","description":"Name of the ad set"},{"type":"null","description":"Name of the ad set"}]},"objective":{"oneOf":[{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"string","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"},{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"null","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"}]},"schedule":{"oneOf":[{"type":"object","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"},{"type":"null","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"}]},"scheduledBudgets":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}},{"type":"null","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}}]},"serverToServerTrackings":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."},{"type":"null","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."}]},"targeting":{"oneOf":[{"type":"object","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"},{"type":"null","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"}]},"videoChannel":{"oneOf":[{"enum":["olv","ctv"],"type":"string"},{"enum":["olv","ctv"],"type":"null"}]}},"description":"Ad set read model.\r\n \r\nThe ad set is the configuration unit that defines ads delivery. Its binds together the objective, budget,\r\nscheduling, targeting options and ads."}]},"id":{"oneOf":[{"type":"string","description":"Id of the entity","readOnly":true},{"type":"null","description":"Id of the entity","readOnly":true}]},"type":{"oneOf":[{"type":"string","readOnly":true,"example":"ReadAdSetV26Q1"},{"type":"null","readOnly":true,"example":"ReadAdSetV26Q1"}]}},"description":"read model data for resources"},{"type":"null","properties":{"attributes":{"oneOf":[{"type":"object","properties":{"adSetType":{"oneOf":[{"enum":["standard","appRetargeting","unknown"],"type":"string","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."},{"enum":["standard","appRetargeting","unknown"],"type":"null","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."}]},"advertiserId":{"oneOf":[{"type":"string","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."},{"type":"null","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."}]},"attributionConfiguration":{"oneOf":[{"type":"object","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."},{"type":"null","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."}]},"bidding":{"oneOf":[{"type":"object","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."},{"type":"null","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."}]},"budget":{"oneOf":[{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."},{"type":"null","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."}]},"campaignId":{"oneOf":[{"type":"string","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."},{"type":"null","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."}]},"datasetId":{"oneOf":[{"type":"string","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."},{"type":"null","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."}]},"destinationEnvironment":{"oneOf":[{"enum":["undefined","web","app"],"type":"string","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"},{"enum":["undefined","web","app"],"type":"null","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"}]},"mediaType":{"oneOf":[{"enum":["display","video"],"type":"string"},{"enum":["display","video"],"type":"null"}]},"name":{"oneOf":[{"type":"string","description":"Name of the ad set"},{"type":"null","description":"Name of the ad set"}]},"objective":{"oneOf":[{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"string","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"},{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"null","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"}]},"schedule":{"oneOf":[{"type":"object","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"},{"type":"null","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"}]},"scheduledBudgets":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}},{"type":"null","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}}]},"serverToServerTrackings":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."},{"type":"null","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."}]},"targeting":{"oneOf":[{"type":"object","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"},{"type":"null","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"}]},"videoChannel":{"oneOf":[{"enum":["olv","ctv"],"type":"string"},{"enum":["olv","ctv"],"type":"null"}]}},"description":"Ad set read model.\r\n \r\nThe ad set is the configuration unit that defines ads delivery. Its binds together the objective, budget,\r\nscheduling, targeting options and ads."},{"type":"null","properties":{"adSetType":{"oneOf":[{"enum":["standard","appRetargeting","unknown"],"type":"string","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."},{"enum":["standard","appRetargeting","unknown"],"type":"null","description":"Type of the ad set.\r\nNot returned when field projection (meta.fields) is used in a search."}]},"advertiserId":{"oneOf":[{"type":"string","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."},{"type":"null","description":"Advertiser id of the campaign this ad set belongs to\r\nThis value is a string-encoded integer."}]},"attributionConfiguration":{"oneOf":[{"type":"object","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."},{"type":"null","properties":{"attributionMethod":{"oneOf":[{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"string","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"},{"enum":["unknown","criteoAttribution","lastClick","postClick","sftp","googleAnalytics"],"type":"null","description":"Ad set attribution method.\r\nThis defines how certain events (visits, clicks, sales...) are attributed to the ad set.\r\n \r\nPossible values:\r\n- unknown\r\n- criteoAttribution (default attribution method)\r\n- lastClick\r\n- postClick\r\n- sftp\r\n- googleAnalytics (requires Google Analytics integration)"}]},"lookbackWindow":{"oneOf":[{"enum":["unknown","30M","24H","7D","30D"],"type":"string","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."},{"enum":["unknown","30M","24H","7D","30D"],"type":"null","description":"The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick."}]}},"description":"Read model for an ad set's attribution configuration.\r\n \r\nThe lookback window is only set for ad sets with an attribution method that is postClick or lastClick.\r\nIt will be null with any other attribution method."}]},"bidding":{"oneOf":[{"type":"object","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."},{"type":"null","properties":{"bidAmount":{"oneOf":[{"type":"number","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"},{"type":"null","description":"Decimal value target relating to the `adSetObjective` specified.\r\nMay be `null` for objectives that do not require a target value.\r\nAt most 4 decimals are supported. Additional decimals are rounded.","format":"double"}]},"costController":{"oneOf":[{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"string","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"},{"enum":["COS","maxCPC","CPI","CPM","CPO","CPSV","CPV","dailyBudget","targetCPM"],"type":"null","description":"Cost controller for the ad set.\r\n \r\nPossible values:\r\n- COS\r\n- maxCPC\r\n- CPI\r\n- CPM\r\n- CPO\r\n- CPSV\r\n- CPV\r\n- dailyBudget\r\n- targetCPM"}]}},"description":"Ad set bidding read configuration."}]},"budget":{"oneOf":[{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."},{"type":"null","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Required non-null when capped. Must be null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Required for uncapped budgets and accelerated budgets."}]}},"description":"Budget configuration for an ad set. Controls how much can be spent and how spending is paced.\r\nWhen budgetStrategy is \"capped\": budgetAmount, budgetRenewal, and budgetDeliverySmoothing are all set.\r\nWhen budgetStrategy is \"uncapped\": budgetAmount is null, budgetRenewal is \"undefined\", budgetDeliverySmoothing is null, budgetDeliveryWeek is \"undefined\", and pacingBehavior is \"undefined\"."}]},"campaignId":{"oneOf":[{"type":"string","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."},{"type":"null","description":"Campaign id this ad set belongs to.\r\n \r\nThis is a key to a MarketingCampaign entity, which can be retrieved using the MarketingCampaigns endpoints.\r\nThis value is a string-encoded integer."}]},"datasetId":{"oneOf":[{"type":"string","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."},{"type":"null","description":"Dataset id of this ad set\r\nThis value is a string-encoded integer."}]},"destinationEnvironment":{"oneOf":[{"enum":["undefined","web","app"],"type":"string","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"},{"enum":["undefined","web","app"],"type":"null","description":"The environment that an ad click will lead a user to.\r\n \r\nPossible values:\r\n- undefined: the ad set does not specify its destination environment\r\n- web: the ad set lead users to a web page\r\n- app: the ad set lead users to an app"}]},"mediaType":{"oneOf":[{"enum":["display","video"],"type":"string"},{"enum":["display","video"],"type":"null"}]},"name":{"oneOf":[{"type":"string","description":"Name of the ad set"},{"type":"null","description":"Name of the ad set"}]},"objective":{"oneOf":[{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"string","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"},{"enum":["customAction","clicks","conversions","displays","appPromotion","revenue","storeConversions","value","reach","visits","videoViews"],"type":"null","description":"Ad set objective.\r\n \r\nPossible values:\r\n- customAction (previously \"Actions\")\r\n- clicks\r\n- conversions\r\n- displays\r\n- appPromotion (previously \"Installs\")\r\n- revenue\r\n- storeConversions\r\n- value\r\n- reach (previously \"ViewedImpressions\")\r\n- visits\r\n- videoViews (previously \"CompletedVideoViews\")"}]},"schedule":{"oneOf":[{"type":"object","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"},{"type":"null","properties":{"activationStatus":{"oneOf":[{"enum":["on","off"],"type":"string","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"},{"enum":["on","off"],"type":"null","description":"Activation status of the ad set, i.e. whether the consumer wants it to deliver"}]},"deliveryStatus":{"oneOf":[{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"string","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"},{"enum":["draft","inactive","live","notLive","pausing","paused","scheduled","ended","notDelivering","archived"],"type":"null","description":"Delivery status of the ad set, i.e. whether the ad set is delivering.\r\n \r\nPossible values:\r\n- draft\r\n- inactive\r\n- live\r\n- notLive\r\n- pausing\r\n- paused\r\n- scheduled\r\n- ended\r\n- notDelivering\r\n- archived"}]},"endDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"startDate":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set schedule read model"}]},"scheduledBudgets":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}},{"type":"null","items":{"type":"object","properties":{"budgetAmount":{"oneOf":[{"type":"number","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"},{"type":"null","description":"Maximum budget amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.","format":"double"}]},"budgetDeliverySmoothing":{"oneOf":[{"enum":["accelerated","standard"],"type":"string","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."},{"enum":["accelerated","standard"],"type":"null","description":"Pacing strategy for spending the budget within a renewal period. Only applicable when budgetStrategy is \"capped\".\r\n- \"accelerated\": spend pacing is based on delivery efficiency rather than the full budget period.\r\n- \"standard\": spread spending evenly over the renewal period.\r\nWhen budgetStrategy is \"uncapped\", this field is not set (null in read responses, omit in create/patch requests)."}]},"budgetDeliveryWeek":{"oneOf":[{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"string","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."},{"enum":["undefined","mondayToSunday","tuesdayToMonday","wednesdayToTuesday","thursdayToWednesday","fridayToThursday","saturdayToFriday","sundayToSaturday"],"type":"null","description":"Defines which day-of-week boundaries are used for weekly budget renewal. Only applicable when budgetStrategy is \"capped\", budgetRenewal is \"weekly\", and budgetDeliverySmoothing is \"standard\".\r\n- \"mondayToSunday\", \"tuesdayToMonday\", etc.: the day range over which the weekly budget is paced. Changing this value on the active budget also propagates to all scheduled budgets of the same ad set.\r\n- \"undefined\": used when budgetStrategy is \"uncapped\", when budgetRenewal is not \"weekly\", or when budgetDeliverySmoothing is \"accelerated\"."}]},"budgetRenewal":{"oneOf":[{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"string","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."},{"enum":["undefined","daily","monthly","lifetime","weekly"],"type":"null","description":"The period over which the budget is spent.\r\n- \"daily\", \"monthly\", \"weekly\": budget resets at the start of each period.\r\n- \"lifetime\": budget covers the entire ad set duration without resetting.\r\n- \"undefined\": only used when budgetStrategy is \"uncapped\" (no renewal applies). Required for capped budgets (must not be \"undefined\")."}]},"budgetStrategy":{"oneOf":[{"enum":["capped","uncapped"],"type":"string","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."},{"enum":["capped","uncapped"],"type":"null","description":"Controls whether the ad set has a spending limit.\r\n- \"capped\": spending is limited to budgetAmount. Requires budgetAmount (non-null), budgetRenewal (not \"undefined\"), and budgetDeliverySmoothing (not null).\r\n- \"uncapped\": no spending limit. budgetAmount is null, budgetRenewal is \"undefined\", and budgetDeliverySmoothing is null."}]},"id":{"oneOf":[{"type":"string","description":"Identifier of the scheduled budget."},{"type":"null","description":"Identifier of the scheduled budget."}]},"pacingBehavior":{"oneOf":[{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"string","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."},{"enum":["undefined","targetFullBudget","targetAverageDailyBudget"],"type":"null","description":"Controls how a standard capped budget is paced.\r\n- \"targetFullBudget\": spend toward the full budget amount within the renewal period.\r\n- \"targetAverageDailyBudget\": spend toward an average daily amount. Only supported for capped, standard, monthly budgets.\r\n- \"undefined\": no explicit pacing behavior. Use for uncapped or accelerated budgets, or omit pacingBehavior."}]},"startDate":{"oneOf":[{"type":"string","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"},{"type":"null","description":"Advertiser-local calendar date when the scheduled budget becomes active.","format":"date"}]}},"description":"A budget configuration scheduled to replace the ad set's active budget on the specified \"startDate\".\r\nIt contains the same fields as the active budget, plus the scheduled budget identifier and start date."}}]},"serverToServerTrackings":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."},{"type":"null","items":{"type":"object","properties":{"url":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"Server-to-server (MMP) tracking URL for an app retargeting ad set."},"description":"MMP / server-to-server tracking URLs. Always present on GET ad-sets/{id} (null when not app retargeting, empty, or unavailable).\r\nAlways omitted on search."}]},"targeting":{"oneOf":[{"type":"object","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"},{"type":"null","properties":{"deliveryLimitations":{"oneOf":[{"type":"object","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."},{"type":"null","properties":{"devices":{"oneOf":[{"type":"array","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["other","desktop","mobile","tablet"],"type":"string","description":"Targeted device type.\r\n \r\nPossible values:\r\n- other\r\n- desktop\r\n- mobile\r\n- tablet"},"description":"List of devices which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"environments":{"oneOf":[{"type":"array","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["web","inApp"],"type":"string","description":"Targeted environment type.\r\n \r\nNote: this is very different from AdSetDestinationEnvironment: this parameter defines a delivery limitation,\r\nnot an impression's destination.\r\n \r\nPossible values:\r\n- web\r\n- inApp"},"description":"List of environments which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]},"operatingSystems":{"oneOf":[{"type":"array","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."},{"type":"null","items":{"enum":["android","ios","unknown"],"type":"string","description":"Targeted operating system.\r\n \r\nPossible values:\r\n- android\r\n- ios\r\n- unknown"},"description":"List of operating systems which the ad set should target.\r\n \r\nNo limitation if the list is empty."}]}},"description":"Delivery limitations for an ad set."}]},"frequencyCapping":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."},{"type":"null","properties":{"frequency":{"oneOf":[{"enum":["hourly","daily","lifetime","advanced"],"type":"string","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"},{"enum":["hourly","daily","lifetime","advanced"],"type":"null","description":"Period on which impression limitation is calculated.\r\n \r\nPossible values:\r\n- hourly\r\n- daily\r\n- lifetime\r\n- advanced"}]},"maximumImpressions":{"oneOf":[{"type":"integer","description":"Maximum impressions for the specified period.","format":"int32"},{"type":"null","description":"Maximum impressions for the specified period.","format":"int32"}]}},"description":"Ad set frequency capping.\r\n \r\nSettings that can limit the number of impression by viewer and by period."}]}}}]},"geoLocation":{"oneOf":[{"type":"object","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."},{"type":"null","properties":{"countries":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"subdivisions":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]},"zipCodes":{"oneOf":[{"type":"object","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."},{"type":"null","properties":{"value":{"oneOf":[{"type":"object","description":"ad set targeting rule model","properties":{"operand":{"enum":["undefined","in","notIn"],"type":"string"},"values":{"oneOf":[{"type":"array","items":{"type":"string"}},{"type":"null","items":{"type":"string"}}]}}},{"type":"null"}]}},"description":"structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided."}]}},"description":"Ad set geolocation options."}]}},"description":"ad set targeting model"}]},"videoChannel":{"oneOf":[{"enum":["olv","ctv"],"type":"string"},{"enum":["olv","ctv"],"type":"null"}]}},"description":"Ad set read model.\r\n \r\nThe ad set is the configuration unit that defines ads delivery. Its binds together the objective, budget,\r\nscheduling, targeting options and ads."}]},"id":{"oneOf":[{"type":"string","description":"Id of the entity","readOnly":true},{"type":"null","description":"Id of the entity","readOnly":true}]},"type":{"oneOf":[{"type":"string","readOnly":true,"example":"ReadAdSetV26Q1"},{"type":"null","readOnly":true,"example":"ReadAdSetV26Q1"}]}},"description":"read model data for resources"}]},"readOnly":true,"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"(object | null)[] | null"},"errors":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"code":{"oneOf":[{"type":"string","description":"A machine-readable error code, expressed as a string value.","uniqueKey":"errors.oneOf.0.items.[INDEX].code.oneOf.0","typeLabel":"string"},{"type":"null","description":"A machine-readable error code, expressed as a string value.","uniqueKey":"errors.oneOf.0.items.[INDEX].code.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].code","typeLabel":"string | null"},"detail":{"oneOf":[{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem","uniqueKey":"errors.oneOf.0.items.[INDEX].detail.oneOf.0","typeLabel":"string"},{"type":"null","description":"A human-readable explanation specific to this occurrence of the problem","uniqueKey":"errors.oneOf.0.items.[INDEX].detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","description":"A URI that identifies the specific occurrence of the problem.","uniqueKey":"errors.oneOf.0.items.[INDEX].instance.oneOf.0","typeLabel":"string"},{"type":"null","description":"A URI that identifies the specific occurrence of the problem.","uniqueKey":"errors.oneOf.0.items.[INDEX].instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].instance","typeLabel":"string | null"},"source":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].source.oneOf.0.additionalProperties","typeLabel":"string"},"description":"A machine-readable structure to reference to the exact location(s) causing the error(s)","uniqueKey":"errors.oneOf.0.items.[INDEX].source.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].source.oneOf.1.additionalProperties","typeLabel":"string"},"description":"A machine-readable structure to reference to the exact location(s) causing the error(s)","uniqueKey":"errors.oneOf.0.items.[INDEX].source.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].source","typeLabel":"object | null"},"stackTrace":{"oneOf":[{"type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].stackTrace.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"errors.oneOf.0.items.[INDEX].stackTrace.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].stackTrace","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","description":"A short human-readable description of the problem type","uniqueKey":"errors.oneOf.0.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","description":"A short human-readable description of the problem type","uniqueKey":"errors.oneOf.0.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].title","typeLabel":"string | null"},"traceId":{"oneOf":[{"type":"string","description":"The request correlation ID this problem comes from.","uniqueKey":"errors.oneOf.0.items.[INDEX].traceId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request correlation ID this problem comes from.","uniqueKey":"errors.oneOf.0.items.[INDEX].traceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].traceId","typeLabel":"string | null"},"traceIdentifier":{"oneOf":[{"type":"string","description":"The request correlation ID this problem comes from. (deprecated, use traceId instead)","uniqueKey":"errors.oneOf.0.items.[INDEX].traceIdentifier.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request correlation ID this problem comes from. (deprecated, use traceId instead)","uniqueKey":"errors.oneOf.0.items.[INDEX].traceIdentifier.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].traceIdentifier","typeLabel":"string | null"},"type":{"oneOf":[{"enum":["unknown","access-control","authentication","authorization","availability","deprecation","quota","validation"],"type":"string","description":"The problem's category.","uniqueKey":"errors.oneOf.0.items.[INDEX].type.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["unknown","access-control","authentication","authorization","availability","deprecation","quota","validation"],"type":"null","description":"The problem's category.","uniqueKey":"errors.oneOf.0.items.[INDEX].type.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors.oneOf.0.items.[INDEX].type","typeLabel":"enum\u003cstring> | null"}},"description":"Common problem object.","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"readOnly":true,"uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"code":{"oneOf":[{"type":"string","description":"A machine-readable error code, expressed as a string value."},{"type":"null","description":"A machine-readable error code, expressed as a string value."}]},"detail":{"oneOf":[{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem"},{"type":"null","description":"A human-readable explanation specific to this occurrence of the problem"}]},"instance":{"oneOf":[{"type":"string","description":"A URI that identifies the specific occurrence of the problem."},{"type":"null","description":"A URI that identifies the specific occurrence of the problem."}]},"source":{"oneOf":[{"type":"object","additionalProperties":{"type":"string"},"description":"A machine-readable structure to reference to the exact location(s) causing the error(s)"},{"type":"null","additionalProperties":{"type":"string"},"description":"A machine-readable structure to reference to the exact location(s) causing the error(s)"}]},"stackTrace":{"oneOf":[{"type":"string"},{"type":"null"}]},"title":{"oneOf":[{"type":"string","description":"A short human-readable description of the problem type"},{"type":"null","description":"A short human-readable description of the problem type"}]},"traceId":{"oneOf":[{"type":"string","description":"The request correlation ID this problem comes from."},{"type":"null","description":"The request correlation ID this problem comes from."}]},"traceIdentifier":{"oneOf":[{"type":"string","description":"The request correlation ID this problem comes from. (deprecated, use traceId instead)"},{"type":"null","description":"The request correlation ID this problem comes from. (deprecated, use traceId instead)"}]},"type":{"oneOf":[{"enum":["unknown","access-control","authentication","authorization","availability","deprecation","quota","validation"],"type":"string","description":"The problem's category."},{"enum":["unknown","access-control","authentication","authorization","availability","deprecation","quota","validation"],"type":"null","description":"The problem's category."}]}},"description":"Common problem object."},"readOnly":true,"uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"warnings":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"code":{"oneOf":[{"type":"string","description":"A machine-readable error code, expressed as a string value.","uniqueKey":"warnings.oneOf.0.items.[INDEX].code.oneOf.0","typeLabel":"string"},{"type":"null","description":"A machine-readable error code, expressed as a string value.","uniqueKey":"warnings.oneOf.0.items.[INDEX].code.oneOf.1","typeLabel":"null"}],"uniqueKey":"warnings.oneOf.0.items.[INDEX].code","typeLabel":"string | null"},"detail":{"oneOf":[{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem","uniqueKey":"warnings.oneOf.0.items.[INDEX].detail.oneOf.0","typeLabel":"string"},{"type":"null","description":"A human-readable explanation specific to this occurrence of the problem","uniqueKey":"warnings.oneOf.0.items.[INDEX].detail.oneOf.1","typeLabel":"null"}],"uniqueKey":"warnings.oneOf.0.items.[INDEX].detail","typeLabel":"string | null"},"instance":{"oneOf":[{"type":"string","description":"A URI that identifies the specific occurrence of the problem.","uniqueKey":"warnings.oneOf.0.items.[INDEX].instance.oneOf.0","typeLabel":"string"},{"type":"null","description":"A URI that identifies the specific occurrence of the problem.","uniqueKey":"warnings.oneOf.0.items.[INDEX].instance.oneOf.1","typeLabel":"null"}],"uniqueKey":"warnings.oneOf.0.items.[INDEX].instance","typeLabel":"string | null"},"source":{"oneOf":[{"type":"object","additionalProperties":{"type":"string","uniqueKey":"warnings.oneOf.0.items.[INDEX].source.oneOf.0.additionalProperties","typeLabel":"string"},"description":"A machine-readable structure to reference to the exact location(s) causing the error(s)","uniqueKey":"warnings.oneOf.0.items.[INDEX].source.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":{"type":"string","uniqueKey":"warnings.oneOf.0.items.[INDEX].source.oneOf.1.additionalProperties","typeLabel":"string"},"description":"A machine-readable structure to reference to the exact location(s) causing the error(s)","uniqueKey":"warnings.oneOf.0.items.[INDEX].source.oneOf.1","typeLabel":"null"}],"uniqueKey":"warnings.oneOf.0.items.[INDEX].source","typeLabel":"object | null"},"stackTrace":{"oneOf":[{"type":"string","uniqueKey":"warnings.oneOf.0.items.[INDEX].stackTrace.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"warnings.oneOf.0.items.[INDEX].stackTrace.oneOf.1","typeLabel":"null"}],"uniqueKey":"warnings.oneOf.0.items.[INDEX].stackTrace","typeLabel":"string | null"},"title":{"oneOf":[{"type":"string","description":"A short human-readable description of the problem type","uniqueKey":"warnings.oneOf.0.items.[INDEX].title.oneOf.0","typeLabel":"string"},{"type":"null","description":"A short human-readable description of the problem type","uniqueKey":"warnings.oneOf.0.items.[INDEX].title.oneOf.1","typeLabel":"null"}],"uniqueKey":"warnings.oneOf.0.items.[INDEX].title","typeLabel":"string | null"},"traceId":{"oneOf":[{"type":"string","description":"The request correlation ID this problem comes from.","uniqueKey":"warnings.oneOf.0.items.[INDEX].traceId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request correlation ID this problem comes from.","uniqueKey":"warnings.oneOf.0.items.[INDEX].traceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"warnings.oneOf.0.items.[INDEX].traceId","typeLabel":"string | null"},"traceIdentifier":{"oneOf":[{"type":"string","description":"The request correlation ID this problem comes from. (deprecated, use traceId instead)","uniqueKey":"warnings.oneOf.0.items.[INDEX].traceIdentifier.oneOf.0","typeLabel":"string"},{"type":"null","description":"The request correlation ID this problem comes from. (deprecated, use traceId instead)","uniqueKey":"warnings.oneOf.0.items.[INDEX].traceIdentifier.oneOf.1","typeLabel":"null"}],"uniqueKey":"warnings.oneOf.0.items.[INDEX].traceIdentifier","typeLabel":"string | null"},"type":{"oneOf":[{"enum":["unknown","access-control","authentication","authorization","availability","deprecation","quota","validation"],"type":"string","description":"The problem's category.","uniqueKey":"warnings.oneOf.0.items.[INDEX].type.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["unknown","access-control","authentication","authorization","availability","deprecation","quota","validation"],"type":"null","description":"The problem's category.","uniqueKey":"warnings.oneOf.0.items.[INDEX].type.oneOf.1","typeLabel":"null"}],"uniqueKey":"warnings.oneOf.0.items.[INDEX].type","typeLabel":"enum\u003cstring> | null"}},"description":"Common problem object.","uniqueKey":"warnings.oneOf.0.items.[INDEX]","typeLabel":"object"},"readOnly":true,"uniqueKey":"warnings.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"code":{"oneOf":[{"type":"string","description":"A machine-readable error code, expressed as a string value."},{"type":"null","description":"A machine-readable error code, expressed as a string value."}]},"detail":{"oneOf":[{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem"},{"type":"null","description":"A human-readable explanation specific to this occurrence of the problem"}]},"instance":{"oneOf":[{"type":"string","description":"A URI that identifies the specific occurrence of the problem."},{"type":"null","description":"A URI that identifies the specific occurrence of the problem."}]},"source":{"oneOf":[{"type":"object","additionalProperties":{"type":"string"},"description":"A machine-readable structure to reference to the exact location(s) causing the error(s)"},{"type":"null","additionalProperties":{"type":"string"},"description":"A machine-readable structure to reference to the exact location(s) causing the error(s)"}]},"stackTrace":{"oneOf":[{"type":"string"},{"type":"null"}]},"title":{"oneOf":[{"type":"string","description":"A short human-readable description of the problem type"},{"type":"null","description":"A short human-readable description of the problem type"}]},"traceId":{"oneOf":[{"type":"string","description":"The request correlation ID this problem comes from."},{"type":"null","description":"The request correlation ID this problem comes from."}]},"traceIdentifier":{"oneOf":[{"type":"string","description":"The request correlation ID this problem comes from. (deprecated, use traceId instead)"},{"type":"null","description":"The request correlation ID this problem comes from. (deprecated, use traceId instead)"}]},"type":{"oneOf":[{"enum":["unknown","access-control","authentication","authorization","availability","deprecation","quota","validation"],"type":"string","description":"The problem's category."},{"enum":["unknown","access-control","authentication","authorization","availability","deprecation","quota","validation"],"type":"null","description":"The problem's category."}]}},"description":"Common problem object."},"readOnly":true,"uniqueKey":"warnings.oneOf.1","typeLabel":"null"}],"uniqueKey":"warnings","typeLabel":"object[] | null"}},"description":"List of output resources","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":[{"attributes":{"adSetType":"standard","advertiserId":"\u003cstring>","attributionConfiguration":{"attributionMethod":"unknown","lookbackWindow":"unknown"},"bidding":{"bidAmount":123,"costController":"COS"},"budget":{"budgetAmount":123,"budgetDeliverySmoothing":"accelerated","budgetDeliveryWeek":"undefined","budgetRenewal":"undefined","budgetStrategy":"capped","pacingBehavior":"undefined"},"campaignId":"\u003cstring>","datasetId":"\u003cstring>","destinationEnvironment":"undefined","mediaType":"display","name":"\u003cstring>","objective":"customAction","schedule":{"activationStatus":"on","deliveryStatus":"draft","endDate":{"value":"2023-11-07T05:31:56Z"},"startDate":{"value":"2023-11-07T05:31:56Z"}},"scheduledBudgets":[{"budgetAmount":123,"budgetDeliverySmoothing":"accelerated","budgetDeliveryWeek":"undefined","budgetRenewal":"undefined","budgetStrategy":"capped","id":"\u003cstring>","pacingBehavior":"undefined","startDate":"2023-12-25"}],"serverToServerTrackings":[{"url":"\u003cstring>"}],"targeting":{"deliveryLimitations":{"devices":["other"],"environments":["web"],"operatingSystems":["android"]},"frequencyCapping":{"value":{"frequency":"hourly","maximumImpressions":123}},"geoLocation":{"countries":{"value":{"operand":"undefined","values":["\u003cstring>"]}},"subdivisions":{"value":{"operand":"undefined","values":["\u003cstring>"]}},"zipCodes":{"value":{"operand":"undefined","values":["\u003cstring>"]}}}},"videoChannel":"olv"},"id":"\u003cstring>","type":"ReadAdSetV26Q1"}],"errors":[{"code":"\u003cstring>","detail":"\u003cstring>","instance":"\u003cstring>","source":{},"stackTrace":"\u003cstring>","title":"\u003cstring>","traceId":"\u003cstring>","traceIdentifier":"\u003cstring>","type":"unknown"}],"warnings":[{"code":"\u003cstring>","detail":"\u003cstring>","instance":"\u003cstring>","source":{},"stackTrace":"\u003cstring>","title":"\u003cstring>","traceId":"\u003cstring>","traceIdentifier":"\u003cstring>","type":"unknown"}]}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"7b203994-853e-4aac-a373-2c94f05e8349":{"oauth":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.criteo.com/oauth2/token","scopes":{"MarketingSolutions_Analytics_Read":"Grants Read access to the capabilities from the Analytics domain, for MarketingSolutions applications","MarketingSolutions_Audience_Manage":"Grants Manage access to the capabilities from the Audience domain, for MarketingSolutions applications","MarketingSolutions_Audience_Read":"Grants Read access to the capabilities from the Audience domain, for MarketingSolutions applications","MarketingSolutions_Campaign_Manage":"Grants Manage access to the capabilities from the Campaign domain, for MarketingSolutions applications","MarketingSolutions_Campaign_Read":"Grants Read access to the capabilities from the Campaign domain, for MarketingSolutions applications","MarketingSolutions_Creative_Manage":"Grants Manage access to the capabilities from the Creative domain, for MarketingSolutions applications","MarketingSolutions_Creative_Read":"Grants Read access to the capabilities from the Creative domain, for MarketingSolutions applications","MarketingSolutions_Reco_Manage":"Grants Manage access to the capabilities from the Reco domain, for MarketingSolutions applications","MarketingSolutions_Reco_Read":"Grants Read access to the capabilities from the Reco domain, for MarketingSolutions applications"}},"authorizationCode":{"authorizationUrl":"https://api.criteo.com/oauth2","tokenUrl":"https://api.criteo.com/oauth2/token","scopes":{"MarketingSolutions_Analytics_Read":"Grants Read access to the capabilities from the Analytics domain, for MarketingSolutions applications","MarketingSolutions_Audience_Manage":"Grants Manage access to the capabilities from the Audience domain, for MarketingSolutions applications","MarketingSolutions_Audience_Read":"Grants Read access to the capabilities from the Audience domain, for MarketingSolutions applications","MarketingSolutions_Campaign_Manage":"Grants Manage access to the capabilities from the Campaign domain, for MarketingSolutions applications","MarketingSolutions_Campaign_Read":"Grants Read access to the capabilities from the Campaign domain, for MarketingSolutions applications","MarketingSolutions_Creative_Manage":"Grants Manage access to the capabilities from the Creative domain, for MarketingSolutions applications","MarketingSolutions_Creative_Read":"Grants Read access to the capabilities from the Creative domain, for MarketingSolutions applications","MarketingSolutions_Reco_Manage":"Grants Manage access to the capabilities from the Reco domain, for MarketingSolutions applications","MarketingSolutions_Reco_Read":"Grants Read access to the capabilities from the Reco domain, for MarketingSolutions applications"}}},"scopes":["MarketingSolutions_Campaign_Read"],"schemeName":"oauth"}}},"servers":{"150d8545-65e0-447e-8e47-18aa9fd99d7d":{"url":"https://api.criteo.com"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"https://api.criteo.com/oauth2/token","scopes":{"MarketingSolutions_Analytics_Read":"Grants Read access to the capabilities from the Analytics domain, for MarketingSolutions applications","MarketingSolutions_Audience_Manage":"Grants Manage access to the capabilities from the Audience domain, for MarketingSolutions applications","MarketingSolutions_Audience_Read":"Grants Read access to the capabilities from the Audience domain, for MarketingSolutions applications","MarketingSolutions_Campaign_Manage":"Grants Manage access to the capabilities from the Campaign domain, for MarketingSolutions applications","MarketingSolutions_Campaign_Read":"Grants Read access to the capabilities from the Campaign domain, for MarketingSolutions applications","MarketingSolutions_Creative_Manage":"Grants Manage access to the capabilities from the Creative domain, for MarketingSolutions applications","MarketingSolutions_Creative_Read":"Grants Read access to the capabilities from the Creative domain, for MarketingSolutions applications","MarketingSolutions_Reco_Manage":"Grants Manage access to the capabilities from the Reco domain, for MarketingSolutions applications","MarketingSolutions_Reco_Read":"Grants Read access to the capabilities from the Reco domain, for MarketingSolutions applications"}},"authorizationCode":{"authorizationUrl":"https://api.criteo.com/oauth2","tokenUrl":"https://api.criteo.com/oauth2/token","scopes":{"MarketingSolutions_Analytics_Read":"Grants Read access to the capabilities from the Analytics domain, for MarketingSolutions applications","MarketingSolutions_Audience_Manage":"Grants Manage access to the capabilities from the Audience domain, for MarketingSolutions applications","MarketingSolutions_Audience_Read":"Grants Read access to the capabilities from the Audience domain, for MarketingSolutions applications","MarketingSolutions_Campaign_Manage":"Grants Manage access to the capabilities from the Campaign domain, for MarketingSolutions applications","MarketingSolutions_Campaign_Read":"Grants Read access to the capabilities from the Campaign domain, for MarketingSolutions applications","MarketingSolutions_Creative_Manage":"Grants Manage access to the capabilities from the Creative domain, for MarketingSolutions applications","MarketingSolutions_Creative_Read":"Grants Read access to the capabilities from the Creative domain, for MarketingSolutions applications","MarketingSolutions_Reco_Manage":"Grants Manage access to the capabilities from the Reco domain, for MarketingSolutions applications","MarketingSolutions_Reco_Read":"Grants Read access to the capabilities from the Reco domain, for MarketingSolutions applications"}}},"scopes":["MarketingSolutions_Campaign_Read"],"schemeName":"oauth"},"schema":{"title":"OAuth2 Auth","type":"string","isRequired":true,"description":"The access token received from the authorization server in the OAuth 2.0 flow.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"oauth","name":"Authorization"}],"title":"oauth"}]},"originalFileLocation":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json"},"subdomain":"criteo-e1682996","siteName":"Criteo Docs","title":"/2026-07/marketing-solutions/ad-sets/search - Criteo Docs","navMaps":{"firstHrefInVersion":{"ms-2026.07":{"href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch","matchLevel":0},"ms-2027.01-rc":{"href":"/marketing-solutions/v2027.01-rc/reference/advertiser/2027-01advertisersme","matchLevel":2},"ms-2026.01":{"href":"/marketing-solutions/v2026.01/reference/advertiser/2026-01advertisersme","matchLevel":2},"ms-experimental":{"href":"/marketing-solutions/experimental/reference/reco/experimentalads-product-filter","matchLevel":3},"ms-2026-preview":{"href":"/marketing-solutions/v2026-preview/reference/reco/previewads-product-filter","matchLevel":3},"ms-2025.10":{"href":"/marketing-solutions/v2025.10/reference/advertiser/2025-10advertisersme","matchLevel":3},"ms-2025.07":{"href":"/marketing-solutions/v2025.07/reference/advertiser/2025-07advertisersme","matchLevel":3},"ms-2025.04":{"href":"/marketing-solutions/v2025.04/reference/advertiser/2025-04advertisersme","matchLevel":3},"ms-2025.01":{"href":"/marketing-solutions/v2025.01/reference/advertiser/2025-01advertisersme","matchLevel":3},"rm-2026.07":{"href":"/retail-media/docs/welcome-to-criteo","matchLevel":4},"rm-2027.01-rc":{"href":"/retail-media/v2027.01-rc/docs/introduction-to-release-candidate","matchLevel":4},"rm-experimental":{"href":"/retail-media/experimental/docs/introduction-to-experimental","matchLevel":4},"rm-2026.01":{"href":"/retail-media/v2026.01/docs/welcome-to-criteo","matchLevel":4},"rm-2026-preview":{"href":"/retail-media/v2026-preview/docs/introduction-to-preview","matchLevel":4},"rm-2025.10":{"href":"/retail-media/v2025.10/docs/welcome-to-criteo","matchLevel":4},"rm-2025.07":{"href":"/retail-media/v2025.07/docs/welcome-to-criteo","matchLevel":4},"rm-2025.04":{"href":"/retail-media/v2025.04/docs/welcome-to-criteo","matchLevel":4},"rm-2025.01":{"href":"/retail-media/v2025.01/docs/welcome-to-criteo","matchLevel":4},"ri-2026.01":{"href":"/retailer-integration/docs/overview","matchLevel":4}},"firstHrefInLanguage":{}},"lastModified":"2026-11-02T16:49:56.665Z","originalFileLocation":"marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Search for ad sets based on provided criteria. This returns the full configuration of ad sets matching those criteria. Field projection can be used if only a subset of fields is required, instead of the full configuration. If specific fields are precised in the user prompt, use meta.fields field projection in order to query only the value of these fields, else, provide every field.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Criteo Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/criteo-e1682996/Q7JsFULesw3hnXj8/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/criteo-e1682996/Q7JsFULesw3hnXj8/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/criteo-e1682996/Q7JsFULesw3hnXj8/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/criteo-e1682996/Q7JsFULesw3hnXj8/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/criteo-e1682996/Q7JsFULesw3hnXj8/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/criteo-e1682996/Q7JsFULesw3hnXj8/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/criteo-e1682996/Q7JsFULesw3hnXj8/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/criteo-e1682996/Q7JsFULesw3hnXj8/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/criteo-e1682996/Q7JsFULesw3hnXj8/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"/2026-07/marketing-solutions/ad-sets/search - Criteo Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Search for ad sets based on provided criteria. This returns the full configuration of ad sets matching those criteria. Field projection can be used if only a subset of fields is required, instead of the full configuration. If specific fields are precised in the user prompt, use meta.fields field projection in order to query only the value of these fields, else, provide every field.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Criteo Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developers.criteo.com/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://criteo-e1682996.mintlify.app/_mintlify/api/og/v2?division=Campaign\u0026amp;title=%2F2026-07%2Fmarketing-solutions%2Fad-sets%2Fsearch\u0026amp;description=Search+for+ad+sets+based+on+provided+criteria.%0D%0AThis+returns+the+full+configuration+of+ad+sets+matching+those+criteria.%0D%0AField+projection+can+be+used+if+only+a+\u0026amp;theme=41f5d581d5525872491a60f5\u0026amp;signature=f1bcbf0831526ce10f72874dcf5b1575a31055a6d780221bcc3f8128718ad52b\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"/2026-07/marketing-solutions/ad-sets/search - Criteo Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Search for ad sets based on provided criteria. This returns the full configuration of ad sets matching those criteria. Field projection can be used if only a subset of fields is required, instead of the full configuration. If specific fields are precised in the user prompt, use meta.fields field projection in order to query only the value of these fields, else, provide every field.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://criteo-e1682996.mintlify.app/_mintlify/api/og/v2?division=Campaign\u0026amp;title=%2F2026-07%2Fmarketing-solutions%2Fad-sets%2Fsearch\u0026amp;description=Search+for+ad+sets+based+on+provided+criteria.%0D%0AThis+returns+the+full+configuration+of+ad+sets+matching+those+criteria.%0D%0AField+projection+can+be+used+if+only+a+\u0026amp;theme=41f5d581d5525872491a60f5\u0026amp;signature=f1bcbf0831526ce10f72874dcf5b1575a31055a6d780221bcc3f8128718ad52b\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/criteo-e1682996/Q7JsFULesw3hnXj8/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Criteo Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FE5001\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developers.criteo.com/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developers.criteo.com/#organization\",\"name\":\"Criteo Docs\",\"url\":\"https://developers.criteo.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/criteo-e1682996/oGhV8AgFf1afoax4/logo/light.svg?fit=max\u0026auto=format\u0026n=oGhV8AgFf1afoax4\u0026q=85\u0026s=25bacaf5d815bd4242b98ca759ed086c\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developers.criteo.com#website\",\"name\":\"Criteo Docs\",\"url\":\"https://developers.criteo.com\",\"publisher\":{\"@id\":\"https://developers.criteo.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developers.criteo.com/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch#webpage\",\"url\":\"https://developers.criteo.com/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch\",\"name\":\"/2026-07/marketing-solutions/ad-sets/search\",\"description\":\"Search for ad sets based on provided criteria. This returns the full configuration of ad sets matching those criteria. Field projection can be used if only a subset of fields is required, instead of the full configuration. If specific fields are precised in the user prompt, use meta.fields field projection in order to query only the value of these fields, else, provide every field.\",\"dateModified\":\"2026-11-02T16:49:56.665Z\",\"isPartOf\":{\"@id\":\"https://developers.criteo.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.criteo.com/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.criteo.com/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Marketing Solutions API\",\"item\":\"https://developers.criteo.com/marketing-solutions/v2026.07/reference/advertiser/2026-07advertisersme\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Campaign\",\"item\":\"https://developers.criteo.com/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-sets\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"/2026-07/marketing-solutions/ad-sets/search\",\"item\":\"https://developers.criteo.com/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.criteo.com/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch#apireference\",\"headline\":\"/2026-07/marketing-solutions/ad-sets/search\",\"name\":\"/2026-07/marketing-solutions/ad-sets/search\",\"description\":\"Search for ad sets based on provided criteria. This returns the full configuration of ad sets matching those criteria. Field projection can be used if only a subset of fields is required, instead of the full configuration. If specific fields are precised in the user prompt, use meta.fields field projection in order to query only the value of these fields, else, provide every field.\",\"url\":\"https://developers.criteo.com/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch\",\"mainEntityOfPage\":{\"@id\":\"https://developers.criteo.com/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch#webpage\"},\"dateModified\":\"2026-11-02T16:49:56.665Z\",\"publisher\":{\"@id\":\"https://developers.criteo.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developers.criteo.com#website\"}}]}\u003c/script>","siteName":"Criteo Docs","nav":{"global":{},"products":[{"product":"API Resources","pages":[{"title":"API Resources","href":"/criteo-apis/docs/overview"}]},{"product":"Retail Media API","pages":[{"title":"Retail Media API","href":"/retail-media/docs/welcome-to-criteo"}]},{"product":"Marketing Solutions API","tabs":[{"tab":"Guides","versions":[{"version":"ms-2026.07","groups":[{"group":"Introduction","pages":[{"title":"Welcome to Criteo","href":"/marketing-solutions/docs/welcome-to-criteo"},{"title":"Is Criteo API for you?","href":"/marketing-solutions/docs/is-criteo-api-for-you"},{"title":"App Scopes","href":"/marketing-solutions/docs/app-scopes"}]},{"group":"Marketing Solutions Endpoints","pages":[{"title":"Authentication","href":"/marketing-solutions/docs/authentication"},{"group":"Advertisers","root":{"title":"Advertisers","href":"/marketing-solutions/docs/advertisers"},"pages":[{"title":"Get Advertiser Portfolio","href":"/marketing-solutions/docs/get-advertiser-portfolio"}]},{"group":"Analytics","root":{"title":"Analytics","href":"/marketing-solutions/docs/analytics"},"pages":[{"title":"Campaign Statistics","href":"/marketing-solutions/docs/campaign-statistics"},{"title":"Transaction IDs","href":"/marketing-solutions/docs/transaction-ids"},{"title":"Log-Level","href":"/marketing-solutions/docs/log-level"},{"title":"Placement","href":"/marketing-solutions/docs/placement"},{"title":"Placement Category","href":"/marketing-solutions/docs/placement-category"}]},{"group":"Audiences","root":{"title":"Audiences","href":"/marketing-solutions/docs/audiences"},"pages":[{"title":"Audience","href":"/marketing-solutions/docs/audience"},{"title":"Audience Segments","href":"/marketing-solutions/docs/audience-segments"},{"title":"Algebra Nodes","href":"/marketing-solutions/docs/algebra-nodes"}]},{"group":"Campaigns","root":{"title":"Campaigns","href":"/marketing-solutions/docs/campaigns"},"pages":[{"title":"Campaign","href":"/marketing-solutions/docs/campaign"},{"title":"Ad Set","href":"/marketing-solutions/docs/ad-set"},{"title":"Display Multipliers","href":"/marketing-solutions/docs/display-multipliers"},{"title":"Category Bids","href":"/marketing-solutions/docs/category-bids"}]},{"group":"Catalog","root":{"title":"Catalog","href":"/marketing-solutions/docs/catalog"},"pages":[{"title":"Product Sets","href":"/marketing-solutions/docs/product-sets"},{"title":"Product Boost","href":"/marketing-solutions/docs/product-boost"}]},{"group":"Creatives","root":{"title":"Creatives","href":"/marketing-solutions/docs/creatives"},"pages":[{"title":"Creatives","href":"/marketing-solutions/docs/creative"},{"title":"Ads","href":"/marketing-solutions/docs/ads"},{"title":"Coupon","href":"/marketing-solutions/docs/coupon"}]},{"group":"Marketplace Performance Outcomes","root":{"title":"Marketplace Performance Outcomes","href":"/marketing-solutions/docs/marketplace-performance-outcomes"},"pages":[{"group":"Multi-Seller","root":{"title":"Multi-Seller","href":"/marketing-solutions/docs/multiseller"},"pages":[{"title":"Campaigns- Concept Guide","href":"/marketing-solutions/docs/campaigns-concept-guide-1"},{"title":"Quick Start – Launch a Multi-Seller Campaign via MPO","href":"/marketing-solutions/docs/quick-start-launch-a-multi-seller-campaign-via-mpo"},{"title":"Managing Sellers","href":"/marketing-solutions/docs/multiseller-managing-sellers"},{"title":"Managing Campaigns","href":"/marketing-solutions/docs/multiseller-managing-campaigns"},{"title":"Managing Budgets","href":"/marketing-solutions/docs/multiseller-managing-budgets"},{"title":"Getting Statistics","href":"/marketing-solutions/docs/multiseller-getting-statistics"},{"title":"Troubleshooting \u0026 FAQ","href":"/marketing-solutions/docs/troubleshooting-faq"}]},{"group":"Single-Seller","root":{"title":"Single-Seller","href":"/marketing-solutions/docs/singleseller"},"pages":[{"title":"Campaigns- Concept Guide","href":"/marketing-solutions/docs/campaigns-concept-guide"},{"title":"Quick Start – Launch a Single-Seller Campaign via MPO","href":"/marketing-solutions/docs/quick-start-launch-a-single-seller-campaign-via-mpo"},{"title":"Managing Sellers","href":"/marketing-solutions/docs/managing-sellers"},{"title":"Managing Campaigns","href":"/marketing-solutions/docs/managing-campaigns"},{"title":"Managing Budgets","href":"/marketing-solutions/docs/managing-budgets"},{"title":"Getting Statistics","href":"/marketing-solutions/docs/getting-statistics"},{"title":"Troubleshooting \u0026 FAQ","href":"/marketing-solutions/docs/troubleshooting-faq-1"}]},{"group":"Reporting","root":{"title":"Reporting","href":"/marketing-solutions/docs/reporting"},"pages":[{"title":"Standard Reporting API","sidebarTitle":"Standard Reporting API","href":"/marketing-solutions/docs/mpo-standard-reporting-api"},{"title":"Standard Reporting API Metric Definitions","sidebarTitle":"Standard Reporting API Metric Definitions","href":"/marketing-solutions/docs/mpo-standard-reporting-api-metric-definitions"}]},{"group":"Integration","pages":[{"title":"Onboarding","sidebarTitle":"Onboarding","href":"/marketing-solutions/docs/onboarding-to-mpo"},{"title":"Attribution","sidebarTitle":"Attribution","href":"/marketing-solutions/docs/mpo-attribution"},{"title":"Latency","sidebarTitle":"Latency","href":"/marketing-solutions/docs/mpo-latency"},{"title":"Best Practices for API Integration","sidebarTitle":"Best Practices for API Integration","href":"/marketing-solutions/docs/mpo-api-integration-best-practices"}]}]},{"group":"Commerce Grid","root":{"title":"Commerce Grid","href":"/marketing-solutions/docs/commerce-grid"},"pages":[{"title":"Commerce Grid Audience Segments Endpoints","href":"/marketing-solutions/docs/commerce-grid-audience-segments-endpoints"}]}]}]},{"version":"ms-2027.01-rc","pages":[{"title":"ms-2027.01-rc","href":"/marketing-solutions/v2027.01-rc/docs/introduction-to-release-candidate"}]},{"version":"ms-2026.01","pages":[{"title":"ms-2026.01","href":"/marketing-solutions/v2026.01/docs/welcome-to-criteo"}]},{"version":"ms-experimental","pages":[{"title":"ms-experimental","href":"/marketing-solutions/experimental/docs/introduction-to-experimental"}]},{"version":"ms-2026-preview","pages":[{"title":"ms-2026-preview","href":"/marketing-solutions/v2026-preview/docs/introduction"}]},{"version":"ms-2025.10","pages":[{"title":"ms-2025.10","href":"/marketing-solutions/v2025.10/docs/welcome-to-criteo"}]},{"version":"ms-2025.07","pages":[{"title":"ms-2025.07","href":"/marketing-solutions/v2025.07/docs/welcome-to-criteo"}]},{"version":"ms-2025.04","pages":[{"title":"ms-2025.04","href":"/marketing-solutions/v2025.04/docs/welcome-to-criteo"}]},{"version":"ms-2025.01","pages":[{"title":"ms-2025.01","href":"/marketing-solutions/v2025.01/docs/welcome-to-criteo"}]}]},{"tab":"API Reference","icon":"code","versions":[{"version":"ms-2026.07","groups":[{"group":"Marketing Solutions API","pages":[{"group":"Advertiser","pages":[{"title":"/2026-07/advertisers/me","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/advertisers/me","href":"/marketing-solutions/v2026.07/reference/advertiser/2026-07advertisersme"}]},{"group":"Analytics","pages":[{"title":"/2026-07/log-level/advertisers/{advertiser-id}/report","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/log-level/advertisers/{advertiser-id}/report","href":"/marketing-solutions/v2026.07/reference/analytics/2026-07log-leveladvertisers-report"},{"title":"/2026-07/placements/report","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/placements/report","href":"/marketing-solutions/v2026.07/reference/analytics/2026-07placementsreport"},{"title":"/2026-07/statistics/report","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/statistics/report","href":"/marketing-solutions/v2026.07/reference/analytics/2026-07statisticsreport"},{"title":"/2026-07/transactions/report","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/transactions/report","href":"/marketing-solutions/v2026.07/reference/analytics/2026-07transactionsreport"}]},{"group":"Campaign","pages":[{"title":"/2026-07/marketing-solutions/ad-sets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/ad-sets","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-sets"},{"title":"/2026-07/marketing-solutions/ad-sets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json patch /2026-07/marketing-solutions/ad-sets","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-sets-1"},{"title":"/2026-07/marketing-solutions/ad-sets/{ad-set-id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/ad-sets/{ad-set-id}","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-sets-2"},{"title":"/2026-07/marketing-solutions/ad-sets/{ad-set-id}/audience","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json put /2026-07/marketing-solutions/ad-sets/{ad-set-id}/audience","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-sets-audience"},{"title":"/2026-07/marketing-solutions/ad-sets/{ad-set-id}/category-bids","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/ad-sets/{ad-set-id}/category-bids","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-sets-category-bids"},{"title":"/2026-07/marketing-solutions/ad-sets/{ad-set-id}/category-bids","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json patch /2026-07/marketing-solutions/ad-sets/{ad-set-id}/category-bids","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-sets-category-bids-1"},{"title":"/2026-07/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-sets-display-multipliers"},{"title":"/2026-07/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers","description":"Update the Display Multipliers for given Categories associated to an Ad Set\r\nPatch Display Multipliers for one or more Categories in a single request. Partial success policy is followed.","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json patch /2026-07/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-sets-display-multipliers-1"},{"title":"/2026-07/marketing-solutions/ad-sets/search","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/ad-sets/search","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setssearch"},{"title":"/2026-07/marketing-solutions/ad-sets/start","description":"Start the specified list of ad sets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/ad-sets/start","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setsstart"},{"title":"/2026-07/marketing-solutions/ad-sets/stop","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/ad-sets/stop","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsad-setsstop"},{"title":"/2026-07/marketing-solutions/campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/campaigns","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionscampaigns"},{"title":"/2026-07/marketing-solutions/campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json patch /2026-07/marketing-solutions/campaigns","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionscampaigns-1"},{"title":"/2026-07/marketing-solutions/campaigns/{campaign-id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/campaigns/{campaign-id}","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionscampaigns-2"},{"title":"/2026-07/marketing-solutions/campaigns/search","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/campaigns/search","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionscampaignssearch"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesadvertisers"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesadvertisers-1"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/ad-preview","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/ad-preview","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesadvertisers-ad-preview"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/adsets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/adsets","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesadvertisers-adsets"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/budgets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/budgets","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesadvertisers-budgets"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/campaigns","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesadvertisers-campaigns"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/seller-campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/seller-campaigns","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesadvertisers-seller-campaigns"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/sellers","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/sellers","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesadvertisers-sellers"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/preview-limit","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/advertisers/preview-limit","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesadvertiserspreview-limit"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/budgets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/budgets","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesbudgets"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/budgets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/marketplace-performance-outcomes/budgets","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesbudgets-1"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/budgets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json patch /2026-07/marketing-solutions/marketplace-performance-outcomes/budgets","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesbudgets-2"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesbudgets-3"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json patch /2026-07/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesbudgets-4"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesseller-campaigns"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json patch /2026-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesseller-campaigns-1"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesseller-campaigns-2"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json patch /2026-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesseller-campaigns-3"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}/budgets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}/budgets","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesseller-campaigns-budgets"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/sellers","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/sellers","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomessellers"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomessellers-1"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/budgets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/budgets","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomessellers-budgets"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/seller-campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/seller-campaigns","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomessellers-seller-campaigns"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/seller-campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/seller-campaigns","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomessellers-seller-campaigns-1"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/stats/campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/stats/campaigns","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesstatscampaigns"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/stats/seller-campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/stats/seller-campaigns","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesstatsseller-campaigns"},{"title":"/2026-07/marketing-solutions/marketplace-performance-outcomes/stats/sellers","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/marketplace-performance-outcomes/stats/sellers","href":"/marketing-solutions/v2026.07/reference/campaign/2026-07marketing-solutionsmarketplace-performance-outcomesstatssellers"}]},{"group":"Reco","pages":[{"title":"/2026-07/marketing-solutions/ads/{ad-id}/product-boost","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/ads/{ad-id}/product-boost","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsads-product-boost"},{"title":"/2026-07/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id}","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsads-product-boost-1"},{"title":"/2026-07/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id}","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsads-product-boost-2"},{"title":"/2026-07/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json delete /2026-07/marketing-solutions/ads/{ad-id}/product-boost/{product-set-id}","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsads-product-boost-3"},{"title":"/2026-07/marketing-solutions/ads/{ad-id}/product-filter","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/ads/{ad-id}/product-filter","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsads-product-filter"},{"title":"/2026-07/marketing-solutions/ads/{ad-id}/product-filter","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/ads/{ad-id}/product-filter","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsads-product-filter-1"},{"title":"/2026-07/marketing-solutions/ads/{ad-id}/product-filter","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json delete /2026-07/marketing-solutions/ads/{ad-id}/product-filter","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsads-product-filter-2"},{"title":"/2026-07/marketing-solutions/dataset/{dataset-id}/product-boost","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/dataset/{dataset-id}/product-boost","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsdataset-product-boost"},{"title":"/2026-07/marketing-solutions/product-sets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/product-sets","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsproduct-sets"},{"title":"/2026-07/marketing-solutions/product-sets/{product-set-id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/product-sets/{product-set-id}","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsproduct-sets-1"},{"title":"/2026-07/marketing-solutions/product-sets/{product-set-id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json delete /2026-07/marketing-solutions/product-sets/{product-set-id}","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsproduct-sets-2"},{"title":"/2026-07/marketing-solutions/product-sets/{product-set-id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json patch /2026-07/marketing-solutions/product-sets/{product-set-id}","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsproduct-sets-3"},{"title":"/2026-07/marketing-solutions/product-sets/{product-set-id}/product-filters","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/product-sets/{product-set-id}/product-filters","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsproduct-sets-product-filters"},{"title":"/2026-07/marketing-solutions/product-sets/dataset/{dataset-id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/product-sets/dataset/{dataset-id}","href":"/marketing-solutions/v2026.07/reference/reco/2026-07marketing-solutionsproduct-setsdataset"}]},{"group":"Creative","pages":[{"title":"/2026-07/marketing-solutions/ads/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/ads/{id}","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionsads"},{"title":"/2026-07/marketing-solutions/ads/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json delete /2026-07/marketing-solutions/ads/{id}","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionsads-1"},{"title":"/2026-07/marketing-solutions/advertisers/{advertiser-id}/ads","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/advertisers/{advertiser-id}/ads","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionsadvertisers-ads"},{"title":"/2026-07/marketing-solutions/advertisers/{advertiser-id}/ads","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/advertisers/{advertiser-id}/ads","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionsadvertisers-ads-1"},{"title":"/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionsadvertisers-coupons"},{"title":"/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionsadvertisers-coupons-1"},{"title":"/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons-supported-sizes","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons-supported-sizes","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionsadvertisers-coupons-supported-sizes"},{"title":"/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionsadvertisers-coupons-2"},{"title":"/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json put /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionsadvertisers-coupons-3"},{"title":"/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json delete /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionsadvertisers-coupons-4"},{"title":"/2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}/preview","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}/preview","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionsadvertisers-coupons-preview"},{"title":"/2026-07/marketing-solutions/advertisers/{advertiser-id}/creatives","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/advertisers/{advertiser-id}/creatives","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionsadvertisers-creatives"},{"title":"/2026-07/marketing-solutions/advertisers/{advertiser-id}/creatives","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/advertisers/{advertiser-id}/creatives","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionsadvertisers-creatives-1"},{"title":"/2026-07/marketing-solutions/creatives/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/creatives/{id}","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionscreatives"},{"title":"/2026-07/marketing-solutions/creatives/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json put /2026-07/marketing-solutions/creatives/{id}","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionscreatives-1"},{"title":"/2026-07/marketing-solutions/creatives/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json delete /2026-07/marketing-solutions/creatives/{id}","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionscreatives-2"},{"title":"/2026-07/marketing-solutions/creatives/{id}/preview","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/creatives/{id}/preview","href":"/marketing-solutions/v2026.07/reference/creative/2026-07marketing-solutionscreatives-preview"}]},{"group":"Audience","pages":[{"title":"/2026-07/marketing-solutions/audience-segments","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json patch /2026-07/marketing-solutions/audience-segments","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudience-segments"},{"title":"/2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json delete /2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudience-segments-contact-list"},{"title":"/2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json patch /2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudience-segments-contact-list-1"},{"title":"/2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list/statistics","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list/statistics","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudience-segments-contact-liststatistics"},{"title":"/2026-07/marketing-solutions/audience-segments/compute-sizes","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/audience-segments/compute-sizes","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudience-segmentscompute-sizes"},{"title":"/2026-07/marketing-solutions/audience-segments/create","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/audience-segments/create","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudience-segmentscreate"},{"title":"/2026-07/marketing-solutions/audience-segments/delete","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/audience-segments/delete","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudience-segmentsdelete"},{"title":"/2026-07/marketing-solutions/audience-segments/estimate-size","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/audience-segments/estimate-size","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudience-segmentsestimate-size"},{"title":"/2026-07/marketing-solutions/audience-segments/in-market-brands","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/audience-segments/in-market-brands","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudience-segmentsin-market-brands"},{"title":"/2026-07/marketing-solutions/audience-segments/in-market-interests","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/audience-segments/in-market-interests","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudience-segmentsin-market-interests"},{"title":"/2026-07/marketing-solutions/audience-segments/search","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/audience-segments/search","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudience-segmentssearch"},{"title":"/2026-07/marketing-solutions/audiences","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json patch /2026-07/marketing-solutions/audiences","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudiences"},{"title":"/2026-07/marketing-solutions/audiences/compute-sizes","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/audiences/compute-sizes","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudiencescompute-sizes"},{"title":"/2026-07/marketing-solutions/audiences/create","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/audiences/create","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudiencescreate"},{"title":"/2026-07/marketing-solutions/audiences/delete","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/audiences/delete","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudiencesdelete"},{"title":"/2026-07/marketing-solutions/audiences/estimate-size","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/audiences/estimate-size","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudiencesestimate-size"},{"title":"/2026-07/marketing-solutions/audiences/search","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json post /2026-07/marketing-solutions/audiences/search","href":"/marketing-solutions/v2026.07/reference/audience/2026-07marketing-solutionsaudiencessearch"}]},{"group":"Gateway","pages":[{"title":"/2026-07/marketing-solutions/me","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/marketingsolutions/open-api-specifications.json get /2026-07/marketing-solutions/me","href":"/marketing-solutions/v2026.07/reference/gateway/2026-07marketing-solutionsme"}]}]},{"group":"Commerce Grid API","pages":[{"group":"Segment","pages":[{"title":"/2026-07/commerce-grid/audience-segments","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/commercegrid/open-api-specifications.json patch /2026-07/commerce-grid/audience-segments","href":"/marketing-solutions/v2026.07/reference/commerce-grid/segment/2026-07commerce-gridaudience-segments"},{"title":"/2026-07/commerce-grid/audience-segments/{audience-segment-id}/contact-list/add-remove","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/commercegrid/open-api-specifications.json post /2026-07/commerce-grid/audience-segments/{audience-segment-id}/contact-list/add-remove","href":"/marketing-solutions/v2026.07/reference/commerce-grid/segment/2026-07commerce-gridaudience-segments-contact-listadd-remove"},{"title":"/2026-07/commerce-grid/audience-segments/{audience-segment-id}/contact-list/clear","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/commercegrid/open-api-specifications.json post /2026-07/commerce-grid/audience-segments/{audience-segment-id}/contact-list/clear","href":"/marketing-solutions/v2026.07/reference/commerce-grid/segment/2026-07commerce-gridaudience-segments-contact-listclear"},{"title":"/2026-07/commerce-grid/audience-segments/{audience-segment-id}/contact-list/statistics","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/commercegrid/open-api-specifications.json get /2026-07/commerce-grid/audience-segments/{audience-segment-id}/contact-list/statistics","href":"/marketing-solutions/v2026.07/reference/commerce-grid/segment/2026-07commerce-gridaudience-segments-contact-liststatistics"},{"title":"/2026-07/commerce-grid/audience-segments/create","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/commercegrid/open-api-specifications.json post /2026-07/commerce-grid/audience-segments/create","href":"/marketing-solutions/v2026.07/reference/commerce-grid/segment/2026-07commerce-gridaudience-segmentscreate"},{"title":"/2026-07/commerce-grid/audience-segments/delete","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/commercegrid/open-api-specifications.json post /2026-07/commerce-grid/audience-segments/delete","href":"/marketing-solutions/v2026.07/reference/commerce-grid/segment/2026-07commerce-gridaudience-segmentsdelete"},{"title":"/2026-07/commerce-grid/audience-segments/search","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/commercegrid/open-api-specifications.json post /2026-07/commerce-grid/audience-segments/search","href":"/marketing-solutions/v2026.07/reference/commerce-grid/segment/2026-07commerce-gridaudience-segmentssearch"}]},{"group":"Gateway","pages":[{"title":"/2026-07/commerce-grid/me","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2026-07/commercegrid/open-api-specifications.json get /2026-07/commerce-grid/me","href":"/marketing-solutions/v2026.07/reference/commerce-grid/gateway/2026-07commerce-gridme"}]}]}]},{"version":"ms-2027.01-rc","pages":[{"title":"ms-2027.01-rc","href":"/marketing-solutions/v2027.01-rc/reference/advertiser/2027-01advertisersme"}]},{"version":"ms-2026.01","pages":[{"title":"ms-2026.01","href":"/marketing-solutions/v2026.01/reference/advertiser/2026-01advertisersme"}]},{"version":"ms-experimental","pages":[{"title":"ms-experimental","href":"/marketing-solutions/experimental/reference/reco/experimentalads-product-filter"}]},{"version":"ms-2026-preview","pages":[{"title":"ms-2026-preview","href":"/marketing-solutions/v2026-preview/reference/reco/previewads-product-filter"}]},{"version":"ms-2025.10","pages":[{"title":"ms-2025.10","href":"/marketing-solutions/v2025.10/reference/advertiser/2025-10advertisersme"}]},{"version":"ms-2025.07","pages":[{"title":"ms-2025.07","href":"/marketing-solutions/v2025.07/reference/advertiser/2025-07advertisersme"}]},{"version":"ms-2025.04","pages":[{"title":"ms-2025.04","href":"/marketing-solutions/v2025.04/reference/advertiser/2025-04advertisersme"}]},{"version":"ms-2025.01","pages":[{"title":"ms-2025.01","href":"/marketing-solutions/v2025.01/reference/advertiser/2025-01advertisersme"}]}]},{"tab":"Changelog","icon":"bullhorn","pages":[{"title":"Changelog","href":"/marketing-solutions/changelog/changelog"}]}]},{"product":"Retailer Integration","pages":[{"title":"Retailer Integration","href":"/retailer-integration/docs/overview"}]},{"product":"MMP Integrations","pages":[{"title":"MMP Integrations","href":"/mobile-integrations/docs/mobile-endpoint-specification"}]},{"product":"Model Context Protocol (MCP)","pages":[{"title":"Model Context Protocol (MCP)","href":"/mcp/docs/criteos-model-context-protocol-mcp"}]}]},"basePath":"","title":"/2026-07/marketing-solutions/ad-sets/search - Criteo Docs","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DX1Meug0.js","utils-B_OMIQVC.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-ChxhRPMa.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CuKvD8Iv.js","snippetPresets-C5d7p2hp.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CfHcE8m4.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C1zZV314.js","shallow-CmQhqCJn.js","getApiPlaygroundDisplay-YRo9s1O7.js","CodeSnippet-RN1MTdfk.js","CodeSnippets-DKLPHxJA.js","Page-BAvA99GL.js","getPastedJson-bz0M41mU.js","icon-CsmhpPrv.js","MethodPill-CNGsVE77.js","DuplicateIcon-DilfU_Z2.js","createIcon-BdsYzQck.js","DynamicMarkdown-CbqEDjbV.js","SectionHeading-O6hXpFCN.js","axios-vUo_bRtp.js","Markdown-nKm-uidQ.js","clsx-ClVdStUn.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CIQkMg3R.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-ImrFS4Fy.js"]}