Your ads are placed in different domains (publishers) and environments (websites and apps). Thanks to the placements endpoint, you can analyse the performances for each publisher, comparing displays, clicks and sales generated.
This endpoint supports data retrieval for up to three months in the past.
{"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.01/reference/analytics/2025-01placementsreport","slug":"/marketing-solutions/v2025.01/reference/analytics/2025-01placementsreport","pageMetadata":{"title":"/2025-01/placements/report","description":"Your ads are placed in different domains (publishers) and environments (websites and apps). Thanks to the placements endpoint, you can analyse the performances for each publisher, comparing displays, clicks and sales generated.\r\n\u003cbr/>\u003cbr/>\r\nThis endpoint supports data retrieval for up to three months in the past.","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/placements/report","href":"/marketing-solutions/v2025.01/reference/analytics/2025-01placementsreport","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Your ads are placed in different domains (publishers) and environments (websites and apps). Thanks to the placements endpoint, you can analyse the performances for each publisher, comparing displays, clicks and sales generated.\"\n }), \"\\n\", _jsx(\"br\", {}), \"\\n\", _jsx(\"br\", {}), \"\\n\", _jsx(_components.p, {\n children: \"This endpoint supports data retrieval for up to three months in the past.\"\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"/2025-01/placements/report","description":"Your ads are placed in different domains (publishers) and environments (websites and apps). Thanks to the placements endpoint, you can analyse the performances for each publisher, comparing displays, clicks and sales generated.\r\n\u003cbr/>\u003cbr/>\r\nThis endpoint supports data retrieval for up to three months in the past.","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/placements/report","href":"/marketing-solutions/v2025.01/reference/analytics/2025-01placementsreport","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Analytics"],"summary":"/2025-01/placements/report","description":"Your ads are placed in different domains (publishers) and environments (websites and apps). Thanks to the placements endpoint, you can analyse the performances for each publisher, comparing displays, clicks and sales generated.\r\n\u003cbr/>\u003cbr/>\r\nThis endpoint supports data retrieval for up to three months in the past.","operationId":"GetPlacementsReport","requestBody":"955c67d2-1684-45af-9189-d9f9bc3112cc","responses":{"200":"ddfbe8eb-e792-43b1-b160-d6bfb4b92481"},"security":["2274fefa-449d-4cfe-a541-86e1a0883770"],"method":"post","type":"path","servers":["e08559b4-6fb1-4f2c-9a18-264611e4b47a"],"path":"/2025-01/placements/report","baseUrlOptions":["https://api.criteo.com"],"title":"/2025-01/placements/report","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"attributes":{"required":["advertiserIds","currency","dimensions","endDate","metrics","startDate"],"type":"object","properties":{"advertiserIds":{"type":"string","description":"List of advertiser IDs to report on, provided as a single comma-separated string (e.g., \"123,456,789\"). The advertisers must already exist. If empty, all advertisers will be used.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.advertiserIds","typeLabel":"string"},"currency":{"type":"string","description":"The currency used for the report. ISO 4217 code (three-letter capitals).","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.currency","typeLabel":"string"},"dimensions":{"minItems":1,"type":"array","items":{"enum":["AdsetId","AdvertiserId","Placement","Environment","AdsetName","AdvertiserName","CampaignId","CampaignName","AdChannel","SocialPlatform","CategoryId","CategoryName"],"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.dimensions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"List of dimensions for the report. At least one dimension should be provided.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.dimensions","typeLabel":"enum\u003cstring>[]"},"endDate":{"type":"string","description":"End date of the report. Date component of ISO 8601 format, any time or timezone component is ignored.","format":"date-time","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.endDate","typeLabel":"string\u003cdate-time>"},"metrics":{"minItems":1,"type":"array","items":{"enum":["Clicks","Displays","Cost","SalesPc30d","RevenuePc30d","CosPc30d","RoasPc30d","CpoPc30d","CvrPc30d","SalesPv1d","RevenuePv1d","CosPv1d","RoasPv1d","CpoPv1d","CvrPv1d"],"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.metrics.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"List of metrics for the report. At least one dimension should be provided.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.metrics","typeLabel":"enum\u003cstring>[]"},"startDate":{"type":"string","description":"Start date of the report. Date component of ISO 8601 format, any time or timezone component is ignored. Must be ≤ endDate.","format":"date-time","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.startDate","typeLabel":"string\u003cdate-time>"},"adsetIds":{"oneOf":[{"type":"string","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.adsetIds.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.adsetIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.adsetIds","typeLabel":"string | null"},"campaignIds":{"oneOf":[{"type":"string","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.campaignIds.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.campaignIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.campaignIds","typeLabel":"string | null"},"disclosed":{"type":"boolean","description":"Optionally returns disclosed or undisclosed placements.","default":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.disclosed","typeLabel":"boolean"},"environment":{"oneOf":[{"enum":["Web","Android","Ios"],"type":"string","description":"Optional type of environment to filter on. If empty, all environments will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.environment.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["Web","Android","Ios"],"type":"null","description":"Optional type of environment to filter on. If empty, all environments will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.environment.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.environment","typeLabel":"enum\u003cstring> | null"},"format":{"enum":["csv","excel","xml","json"],"type":"string","description":"Optional file format of the generated report.","default":"json","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.format","typeLabel":"enum\u003cstring>"},"placement":{"oneOf":[{"type":"string","description":"Optional filter on a specific placement domain name. If empty, all placements will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.placement.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional filter on a specific placement domain name. If empty, all placements will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.placement.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.placement","typeLabel":"string | null"},"timezone":{"oneOf":[{"type":"string","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.timezone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.timezone.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.timezone","typeLabel":"string | null"}},"additionalProperties":false,"description":"This is the message defining the query for Placements report","uniqueKey":"data.oneOf.0.items.[INDEX].attributes","typeLabel":"object"},"type":{"oneOf":[{"type":"string","description":"Type of the resource.","uniqueKey":"data.oneOf.0.items.[INDEX].type.oneOf.0","typeLabel":"string"},{"type":"null","description":"Type of the resource.","uniqueKey":"data.oneOf.0.items.[INDEX].type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].type","typeLabel":"string | null"}},"additionalProperties":false,"description":"A value resource exposed by the API.","uniqueKey":"data.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"attributes":{"required":["advertiserIds","currency","dimensions","endDate","metrics","startDate"],"type":"object","properties":{"adsetIds":{"oneOf":[{"type":"string","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included."},{"type":"null","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included."}]},"advertiserIds":{"type":"string","description":"List of advertiser IDs to report on, provided as a single comma-separated string (e.g., \"123,456,789\"). The advertisers must already exist. If empty, all advertisers will be used."},"campaignIds":{"oneOf":[{"type":"string","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included."},{"type":"null","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included."}]},"currency":{"type":"string","description":"The currency used for the report. ISO 4217 code (three-letter capitals)."},"dimensions":{"minItems":1,"type":"array","items":{"enum":["AdsetId","AdvertiserId","Placement","Environment","AdsetName","AdvertiserName","CampaignId","CampaignName","AdChannel","SocialPlatform","CategoryId","CategoryName"],"type":"string"},"description":"List of dimensions for the report. At least one dimension should be provided."},"disclosed":{"type":"boolean","description":"Optionally returns disclosed or undisclosed placements.","default":true},"endDate":{"type":"string","description":"End date of the report. Date component of ISO 8601 format, any time or timezone component is ignored.","format":"date-time"},"environment":{"oneOf":[{"enum":["Web","Android","Ios"],"type":"string","description":"Optional type of environment to filter on. If empty, all environments will be included."},{"enum":["Web","Android","Ios"],"type":"null","description":"Optional type of environment to filter on. If empty, all environments will be included."}]},"format":{"enum":["csv","excel","xml","json"],"type":"string","description":"Optional file format of the generated report.","default":"json"},"metrics":{"minItems":1,"type":"array","items":{"enum":["Clicks","Displays","Cost","SalesPc30d","RevenuePc30d","CosPc30d","RoasPc30d","CpoPc30d","CvrPc30d","SalesPv1d","RevenuePv1d","CosPv1d","RoasPv1d","CpoPv1d","CvrPv1d"],"type":"string"},"description":"List of metrics for the report. At least one dimension should be provided."},"placement":{"oneOf":[{"type":"string","description":"Optional filter on a specific placement domain name. If empty, all placements will be included."},{"type":"null","description":"Optional filter on a specific placement domain name. If empty, all placements will be included."}]},"startDate":{"type":"string","description":"Start date of the report. Date component of ISO 8601 format, any time or timezone component is ignored. Must be ≤ endDate.","format":"date-time"},"timezone":{"oneOf":[{"type":"string","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC"},{"type":"null","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC"}]}},"additionalProperties":false,"description":"This is the message defining the query for Placements report"},"type":{"oneOf":[{"type":"string","description":"Type of the resource."},{"type":"null","description":"Type of the resource."}]}},"additionalProperties":false,"description":"A value resource exposed by the API."},"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object[] | null"}},"additionalProperties":false,"description":"A top-level object that encapsulates a Criteo API request for several value objects.","uniqueKey":"","typeLabel":"object"},"example":{"data":[{"type":"report","attributes":{"advertiserIds":"123,456,789","campaignIds":"111,222,333,444","adsetIds":"135,246,357,468","environment":"Web","placement":"MyPlacement","dimensions":["AdsetId","AdvertiserId","Placement"],"metrics":["Clicks","Displays","Cost"],"currency":"EUR","disclosed":false,"format":"csv","timezone":"Europe/Paris","startDate":"2024-01-01T00:00:00.0000000+00:00","endDate":"2024-01-04T00:00:00.0000000+00:00"}}]},"examples":{"Example":{"title":"Example","value":{"data":[{"type":"report","attributes":{"advertiserIds":"123,456,789","campaignIds":"111,222,333,444","adsetIds":"135,246,357,468","environment":"Web","placement":"MyPlacement","dimensions":["AdsetId","AdvertiserId","Placement"],"metrics":["Clicks","Displays","Cost"],"currency":"EUR","disclosed":false,"format":"csv","timezone":"Europe/Paris","startDate":"2024-01-01T00:00:00.0000000+00:00","endDate":"2024-01-04T00:00:00.0000000+00:00"}}]}}},"exampleType":"examples"},"application/xml":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"attributes":{"required":["advertiserIds","currency","dimensions","endDate","metrics","startDate"],"type":"object","properties":{"advertiserIds":{"type":"string","description":"List of advertiser IDs to report on, provided as a single comma-separated string (e.g., \"123,456,789\"). The advertisers must already exist. If empty, all advertisers will be used.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.advertiserIds","typeLabel":"string"},"currency":{"type":"string","description":"The currency used for the report. ISO 4217 code (three-letter capitals).","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.currency","typeLabel":"string"},"dimensions":{"minItems":1,"type":"array","items":{"enum":["AdsetId","AdvertiserId","Placement","Environment","AdsetName","AdvertiserName","CampaignId","CampaignName","AdChannel","SocialPlatform","CategoryId","CategoryName"],"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.dimensions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"List of dimensions for the report. At least one dimension should be provided.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.dimensions","typeLabel":"enum\u003cstring>[]"},"endDate":{"type":"string","description":"End date of the report. Date component of ISO 8601 format, any time or timezone component is ignored.","format":"date-time","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.endDate","typeLabel":"string\u003cdate-time>"},"metrics":{"minItems":1,"type":"array","items":{"enum":["Clicks","Displays","Cost","SalesPc30d","RevenuePc30d","CosPc30d","RoasPc30d","CpoPc30d","CvrPc30d","SalesPv1d","RevenuePv1d","CosPv1d","RoasPv1d","CpoPv1d","CvrPv1d"],"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.metrics.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"List of metrics for the report. At least one dimension should be provided.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.metrics","typeLabel":"enum\u003cstring>[]"},"startDate":{"type":"string","description":"Start date of the report. Date component of ISO 8601 format, any time or timezone component is ignored. Must be ≤ endDate.","format":"date-time","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.startDate","typeLabel":"string\u003cdate-time>"},"adsetIds":{"oneOf":[{"type":"string","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.adsetIds.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.adsetIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.adsetIds","typeLabel":"string | null"},"campaignIds":{"oneOf":[{"type":"string","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.campaignIds.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.campaignIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.campaignIds","typeLabel":"string | null"},"disclosed":{"type":"boolean","description":"Optionally returns disclosed or undisclosed placements.","default":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.disclosed","typeLabel":"boolean"},"environment":{"oneOf":[{"enum":["Web","Android","Ios"],"type":"string","description":"Optional type of environment to filter on. If empty, all environments will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.environment.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["Web","Android","Ios"],"type":"null","description":"Optional type of environment to filter on. If empty, all environments will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.environment.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.environment","typeLabel":"enum\u003cstring> | null"},"format":{"enum":["csv","excel","xml","json"],"type":"string","description":"Optional file format of the generated report.","default":"json","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.format","typeLabel":"enum\u003cstring>"},"placement":{"oneOf":[{"type":"string","description":"Optional filter on a specific placement domain name. If empty, all placements will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.placement.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional filter on a specific placement domain name. If empty, all placements will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.placement.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.placement","typeLabel":"string | null"},"timezone":{"oneOf":[{"type":"string","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.timezone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.timezone.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.timezone","typeLabel":"string | null"}},"additionalProperties":false,"description":"This is the message defining the query for Placements report","uniqueKey":"data.oneOf.0.items.[INDEX].attributes","typeLabel":"object"},"type":{"oneOf":[{"type":"string","description":"Type of the resource.","uniqueKey":"data.oneOf.0.items.[INDEX].type.oneOf.0","typeLabel":"string"},{"type":"null","description":"Type of the resource.","uniqueKey":"data.oneOf.0.items.[INDEX].type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].type","typeLabel":"string | null"}},"additionalProperties":false,"description":"A value resource exposed by the API.","uniqueKey":"data.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"attributes":{"required":["advertiserIds","currency","dimensions","endDate","metrics","startDate"],"type":"object","properties":{"adsetIds":{"oneOf":[{"type":"string","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included."},{"type":"null","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included."}]},"advertiserIds":{"type":"string","description":"List of advertiser IDs to report on, provided as a single comma-separated string (e.g., \"123,456,789\"). The advertisers must already exist. If empty, all advertisers will be used."},"campaignIds":{"oneOf":[{"type":"string","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included."},{"type":"null","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included."}]},"currency":{"type":"string","description":"The currency used for the report. ISO 4217 code (three-letter capitals)."},"dimensions":{"minItems":1,"type":"array","items":{"enum":["AdsetId","AdvertiserId","Placement","Environment","AdsetName","AdvertiserName","CampaignId","CampaignName","AdChannel","SocialPlatform","CategoryId","CategoryName"],"type":"string"},"description":"List of dimensions for the report. At least one dimension should be provided."},"disclosed":{"type":"boolean","description":"Optionally returns disclosed or undisclosed placements.","default":true},"endDate":{"type":"string","description":"End date of the report. Date component of ISO 8601 format, any time or timezone component is ignored.","format":"date-time"},"environment":{"oneOf":[{"enum":["Web","Android","Ios"],"type":"string","description":"Optional type of environment to filter on. If empty, all environments will be included."},{"enum":["Web","Android","Ios"],"type":"null","description":"Optional type of environment to filter on. If empty, all environments will be included."}]},"format":{"enum":["csv","excel","xml","json"],"type":"string","description":"Optional file format of the generated report.","default":"json"},"metrics":{"minItems":1,"type":"array","items":{"enum":["Clicks","Displays","Cost","SalesPc30d","RevenuePc30d","CosPc30d","RoasPc30d","CpoPc30d","CvrPc30d","SalesPv1d","RevenuePv1d","CosPv1d","RoasPv1d","CpoPv1d","CvrPv1d"],"type":"string"},"description":"List of metrics for the report. At least one dimension should be provided."},"placement":{"oneOf":[{"type":"string","description":"Optional filter on a specific placement domain name. If empty, all placements will be included."},{"type":"null","description":"Optional filter on a specific placement domain name. If empty, all placements will be included."}]},"startDate":{"type":"string","description":"Start date of the report. Date component of ISO 8601 format, any time or timezone component is ignored. Must be ≤ endDate.","format":"date-time"},"timezone":{"oneOf":[{"type":"string","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC"},{"type":"null","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC"}]}},"additionalProperties":false,"description":"This is the message defining the query for Placements report"},"type":{"oneOf":[{"type":"string","description":"Type of the resource."},{"type":"null","description":"Type of the resource."}]}},"additionalProperties":false,"description":"A value resource exposed by the API."},"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object[] | null"}},"additionalProperties":false,"description":"A top-level object that encapsulates a Criteo API request for several value objects.","uniqueKey":"","typeLabel":"object"},"example":"\u003cValueResourceCollectionInputOfPlacementsReportQueryMessagetukRIHCU xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Resources\">\r\n \u003cData>\r\n \u003cValueResourceOfPlacementsReportQueryMessagetukRIHCU>\r\n \u003cAttributes xmlns:d4p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Messages\">\r\n \u003cd4p1:EndDate>2024-01-04T00:00:00\u003c/d4p1:EndDate>\r\n \u003cd4p1:StartDate>2024-01-01T00:00:00\u003c/d4p1:StartDate>\r\n \u003cd4p1:Format>csv\u003c/d4p1:Format>\r\n \u003cd4p1:Timezone>Europe/Paris\u003c/d4p1:Timezone>\r\n \u003cd4p1:AdsetIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>135\u003c/d6p1:int>\r\n \u003cd6p1:int>246\u003c/d6p1:int>\r\n \u003cd6p1:int>357\u003c/d6p1:int>\r\n \u003cd6p1:int>468\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:AdsetIds>\r\n \u003cd4p1:AdvertiserIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>123\u003c/d6p1:int>\r\n \u003cd6p1:int>456\u003c/d6p1:int>\r\n \u003cd6p1:int>789\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:AdvertiserIds>\r\n \u003cd4p1:CampaignIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>111\u003c/d6p1:int>\r\n \u003cd6p1:int>222\u003c/d6p1:int>\r\n \u003cd6p1:int>333\u003c/d6p1:int>\r\n \u003cd6p1:int>444\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:CampaignIds>\r\n \u003cd4p1:Currency>EUR\u003c/d4p1:Currency>\r\n \u003cd4p1:Dimensions xmlns:d5p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Models\">\r\n \u003cd5p1:PlacementsReportDimensions>AdsetId\u003c/d5p1:PlacementsReportDimensions>\r\n \u003cd5p1:PlacementsReportDimensions>AdvertiserId\u003c/d5p1:PlacementsReportDimensions>\r\n \u003cd5p1:PlacementsReportDimensions>Placement\u003c/d5p1:PlacementsReportDimensions>\r\n \u003c/d4p1:Dimensions>\r\n \u003cd4p1:Disclosed>false\u003c/d4p1:Disclosed>\r\n \u003cd4p1:Environment>Web\u003c/d4p1:Environment>\r\n \u003cd4p1:IsInternal>false\u003c/d4p1:IsInternal>\r\n \u003cd4p1:Metrics xmlns:d5p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Models\">\r\n \u003cd5p1:PlacementsReportMetrics>Clicks\u003c/d5p1:PlacementsReportMetrics>\r\n \u003cd5p1:PlacementsReportMetrics>Displays\u003c/d5p1:PlacementsReportMetrics>\r\n \u003cd5p1:PlacementsReportMetrics>Cost\u003c/d5p1:PlacementsReportMetrics>\r\n \u003c/d4p1:Metrics>\r\n \u003cd4p1:Placement>MyPlacement\u003c/d4p1:Placement>\r\n \u003c/Attributes>\r\n \u003cType>report\u003c/Type>\r\n \u003c/ValueResourceOfPlacementsReportQueryMessagetukRIHCU>\r\n \u003c/Data>\r\n\u003c/ValueResourceCollectionInputOfPlacementsReportQueryMessagetukRIHCU>","examples":{"Example":{"title":"Example","value":"\u003cValueResourceCollectionInputOfPlacementsReportQueryMessagetukRIHCU xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Resources\">\r\n \u003cData>\r\n \u003cValueResourceOfPlacementsReportQueryMessagetukRIHCU>\r\n \u003cAttributes xmlns:d4p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Messages\">\r\n \u003cd4p1:EndDate>2024-01-04T00:00:00\u003c/d4p1:EndDate>\r\n \u003cd4p1:StartDate>2024-01-01T00:00:00\u003c/d4p1:StartDate>\r\n \u003cd4p1:Format>csv\u003c/d4p1:Format>\r\n \u003cd4p1:Timezone>Europe/Paris\u003c/d4p1:Timezone>\r\n \u003cd4p1:AdsetIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>135\u003c/d6p1:int>\r\n \u003cd6p1:int>246\u003c/d6p1:int>\r\n \u003cd6p1:int>357\u003c/d6p1:int>\r\n \u003cd6p1:int>468\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:AdsetIds>\r\n \u003cd4p1:AdvertiserIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>123\u003c/d6p1:int>\r\n \u003cd6p1:int>456\u003c/d6p1:int>\r\n \u003cd6p1:int>789\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:AdvertiserIds>\r\n \u003cd4p1:CampaignIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>111\u003c/d6p1:int>\r\n \u003cd6p1:int>222\u003c/d6p1:int>\r\n \u003cd6p1:int>333\u003c/d6p1:int>\r\n \u003cd6p1:int>444\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:CampaignIds>\r\n \u003cd4p1:Currency>EUR\u003c/d4p1:Currency>\r\n \u003cd4p1:Dimensions xmlns:d5p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Models\">\r\n \u003cd5p1:PlacementsReportDimensions>AdsetId\u003c/d5p1:PlacementsReportDimensions>\r\n \u003cd5p1:PlacementsReportDimensions>AdvertiserId\u003c/d5p1:PlacementsReportDimensions>\r\n \u003cd5p1:PlacementsReportDimensions>Placement\u003c/d5p1:PlacementsReportDimensions>\r\n \u003c/d4p1:Dimensions>\r\n \u003cd4p1:Disclosed>false\u003c/d4p1:Disclosed>\r\n \u003cd4p1:Environment>Web\u003c/d4p1:Environment>\r\n \u003cd4p1:IsInternal>false\u003c/d4p1:IsInternal>\r\n \u003cd4p1:Metrics xmlns:d5p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Models\">\r\n \u003cd5p1:PlacementsReportMetrics>Clicks\u003c/d5p1:PlacementsReportMetrics>\r\n \u003cd5p1:PlacementsReportMetrics>Displays\u003c/d5p1:PlacementsReportMetrics>\r\n \u003cd5p1:PlacementsReportMetrics>Cost\u003c/d5p1:PlacementsReportMetrics>\r\n \u003c/d4p1:Metrics>\r\n \u003cd4p1:Placement>MyPlacement\u003c/d4p1:Placement>\r\n \u003c/Attributes>\r\n \u003cType>report\u003c/Type>\r\n \u003c/ValueResourceOfPlacementsReportQueryMessagetukRIHCU>\r\n \u003c/Data>\r\n\u003c/ValueResourceCollectionInputOfPlacementsReportQueryMessagetukRIHCU>"}},"exampleType":"examples"},"text/xml":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"attributes":{"required":["advertiserIds","currency","dimensions","endDate","metrics","startDate"],"type":"object","properties":{"advertiserIds":{"type":"string","description":"List of advertiser IDs to report on, provided as a single comma-separated string (e.g., \"123,456,789\"). The advertisers must already exist. If empty, all advertisers will be used.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.advertiserIds","typeLabel":"string"},"currency":{"type":"string","description":"The currency used for the report. ISO 4217 code (three-letter capitals).","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.currency","typeLabel":"string"},"dimensions":{"minItems":1,"type":"array","items":{"enum":["AdsetId","AdvertiserId","Placement","Environment","AdsetName","AdvertiserName","CampaignId","CampaignName","AdChannel","SocialPlatform","CategoryId","CategoryName"],"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.dimensions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"List of dimensions for the report. At least one dimension should be provided.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.dimensions","typeLabel":"enum\u003cstring>[]"},"endDate":{"type":"string","description":"End date of the report. Date component of ISO 8601 format, any time or timezone component is ignored.","format":"date-time","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.endDate","typeLabel":"string\u003cdate-time>"},"metrics":{"minItems":1,"type":"array","items":{"enum":["Clicks","Displays","Cost","SalesPc30d","RevenuePc30d","CosPc30d","RoasPc30d","CpoPc30d","CvrPc30d","SalesPv1d","RevenuePv1d","CosPv1d","RoasPv1d","CpoPv1d","CvrPv1d"],"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.metrics.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"List of metrics for the report. At least one dimension should be provided.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.metrics","typeLabel":"enum\u003cstring>[]"},"startDate":{"type":"string","description":"Start date of the report. Date component of ISO 8601 format, any time or timezone component is ignored. Must be ≤ endDate.","format":"date-time","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.startDate","typeLabel":"string\u003cdate-time>"},"adsetIds":{"oneOf":[{"type":"string","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.adsetIds.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.adsetIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.adsetIds","typeLabel":"string | null"},"campaignIds":{"oneOf":[{"type":"string","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.campaignIds.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.campaignIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.campaignIds","typeLabel":"string | null"},"disclosed":{"type":"boolean","description":"Optionally returns disclosed or undisclosed placements.","default":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.disclosed","typeLabel":"boolean"},"environment":{"oneOf":[{"enum":["Web","Android","Ios"],"type":"string","description":"Optional type of environment to filter on. If empty, all environments will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.environment.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["Web","Android","Ios"],"type":"null","description":"Optional type of environment to filter on. If empty, all environments will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.environment.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.environment","typeLabel":"enum\u003cstring> | null"},"format":{"enum":["csv","excel","xml","json"],"type":"string","description":"Optional file format of the generated report.","default":"json","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.format","typeLabel":"enum\u003cstring>"},"placement":{"oneOf":[{"type":"string","description":"Optional filter on a specific placement domain name. If empty, all placements will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.placement.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional filter on a specific placement domain name. If empty, all placements will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.placement.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.placement","typeLabel":"string | null"},"timezone":{"oneOf":[{"type":"string","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.timezone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.timezone.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.timezone","typeLabel":"string | null"}},"additionalProperties":false,"description":"This is the message defining the query for Placements report","uniqueKey":"data.oneOf.0.items.[INDEX].attributes","typeLabel":"object"},"type":{"oneOf":[{"type":"string","description":"Type of the resource.","uniqueKey":"data.oneOf.0.items.[INDEX].type.oneOf.0","typeLabel":"string"},{"type":"null","description":"Type of the resource.","uniqueKey":"data.oneOf.0.items.[INDEX].type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].type","typeLabel":"string | null"}},"additionalProperties":false,"description":"A value resource exposed by the API.","uniqueKey":"data.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"attributes":{"required":["advertiserIds","currency","dimensions","endDate","metrics","startDate"],"type":"object","properties":{"adsetIds":{"oneOf":[{"type":"string","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included."},{"type":"null","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included."}]},"advertiserIds":{"type":"string","description":"List of advertiser IDs to report on, provided as a single comma-separated string (e.g., \"123,456,789\"). The advertisers must already exist. If empty, all advertisers will be used."},"campaignIds":{"oneOf":[{"type":"string","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included."},{"type":"null","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included."}]},"currency":{"type":"string","description":"The currency used for the report. ISO 4217 code (three-letter capitals)."},"dimensions":{"minItems":1,"type":"array","items":{"enum":["AdsetId","AdvertiserId","Placement","Environment","AdsetName","AdvertiserName","CampaignId","CampaignName","AdChannel","SocialPlatform","CategoryId","CategoryName"],"type":"string"},"description":"List of dimensions for the report. At least one dimension should be provided."},"disclosed":{"type":"boolean","description":"Optionally returns disclosed or undisclosed placements.","default":true},"endDate":{"type":"string","description":"End date of the report. Date component of ISO 8601 format, any time or timezone component is ignored.","format":"date-time"},"environment":{"oneOf":[{"enum":["Web","Android","Ios"],"type":"string","description":"Optional type of environment to filter on. If empty, all environments will be included."},{"enum":["Web","Android","Ios"],"type":"null","description":"Optional type of environment to filter on. If empty, all environments will be included."}]},"format":{"enum":["csv","excel","xml","json"],"type":"string","description":"Optional file format of the generated report.","default":"json"},"metrics":{"minItems":1,"type":"array","items":{"enum":["Clicks","Displays","Cost","SalesPc30d","RevenuePc30d","CosPc30d","RoasPc30d","CpoPc30d","CvrPc30d","SalesPv1d","RevenuePv1d","CosPv1d","RoasPv1d","CpoPv1d","CvrPv1d"],"type":"string"},"description":"List of metrics for the report. At least one dimension should be provided."},"placement":{"oneOf":[{"type":"string","description":"Optional filter on a specific placement domain name. If empty, all placements will be included."},{"type":"null","description":"Optional filter on a specific placement domain name. If empty, all placements will be included."}]},"startDate":{"type":"string","description":"Start date of the report. Date component of ISO 8601 format, any time or timezone component is ignored. Must be ≤ endDate.","format":"date-time"},"timezone":{"oneOf":[{"type":"string","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC"},{"type":"null","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC"}]}},"additionalProperties":false,"description":"This is the message defining the query for Placements report"},"type":{"oneOf":[{"type":"string","description":"Type of the resource."},{"type":"null","description":"Type of the resource."}]}},"additionalProperties":false,"description":"A value resource exposed by the API."},"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object[] | null"}},"additionalProperties":false,"description":"A top-level object that encapsulates a Criteo API request for several value objects.","uniqueKey":"","typeLabel":"object"},"example":"\u003cValueResourceCollectionInputOfPlacementsReportQueryMessagetukRIHCU xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Resources\">\r\n \u003cData>\r\n \u003cValueResourceOfPlacementsReportQueryMessagetukRIHCU>\r\n \u003cAttributes xmlns:d4p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Messages\">\r\n \u003cd4p1:EndDate>2024-01-04T00:00:00\u003c/d4p1:EndDate>\r\n \u003cd4p1:StartDate>2024-01-01T00:00:00\u003c/d4p1:StartDate>\r\n \u003cd4p1:Format>csv\u003c/d4p1:Format>\r\n \u003cd4p1:Timezone>Europe/Paris\u003c/d4p1:Timezone>\r\n \u003cd4p1:AdsetIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>135\u003c/d6p1:int>\r\n \u003cd6p1:int>246\u003c/d6p1:int>\r\n \u003cd6p1:int>357\u003c/d6p1:int>\r\n \u003cd6p1:int>468\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:AdsetIds>\r\n \u003cd4p1:AdvertiserIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>123\u003c/d6p1:int>\r\n \u003cd6p1:int>456\u003c/d6p1:int>\r\n \u003cd6p1:int>789\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:AdvertiserIds>\r\n \u003cd4p1:CampaignIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>111\u003c/d6p1:int>\r\n \u003cd6p1:int>222\u003c/d6p1:int>\r\n \u003cd6p1:int>333\u003c/d6p1:int>\r\n \u003cd6p1:int>444\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:CampaignIds>\r\n \u003cd4p1:Currency>EUR\u003c/d4p1:Currency>\r\n \u003cd4p1:Dimensions xmlns:d5p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Models\">\r\n \u003cd5p1:PlacementsReportDimensions>AdsetId\u003c/d5p1:PlacementsReportDimensions>\r\n \u003cd5p1:PlacementsReportDimensions>AdvertiserId\u003c/d5p1:PlacementsReportDimensions>\r\n \u003cd5p1:PlacementsReportDimensions>Placement\u003c/d5p1:PlacementsReportDimensions>\r\n \u003c/d4p1:Dimensions>\r\n \u003cd4p1:Disclosed>false\u003c/d4p1:Disclosed>\r\n \u003cd4p1:Environment>Web\u003c/d4p1:Environment>\r\n \u003cd4p1:IsInternal>false\u003c/d4p1:IsInternal>\r\n \u003cd4p1:Metrics xmlns:d5p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Models\">\r\n \u003cd5p1:PlacementsReportMetrics>Clicks\u003c/d5p1:PlacementsReportMetrics>\r\n \u003cd5p1:PlacementsReportMetrics>Displays\u003c/d5p1:PlacementsReportMetrics>\r\n \u003cd5p1:PlacementsReportMetrics>Cost\u003c/d5p1:PlacementsReportMetrics>\r\n \u003c/d4p1:Metrics>\r\n \u003cd4p1:Placement>MyPlacement\u003c/d4p1:Placement>\r\n \u003c/Attributes>\r\n \u003cType>report\u003c/Type>\r\n \u003c/ValueResourceOfPlacementsReportQueryMessagetukRIHCU>\r\n \u003c/Data>\r\n\u003c/ValueResourceCollectionInputOfPlacementsReportQueryMessagetukRIHCU>","examples":{"Example":{"title":"Example","value":"\u003cValueResourceCollectionInputOfPlacementsReportQueryMessagetukRIHCU xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Resources\">\r\n \u003cData>\r\n \u003cValueResourceOfPlacementsReportQueryMessagetukRIHCU>\r\n \u003cAttributes xmlns:d4p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Messages\">\r\n \u003cd4p1:EndDate>2024-01-04T00:00:00\u003c/d4p1:EndDate>\r\n \u003cd4p1:StartDate>2024-01-01T00:00:00\u003c/d4p1:StartDate>\r\n \u003cd4p1:Format>csv\u003c/d4p1:Format>\r\n \u003cd4p1:Timezone>Europe/Paris\u003c/d4p1:Timezone>\r\n \u003cd4p1:AdsetIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>135\u003c/d6p1:int>\r\n \u003cd6p1:int>246\u003c/d6p1:int>\r\n \u003cd6p1:int>357\u003c/d6p1:int>\r\n \u003cd6p1:int>468\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:AdsetIds>\r\n \u003cd4p1:AdvertiserIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>123\u003c/d6p1:int>\r\n \u003cd6p1:int>456\u003c/d6p1:int>\r\n \u003cd6p1:int>789\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:AdvertiserIds>\r\n \u003cd4p1:CampaignIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>111\u003c/d6p1:int>\r\n \u003cd6p1:int>222\u003c/d6p1:int>\r\n \u003cd6p1:int>333\u003c/d6p1:int>\r\n \u003cd6p1:int>444\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:CampaignIds>\r\n \u003cd4p1:Currency>EUR\u003c/d4p1:Currency>\r\n \u003cd4p1:Dimensions xmlns:d5p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Models\">\r\n \u003cd5p1:PlacementsReportDimensions>AdsetId\u003c/d5p1:PlacementsReportDimensions>\r\n \u003cd5p1:PlacementsReportDimensions>AdvertiserId\u003c/d5p1:PlacementsReportDimensions>\r\n \u003cd5p1:PlacementsReportDimensions>Placement\u003c/d5p1:PlacementsReportDimensions>\r\n \u003c/d4p1:Dimensions>\r\n \u003cd4p1:Disclosed>false\u003c/d4p1:Disclosed>\r\n \u003cd4p1:Environment>Web\u003c/d4p1:Environment>\r\n \u003cd4p1:IsInternal>false\u003c/d4p1:IsInternal>\r\n \u003cd4p1:Metrics xmlns:d5p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Models\">\r\n \u003cd5p1:PlacementsReportMetrics>Clicks\u003c/d5p1:PlacementsReportMetrics>\r\n \u003cd5p1:PlacementsReportMetrics>Displays\u003c/d5p1:PlacementsReportMetrics>\r\n \u003cd5p1:PlacementsReportMetrics>Cost\u003c/d5p1:PlacementsReportMetrics>\r\n \u003c/d4p1:Metrics>\r\n \u003cd4p1:Placement>MyPlacement\u003c/d4p1:Placement>\r\n \u003c/Attributes>\r\n \u003cType>report\u003c/Type>\r\n \u003c/ValueResourceOfPlacementsReportQueryMessagetukRIHCU>\r\n \u003c/Data>\r\n\u003c/ValueResourceCollectionInputOfPlacementsReportQueryMessagetukRIHCU>"}},"exampleType":"examples"},"application/*+xml":{"schema":{"type":"object","properties":{"data":{"oneOf":[{"type":"array","items":{"type":"object","properties":{"attributes":{"required":["advertiserIds","currency","dimensions","endDate","metrics","startDate"],"type":"object","properties":{"advertiserIds":{"type":"string","description":"List of advertiser IDs to report on, provided as a single comma-separated string (e.g., \"123,456,789\"). The advertisers must already exist. If empty, all advertisers will be used.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.advertiserIds","typeLabel":"string"},"currency":{"type":"string","description":"The currency used for the report. ISO 4217 code (three-letter capitals).","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.currency","typeLabel":"string"},"dimensions":{"minItems":1,"type":"array","items":{"enum":["AdsetId","AdvertiserId","Placement","Environment","AdsetName","AdvertiserName","CampaignId","CampaignName","AdChannel","SocialPlatform","CategoryId","CategoryName"],"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.dimensions.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"List of dimensions for the report. At least one dimension should be provided.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.dimensions","typeLabel":"enum\u003cstring>[]"},"endDate":{"type":"string","description":"End date of the report. Date component of ISO 8601 format, any time or timezone component is ignored.","format":"date-time","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.endDate","typeLabel":"string\u003cdate-time>"},"metrics":{"minItems":1,"type":"array","items":{"enum":["Clicks","Displays","Cost","SalesPc30d","RevenuePc30d","CosPc30d","RoasPc30d","CpoPc30d","CvrPc30d","SalesPv1d","RevenuePv1d","CosPv1d","RoasPv1d","CpoPv1d","CvrPv1d"],"type":"string","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.metrics.items.[INDEX]","typeLabel":"enum\u003cstring>"},"description":"List of metrics for the report. At least one dimension should be provided.","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.metrics","typeLabel":"enum\u003cstring>[]"},"startDate":{"type":"string","description":"Start date of the report. Date component of ISO 8601 format, any time or timezone component is ignored. Must be ≤ endDate.","format":"date-time","isRequired":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.startDate","typeLabel":"string\u003cdate-time>"},"adsetIds":{"oneOf":[{"type":"string","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.adsetIds.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.adsetIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.adsetIds","typeLabel":"string | null"},"campaignIds":{"oneOf":[{"type":"string","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.campaignIds.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.campaignIds.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.campaignIds","typeLabel":"string | null"},"disclosed":{"type":"boolean","description":"Optionally returns disclosed or undisclosed placements.","default":true,"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.disclosed","typeLabel":"boolean"},"environment":{"oneOf":[{"enum":["Web","Android","Ios"],"type":"string","description":"Optional type of environment to filter on. If empty, all environments will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.environment.oneOf.0","typeLabel":"enum\u003cstring>"},{"enum":["Web","Android","Ios"],"type":"null","description":"Optional type of environment to filter on. If empty, all environments will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.environment.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.environment","typeLabel":"enum\u003cstring> | null"},"format":{"enum":["csv","excel","xml","json"],"type":"string","description":"Optional file format of the generated report.","default":"json","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.format","typeLabel":"enum\u003cstring>"},"placement":{"oneOf":[{"type":"string","description":"Optional filter on a specific placement domain name. If empty, all placements will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.placement.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional filter on a specific placement domain name. If empty, all placements will be included.","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.placement.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.placement","typeLabel":"string | null"},"timezone":{"oneOf":[{"type":"string","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.timezone.oneOf.0","typeLabel":"string"},{"type":"null","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC","uniqueKey":"data.oneOf.0.items.[INDEX].attributes.timezone.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].attributes.timezone","typeLabel":"string | null"}},"additionalProperties":false,"description":"This is the message defining the query for Placements report","uniqueKey":"data.oneOf.0.items.[INDEX].attributes","typeLabel":"object"},"type":{"oneOf":[{"type":"string","description":"Type of the resource.","uniqueKey":"data.oneOf.0.items.[INDEX].type.oneOf.0","typeLabel":"string"},{"type":"null","description":"Type of the resource.","uniqueKey":"data.oneOf.0.items.[INDEX].type.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.oneOf.0.items.[INDEX].type","typeLabel":"string | null"}},"additionalProperties":false,"description":"A value resource exposed by the API.","uniqueKey":"data.oneOf.0.items.[INDEX]","typeLabel":"object"},"uniqueKey":"data.oneOf.0","typeLabel":"object[]"},{"type":"null","items":{"type":"object","properties":{"attributes":{"required":["advertiserIds","currency","dimensions","endDate","metrics","startDate"],"type":"object","properties":{"adsetIds":{"oneOf":[{"type":"string","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included."},{"type":"null","description":"Optional list of ad set IDs to filter on. The ad sets must already exist. If empty, all ad sets will be included."}]},"advertiserIds":{"type":"string","description":"List of advertiser IDs to report on, provided as a single comma-separated string (e.g., \"123,456,789\"). The advertisers must already exist. If empty, all advertisers will be used."},"campaignIds":{"oneOf":[{"type":"string","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included."},{"type":"null","description":"Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included."}]},"currency":{"type":"string","description":"The currency used for the report. ISO 4217 code (three-letter capitals)."},"dimensions":{"minItems":1,"type":"array","items":{"enum":["AdsetId","AdvertiserId","Placement","Environment","AdsetName","AdvertiserName","CampaignId","CampaignName","AdChannel","SocialPlatform","CategoryId","CategoryName"],"type":"string"},"description":"List of dimensions for the report. At least one dimension should be provided."},"disclosed":{"type":"boolean","description":"Optionally returns disclosed or undisclosed placements.","default":true},"endDate":{"type":"string","description":"End date of the report. Date component of ISO 8601 format, any time or timezone component is ignored.","format":"date-time"},"environment":{"oneOf":[{"enum":["Web","Android","Ios"],"type":"string","description":"Optional type of environment to filter on. If empty, all environments will be included."},{"enum":["Web","Android","Ios"],"type":"null","description":"Optional type of environment to filter on. If empty, all environments will be included."}]},"format":{"enum":["csv","excel","xml","json"],"type":"string","description":"Optional file format of the generated report.","default":"json"},"metrics":{"minItems":1,"type":"array","items":{"enum":["Clicks","Displays","Cost","SalesPc30d","RevenuePc30d","CosPc30d","RoasPc30d","CpoPc30d","CvrPc30d","SalesPv1d","RevenuePv1d","CosPv1d","RoasPv1d","CpoPv1d","CvrPv1d"],"type":"string"},"description":"List of metrics for the report. At least one dimension should be provided."},"placement":{"oneOf":[{"type":"string","description":"Optional filter on a specific placement domain name. If empty, all placements will be included."},{"type":"null","description":"Optional filter on a specific placement domain name. If empty, all placements will be included."}]},"startDate":{"type":"string","description":"Start date of the report. Date component of ISO 8601 format, any time or timezone component is ignored. Must be ≤ endDate.","format":"date-time"},"timezone":{"oneOf":[{"type":"string","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC"},{"type":"null","description":"Optional timezone used for the report. Timezone Database format (Tz).","default":"UTC"}]}},"additionalProperties":false,"description":"This is the message defining the query for Placements report"},"type":{"oneOf":[{"type":"string","description":"Type of the resource."},{"type":"null","description":"Type of the resource."}]}},"additionalProperties":false,"description":"A value resource exposed by the API."},"uniqueKey":"data.oneOf.1","typeLabel":"null"}],"uniqueKey":"data","typeLabel":"object[] | null"}},"additionalProperties":false,"description":"A top-level object that encapsulates a Criteo API request for several value objects.","uniqueKey":"","typeLabel":"object"},"example":"\u003cValueResourceCollectionInputOfPlacementsReportQueryMessagetukRIHCU xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Resources\">\r\n \u003cData>\r\n \u003cValueResourceOfPlacementsReportQueryMessagetukRIHCU>\r\n \u003cAttributes xmlns:d4p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Messages\">\r\n \u003cd4p1:EndDate>2024-01-04T00:00:00\u003c/d4p1:EndDate>\r\n \u003cd4p1:StartDate>2024-01-01T00:00:00\u003c/d4p1:StartDate>\r\n \u003cd4p1:Format>csv\u003c/d4p1:Format>\r\n \u003cd4p1:Timezone>Europe/Paris\u003c/d4p1:Timezone>\r\n \u003cd4p1:AdsetIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>135\u003c/d6p1:int>\r\n \u003cd6p1:int>246\u003c/d6p1:int>\r\n \u003cd6p1:int>357\u003c/d6p1:int>\r\n \u003cd6p1:int>468\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:AdsetIds>\r\n \u003cd4p1:AdvertiserIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>123\u003c/d6p1:int>\r\n \u003cd6p1:int>456\u003c/d6p1:int>\r\n \u003cd6p1:int>789\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:AdvertiserIds>\r\n \u003cd4p1:CampaignIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>111\u003c/d6p1:int>\r\n \u003cd6p1:int>222\u003c/d6p1:int>\r\n \u003cd6p1:int>333\u003c/d6p1:int>\r\n \u003cd6p1:int>444\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:CampaignIds>\r\n \u003cd4p1:Currency>EUR\u003c/d4p1:Currency>\r\n \u003cd4p1:Dimensions xmlns:d5p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Models\">\r\n \u003cd5p1:PlacementsReportDimensions>AdsetId\u003c/d5p1:PlacementsReportDimensions>\r\n \u003cd5p1:PlacementsReportDimensions>AdvertiserId\u003c/d5p1:PlacementsReportDimensions>\r\n \u003cd5p1:PlacementsReportDimensions>Placement\u003c/d5p1:PlacementsReportDimensions>\r\n \u003c/d4p1:Dimensions>\r\n \u003cd4p1:Disclosed>false\u003c/d4p1:Disclosed>\r\n \u003cd4p1:Environment>Web\u003c/d4p1:Environment>\r\n \u003cd4p1:IsInternal>false\u003c/d4p1:IsInternal>\r\n \u003cd4p1:Metrics xmlns:d5p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Models\">\r\n \u003cd5p1:PlacementsReportMetrics>Clicks\u003c/d5p1:PlacementsReportMetrics>\r\n \u003cd5p1:PlacementsReportMetrics>Displays\u003c/d5p1:PlacementsReportMetrics>\r\n \u003cd5p1:PlacementsReportMetrics>Cost\u003c/d5p1:PlacementsReportMetrics>\r\n \u003c/d4p1:Metrics>\r\n \u003cd4p1:Placement>MyPlacement\u003c/d4p1:Placement>\r\n \u003c/Attributes>\r\n \u003cType>report\u003c/Type>\r\n \u003c/ValueResourceOfPlacementsReportQueryMessagetukRIHCU>\r\n \u003c/Data>\r\n\u003c/ValueResourceCollectionInputOfPlacementsReportQueryMessagetukRIHCU>","examples":{"Example":{"title":"Example","value":"\u003cValueResourceCollectionInputOfPlacementsReportQueryMessagetukRIHCU xmlns:i=\"http://www.w3.org/2001/XMLSchema-instance\" xmlns=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Resources\">\r\n \u003cData>\r\n \u003cValueResourceOfPlacementsReportQueryMessagetukRIHCU>\r\n \u003cAttributes xmlns:d4p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Messages\">\r\n \u003cd4p1:EndDate>2024-01-04T00:00:00\u003c/d4p1:EndDate>\r\n \u003cd4p1:StartDate>2024-01-01T00:00:00\u003c/d4p1:StartDate>\r\n \u003cd4p1:Format>csv\u003c/d4p1:Format>\r\n \u003cd4p1:Timezone>Europe/Paris\u003c/d4p1:Timezone>\r\n \u003cd4p1:AdsetIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>135\u003c/d6p1:int>\r\n \u003cd6p1:int>246\u003c/d6p1:int>\r\n \u003cd6p1:int>357\u003c/d6p1:int>\r\n \u003cd6p1:int>468\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:AdsetIds>\r\n \u003cd4p1:AdvertiserIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>123\u003c/d6p1:int>\r\n \u003cd6p1:int>456\u003c/d6p1:int>\r\n \u003cd6p1:int>789\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:AdvertiserIds>\r\n \u003cd4p1:CampaignIds>\r\n \u003cd4p1:Values xmlns:d6p1=\"http://schemas.microsoft.com/2003/10/Serialization/Arrays\">\r\n \u003cd6p1:int>111\u003c/d6p1:int>\r\n \u003cd6p1:int>222\u003c/d6p1:int>\r\n \u003cd6p1:int>333\u003c/d6p1:int>\r\n \u003cd6p1:int>444\u003c/d6p1:int>\r\n \u003c/d4p1:Values>\r\n \u003c/d4p1:CampaignIds>\r\n \u003cd4p1:Currency>EUR\u003c/d4p1:Currency>\r\n \u003cd4p1:Dimensions xmlns:d5p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Models\">\r\n \u003cd5p1:PlacementsReportDimensions>AdsetId\u003c/d5p1:PlacementsReportDimensions>\r\n \u003cd5p1:PlacementsReportDimensions>AdvertiserId\u003c/d5p1:PlacementsReportDimensions>\r\n \u003cd5p1:PlacementsReportDimensions>Placement\u003c/d5p1:PlacementsReportDimensions>\r\n \u003c/d4p1:Dimensions>\r\n \u003cd4p1:Disclosed>false\u003c/d4p1:Disclosed>\r\n \u003cd4p1:Environment>Web\u003c/d4p1:Environment>\r\n \u003cd4p1:IsInternal>false\u003c/d4p1:IsInternal>\r\n \u003cd4p1:Metrics xmlns:d5p1=\"http://schemas.datacontract.org/2004/07/Criteo.Api.Exam.Statistics.Controllers.V1.Models\">\r\n \u003cd5p1:PlacementsReportMetrics>Clicks\u003c/d5p1:PlacementsReportMetrics>\r\n \u003cd5p1:PlacementsReportMetrics>Displays\u003c/d5p1:PlacementsReportMetrics>\r\n \u003cd5p1:PlacementsReportMetrics>Cost\u003c/d5p1:PlacementsReportMetrics>\r\n \u003c/d4p1:Metrics>\r\n \u003cd4p1:Placement>MyPlacement\u003c/d4p1:Placement>\r\n \u003c/Attributes>\r\n \u003cType>report\u003c/Type>\r\n \u003c/ValueResourceOfPlacementsReportQueryMessagetukRIHCU>\r\n \u003c/Data>\r\n\u003c/ValueResourceCollectionInputOfPlacementsReportQueryMessagetukRIHCU>"}},"exampleType":"examples"}},"exampleType":"examples"},"responses":{"ddfbe8eb-e792-43b1-b160-d6bfb4b92481":{"description":"Success","content":{"application/json":{"schema":{"type":"string","format":"binary","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"},"text/csv":{"schema":{"type":"string","format":"binary","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"},"text/xml":{"schema":{"type":"string","format":"binary","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"},"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet":{"schema":{"type":"string","format":"binary","uniqueKey":"","typeLabel":"file"},"examples":{"Example":{"title":"Example","value":"\u003cstring>"}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"2274fefa-449d-4cfe-a541-86e1a0883770":{"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_Analytics_Read"]}}},"servers":{"e08559b4-6fb1-4f2c-9a18-264611e4b47a":{"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_Analytics_Read"]},"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-01/marketingsolutions/open-api-specifications.json"},"subdomain":"criteo-e1682996","siteName":"Criteo Docs","title":"/2025-01/placements/report - 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/analytics/experimentalcategoriesreport","matchLevel":2},"ms-2026-preview":{"href":"/marketing-solutions/v2026-preview/reference/analytics/previewcategoriesreport","matchLevel":2},"ms-2025.10":{"href":"/marketing-solutions/v2025.10/reference/analytics/2025-10log-leveladvertisers-report","matchLevel":2},"ms-2025.07":{"href":"/marketing-solutions/v2025.07/reference/analytics/2025-07log-leveladvertisers-report","matchLevel":2},"ms-2025.04":{"href":"/marketing-solutions/v2025.04/reference/analytics/2025-04log-leveladvertisers-report","matchLevel":2},"ms-2025.01":{"href":"/marketing-solutions/v2025.01/reference/analytics/2025-01placementsreport","matchLevel":0},"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.103Z","originalFileLocation":"marketing-solutions/v2025.01/reference/analytics/2025-01placementsreport.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=\"Your ads are placed in different domains (publishers) and environments (websites and apps). Thanks to the placements endpoint, you can analyse the performances for each publisher, comparing displays, clicks and sales generated. This endpoint supports data retrieval for up to three months in the past.\">\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-01/placements/report - Criteo Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Your ads are placed in different domains (publishers) and environments (websites and apps). Thanks to the placements endpoint, you can analyse the performances for each publisher, comparing displays, clicks and sales generated. This endpoint supports data retrieval for up to three months in the past.\">\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.01/reference/analytics/2025-01placementsreport\">\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=Analytics\u0026amp;title=%2F2025-01%2Fplacements%2Freport\u0026amp;description=Your+ads+are+placed+in+different+domains+%28publishers%29+and+environments+%28websites+and+apps%29.+Thanks+to+the+placements+endpoint%2C+you+can+analyse+the+performances+\u0026amp;theme=41f5d581d5525872491a60f5\u0026amp;signature=efb1beba56e685c4d6bc6ea89f52e33552200bd0e909d6db43ebcd28e19fedae\">\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-01/placements/report - Criteo Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Your ads are placed in different domains (publishers) and environments (websites and apps). Thanks to the placements endpoint, you can analyse the performances for each publisher, comparing displays, clicks and sales generated. This endpoint supports data retrieval for up to three months in the past.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://criteo-e1682996.mintlify.app/_mintlify/api/og/v2?division=Analytics\u0026amp;title=%2F2025-01%2Fplacements%2Freport\u0026amp;description=Your+ads+are+placed+in+different+domains+%28publishers%29+and+environments+%28websites+and+apps%29.+Thanks+to+the+placements+endpoint%2C+you+can+analyse+the+performances+\u0026amp;theme=41f5d581d5525872491a60f5\u0026amp;signature=efb1beba56e685c4d6bc6ea89f52e33552200bd0e909d6db43ebcd28e19fedae\">\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.01/reference/analytics/2025-01placementsreport\">\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.01/reference/analytics/2025-01placementsreport.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.01/reference/analytics/2025-01placementsreport#webpage\",\"url\":\"https://developers.criteo.com/marketing-solutions/v2025.01/reference/analytics/2025-01placementsreport\",\"name\":\"/2025-01/placements/report\",\"description\":\"Your ads are placed in different domains (publishers) and environments (websites and apps). Thanks to the placements endpoint, you can analyse the performances for each publisher, comparing displays, clicks and sales generated. This endpoint supports data retrieval for up to three months in the past.\",\"dateModified\":\"2026-09-30T14:18:31.103Z\",\"isPartOf\":{\"@id\":\"https://developers.criteo.com#website\"},\"breadcrumb\":{\"@id\":\"https://developers.criteo.com/marketing-solutions/v2025.01/reference/analytics/2025-01placementsreport#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developers.criteo.com/marketing-solutions/v2025.01/reference/analytics/2025-01placementsreport#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Analytics\",\"item\":\"https://developers.criteo.com/marketing-solutions/v2025.01/reference/analytics/2025-01log-leveladvertisers-report\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"/2025-01/placements/report\",\"item\":\"https://developers.criteo.com/marketing-solutions/v2025.01/reference/analytics/2025-01placementsreport\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developers.criteo.com/marketing-solutions/v2025.01/reference/analytics/2025-01placementsreport#apireference\",\"headline\":\"/2025-01/placements/report\",\"name\":\"/2025-01/placements/report\",\"description\":\"Your ads are placed in different domains (publishers) and environments (websites and apps). Thanks to the placements endpoint, you can analyse the performances for each publisher, comparing displays, clicks and sales generated. This endpoint supports data retrieval for up to three months in the past.\",\"url\":\"https://developers.criteo.com/marketing-solutions/v2025.01/reference/analytics/2025-01placementsreport\",\"mainEntityOfPage\":{\"@id\":\"https://developers.criteo.com/marketing-solutions/v2025.01/reference/analytics/2025-01placementsreport#webpage\"},\"dateModified\":\"2026-09-30T14:18:31.103Z\",\"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","pages":[{"title":"ms-2025.07","href":"/marketing-solutions/v2025.07/docs/welcome-to-criteo"}]},{"version":"ms-2025.04","pages":[{"title":"ms-2025.04","href":"/marketing-solutions/v2025.04/docs/welcome-to-criteo"}]},{"version":"ms-2025.01","groups":[{"group":"Introduction to the Criteo API","pages":[{"title":"Welcome to Criteo","href":"/marketing-solutions/v2025.01/docs/welcome-to-criteo"}]},{"group":"Marketing Solutions Endpoints","pages":[{"title":"Authentication","href":"/marketing-solutions/v2025.01/docs/authentication"},{"group":"Advertisers","root":{"title":"Advertisers","href":"/marketing-solutions/v2025.01/docs/advertisers"},"pages":[{"title":"Get Advertiser Portfolio","href":"/marketing-solutions/v2025.01/docs/get-advertiser-portfolio"}]},{"group":"Analytics","root":{"title":"Analytics","href":"/marketing-solutions/v2025.01/docs/analytics"},"pages":[{"title":"Campaign Statistics","href":"/marketing-solutions/v2025.01/docs/campaign-statistics"},{"title":"Transaction IDs","href":"/marketing-solutions/v2025.01/docs/transaction-ids"},{"title":"Log-Level","href":"/marketing-solutions/v2025.01/docs/log-level"},{"title":"Placement","href":"/marketing-solutions/v2025.01/docs/placement"},{"title":"Placement Category","href":"/marketing-solutions/v2025.01/docs/placement-category"}]},{"group":"Audiences","root":{"title":"Audiences","href":"/marketing-solutions/v2025.01/docs/audiences"},"pages":[{"title":"Audience","href":"/marketing-solutions/v2025.01/docs/audience"},{"title":"Audience Segments","href":"/marketing-solutions/v2025.01/docs/audience-segments"},{"title":"Algebra Nodes","href":"/marketing-solutions/v2025.01/docs/algebra-nodes"}]},{"group":"Campaigns","root":{"title":"Campaigns","href":"/marketing-solutions/v2025.01/docs/campaigns"},"pages":[{"title":"Campaign","href":"/marketing-solutions/v2025.01/docs/campaign"},{"title":"Ad Set","href":"/marketing-solutions/v2025.01/docs/ad-set"},{"title":"Display Multipliers","href":"/marketing-solutions/v2025.01/docs/display-multipliers"},{"title":"Category Bids","href":"/marketing-solutions/v2025.01/docs/category-bids"}]},{"group":"Creatives","root":{"title":"Creatives","href":"/marketing-solutions/v2025.01/docs/creatives"},"pages":[{"title":"Creative","href":"/marketing-solutions/v2025.01/docs/creative"},{"title":"Ads","href":"/marketing-solutions/v2025.01/docs/ads"},{"title":"Coupon","href":"/marketing-solutions/v2025.01/docs/coupon"}]}]}]}]},{"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/analytics/experimentalcategoriesreport"}]},{"version":"ms-2026-preview","pages":[{"title":"ms-2026-preview","href":"/marketing-solutions/v2026-preview/reference/analytics/previewcategoriesreport"}]},{"version":"ms-2025.10","pages":[{"title":"ms-2025.10","href":"/marketing-solutions/v2025.10/reference/analytics/2025-10log-leveladvertisers-report"}]},{"version":"ms-2025.07","pages":[{"title":"ms-2025.07","href":"/marketing-solutions/v2025.07/reference/analytics/2025-07log-leveladvertisers-report"}]},{"version":"ms-2025.04","pages":[{"title":"ms-2025.04","href":"/marketing-solutions/v2025.04/reference/analytics/2025-04log-leveladvertisers-report"}]},{"version":"ms-2025.01","groups":[{"group":"Advertiser","pages":[{"title":"/2025-01/advertisers/me","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/advertisers/me","href":"/marketing-solutions/v2025.01/reference/advertiser/2025-01advertisersme"}]},{"group":"Analytics","pages":[{"title":"/2025-01/log-level/advertisers/{advertiser-id}/report","description":"This Statistics endpoint provides publisher data.","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/log-level/advertisers/{advertiser-id}/report","href":"/marketing-solutions/v2025.01/reference/analytics/2025-01log-leveladvertisers-report"},{"title":"/2025-01/placements/report","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/placements/report","href":"/marketing-solutions/v2025.01/reference/analytics/2025-01placementsreport"},{"title":"/2025-01/statistics/report","description":"This Statistics endpoint provides ad set related data. It is an upgrade of our previous Statistics endpoint, and includes new metrics and customization capabilities.\r\n\u003cbr/>\u003cbr/>\r\nThis endpoint supports data retrieval for up to two years in the past.","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/statistics/report","href":"/marketing-solutions/v2025.01/reference/analytics/2025-01statisticsreport"},{"title":"/2025-01/transactions/report","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/transactions/report","href":"/marketing-solutions/v2025.01/reference/analytics/2025-01transactionsreport"}]},{"group":"Campaign","pages":[{"title":"/2025-01/marketing-solutions/ad-sets/{ad-set-id}/audience","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json put /2025-01/marketing-solutions/ad-sets/{ad-set-id}/audience","href":"/marketing-solutions/v2025.01/reference/campaign/2025-01marketing-solutionsad-sets-audience"},{"title":"/2025-01/marketing-solutions/ad-sets/{ad-set-id}/category-bids","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/ad-sets/{ad-set-id}/category-bids","href":"/marketing-solutions/v2025.01/reference/campaign/2025-01marketing-solutionsad-sets-category-bids"},{"title":"/2025-01/marketing-solutions/ad-sets/{ad-set-id}/category-bids","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json patch /2025-01/marketing-solutions/ad-sets/{ad-set-id}/category-bids","href":"/marketing-solutions/v2025.01/reference/campaign/2025-01marketing-solutionsad-sets-category-bids-1"},{"title":"/2025-01/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers","href":"/marketing-solutions/v2025.01/reference/campaign/2025-01marketing-solutionsad-sets-display-multipliers"},{"title":"/2025-01/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json patch /2025-01/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers","href":"/marketing-solutions/v2025.01/reference/campaign/2025-01marketing-solutionsad-sets-display-multipliers-1"},{"title":"/2025-01/marketing-solutions/ad-sets/start","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/ad-sets/start","href":"/marketing-solutions/v2025.01/reference/campaign/2025-01marketing-solutionsad-setsstart"},{"title":"/2025-01/marketing-solutions/ad-sets/stop","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/ad-sets/stop","href":"/marketing-solutions/v2025.01/reference/campaign/2025-01marketing-solutionsad-setsstop"},{"title":"/2025-01/marketing-solutions/campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/campaigns","href":"/marketing-solutions/v2025.01/reference/campaign/2025-01marketing-solutionscampaigns"},{"title":"/2025-01/marketing-solutions/campaigns","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json patch /2025-01/marketing-solutions/campaigns","href":"/marketing-solutions/v2025.01/reference/campaign/2025-01marketing-solutionscampaigns-1"},{"title":"/2025-01/marketing-solutions/campaigns/{campaign-id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/campaigns/{campaign-id}","href":"/marketing-solutions/v2025.01/reference/campaign/2025-01marketing-solutionscampaigns-2"},{"title":"/2025-01/marketing-solutions/campaigns/search","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/campaigns/search","href":"/marketing-solutions/v2025.01/reference/campaign/2025-01marketing-solutionscampaignssearch"}]},{"group":"Creative","pages":[{"title":"/2025-01/marketing-solutions/ads/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/ads/{id}","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsads"},{"title":"/2025-01/marketing-solutions/ads/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json delete /2025-01/marketing-solutions/ads/{id}","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsads-1"},{"title":"/2025-01/marketing-solutions/advertisers/{advertiser-id}/ads","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/advertisers/{advertiser-id}/ads","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsadvertisers-ads"},{"title":"/2025-01/marketing-solutions/advertisers/{advertiser-id}/ads","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/advertisers/{advertiser-id}/ads","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsadvertisers-ads-1"},{"title":"/2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsadvertisers-coupons"},{"title":"/2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsadvertisers-coupons-1"},{"title":"/2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons-supported-sizes","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons-supported-sizes","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsadvertisers-coupons-supported-sizes"},{"title":"/2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsadvertisers-coupons-2"},{"title":"/2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json put /2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsadvertisers-coupons-3"},{"title":"/2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json delete /2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsadvertisers-coupons-4"},{"title":"/2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}/preview","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}/preview","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsadvertisers-coupons-preview"},{"title":"/2025-01/marketing-solutions/advertisers/{advertiser-id}/creatives","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/advertisers/{advertiser-id}/creatives","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsadvertisers-creatives"},{"title":"/2025-01/marketing-solutions/advertisers/{advertiser-id}/creatives","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/advertisers/{advertiser-id}/creatives","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionsadvertisers-creatives-1"},{"title":"/2025-01/marketing-solutions/creatives/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/creatives/{id}","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionscreatives"},{"title":"/2025-01/marketing-solutions/creatives/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json put /2025-01/marketing-solutions/creatives/{id}","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionscreatives-1"},{"title":"/2025-01/marketing-solutions/creatives/{id}","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json delete /2025-01/marketing-solutions/creatives/{id}","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionscreatives-2"},{"title":"/2025-01/marketing-solutions/creatives/{id}/preview","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/creatives/{id}/preview","href":"/marketing-solutions/v2025.01/reference/creative/2025-01marketing-solutionscreatives-preview"}]},{"group":"Audience","pages":[{"title":"/2025-01/marketing-solutions/audience-segments","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json patch /2025-01/marketing-solutions/audience-segments","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudience-segments"},{"title":"/2025-01/marketing-solutions/audience-segments/{audience-segment-id}/contact-list","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json delete /2025-01/marketing-solutions/audience-segments/{audience-segment-id}/contact-list","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudience-segments-contact-list"},{"title":"/2025-01/marketing-solutions/audience-segments/{audience-segment-id}/contact-list","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json patch /2025-01/marketing-solutions/audience-segments/{audience-segment-id}/contact-list","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudience-segments-contact-list-1"},{"title":"/2025-01/marketing-solutions/audience-segments/{audience-segment-id}/contact-list/statistics","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/audience-segments/{audience-segment-id}/contact-list/statistics","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudience-segments-contact-liststatistics"},{"title":"/2025-01/marketing-solutions/audience-segments/compute-sizes","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/audience-segments/compute-sizes","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudience-segmentscompute-sizes"},{"title":"/2025-01/marketing-solutions/audience-segments/create","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/audience-segments/create","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudience-segmentscreate"},{"title":"/2025-01/marketing-solutions/audience-segments/delete","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/audience-segments/delete","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudience-segmentsdelete"},{"title":"/2025-01/marketing-solutions/audience-segments/estimate-size","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/audience-segments/estimate-size","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudience-segmentsestimate-size"},{"title":"/2025-01/marketing-solutions/audience-segments/in-market-brands","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/audience-segments/in-market-brands","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudience-segmentsin-market-brands"},{"title":"/2025-01/marketing-solutions/audience-segments/in-market-interests","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/audience-segments/in-market-interests","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudience-segmentsin-market-interests"},{"title":"/2025-01/marketing-solutions/audience-segments/search","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/audience-segments/search","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudience-segmentssearch"},{"title":"/2025-01/marketing-solutions/audiences","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json patch /2025-01/marketing-solutions/audiences","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudiences"},{"title":"/2025-01/marketing-solutions/audiences/compute-sizes","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/audiences/compute-sizes","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudiencescompute-sizes"},{"title":"/2025-01/marketing-solutions/audiences/create","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/audiences/create","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudiencescreate"},{"title":"/2025-01/marketing-solutions/audiences/delete","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/audiences/delete","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudiencesdelete"},{"title":"/2025-01/marketing-solutions/audiences/estimate-size","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/audiences/estimate-size","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudiencesestimate-size"},{"title":"/2025-01/marketing-solutions/audiences/search","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json post /2025-01/marketing-solutions/audiences/search","href":"/marketing-solutions/v2025.01/reference/audience/2025-01marketing-solutionsaudiencessearch"}]},{"group":"Gateway","pages":[{"title":"/2025-01/marketing-solutions/me","deprecated":null,"version":null,"openapi":"https://api.criteo.com/2025-01/marketingsolutions/open-api-specifications.json get /2025-01/marketing-solutions/me","href":"/marketing-solutions/v2025.01/reference/gateway/2025-01marketing-solutionsme"}]}]}]},{"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-01/placements/report - 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"]}