Creates an ad by binding an existing creative to an existing ad set of the advertiser, delivering
from the start date given. The creative and the ad set must both belong to that advertiser. Returns
the new ad and its id.
{"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":"6ae362234d48ffa49b8b1431","collectionId":"7d4c939d-1d51-4499-b627-6d48dd0269f5","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae362234d48ffa49b8b1431"},"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":"6ae4a0ade43296fe36a0fa73","clientVersion":"0.0.4043","searchFilterCounts":[{"language":"default","tag":"API Reference","count":1622},{"language":"default","tag":"Marketing Solutions API","count":1398},{"language":"default","tag":"Retail Media API","count":1076},{"language":"default","tag":"Campaign","count":689},{"language":"default","tag":"Guides","count":657},{"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":"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":"byok-sep-25","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":"billing-updated-9-15","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}],"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":""}],"page":{"pagePath":"marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1","slug":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1","pageMetadata":{"title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads","description":"Creates an ad by binding an existing creative to an existing ad set of the advertiser, delivering\r\nfrom the start date given. The creative and the ad set must both belong to that advertiser. Returns\r\nthe new ad and its id.","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/advertisers/{advertiser-id}/ads","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Creates an ad by binding an existing creative to an existing ad set of the advertiser, delivering\\r\\nfrom the start date given. The creative and the ad set must both belong to that advertiser. Returns\\r\\nthe new ad and its id.\"\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":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads","description":"Creates an ad by binding an existing creative to an existing ad set of the advertiser, delivering\r\nfrom the start date given. The creative and the ad set must both belong to that advertiser. Returns\r\nthe new ad and its id.","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/advertisers/{advertiser-id}/ads","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Creative"],"summary":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads","description":"Creates an ad by binding an existing creative to an existing ad set of the advertiser, delivering\r\nfrom the start date given. The creative and the ad set must both belong to that advertiser. Returns\r\nthe new ad and its id.","operationId":"CreateAdvertiserAd","parameters":["cfd26cb5-7bf0-4be5-96b7-37e0de29f08a"],"requestBody":"d6f3b3a9-82c5-48d1-9f3f-323a01279442","responses":{"201":"dc421d91-a095-4bd4-a448-001a6d6caec0"},"security":["09242c9b-f937-4c79-88fc-23e2e2d235db"],"method":"post","type":"path","servers":["392d40f7-9623-4335-8082-910e389aa369"],"path":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads","baseUrlOptions":["https://api.criteo.com"],"title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"cfd26cb5-7bf0-4be5-96b7-37e0de29f08a":{"name":"advertiser-id","in":"path","description":"The advertiser identifier.","required":true,"schema":{"type":"string","isRequired":true,"description":"The advertiser identifier.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"description":"The ad information.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"type":"object","properties":{"attributes":{"required":["adSetId","creativeId","name","startDate"],"type":"object","properties":{"adSetId":{"type":"string","description":"The id of the Ad Set bound to this Ad","isRequired":true,"uniqueKey":"data.attributes.adSetId","typeLabel":"string"},"creativeId":{"type":"string","description":"The id of the Creative bound to this Ad","isRequired":true,"uniqueKey":"data.attributes.creativeId","typeLabel":"string"},"name":{"type":"string","description":"The name of the ad","isRequired":true,"uniqueKey":"data.attributes.name","typeLabel":"string"},"startDate":{"type":"string","description":"The date when the ad will be launched. It must be a date in the future.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are both required, for example \"2026-10-01T09:30:00.000Z\".\r\nNo other ISO8601 layout is accepted, neither a UTC offset such as \"2026-10-01T11:30:00+02:00\" nor a\r\nsecond-precision \"2026-10-01T09:30:00Z\".","isRequired":true,"uniqueKey":"data.attributes.startDate","typeLabel":"string"},"adClickTracking":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].bindingId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].bindingId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].bindingId","typeLabel":"string | null"},"clickZone":{"oneOf":[{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"string","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\".","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].clickZone.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"null","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\".","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].clickZone.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].clickZone","typeLabel":"enum\u003cstring> | null"},"disableForCoupons":{"oneOf":[{"type":"boolean","description":"Whether this rule is skipped for clicks on coupons.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].disableForCoupons.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether this rule is skipped for clicks on coupons.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].disableForCoupons.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].disableForCoupons","typeLabel":"boolean | null"},"disableLandingUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether the landing url is left unencoded when it is substituted into the tracking url.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].disableLandingUrlEncode.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the landing url is left unencoded when it is substituted into the tracking url.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].disableLandingUrlEncode.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].disableLandingUrlEncode","typeLabel":"boolean | null"},"disableMacroUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether url macros are left unencoded when they are substituted into the tracking url.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].disableMacroUrlEncode.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether url macros are left unencoded when they are substituted into the tracking url.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].disableMacroUrlEncode.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].disableMacroUrlEncode","typeLabel":"boolean | null"},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].displayHeight.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].displayHeight.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].displayHeight","typeLabel":"integer\u003cint32> | null"},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].displayWidth.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].displayWidth.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].displayWidth","typeLabel":"integer\u003cint32> | null"},"id":{"oneOf":[{"type":"string","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].id","typeLabel":"string | null"},"urlPrefix":{"oneOf":[{"type":"string","description":"The url prepended to the landing url of the clicks this rule covers.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].urlPrefix.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url prepended to the landing url of the clicks this rule covers.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].urlPrefix.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].urlPrefix","typeLabel":"string | null"},"urlSuffix":{"oneOf":[{"type":"string","description":"The url appended to the landing url of the clicks this rule covers.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].urlSuffix.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url appended to the landing url of the clicks this rule covers.","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].urlSuffix.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX].urlSuffix","typeLabel":"string | null"}},"description":"An ad-level click tracking rule. A rule wraps the landing url of the clicks it covers with a prefix and a\r\nsuffix. It applies either to the whole ad (neither clickZone nor a display size set), to one banner zone\r\n(clickZone set), or to one display size (displayWidth and displayHeight both set).","uniqueKey":"data.attributes.adClickTracking.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Optional ad-level click tracking configuration.","uniqueKey":"data.attributes.adClickTracking.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"clickZone":{"oneOf":[{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"string","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."},{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"null","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."}]},"disableForCoupons":{"oneOf":[{"type":"boolean","description":"Whether this rule is skipped for clicks on coupons."},{"type":"null","description":"Whether this rule is skipped for clicks on coupons."}]},"disableLandingUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."},{"type":"null","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."}]},"disableMacroUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether url macros are left unencoded when they are substituted into the tracking url."},{"type":"null","description":"Whether url macros are left unencoded when they are substituted into the tracking url."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."}]},"urlPrefix":{"oneOf":[{"type":"string","description":"The url prepended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url prepended to the landing url of the clicks this rule covers."}]},"urlSuffix":{"oneOf":[{"type":"string","description":"The url appended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url appended to the landing url of the clicks this rule covers."}]}},"description":"An ad-level click tracking rule. A rule wraps the landing url of the clicks it covers with a prefix and a\r\nsuffix. It applies either to the whole ad (neither clickZone nor a display size set), to one banner zone\r\n(clickZone set), or to one display size (displayWidth and displayHeight both set)."},"description":"Optional ad-level click tracking configuration.","uniqueKey":"data.attributes.adClickTracking.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adClickTracking","typeLabel":"object[] | null"},"adImpressionTracking":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused.","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].bindingId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused.","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].bindingId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].bindingId","typeLabel":"string | null"},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].displayHeight.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].displayHeight.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].displayHeight","typeLabel":"integer\u003cint32> | null"},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].displayWidth.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].displayWidth.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].displayWidth","typeLabel":"integer\u003cint32> | null"},"id":{"oneOf":[{"type":"string","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted.","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted.","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].id","typeLabel":"string | null"},"url":{"oneOf":[{"type":"string","description":"The url called when an impression covered by this rule is served.","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url called when an impression covered by this rule is served.","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].url","typeLabel":"string | null"},"vendorId":{"oneOf":[{"type":"string","description":"Unique ID of the third party vendor the tracking url belongs to.","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].vendorId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unique ID of the third party vendor the tracking url belongs to.","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].vendorId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX].vendorId","typeLabel":"string | null"}},"description":"An ad-level impression tracking rule. The rule calls its url when an impression it covers is served. It\r\napplies either to the whole ad (no display size set) or to one display size (displayWidth and displayHeight\r\nboth set).","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Optional ad-level impression tracking configuration.","uniqueKey":"data.attributes.adImpressionTracking.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."}]},"url":{"oneOf":[{"type":"string","description":"The url called when an impression covered by this rule is served."},{"type":"null","description":"The url called when an impression covered by this rule is served."}]},"vendorId":{"oneOf":[{"type":"string","description":"Unique ID of the third party vendor the tracking url belongs to."},{"type":"null","description":"Unique ID of the third party vendor the tracking url belongs to."}]}},"description":"An ad-level impression tracking rule. The rule calls its url when an impression it covers is served. It\r\napplies either to the whole ad (no display size set) or to one display size (displayWidth and displayHeight\r\nboth set)."},"description":"Optional ad-level impression tracking configuration.","uniqueKey":"data.attributes.adImpressionTracking.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.adImpressionTracking","typeLabel":"object[] | null"},"description":{"oneOf":[{"type":"string","description":"The description of the ad","uniqueKey":"data.attributes.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"The description of the ad","uniqueKey":"data.attributes.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.description","typeLabel":"string | null"},"endDate":{"oneOf":[{"type":"string","description":"The date when we will stop showing this ad, which must come after the start date. If the end\r\ndate is not specified (i.e. null) then the ad will go on forever.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are both required, for example \"2026-10-01T09:30:00.000Z\".\r\nNo other ISO8601 layout is accepted, neither a UTC offset such as \"2026-10-01T11:30:00+02:00\" nor a\r\nsecond-precision \"2026-10-01T09:30:00Z\".","uniqueKey":"data.attributes.endDate.oneOf.0","typeLabel":"string"},{"type":"null","description":"The date when we will stop showing this ad, which must come after the start date. If the end\r\ndate is not specified (i.e. null) then the ad will go on forever.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are both required, for example \"2026-10-01T09:30:00.000Z\".\r\nNo other ISO8601 layout is accepted, neither a UTC offset such as \"2026-10-01T11:30:00+02:00\" nor a\r\nsecond-precision \"2026-10-01T09:30:00Z\".","uniqueKey":"data.attributes.endDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.endDate","typeLabel":"string | null"},"id":{"oneOf":[{"type":"string","uniqueKey":"data.attributes.id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.attributes.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.id","typeLabel":"string | null"},"inventoryType":{"oneOf":[{"enum":["Native","Display","Video","Meta"],"type":"string","description":"The inventory the Ad to be created or updated belongs to. Possible values are \"Display\", \"Native\",\r\n\"Video\" and \"Meta\". This is optional since it doesn't make sense for every creative type: it is inferred\r\nfrom the creative for a video creative, and an error is returned if it is not set for a dynamic creative.\r\n\"Meta\" additionally requires the target ad set to be linked to Meta.","uniqueKey":"data.attributes.inventoryType.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["Native","Display","Video","Meta"],"type":"null","description":"The inventory the Ad to be created or updated belongs to. Possible values are \"Display\", \"Native\",\r\n\"Video\" and \"Meta\". This is optional since it doesn't make sense for every creative type: it is inferred\r\nfrom the creative for a video creative, and an error is returned if it is not set for a dynamic creative.\r\n\"Meta\" additionally requires the target ad set to be linked to Meta.","uniqueKey":"data.attributes.inventoryType.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.attributes.inventoryType","typeLabel":"enum\u003cstring> | null"}},"description":"Entity to create an ad","uniqueKey":"data.attributes","typeLabel":"object"},"id":{"oneOf":[{"type":"string","description":"Unique identifier of this resource.","uniqueKey":"data.id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unique identifier of this resource.","uniqueKey":"data.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.id","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"data.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.type","typeLabel":"string | null"}},"description":"A class that represents a domain entity exposed by an API.","uniqueKey":"data","typeLabel":"object"}},"description":"A top-level object that encapsulates a Criteo API request for a single entity.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"id":"\u003cstring>","type":"\u003cstring>"}}}},"exampleType":"generated"}},"required":true,"x-bodyName":"request","exampleType":"generated"},"responses":{"dc421d91-a095-4bd4-a448-001a6d6caec0":{"description":"The created Ad is returned.","content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"type":"object","properties":{"attributes":{"oneOf":[{"type":"object","properties":{"adClickTracking":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].bindingId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].bindingId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].bindingId","typeLabel":"string | null"},"clickZone":{"oneOf":[{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"string","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\".","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].clickZone.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"null","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\".","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].clickZone.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].clickZone","typeLabel":"enum\u003cstring> | null"},"disableForCoupons":{"oneOf":[{"type":"boolean","description":"Whether this rule is skipped for clicks on coupons.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].disableForCoupons.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether this rule is skipped for clicks on coupons.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].disableForCoupons.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].disableForCoupons","typeLabel":"boolean | null"},"disableLandingUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether the landing url is left unencoded when it is substituted into the tracking url.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].disableLandingUrlEncode.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether the landing url is left unencoded when it is substituted into the tracking url.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].disableLandingUrlEncode.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].disableLandingUrlEncode","typeLabel":"boolean | null"},"disableMacroUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether url macros are left unencoded when they are substituted into the tracking url.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].disableMacroUrlEncode.oneOf.0","typeLabel":"boolean"},{"type":"null","description":"Whether url macros are left unencoded when they are substituted into the tracking url.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].disableMacroUrlEncode.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].disableMacroUrlEncode","typeLabel":"boolean | null"},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].displayHeight.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].displayHeight.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].displayHeight","typeLabel":"integer\u003cint32> | null"},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].displayWidth.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].displayWidth.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].displayWidth","typeLabel":"integer\u003cint32> | null"},"id":{"oneOf":[{"type":"string","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].id","typeLabel":"string | null"},"urlPrefix":{"oneOf":[{"type":"string","description":"The url prepended to the landing url of the clicks this rule covers.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].urlPrefix.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url prepended to the landing url of the clicks this rule covers.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].urlPrefix.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].urlPrefix","typeLabel":"string | null"},"urlSuffix":{"oneOf":[{"type":"string","description":"The url appended to the landing url of the clicks this rule covers.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].urlSuffix.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url appended to the landing url of the clicks this rule covers.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].urlSuffix.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX].urlSuffix","typeLabel":"string | null"}},"description":"An ad-level click tracking rule. A rule wraps the landing url of the clicks it covers with a prefix and a\r\nsuffix. It applies either to the whole ad (neither clickZone nor a display size set), to one banner zone\r\n(clickZone set), or to one display size (displayWidth and displayHeight both set).","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Optional ad-level click tracking configuration.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"clickZone":{"oneOf":[{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"string","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."},{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"null","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."}]},"disableForCoupons":{"oneOf":[{"type":"boolean","description":"Whether this rule is skipped for clicks on coupons."},{"type":"null","description":"Whether this rule is skipped for clicks on coupons."}]},"disableLandingUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."},{"type":"null","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."}]},"disableMacroUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether url macros are left unencoded when they are substituted into the tracking url."},{"type":"null","description":"Whether url macros are left unencoded when they are substituted into the tracking url."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."}]},"urlPrefix":{"oneOf":[{"type":"string","description":"The url prepended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url prepended to the landing url of the clicks this rule covers."}]},"urlSuffix":{"oneOf":[{"type":"string","description":"The url appended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url appended to the landing url of the clicks this rule covers."}]}},"description":"An ad-level click tracking rule. A rule wraps the landing url of the clicks it covers with a prefix and a\r\nsuffix. It applies either to the whole ad (neither clickZone nor a display size set), to one banner zone\r\n(clickZone set), or to one display size (displayWidth and displayHeight both set)."},"description":"Optional ad-level click tracking configuration.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adClickTracking","typeLabel":"object[] | null"},"adDeliveryStatus":{"oneOf":[{"enum":["Live","Paused"],"type":"string","description":"The delivery status of the ad. Possible values are \"Live\" and \"Paused\". This is read-only: use the\r\ndedicated pause and unpause operations to change it.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adDeliveryStatus.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["Live","Paused"],"type":"null","description":"The delivery status of the ad. Possible values are \"Live\" and \"Paused\". This is read-only: use the\r\ndedicated pause and unpause operations to change it.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adDeliveryStatus.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adDeliveryStatus","typeLabel":"enum\u003cstring> | null"},"adImpressionTracking":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].bindingId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].bindingId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].bindingId","typeLabel":"string | null"},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].displayHeight.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].displayHeight.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].displayHeight","typeLabel":"integer\u003cint32> | null"},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].displayWidth.oneOf.0","typeLabel":"integer\u003cint32>"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].displayWidth.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].displayWidth","typeLabel":"integer\u003cint32> | null"},"id":{"oneOf":[{"type":"string","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].id","typeLabel":"string | null"},"url":{"oneOf":[{"type":"string","description":"The url called when an impression covered by this rule is served.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].url.oneOf.0","typeLabel":"string"},{"type":"null","description":"The url called when an impression covered by this rule is served.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].url.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].url","typeLabel":"string | null"},"vendorId":{"oneOf":[{"type":"string","description":"Unique ID of the third party vendor the tracking url belongs to.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].vendorId.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unique ID of the third party vendor the tracking url belongs to.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].vendorId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX].vendorId","typeLabel":"string | null"}},"description":"An ad-level impression tracking rule. The rule calls its url when an impression it covers is served. It\r\napplies either to the whole ad (no display size set) or to one display size (displayWidth and displayHeight\r\nboth set).","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0.items.[INDEX]","typeLabel":"object"},"description":"Optional ad-level impression tracking configuration.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."}]},"url":{"oneOf":[{"type":"string","description":"The url called when an impression covered by this rule is served."},{"type":"null","description":"The url called when an impression covered by this rule is served."}]},"vendorId":{"oneOf":[{"type":"string","description":"Unique ID of the third party vendor the tracking url belongs to."},{"type":"null","description":"Unique ID of the third party vendor the tracking url belongs to."}]}},"description":"An ad-level impression tracking rule. The rule calls its url when an impression it covers is served. It\r\napplies either to the whole ad (no display size set) or to one display size (displayWidth and displayHeight\r\nboth set)."},"description":"Optional ad-level impression tracking configuration.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adImpressionTracking","typeLabel":"object[] | null"},"adSetId":{"oneOf":[{"type":"string","description":"The id of the Ad Set binded to this Ad","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adSetId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The id of the Ad Set binded to this Ad","uniqueKey":"data.oneOf.0.attributes.oneOf.0.adSetId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.adSetId","typeLabel":"string | null"},"creativeId":{"oneOf":[{"type":"string","description":"The id of the Creative binded to this Ad","uniqueKey":"data.oneOf.0.attributes.oneOf.0.creativeId.oneOf.0","typeLabel":"string"},{"type":"null","description":"The id of the Creative binded to this Ad","uniqueKey":"data.oneOf.0.attributes.oneOf.0.creativeId.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.creativeId","typeLabel":"string | null"},"description":{"oneOf":[{"type":"string","description":"The description of the ad","uniqueKey":"data.oneOf.0.attributes.oneOf.0.description.oneOf.0","typeLabel":"string"},{"type":"null","description":"The description of the ad","uniqueKey":"data.oneOf.0.attributes.oneOf.0.description.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.description","typeLabel":"string | null"},"endDate":{"oneOf":[{"type":"string","description":"The date when we will stop showing this ad. If the end date is not specified (i.e. null) then\r\nthe ad will go on forever.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\".","uniqueKey":"data.oneOf.0.attributes.oneOf.0.endDate.oneOf.0","typeLabel":"string"},{"type":"null","description":"The date when we will stop showing this ad. If the end date is not specified (i.e. null) then\r\nthe ad will go on forever.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\".","uniqueKey":"data.oneOf.0.attributes.oneOf.0.endDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.endDate","typeLabel":"string | null"},"id":{"oneOf":[{"type":"string","uniqueKey":"data.oneOf.0.attributes.oneOf.0.id.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.oneOf.0.attributes.oneOf.0.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.id","typeLabel":"string | null"},"inventoryType":{"oneOf":[{"enum":["Native","Display","Video","Meta"],"type":"string","description":"The inventory the Ad belongs to. Possible values are \"Display\", \"Native\", \"Video\" and \"Meta\". This is\r\noptional since it doesn't make sense for every creative type: it is inferred from the creative for a\r\nvideo creative, and an error is returned if it is not set for a dynamic creative.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.inventoryType.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["Native","Display","Video","Meta"],"type":"null","description":"The inventory the Ad belongs to. Possible values are \"Display\", \"Native\", \"Video\" and \"Meta\". This is\r\noptional since it doesn't make sense for every creative type: it is inferred from the creative for a\r\nvideo creative, and an error is returned if it is not set for a dynamic creative.","uniqueKey":"data.oneOf.0.attributes.oneOf.0.inventoryType.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.inventoryType","typeLabel":"enum\u003cstring> | null"},"name":{"oneOf":[{"type":"string","description":"The name of the ad","uniqueKey":"data.oneOf.0.attributes.oneOf.0.name.oneOf.0","typeLabel":"string"},{"type":"null","description":"The name of the ad","uniqueKey":"data.oneOf.0.attributes.oneOf.0.name.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.name","typeLabel":"string | null"},"startDate":{"oneOf":[{"type":"string","description":"The date when the ad will be launched.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\".","uniqueKey":"data.oneOf.0.attributes.oneOf.0.startDate.oneOf.0","typeLabel":"string"},{"type":"null","description":"The date when the ad will be launched.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\".","uniqueKey":"data.oneOf.0.attributes.oneOf.0.startDate.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes.oneOf.0.startDate","typeLabel":"string | null"}},"description":"An ad is the binding that connects a creative with an ad set","uniqueKey":"data.oneOf.0.attributes.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"adClickTracking":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"clickZone":{"oneOf":[{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"string","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."},{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"null","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."}]},"disableForCoupons":{"oneOf":[{"type":"boolean","description":"Whether this rule is skipped for clicks on coupons."},{"type":"null","description":"Whether this rule is skipped for clicks on coupons."}]},"disableLandingUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."},{"type":"null","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."}]},"disableMacroUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether url macros are left unencoded when they are substituted into the tracking url."},{"type":"null","description":"Whether url macros are left unencoded when they are substituted into the tracking url."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."}]},"urlPrefix":{"oneOf":[{"type":"string","description":"The url prepended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url prepended to the landing url of the clicks this rule covers."}]},"urlSuffix":{"oneOf":[{"type":"string","description":"The url appended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url appended to the landing url of the clicks this rule covers."}]}},"description":"An ad-level click tracking rule. A rule wraps the landing url of the clicks it covers with a prefix and a\r\nsuffix. It applies either to the whole ad (neither clickZone nor a display size set), to one banner zone\r\n(clickZone set), or to one display size (displayWidth and displayHeight both set)."},"description":"Optional ad-level click tracking configuration."},{"type":"null","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"clickZone":{"oneOf":[{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"string","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."},{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"null","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."}]},"disableForCoupons":{"oneOf":[{"type":"boolean","description":"Whether this rule is skipped for clicks on coupons."},{"type":"null","description":"Whether this rule is skipped for clicks on coupons."}]},"disableLandingUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."},{"type":"null","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."}]},"disableMacroUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether url macros are left unencoded when they are substituted into the tracking url."},{"type":"null","description":"Whether url macros are left unencoded when they are substituted into the tracking url."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."}]},"urlPrefix":{"oneOf":[{"type":"string","description":"The url prepended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url prepended to the landing url of the clicks this rule covers."}]},"urlSuffix":{"oneOf":[{"type":"string","description":"The url appended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url appended to the landing url of the clicks this rule covers."}]}},"description":"An ad-level click tracking rule. A rule wraps the landing url of the clicks it covers with a prefix and a\r\nsuffix. It applies either to the whole ad (neither clickZone nor a display size set), to one banner zone\r\n(clickZone set), or to one display size (displayWidth and displayHeight both set)."},"description":"Optional ad-level click tracking configuration."}]},"adDeliveryStatus":{"oneOf":[{"enum":["Live","Paused"],"type":"string","description":"The delivery status of the ad. Possible values are \"Live\" and \"Paused\". This is read-only: use the\r\ndedicated pause and unpause operations to change it."},{"enum":["Live","Paused"],"type":"null","description":"The delivery status of the ad. Possible values are \"Live\" and \"Paused\". This is read-only: use the\r\ndedicated pause and unpause operations to change it."}]},"adImpressionTracking":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."}]},"url":{"oneOf":[{"type":"string","description":"The url called when an impression covered by this rule is served."},{"type":"null","description":"The url called when an impression covered by this rule is served."}]},"vendorId":{"oneOf":[{"type":"string","description":"Unique ID of the third party vendor the tracking url belongs to."},{"type":"null","description":"Unique ID of the third party vendor the tracking url belongs to."}]}},"description":"An ad-level impression tracking rule. The rule calls its url when an impression it covers is served. It\r\napplies either to the whole ad (no display size set) or to one display size (displayWidth and displayHeight\r\nboth set)."},"description":"Optional ad-level impression tracking configuration."},{"type":"null","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."}]},"url":{"oneOf":[{"type":"string","description":"The url called when an impression covered by this rule is served."},{"type":"null","description":"The url called when an impression covered by this rule is served."}]},"vendorId":{"oneOf":[{"type":"string","description":"Unique ID of the third party vendor the tracking url belongs to."},{"type":"null","description":"Unique ID of the third party vendor the tracking url belongs to."}]}},"description":"An ad-level impression tracking rule. The rule calls its url when an impression it covers is served. It\r\napplies either to the whole ad (no display size set) or to one display size (displayWidth and displayHeight\r\nboth set)."},"description":"Optional ad-level impression tracking configuration."}]},"adSetId":{"oneOf":[{"type":"string","description":"The id of the Ad Set binded to this Ad"},{"type":"null","description":"The id of the Ad Set binded to this Ad"}]},"creativeId":{"oneOf":[{"type":"string","description":"The id of the Creative binded to this Ad"},{"type":"null","description":"The id of the Creative binded to this Ad"}]},"description":{"oneOf":[{"type":"string","description":"The description of the ad"},{"type":"null","description":"The description of the ad"}]},"endDate":{"oneOf":[{"type":"string","description":"The date when we will stop showing this ad. If the end date is not specified (i.e. null) then\r\nthe ad will go on forever.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\"."},{"type":"null","description":"The date when we will stop showing this ad. If the end date is not specified (i.e. null) then\r\nthe ad will go on forever.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\"."}]},"id":{"oneOf":[{"type":"string"},{"type":"null"}]},"inventoryType":{"oneOf":[{"enum":["Native","Display","Video","Meta"],"type":"string","description":"The inventory the Ad belongs to. Possible values are \"Display\", \"Native\", \"Video\" and \"Meta\". This is\r\noptional since it doesn't make sense for every creative type: it is inferred from the creative for a\r\nvideo creative, and an error is returned if it is not set for a dynamic creative."},{"enum":["Native","Display","Video","Meta"],"type":"null","description":"The inventory the Ad belongs to. Possible values are \"Display\", \"Native\", \"Video\" and \"Meta\". This is\r\noptional since it doesn't make sense for every creative type: it is inferred from the creative for a\r\nvideo creative, and an error is returned if it is not set for a dynamic creative."}]},"name":{"oneOf":[{"type":"string","description":"The name of the ad"},{"type":"null","description":"The name of the ad"}]},"startDate":{"oneOf":[{"type":"string","description":"The date when the ad will be launched.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\"."},{"type":"null","description":"The date when the ad will be launched.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\"."}]}},"description":"An ad is the binding that connects a creative with an ad set","uniqueKey":"data.oneOf.0.attributes.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.attributes","typeLabel":"object | null"},"id":{"oneOf":[{"type":"string","description":"Unique identifier of this resource.","uniqueKey":"data.oneOf.0.id.oneOf.0","typeLabel":"string"},{"type":"null","description":"Unique identifier of this resource.","uniqueKey":"data.oneOf.0.id.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.id","typeLabel":"string | null"},"type":{"oneOf":[{"type":"string","uniqueKey":"data.oneOf.0.type.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.oneOf.0.type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.type","typeLabel":"string | null"}},"description":"A class that represents a domain entity exposed by an API.","uniqueKey":"data.oneOf.0","typeLabel":"object"},{"type":"null","properties":{"attributes":{"oneOf":[{"type":"object","properties":{"adClickTracking":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"clickZone":{"oneOf":[{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"string","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."},{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"null","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."}]},"disableForCoupons":{"oneOf":[{"type":"boolean","description":"Whether this rule is skipped for clicks on coupons."},{"type":"null","description":"Whether this rule is skipped for clicks on coupons."}]},"disableLandingUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."},{"type":"null","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."}]},"disableMacroUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether url macros are left unencoded when they are substituted into the tracking url."},{"type":"null","description":"Whether url macros are left unencoded when they are substituted into the tracking url."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."}]},"urlPrefix":{"oneOf":[{"type":"string","description":"The url prepended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url prepended to the landing url of the clicks this rule covers."}]},"urlSuffix":{"oneOf":[{"type":"string","description":"The url appended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url appended to the landing url of the clicks this rule covers."}]}},"description":"An ad-level click tracking rule. A rule wraps the landing url of the clicks it covers with a prefix and a\r\nsuffix. It applies either to the whole ad (neither clickZone nor a display size set), to one banner zone\r\n(clickZone set), or to one display size (displayWidth and displayHeight both set)."},"description":"Optional ad-level click tracking configuration."},{"type":"null","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"clickZone":{"oneOf":[{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"string","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."},{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"null","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."}]},"disableForCoupons":{"oneOf":[{"type":"boolean","description":"Whether this rule is skipped for clicks on coupons."},{"type":"null","description":"Whether this rule is skipped for clicks on coupons."}]},"disableLandingUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."},{"type":"null","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."}]},"disableMacroUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether url macros are left unencoded when they are substituted into the tracking url."},{"type":"null","description":"Whether url macros are left unencoded when they are substituted into the tracking url."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."}]},"urlPrefix":{"oneOf":[{"type":"string","description":"The url prepended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url prepended to the landing url of the clicks this rule covers."}]},"urlSuffix":{"oneOf":[{"type":"string","description":"The url appended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url appended to the landing url of the clicks this rule covers."}]}},"description":"An ad-level click tracking rule. A rule wraps the landing url of the clicks it covers with a prefix and a\r\nsuffix. It applies either to the whole ad (neither clickZone nor a display size set), to one banner zone\r\n(clickZone set), or to one display size (displayWidth and displayHeight both set)."},"description":"Optional ad-level click tracking configuration."}]},"adDeliveryStatus":{"oneOf":[{"enum":["Live","Paused"],"type":"string","description":"The delivery status of the ad. Possible values are \"Live\" and \"Paused\". This is read-only: use the\r\ndedicated pause and unpause operations to change it."},{"enum":["Live","Paused"],"type":"null","description":"The delivery status of the ad. Possible values are \"Live\" and \"Paused\". This is read-only: use the\r\ndedicated pause and unpause operations to change it."}]},"adImpressionTracking":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."}]},"url":{"oneOf":[{"type":"string","description":"The url called when an impression covered by this rule is served."},{"type":"null","description":"The url called when an impression covered by this rule is served."}]},"vendorId":{"oneOf":[{"type":"string","description":"Unique ID of the third party vendor the tracking url belongs to."},{"type":"null","description":"Unique ID of the third party vendor the tracking url belongs to."}]}},"description":"An ad-level impression tracking rule. The rule calls its url when an impression it covers is served. It\r\napplies either to the whole ad (no display size set) or to one display size (displayWidth and displayHeight\r\nboth set)."},"description":"Optional ad-level impression tracking configuration."},{"type":"null","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."}]},"url":{"oneOf":[{"type":"string","description":"The url called when an impression covered by this rule is served."},{"type":"null","description":"The url called when an impression covered by this rule is served."}]},"vendorId":{"oneOf":[{"type":"string","description":"Unique ID of the third party vendor the tracking url belongs to."},{"type":"null","description":"Unique ID of the third party vendor the tracking url belongs to."}]}},"description":"An ad-level impression tracking rule. The rule calls its url when an impression it covers is served. It\r\napplies either to the whole ad (no display size set) or to one display size (displayWidth and displayHeight\r\nboth set)."},"description":"Optional ad-level impression tracking configuration."}]},"adSetId":{"oneOf":[{"type":"string","description":"The id of the Ad Set binded to this Ad"},{"type":"null","description":"The id of the Ad Set binded to this Ad"}]},"creativeId":{"oneOf":[{"type":"string","description":"The id of the Creative binded to this Ad"},{"type":"null","description":"The id of the Creative binded to this Ad"}]},"description":{"oneOf":[{"type":"string","description":"The description of the ad"},{"type":"null","description":"The description of the ad"}]},"endDate":{"oneOf":[{"type":"string","description":"The date when we will stop showing this ad. If the end date is not specified (i.e. null) then\r\nthe ad will go on forever.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\"."},{"type":"null","description":"The date when we will stop showing this ad. If the end date is not specified (i.e. null) then\r\nthe ad will go on forever.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\"."}]},"id":{"oneOf":[{"type":"string"},{"type":"null"}]},"inventoryType":{"oneOf":[{"enum":["Native","Display","Video","Meta"],"type":"string","description":"The inventory the Ad belongs to. Possible values are \"Display\", \"Native\", \"Video\" and \"Meta\". This is\r\noptional since it doesn't make sense for every creative type: it is inferred from the creative for a\r\nvideo creative, and an error is returned if it is not set for a dynamic creative."},{"enum":["Native","Display","Video","Meta"],"type":"null","description":"The inventory the Ad belongs to. Possible values are \"Display\", \"Native\", \"Video\" and \"Meta\". This is\r\noptional since it doesn't make sense for every creative type: it is inferred from the creative for a\r\nvideo creative, and an error is returned if it is not set for a dynamic creative."}]},"name":{"oneOf":[{"type":"string","description":"The name of the ad"},{"type":"null","description":"The name of the ad"}]},"startDate":{"oneOf":[{"type":"string","description":"The date when the ad will be launched.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\"."},{"type":"null","description":"The date when the ad will be launched.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\"."}]}},"description":"An ad is the binding that connects a creative with an ad set"},{"type":"null","properties":{"adClickTracking":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"clickZone":{"oneOf":[{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"string","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."},{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"null","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."}]},"disableForCoupons":{"oneOf":[{"type":"boolean","description":"Whether this rule is skipped for clicks on coupons."},{"type":"null","description":"Whether this rule is skipped for clicks on coupons."}]},"disableLandingUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."},{"type":"null","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."}]},"disableMacroUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether url macros are left unencoded when they are substituted into the tracking url."},{"type":"null","description":"Whether url macros are left unencoded when they are substituted into the tracking url."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."}]},"urlPrefix":{"oneOf":[{"type":"string","description":"The url prepended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url prepended to the landing url of the clicks this rule covers."}]},"urlSuffix":{"oneOf":[{"type":"string","description":"The url appended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url appended to the landing url of the clicks this rule covers."}]}},"description":"An ad-level click tracking rule. A rule wraps the landing url of the clicks it covers with a prefix and a\r\nsuffix. It applies either to the whole ad (neither clickZone nor a display size set), to one banner zone\r\n(clickZone set), or to one display size (displayWidth and displayHeight both set)."},"description":"Optional ad-level click tracking configuration."},{"type":"null","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"clickZone":{"oneOf":[{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"string","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."},{"enum":["Unknown","AppInstall","Coupon","Logo","Main","Product","Store","Video","BrandingImage"],"type":"null","description":"The banner zone this rule applies to. Leave it out for a rule that is not specific to a zone.\r\nPossible values are \"AppInstall\", \"Coupon\", \"Logo\", \"Main\", \"Product\", \"Store\", \"Video\" and\r\n\"BrandingImage\"."}]},"disableForCoupons":{"oneOf":[{"type":"boolean","description":"Whether this rule is skipped for clicks on coupons."},{"type":"null","description":"Whether this rule is skipped for clicks on coupons."}]},"disableLandingUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."},{"type":"null","description":"Whether the landing url is left unencoded when it is substituted into the tracking url."}]},"disableMacroUrlEncode":{"oneOf":[{"type":"boolean","description":"Whether url macros are left unencoded when they are substituted into the tracking url."},{"type":"null","description":"Whether url macros are left unencoded when they are substituted into the tracking url."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the click tracking rule. Leave it out to create a rule; send back the ID of an existing\r\nrule to update it. Rules of the ad that are absent from a write request are deleted."}]},"urlPrefix":{"oneOf":[{"type":"string","description":"The url prepended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url prepended to the landing url of the clicks this rule covers."}]},"urlSuffix":{"oneOf":[{"type":"string","description":"The url appended to the landing url of the clicks this rule covers."},{"type":"null","description":"The url appended to the landing url of the clicks this rule covers."}]}},"description":"An ad-level click tracking rule. A rule wraps the landing url of the clicks it covers with a prefix and a\r\nsuffix. It applies either to the whole ad (neither clickZone nor a display size set), to one banner zone\r\n(clickZone set), or to one display size (displayWidth and displayHeight both set)."},"description":"Optional ad-level click tracking configuration."}]},"adDeliveryStatus":{"oneOf":[{"enum":["Live","Paused"],"type":"string","description":"The delivery status of the ad. Possible values are \"Live\" and \"Paused\". This is read-only: use the\r\ndedicated pause and unpause operations to change it."},{"enum":["Live","Paused"],"type":"null","description":"The delivery status of the ad. Possible values are \"Live\" and \"Paused\". This is read-only: use the\r\ndedicated pause and unpause operations to change it."}]},"adImpressionTracking":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."}]},"url":{"oneOf":[{"type":"string","description":"The url called when an impression covered by this rule is served."},{"type":"null","description":"The url called when an impression covered by this rule is served."}]},"vendorId":{"oneOf":[{"type":"string","description":"Unique ID of the third party vendor the tracking url belongs to."},{"type":"null","description":"Unique ID of the third party vendor the tracking url belongs to."}]}},"description":"An ad-level impression tracking rule. The rule calls its url when an impression it covers is served. It\r\napplies either to the whole ad (no display size set) or to one display size (displayWidth and displayHeight\r\nboth set)."},"description":"Optional ad-level impression tracking configuration."},{"type":"null","items":{"type":"object","properties":{"bindingId":{"oneOf":[{"type":"string","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."},{"type":"null","description":"Unique ID of the ad the rule belongs to. It always names the ad of the request path, so it can be left\r\nout of a write; when it is sent it must match that ad, and a rule naming another one is refused."}]},"displayHeight":{"oneOf":[{"type":"integer","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The height in pixels of the display size this rule applies to. Set it together with displayWidth, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"displayWidth":{"oneOf":[{"type":"integer","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"},{"type":"null","description":"The width in pixels of the display size this rule applies to. Set it together with displayHeight, and\r\nleave both out for a rule that is not specific to a display size.","format":"int32"}]},"id":{"oneOf":[{"type":"string","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."},{"type":"null","description":"Unique ID of the impression tracking rule. Leave it out to create a rule; send back the ID of an\r\nexisting rule to update it. Rules of the ad that are absent from a write request are deleted."}]},"url":{"oneOf":[{"type":"string","description":"The url called when an impression covered by this rule is served."},{"type":"null","description":"The url called when an impression covered by this rule is served."}]},"vendorId":{"oneOf":[{"type":"string","description":"Unique ID of the third party vendor the tracking url belongs to."},{"type":"null","description":"Unique ID of the third party vendor the tracking url belongs to."}]}},"description":"An ad-level impression tracking rule. The rule calls its url when an impression it covers is served. It\r\napplies either to the whole ad (no display size set) or to one display size (displayWidth and displayHeight\r\nboth set)."},"description":"Optional ad-level impression tracking configuration."}]},"adSetId":{"oneOf":[{"type":"string","description":"The id of the Ad Set binded to this Ad"},{"type":"null","description":"The id of the Ad Set binded to this Ad"}]},"creativeId":{"oneOf":[{"type":"string","description":"The id of the Creative binded to this Ad"},{"type":"null","description":"The id of the Creative binded to this Ad"}]},"description":{"oneOf":[{"type":"string","description":"The description of the ad"},{"type":"null","description":"The description of the ad"}]},"endDate":{"oneOf":[{"type":"string","description":"The date when we will stop showing this ad. If the end date is not specified (i.e. null) then\r\nthe ad will go on forever.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\"."},{"type":"null","description":"The date when we will stop showing this ad. If the end date is not specified (i.e. null) then\r\nthe ad will go on forever.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\"."}]},"id":{"oneOf":[{"type":"string"},{"type":"null"}]},"inventoryType":{"oneOf":[{"enum":["Native","Display","Video","Meta"],"type":"string","description":"The inventory the Ad belongs to. Possible values are \"Display\", \"Native\", \"Video\" and \"Meta\". This is\r\noptional since it doesn't make sense for every creative type: it is inferred from the creative for a\r\nvideo creative, and an error is returned if it is not set for a dynamic creative."},{"enum":["Native","Display","Video","Meta"],"type":"null","description":"The inventory the Ad belongs to. Possible values are \"Display\", \"Native\", \"Video\" and \"Meta\". This is\r\noptional since it doesn't make sense for every creative type: it is inferred from the creative for a\r\nvideo creative, and an error is returned if it is not set for a dynamic creative."}]},"name":{"oneOf":[{"type":"string","description":"The name of the ad"},{"type":"null","description":"The name of the ad"}]},"startDate":{"oneOf":[{"type":"string","description":"The date when the ad will be launched.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\"."},{"type":"null","description":"The date when the ad will be launched.\r\nString must be in ISO8601 format, more precisely \"yyyy-MM-ddTHH:mm:ss.fffZ\": a UTC timestamp whose\r\nthree millisecond digits and trailing \"Z\" are always present, for example \"2026-10-01T09:30:00.000Z\"."}]}},"description":"An ad is the binding that connects a creative with an ad set"}]},"id":{"oneOf":[{"type":"string","description":"Unique identifier of this resource."},{"type":"null","description":"Unique identifier of this resource."}]},"type":{"oneOf":[{"type":"string"},{"type":"null"}]}},"description":"A class that represents a domain entity exposed by an API.","uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object | 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":"A top-level object that encapsulates a Criteo API response for a single entity.","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"data":{"attributes":{"adClickTracking":[{"bindingId":"\u003cstring>","clickZone":"Unknown","disableForCoupons":true,"disableLandingUrlEncode":true,"disableMacroUrlEncode":true,"displayHeight":123,"displayWidth":123,"id":"\u003cstring>","urlPrefix":"\u003cstring>","urlSuffix":"\u003cstring>"}],"adDeliveryStatus":"Live","adImpressionTracking":[{"bindingId":"\u003cstring>","displayHeight":123,"displayWidth":123,"id":"\u003cstring>","url":"\u003cstring>","vendorId":"\u003cstring>"}],"adSetId":"\u003cstring>","creativeId":"\u003cstring>","description":"\u003cstring>","endDate":"\u003cstring>","id":"\u003cstring>","inventoryType":"Native","name":"\u003cstring>","startDate":"\u003cstring>"},"id":"\u003cstring>","type":"\u003cstring>"},"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":{"09242c9b-f937-4c79-88fc-23e2e2d235db":{"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"}},"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"}}},"scopes":["MarketingSolutions_Creative_Manage"]}}},"servers":{"392d40f7-9623-4335-8082-910e389aa369":{"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"}},"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"}}},"scopes":["MarketingSolutions_Creative_Manage"]},"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/2025-07/marketingsolutions/open-api-specifications.json"},"subdomain":"criteo-e1682996","siteName":"Criteo Docs","title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads - Criteo Docs","navMaps":{"firstHrefInVersion":{"ms-2026.07":{"href":"/marketing-solutions/v2026.07/reference/advertiser/2026-07advertisersme","matchLevel":3},"ms-2027.01-rc":{"href":"/marketing-solutions/v2027.01-rc/reference/advertiser/2027-01advertisersme","matchLevel":3},"ms-2026.01":{"href":"/marketing-solutions/v2026.01/reference/advertiser/2026-01advertisersme","matchLevel":3},"ms-experimental":{"href":"/marketing-solutions/experimental/reference/creative/experimentalads","matchLevel":2},"ms-2026-preview":{"href":"/marketing-solutions/v2026-preview/reference/creative/previewads","matchLevel":2},"ms-2025.10":{"href":"/marketing-solutions/v2025.10/reference/creative/2025-10marketing-solutionsads","matchLevel":2},"ms-2025.07":{"href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1","matchLevel":0},"ms-2025.04":{"href":"/marketing-solutions/v2025.04/reference/creative/2025-04marketing-solutionsads","matchLevel":2},"ms-2025.01":{"href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsads","matchLevel":2},"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-09-30T14:18:31.918Z","originalFileLocation":"marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1.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=\"Creates an ad by binding an existing creative to an existing ad set of the advertiser, delivering from the start date given. The creative and the ad set must both belong to that advertiser. Returns the new ad and its id.\">\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=\"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads - Criteo Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Creates an ad by binding an existing creative to an existing ad set of the advertiser, delivering from the start date given. The creative and the ad set must both belong to that advertiser. Returns the new ad and its id.\">\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/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1\">\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=Creative\u0026amp;title=%2F2025-07%2Fmarketing-solutions%2Fadvertisers%2F%7Badvertiser-id%7D%2Fads\u0026amp;description=Creates+an+ad+by+binding+an+existing+creative+to+an+existing+ad+set+of+the+advertiser%2C+delivering%0D%0Afrom+the+start+date+given.+The+creative+and+the+ad+set+must+b\u0026amp;theme=41f5d581d5525872491a60f5\u0026amp;signature=1eaf2df6ea09331736b3e144d771e84e44a5a01229711d451d56be964cbb5096\">\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=\"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads - Criteo Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Creates an ad by binding an existing creative to an existing ad set of the advertiser, delivering from the start date given. The creative and the ad set must both belong to that advertiser. Returns the new ad and its id.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://criteo-e1682996.mintlify.app/_mintlify/api/og/v2?division=Creative\u0026amp;title=%2F2025-07%2Fmarketing-solutions%2Fadvertisers%2F%7Badvertiser-id%7D%2Fads\u0026amp;description=Creates+an+ad+by+binding+an+existing+creative+to+an+existing+ad+set+of+the+advertiser%2C+delivering%0D%0Afrom+the+start+date+given.+The+creative+and+the+ad+set+must+b\u0026amp;theme=41f5d581d5525872491a60f5\u0026amp;signature=1eaf2df6ea09331736b3e144d771e84e44a5a01229711d451d56be964cbb5096\">\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/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1.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/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1#webpage\",\"url\":\"https://developers.criteo.com/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1\",\"name\":\"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads\",\"description\":\"Creates an ad by binding an existing creative to an existing ad set of the advertiser, delivering from the start date given. The creative and the ad set must both belong to that advertiser. Returns the new ad and its id.\",\"dateModified\":\"2026-09-30T14:18:31.918Z\",\"isPartOf\":{\"@id\":\"https://developers.criteo.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.criteo.com/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.criteo.com/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Creative\",\"item\":\"https://developers.criteo.com/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsads\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads\",\"item\":\"https://developers.criteo.com/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.criteo.com/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1#apireference\",\"headline\":\"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads\",\"name\":\"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads\",\"description\":\"Creates an ad by binding an existing creative to an existing ad set of the advertiser, delivering from the start date given. The creative and the ad set must both belong to that advertiser. Returns the new ad and its id.\",\"url\":\"https://developers.criteo.com/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1\",\"mainEntityOfPage\":{\"@id\":\"https://developers.criteo.com/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1#webpage\"},\"dateModified\":\"2026-09-30T14:18:31.918Z\",\"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","pages":[{"title":"ms-2026.07","href":"/marketing-solutions/docs/welcome-to-criteo"}]},{"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","groups":[{"group":"Introduction to the Criteo API","pages":[{"title":"Welcome to Criteo","href":"/marketing-solutions/v2025.07/docs/welcome-to-criteo"}]},{"group":"Marketing Solutions Endpoints","pages":[{"title":"Authentication","href":"/marketing-solutions/v2025.07/docs/authentication"},{"group":"Advertisers","root":{"title":"Advertisers","href":"/marketing-solutions/v2025.07/docs/advertisers"},"pages":[{"title":"Get Advertiser Portfolio","href":"/marketing-solutions/v2025.07/docs/get-advertiser-portfolio"}]},{"group":"Analytics","root":{"title":"Analytics","href":"/marketing-solutions/v2025.07/docs/analytics"},"pages":[{"title":"Campaign Statistics","href":"/marketing-solutions/v2025.07/docs/campaign-statistics"},{"title":"Transaction IDs","href":"/marketing-solutions/v2025.07/docs/transaction-ids"},{"title":"Log-Level","href":"/marketing-solutions/v2025.07/docs/log-level"},{"title":"Placement","href":"/marketing-solutions/v2025.07/docs/placement"},{"title":"Placement Category","href":"/marketing-solutions/v2025.07/docs/placement-category"}]},{"group":"Audiences","root":{"title":"Audiences","href":"/marketing-solutions/v2025.07/docs/audiences"},"pages":[{"title":"Audience","href":"/marketing-solutions/v2025.07/docs/audience"},{"title":"Audience Segments","href":"/marketing-solutions/v2025.07/docs/audience-segments"},{"title":"Algebra Nodes","href":"/marketing-solutions/v2025.07/docs/algebra-nodes"}]},{"group":"Campaigns","root":{"title":"Campaigns","href":"/marketing-solutions/v2025.07/docs/campaigns"},"pages":[{"title":"Campaign","href":"/marketing-solutions/v2025.07/docs/campaign"},{"title":"Ad Set","href":"/marketing-solutions/v2025.07/docs/ad-set"},{"title":"Display Multipliers","href":"/marketing-solutions/v2025.07/docs/display-multipliers"},{"title":"Category Bids","href":"/marketing-solutions/v2025.07/docs/category-bids"}]},{"group":"Creatives","root":{"title":"Creatives","href":"/marketing-solutions/v2025.07/docs/creatives"},"pages":[{"title":"Creative","href":"/marketing-solutions/v2025.07/docs/creative"},{"title":"Ads","href":"/marketing-solutions/v2025.07/docs/ads"},{"title":"Coupon","href":"/marketing-solutions/v2025.07/docs/coupon"}]},{"group":"Marketplace Performance Outcomes","root":{"title":"Marketplace Performance Outcomes","href":"/marketing-solutions/v2025.07/docs/marketplace-performance-outcomes"},"pages":[{"title":"Managing Sellers","href":"/marketing-solutions/v2025.07/docs/managing-sellers"},{"title":"Managing Campaigns","href":"/marketing-solutions/v2025.07/docs/managing-campaigns"},{"title":"Managing Budgets","href":"/marketing-solutions/v2025.07/docs/managing-budgets"},{"title":"Getting statistics","href":"/marketing-solutions/v2025.07/docs/getting-statistics"},{"title":"Validation Errors","href":"/marketing-solutions/v2025.07/docs/validation-errors"}]}]}]},{"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","pages":[{"title":"ms-2026.07","href":"/marketing-solutions/v2026.07/reference/advertiser/2026-07advertisersme"}]},{"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/creative/experimentalads"}]},{"version":"ms-2026-preview","pages":[{"title":"ms-2026-preview","href":"/marketing-solutions/v2026-preview/reference/creative/previewads"}]},{"version":"ms-2025.10","pages":[{"title":"ms-2025.10","href":"/marketing-solutions/v2025.10/reference/creative/2025-10marketing-solutionsads"}]},{"version":"ms-2025.07","groups":[{"group":"Advertiser","pages":[{"title":"/2025-07/advertisers/me","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/advertisers/me","href":"/marketing-solutions/v2025.07/reference/advertiser/2025-07advertisersme"}]},{"group":"Analytics","pages":[{"title":"/2025-07/log-level/advertisers/{advertiser-id}/report","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/log-level/advertisers/{advertiser-id}/report","href":"/marketing-solutions/v2025.07/reference/analytics/2025-07log-leveladvertisers-report"},{"title":"/2025-07/placements/report","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/placements/report","href":"/marketing-solutions/v2025.07/reference/analytics/2025-07placementsreport"},{"title":"/2025-07/statistics/report","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/statistics/report","href":"/marketing-solutions/v2025.07/reference/analytics/2025-07statisticsreport"},{"title":"/2025-07/transactions/report","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/transactions/report","href":"/marketing-solutions/v2025.07/reference/analytics/2025-07transactionsreport"}]},{"group":"Campaign","pages":[{"title":"/2025-07/marketing-solutions/ad-sets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/ad-sets","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsad-sets"},{"title":"/2025-07/marketing-solutions/ad-sets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json patch /2025-07/marketing-solutions/ad-sets","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsad-sets-1"},{"title":"/2025-07/marketing-solutions/ad-sets/{ad-set-id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/ad-sets/{ad-set-id}","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsad-sets-2"},{"title":"/2025-07/marketing-solutions/ad-sets/{ad-set-id}/audience","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json put /2025-07/marketing-solutions/ad-sets/{ad-set-id}/audience","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsad-sets-audience"},{"title":"/2025-07/marketing-solutions/ad-sets/{ad-set-id}/category-bids","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/ad-sets/{ad-set-id}/category-bids","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsad-sets-category-bids"},{"title":"/2025-07/marketing-solutions/ad-sets/{ad-set-id}/category-bids","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json patch /2025-07/marketing-solutions/ad-sets/{ad-set-id}/category-bids","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsad-sets-category-bids-1"},{"title":"/2025-07/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsad-sets-display-multipliers"},{"title":"/2025-07/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json patch /2025-07/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsad-sets-display-multipliers-1"},{"title":"/2025-07/marketing-solutions/ad-sets/search","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/ad-sets/search","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsad-setssearch"},{"title":"/2025-07/marketing-solutions/ad-sets/start","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/ad-sets/start","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsad-setsstart"},{"title":"/2025-07/marketing-solutions/ad-sets/stop","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/ad-sets/stop","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsad-setsstop"},{"title":"/2025-07/marketing-solutions/campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/campaigns","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionscampaigns"},{"title":"/2025-07/marketing-solutions/campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json patch /2025-07/marketing-solutions/campaigns","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionscampaigns-1"},{"title":"/2025-07/marketing-solutions/campaigns/{campaign-id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/campaigns/{campaign-id}","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionscampaigns-2"},{"title":"/2025-07/marketing-solutions/campaigns/search","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/campaigns/search","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionscampaignssearch"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesadvertisers"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesadvertisers-1"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/ad-preview","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/ad-preview","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesadvertisers-ad-preview"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/adsets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/adsets","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesadvertisers-adsets"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/budgets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/budgets","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesadvertisers-budgets"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/campaigns","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesadvertisers-campaigns"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/seller-campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/seller-campaigns","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesadvertisers-seller-campaigns"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/sellers","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/{advertiserId}/sellers","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesadvertisers-sellers"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/preview-limit","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/advertisers/preview-limit","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesadvertiserspreview-limit"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/budgets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/budgets","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesbudgets"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/budgets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/marketplace-performance-outcomes/budgets","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesbudgets-1"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/budgets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json patch /2025-07/marketing-solutions/marketplace-performance-outcomes/budgets","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesbudgets-2"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesbudgets-3"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json patch /2025-07/marketing-solutions/marketplace-performance-outcomes/budgets/{budgetId}","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesbudgets-4"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesseller-campaigns"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json patch /2025-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesseller-campaigns-1"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesseller-campaigns-2"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json patch /2025-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesseller-campaigns-3"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}/budgets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/seller-campaigns/{sellerCampaignId}/budgets","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesseller-campaigns-budgets"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/sellers","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/sellers","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomessellers"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomessellers-1"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/budgets","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/budgets","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomessellers-budgets"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/seller-campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/seller-campaigns","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomessellers-seller-campaigns"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/seller-campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/marketplace-performance-outcomes/sellers/{sellerId}/seller-campaigns","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomessellers-seller-campaigns-1"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/stats/campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/stats/campaigns","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesstatscampaigns"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/stats/seller-campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/stats/seller-campaigns","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesstatsseller-campaigns"},{"title":"/2025-07/marketing-solutions/marketplace-performance-outcomes/stats/sellers","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/marketplace-performance-outcomes/stats/sellers","href":"/marketing-solutions/v2025.07/reference/campaign/2025-07marketing-solutionsmarketplace-performance-outcomesstatssellers"}]},{"group":"Creative","pages":[{"title":"/2025-07/marketing-solutions/ads/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/ads/{id}","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsads"},{"title":"/2025-07/marketing-solutions/ads/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json delete /2025-07/marketing-solutions/ads/{id}","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsads-1"},{"title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads","description":"Lists the ads of one advertiser, each one binding a creative to an ad set. Use it to find an ad id\r\nbefore reading, pausing, unpausing or deleting a single ad. Page through the ads with limit and\r\noffset.","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/advertisers/{advertiser-id}/ads","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads"},{"title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/advertisers/{advertiser-id}/ads","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-ads-1"},{"title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons","description":"Lists the coupons of one advertiser. Use it to find a coupon id before reading, editing, previewing\r\nor deleting a single coupon. Page through the coupons with limit and offset.","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-coupons"},{"title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-coupons-1"},{"title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons-supported-sizes","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons-supported-sizes","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-coupons-supported-sizes"},{"title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-coupons-2"},{"title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json put /2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-coupons-3"},{"title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json delete /2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-coupons-4"},{"title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}/preview","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}/preview","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-coupons-preview"},{"title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/creatives","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/advertisers/{advertiser-id}/creatives","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-creatives"},{"title":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/creatives","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/advertisers/{advertiser-id}/creatives","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionsadvertisers-creatives-1"},{"title":"/2025-07/marketing-solutions/creatives/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/creatives/{id}","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionscreatives"},{"title":"/2025-07/marketing-solutions/creatives/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json put /2025-07/marketing-solutions/creatives/{id}","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionscreatives-1"},{"title":"/2025-07/marketing-solutions/creatives/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json delete /2025-07/marketing-solutions/creatives/{id}","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionscreatives-2"},{"title":"/2025-07/marketing-solutions/creatives/{id}/preview","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/creatives/{id}/preview","href":"/marketing-solutions/v2025.07/reference/creative/2025-07marketing-solutionscreatives-preview"}]},{"group":"Audience","pages":[{"title":"/2025-07/marketing-solutions/audience-segments","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json patch /2025-07/marketing-solutions/audience-segments","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudience-segments"},{"title":"/2025-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json delete /2025-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudience-segments-contact-list"},{"title":"/2025-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json patch /2025-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudience-segments-contact-list-1"},{"title":"/2025-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list/statistics","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/audience-segments/{audience-segment-id}/contact-list/statistics","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudience-segments-contact-liststatistics"},{"title":"/2025-07/marketing-solutions/audience-segments/compute-sizes","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/audience-segments/compute-sizes","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudience-segmentscompute-sizes"},{"title":"/2025-07/marketing-solutions/audience-segments/create","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/audience-segments/create","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudience-segmentscreate"},{"title":"/2025-07/marketing-solutions/audience-segments/delete","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/audience-segments/delete","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudience-segmentsdelete"},{"title":"/2025-07/marketing-solutions/audience-segments/estimate-size","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/audience-segments/estimate-size","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudience-segmentsestimate-size"},{"title":"/2025-07/marketing-solutions/audience-segments/in-market-brands","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/audience-segments/in-market-brands","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudience-segmentsin-market-brands"},{"title":"/2025-07/marketing-solutions/audience-segments/in-market-interests","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/audience-segments/in-market-interests","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudience-segmentsin-market-interests"},{"title":"/2025-07/marketing-solutions/audience-segments/search","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/audience-segments/search","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudience-segmentssearch"},{"title":"/2025-07/marketing-solutions/audiences","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json patch /2025-07/marketing-solutions/audiences","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudiences"},{"title":"/2025-07/marketing-solutions/audiences/compute-sizes","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/audiences/compute-sizes","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudiencescompute-sizes"},{"title":"/2025-07/marketing-solutions/audiences/create","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/audiences/create","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudiencescreate"},{"title":"/2025-07/marketing-solutions/audiences/delete","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/audiences/delete","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudiencesdelete"},{"title":"/2025-07/marketing-solutions/audiences/estimate-size","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/audiences/estimate-size","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudiencesestimate-size"},{"title":"/2025-07/marketing-solutions/audiences/search","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json post /2025-07/marketing-solutions/audiences/search","href":"/marketing-solutions/v2025.07/reference/audience/2025-07marketing-solutionsaudiencessearch"}]},{"group":"Gateway","pages":[{"title":"/2025-07/marketing-solutions/me","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-07/marketingsolutions/open-api-specifications.json get /2025-07/marketing-solutions/me","href":"/marketing-solutions/v2025.07/reference/gateway/2025-07marketing-solutionsme"}]}]},{"version":"ms-2025.04","pages":[{"title":"ms-2025.04","href":"/marketing-solutions/v2025.04/reference/creative/2025-04marketing-solutionsads"}]},{"version":"ms-2025.01","pages":[{"title":"ms-2025.01","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsads"}]}]},{"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":"/2025-07/marketing-solutions/advertisers/{advertiser-id}/ads - Criteo Docs","buildId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","deploymentId":"dpl_G9nrg4qeJSZtah1Ziwbc2n6WkLch","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-B7XKH4J3.js","utils-lOYzL7z-.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DF6jUUIM.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dpsj5f7C.js","snippetPresets-CYeiDe8v.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-CUFz1YZ_.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D8H_iLS4.js","shallow-DdluZBHX.js","getApiPlaygroundDisplay-B9922vev.js","CodeSnippet-CMoRNGYs.js","CodeSnippets-DwyrPHuw.js","Page-DSVu9Ucl.js","getPastedJson-G-zIvlHh.js","icon-B03fnEy0.js","MethodPill-CW7teklc.js","DuplicateIcon-CtO8eekd.js","createIcon-DZTKdM_A.js","DynamicMarkdown-D5M2At0B.js","SectionHeading-C_2NaA2U.js","axios-vUo_bRtp.js","Markdown-D7QRHV3m.js","clsx-D1Z-ELXV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-lvhuD9Du.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CKfC4ywL.js"]}