{ "openapi": "3.0.1", "info": { "title": "Criteo API", "description": "Criteo API - MarketingSolutions", "version": "2025-04" }, "servers": [ { "url": "https://api.criteo.com" } ], "paths": { "/2025-04/advertisers/me": { "get": { "tags": [ "Advertiser" ], "summary": "/2025-04/advertisers/me", "description": "Fetch the portfolio of Advertisers for this account", "operationId": "ListAdvertisers", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetPortfolioResponse" }, "example": { "data": [ { "type": "advertiser", "id": "13", "attributes": { "advertiserName": "ClientName1" } }, { "type": "advertiser", "id": "1352", "attributes": { "advertiserName": "ClientName2" } }, { "type": "advertiser", "id": "73550", "attributes": { "advertiserName": "ClientName3" } } ], "errors": [ ], "warnings": [ ] } } } } }, "security": [ { "oauth": [ ] } ] } }, "/2025-04/log-level/advertisers/{advertiser-id}/report": { "post": { "tags": [ "Analytics" ], "summary": "/2025-04/log-level/advertisers/{advertiser-id}/report", "description": "This Statistics endpoint provides publisher data.", "operationId": "GetTransparencyReport", "parameters": [ { "name": "advertiser-id", "in": "path", "description": "The advertiser ID to fetch the transparency data for. The advertiser must already exist. Must be greater than 0.", "required": true, "schema": { "type": "string", "format": "int32" } } ], "requestBody": { "description": "The query message.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransparencyQueryMessage" }, "example": { "shouldDisplayProductIds": false, "startDate": "2024-01-01T00:00:00.0000000+00:00", "endDate": "2024-01-04T00:00:00.0000000+00:00" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/TransparencyQueryMessage" }, "example": "\r\n 2024-01-04T00:00:00\r\n 2024-01-01T00:00:00\r\n false\r\n" }, "text/xml": { "schema": { "$ref": "#/components/schemas/TransparencyQueryMessage" }, "example": "\r\n 2024-01-04T00:00:00\r\n 2024-01-01T00:00:00\r\n false\r\n" }, "application/*+xml": { "schema": { "$ref": "#/components/schemas/TransparencyQueryMessage" }, "example": "\r\n 2024-01-04T00:00:00\r\n 2024-01-01T00:00:00\r\n false\r\n" } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransparencyReportListResponse" } }, "application/xml": { "schema": { "$ref": "#/components/schemas/TransparencyReportListResponse" } }, "text/xml": { "schema": { "$ref": "#/components/schemas/TransparencyReportListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Analytics_Read" ] } ] } }, "/2025-04/marketing-solutions/ad-sets": { "patch": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/ad-sets", "description": "Patch a list of AdSets.", "operationId": "PatchAdSets", "requestBody": { "description": "List of adsets to patch.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestsPatchAdSetV24Q3" } } }, "required": true, "x-bodyName": "adSets" }, "responses": { "200": { "description": "List of patched adSets.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponsesAdSetIdV24Q3" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Manage" ] } ] }, "post": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/ad-sets", "description": "Create the specified ad set", "operationId": "CreateAdSet", "requestBody": { "description": "the ad sets to create", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateAdSetV24Q3Request" } } }, "required": true, "x-bodyName": "adSet" }, "responses": { "201": { "description": "The ad set that has been created and errors / warnings", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseReadAdSetV24Q3" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Manage" ] } ] } }, "/2025-04/marketing-solutions/ad-sets/{ad-set-id}": { "get": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/ad-sets/{ad-set-id}", "description": "Get the data for the specified ad set", "operationId": "GetAdSet", "parameters": [ { "name": "ad-set-id", "in": "path", "description": "Id of the ad set", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "data for the ad set", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseReadAdSetV24Q3" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Read" ] } ] } }, "/2025-04/marketing-solutions/ad-sets/{ad-set-id}/audience": { "put": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/ad-sets/{ad-set-id}/audience", "description": "Link or unlink an audience with an ad set", "operationId": "UpdateAdSetAudience", "parameters": [ { "name": "ad-set-id", "in": "path", "description": "The ad set ID.", "required": true, "schema": { "type": "string" } } ], "requestBody": { "description": "Ad set-Audience update request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdSetAudienceLinkInputEntityV1" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdSetAudienceLinkEntityV1Response" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Manage" ] } ] } }, "/2025-04/marketing-solutions/ad-sets/{ad-set-id}/category-bids": { "get": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/ad-sets/{ad-set-id}/category-bids", "description": "Get the Category Bids for all valid Categories associated to an Ad Set", "operationId": "GetAdSetCategoryBids", "parameters": [ { "name": "ad-set-id", "in": "path", "description": "Id of the Ad Set", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "List of Category Bids for all valid Categories associated to an Ad Set.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdSetCategoryBidListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Read" ] } ] }, "patch": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/ad-sets/{ad-set-id}/category-bids", "description": "Update the Category Bids for given Categories associated to an Ad Set\r\nPatch Category Bids for one or more Categories in a single request. Partial success policy is followed.", "operationId": "PatchAdSetCategoryBids", "parameters": [ { "name": "ad-set-id", "in": "path", "description": "Id of the Ad Set", "required": true, "schema": { "type": "string" } } ], "requestBody": { "description": "Collection of category bids to update", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchAdSetCategoryBidListRequest" } } }, "required": true, "x-bodyName": "categoryBidsToUpdate" }, "responses": { "200": { "description": "List of updated Category Bids for given Categories associated to an Ad Set, used for partial successes as well.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchAdSetCategoryBidResultListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Manage" ] } ] } }, "/2025-04/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers": { "get": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers", "description": "Get the Display Multipliers for all valid Categories associated to an Ad Set", "operationId": "GetDisplayMultipliers", "parameters": [ { "name": "ad-set-id", "in": "path", "description": "Id of the Ad Set", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "List of Display Multipliers for all valid Categories associated to an Ad Set.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdSetDisplayMultiplierListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Read" ] } ] }, "patch": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/ad-sets/{ad-set-id}/display-multipliers", "description": "Update the Display Multipliers for given Categories associated to an Ad Set\r\nPatch Display Multipliers for one or more Categories in a single request. Partial success policy is followed.", "operationId": "PatchDisplayMultipliers", "parameters": [ { "name": "ad-set-id", "in": "path", "description": "Id of the Ad Set", "required": true, "schema": { "type": "string" } } ], "requestBody": { "description": "List of display multiplier values to change", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchAdSetDisplayMultiplierListRequest" } } }, "required": true, "x-bodyName": "displayMultipliersToUpdate" }, "responses": { "200": { "description": "List of updated Display Multipliers for given Categories associated to an Ad Set. Make sure to check the error field in the response since a partial success will result in a 200 response code.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchAdSetDisplayMultiplierResultListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Manage" ] } ] } }, "/2025-04/marketing-solutions/ad-sets/search": { "post": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/ad-sets/search", "description": "Search for ad sets", "operationId": "SearchAdSets", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AdSetSearchRequestV24Q3" } } }, "x-bodyName": "request" }, "responses": { "200": { "description": "data for the ad sets", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponsesReadAdSetV24Q3" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Read" ] } ] } }, "/2025-04/marketing-solutions/ad-sets/start": { "post": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/ad-sets/start", "description": "Start the specified list of ad sets", "operationId": "StartAdSets", "requestBody": { "description": "All the ad sets to start", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestsAdSetId" } } }, "x-bodyName": "adSets" }, "responses": { "200": { "description": "List of ad sets that have been started and errors / warnings by ad set", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponsesAdSetId" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Manage" ] } ] } }, "/2025-04/marketing-solutions/ad-sets/stop": { "post": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/ad-sets/stop", "description": "Stop the specified list of ad sets", "operationId": "StopAdSets", "requestBody": { "description": "All the ad sets to stop", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RequestsAdSetId" } } }, "x-bodyName": "adSets" }, "responses": { "200": { "description": "List of ad sets that have been stopped and errors / warnings by ad set", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponsesAdSetId" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Manage" ] } ] } }, "/2025-04/marketing-solutions/ads/{id}": { "delete": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/ads/{id}", "description": "Delete an Ad", "operationId": "DeleteAd", "parameters": [ { "name": "id", "in": "path", "description": "The ad identifier to delete.", "required": true, "schema": { "type": "string", "format": "int32" } } ], "responses": { "204": { "description": "The ad was deleted." } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Manage" ] } ] }, "get": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/ads/{id}", "description": "Get an Ad with its id", "operationId": "GetAd", "parameters": [ { "name": "id", "in": "path", "description": "The ad identifier to retrieve.", "required": true, "schema": { "type": "string", "format": "int32" } } ], "responses": { "200": { "description": "The found ad is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceOutcomeOfAd" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Read" ] } ] } }, "/2025-04/marketing-solutions/advertisers/{advertiser-id}/ads": { "get": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/advertisers/{advertiser-id}/ads", "description": "Get the list of self-services Ads for a given advertiser", "operationId": "GetAdvertiserAds", "parameters": [ { "name": "advertiser-id", "in": "path", "description": "The advertiser identifier.", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "The number of ads to be returned. The default is 50.", "schema": { "type": "integer", "format": "int32", "nullable": true } }, { "name": "offset", "in": "query", "description": "The (zero-based) offset into the collection of ads. The default is 0.", "schema": { "type": "integer", "format": "int32", "nullable": true } } ], "responses": { "200": { "description": "The list of self-services Ads is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceCollectionOutcomeOfAd" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Read" ] } ] }, "post": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/advertisers/{advertiser-id}/ads", "description": "Create an Ad", "operationId": "CreateAdvertiserAd", "parameters": [ { "name": "advertiser-id", "in": "path", "description": "The advertiser identifier.", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceInputOfAdWrite" } } }, "required": true, "x-bodyName": "request" }, "responses": { "201": { "description": "The created Ad is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceOutcomeOfAd" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Manage" ] } ] } }, "/2025-04/marketing-solutions/advertisers/{advertiser-id}/coupons": { "get": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/advertisers/{advertiser-id}/coupons", "description": "Get the list of self-services Coupons for a given advertiser", "operationId": "GetAdvertiserCoupons", "parameters": [ { "name": "advertiser-id", "in": "path", "description": "The advertiser identifier.", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "The number of coupons to be returned. The default is 50.", "schema": { "type": "integer", "format": "int32", "nullable": true } }, { "name": "offset", "in": "query", "description": "The (zero-based) offset into the collection of coupons. The default is 0.", "schema": { "type": "integer", "format": "int32", "nullable": true } } ], "responses": { "200": { "description": "The list of self-services Coupons is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceCollectionOutcomeOfCoupon" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Read" ] } ] }, "post": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/advertisers/{advertiser-id}/coupons", "description": "Create a Coupon", "operationId": "CreateAdvertiserCoupon", "parameters": [ { "name": "advertiser-id", "in": "path", "description": "The advertiser identifier.", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceInputOfCreateCoupon" } } }, "required": true, "x-bodyName": "request" }, "responses": { "201": { "description": "The created Coupon is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceOutcomeOfCoupon" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Manage" ] } ] } }, "/2025-04/marketing-solutions/advertisers/{advertiser-id}/coupons-supported-sizes": { "get": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/advertisers/{advertiser-id}/coupons-supported-sizes", "description": "Get the list of Coupon supported sizes", "operationId": "GetAdvertiserCouponSupportedSizes", "parameters": [ { "name": "ad-set-id", "in": "query", "description": "The ad set id on which you want to check the Coupon supported sizes.", "schema": { "type": "string" } }, { "name": "advertiser-id", "in": "path", "description": "The advertiser identifier.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "The list of Coupon supported sizes is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceOutcomeOfCouponSupportedSizes" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Read" ] } ] } }, "/2025-04/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}": { "delete": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}", "description": "Delete a Coupon", "operationId": "DeleteAdvertiserCoupon", "parameters": [ { "name": "advertiser-id", "in": "path", "description": "The advertiser identifier.", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "description": "The Coupon identifier to delete.", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "The Coupon was deleted." } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Manage" ] } ] }, "get": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}", "description": "Get a Coupon with its id", "operationId": "GetAdvertiserCoupon", "parameters": [ { "name": "advertiser-id", "in": "path", "description": "The advertiser identifier.", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "description": "The Coupon identifier to retrieve.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "The found Coupon is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceOutcomeOfCoupon" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Read" ] } ] }, "put": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}", "description": "Edit a specific Coupon", "operationId": "EditAdvertiserCoupon", "parameters": [ { "name": "advertiser-id", "in": "path", "description": "The advertiser identifier.", "required": true, "schema": { "type": "string" } }, { "name": "id", "in": "path", "description": "The Coupon identifier to edit.", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceInputOfUpdateCoupon" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "The edited Coupon is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceOutcomeOfCoupon" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Manage" ] } ] } }, "/2025-04/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}/preview": { "get": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/advertisers/{advertiser-id}/coupons/{id}/preview", "description": "Get the preview of a specific Coupon", "operationId": "GetAdvertiserCouponPreview", "parameters": [ { "name": "advertiser-id", "in": "path", "description": "The advertiser identifier.", "required": true, "schema": { "type": "string" } }, { "name": "height", "in": "query", "description": "The height of the coupon to preview.", "schema": { "type": "integer", "format": "int32" } }, { "name": "id", "in": "path", "description": "The Coupon identifier to preview.", "required": true, "schema": { "type": "string" } }, { "name": "width", "in": "query", "description": "The width of the coupon to preview.", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "The preview HTML of a specific Coupon is returned.", "content": { "text/html": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "string" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Read" ] } ] } }, "/2025-04/marketing-solutions/advertisers/{advertiser-id}/creatives": { "get": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/advertisers/{advertiser-id}/creatives", "description": "Get the list of self-services Creatives for a given advertiser", "operationId": "GetAdvertiserCreatives", "parameters": [ { "name": "advertiser-id", "in": "path", "description": "The advertiser identifier.", "required": true, "schema": { "type": "string" } }, { "name": "limit", "in": "query", "description": "The number of creatives to be returned. The default is 50.", "schema": { "type": "integer", "format": "int32", "nullable": true } }, { "name": "offset", "in": "query", "description": "The (zero-based) offset into the collection of creatives. The default is 0.", "schema": { "type": "integer", "format": "int32", "nullable": true } } ], "responses": { "200": { "description": "The list of self-services Creatives is returned.This list will contain creatives in draft status as well which will have some properties as null", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceCollectionOutcomeOfCreativeRead" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Read" ] } ] }, "post": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/advertisers/{advertiser-id}/creatives", "description": "Create a Creative", "operationId": "CreateAdvertiserCreative", "parameters": [ { "name": "advertiser-id", "in": "path", "description": "The advertiser identifier.", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceInputOfCreativeWrite" } } }, "required": true, "x-bodyName": "request" }, "responses": { "201": { "description": "The created creative is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceOutcomeOfCreative" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Manage" ] } ] } }, "/2025-04/marketing-solutions/audience-segments": { "patch": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audience-segments", "description": "Updates the properties of all segments with a valid configuration, and returns their IDs. For those that cannot be updated, one or multiple errors are returned.", "operationId": "UpdateAudienceSegments", "requestBody": { "description": "Segment Update request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSegmentBulkUpdateInputV1" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "Success or partial success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSegmentEntityV1ListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Manage" ] } ] } }, "/2025-04/marketing-solutions/audience-segments/{audience-segment-id}/contact-list": { "delete": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audience-segments/{audience-segment-id}/contact-list", "description": "Delete all identifiers from a contact list audience-segment.", "operationId": "DeleteContactListByAudienceSegment", "responses": { "200": { "description": "The Contact List was emptied", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/DeleteAudienceContactListResponse" }, "example": { "data": { "id": "1", "type": "AudienceContactlist" }, "errors": [ ], "warnings": [ { "traceId": "56ed4096-f96a-4944-8881-05468efe0ec9", "type": "deprecation", "code": "deprecated-field", "instance": "/audiences/314195", "title": "'nbValidIds' is deprecated", "detail": "The field 'nbValidIds' is deprecated please use 'nbValidIdentifiers" } ] } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Manage" ] } ] }, "patch": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audience-segments/{audience-segment-id}/contact-list", "description": "Add/remove identifiers to or from a contact list audience-segment.", "operationId": "UpdateContactListByAudienceSegment", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContactlistAmendmentRequest" } } }, "required": true, "x-bodyName": "body" }, "responses": { "200": { "description": "Summary of created request", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ModifyAudienceResponse" }, "example": { "data": { "type": "ContactlistAmendment", "attributes": { "contactListId": 12, "operation": "add", "requestDate": "2018-12-10T10:00:50.0000000+00:00", "identifierType": "madid", "nbValidIdentifiers": 7343, "nbInvalidIdentifiers": 13, "sampleInvalidIdentifiers": [ "InvalidIdentifier" ] } }, "errors": [ ], "warnings": [ { "traceId": "56ed4096-f96a-4944-8881-05468efe0ec9", "type": "deprecation", "code": "deprecated-field", "instance": "/audiences/314195", "title": "'nbValidIds' is deprecated", "detail": "The field 'nbValidIds' is deprecated please use 'nbValidIdentifiers" } ] } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Manage" ] } ] }, "parameters": [ { "name": "audience-segment-id", "in": "path", "description": "The id of the contact list audience-segment to amend", "required": true, "schema": { "type": "string", "format": "int32" } } ] }, "/2025-04/marketing-solutions/audience-segments/{audience-segment-id}/contact-list/statistics": { "get": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audience-segments/{audience-segment-id}/contact-list/statistics", "description": "Returns the statistics of a contact list segment.", "operationId": "GetAudienceSegmentContactListStatistics", "parameters": [ { "name": "audience-segment-id", "in": "path", "description": "The segment ID.", "required": true, "schema": { "type": "string", "format": "int32" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ContactListStatisticsEntityV1Response" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Read" ] } ] } }, "/2025-04/marketing-solutions/audience-segments/compute-sizes": { "post": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audience-segments/compute-sizes", "description": "Gets the size of all segments. An error is returned for those whose size calculation is not supported.", "operationId": "ComputeAudienceSegmentsSizes", "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSegmentComputeSizesInputV1" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "Success or partial success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSegmentSizeEntityV1ListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Manage" ] } ] } }, "/2025-04/marketing-solutions/audience-segments/create": { "post": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audience-segments/create", "description": "Creates all segments with a valid configuration, and returns their IDs. For those that cannot be created, one or multiple errors are returned.", "operationId": "CreateAudienceSegments", "requestBody": { "description": "Segment creation parameter", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSegmentBulkCreateInputV1" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "Success or partial success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSegmentEntityV1ListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Manage" ] } ] } }, "/2025-04/marketing-solutions/audience-segments/delete": { "post": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audience-segments/delete", "description": "Delete the segments associated to the given audience IDs.", "operationId": "DeleteAudienceSegments", "requestBody": { "description": "Segment delete request.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSegmentBulkDeleteInputV1" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "Success or partial success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSegmentIdEntityV1ListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Manage" ] } ] } }, "/2025-04/marketing-solutions/audience-segments/estimate-size": { "post": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audience-segments/estimate-size", "description": "Gets the size estimation of a non existent segment. An error is returned when size calculation is not supported.", "operationId": "EstimateAudienceSegmentsSizes", "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSegmentEstimateSizeInputV1" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSegmentSizeEstimationV1Response" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Manage" ] } ] } }, "/2025-04/marketing-solutions/audience-segments/in-market-brands": { "get": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audience-segments/in-market-brands", "description": "Returns a list with all available in-market brands that can be used to define an in-market segment.", "operationId": "GetAudienceSegmentsInMarketBrands", "parameters": [ { "name": "advertiser-id", "in": "query", "description": "The advertiser ID.", "required": true, "schema": { "type": "string" } }, { "name": "country", "in": "query", "description": "The ISO 3166-1 alpha-2 country code.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InMarketAudienceSegmentBrandEntityV1ListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Read" ] } ] } }, "/2025-04/marketing-solutions/audience-segments/in-market-interests": { "get": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audience-segments/in-market-interests", "description": "Returns a list with all available in-market interests that can be used to define an in-market segment. These in-market interests correspond to the Google product taxonomy.", "operationId": "GetAudienceSegmentsInMarketInterests", "parameters": [ { "name": "advertiser-id", "in": "query", "description": "The advertiser ID.", "required": true, "schema": { "type": "string" } }, { "name": "country", "in": "query", "description": "The ISO 3166-1 alpha-2 country code.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InMarketAudienceSegmentInterestEntityV1ListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Read" ] } ] } }, "/2025-04/marketing-solutions/audience-segments/search": { "post": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audience-segments/search", "description": "Returns a list of segments that match the provided filters. If present, the filters are AND'ed together when applied.", "operationId": "SearchAudienceSegments", "parameters": [ { "name": "limit", "in": "query", "description": "The number of elements to be returned. The default is 50 and the maximum is 100.", "schema": { "maximum": 100, "minimum": 0, "type": "integer", "format": "int32", "default": 50 } }, { "name": "offset", "in": "query", "description": "The (zero-based) offset into the collection. The default is 0.", "schema": { "type": "integer", "format": "int32", "default": 0 } } ], "requestBody": { "description": "Segment search filters.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSegmentSearchInputV1" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSegmentEntityV1AudienceSegmentSearchMetadataV1ListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Read" ] } ] } }, "/2025-04/marketing-solutions/audiences": { "patch": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audiences", "description": "Updates the properties of all audiences with a valid configuration, and returns their IDs. For those that cannot be updated, one or multiple errors are returned.", "operationId": "UpdateAudiences", "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceBulkUpdateInputV1" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "Success or partial success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceEntityV1ListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Manage" ] } ] } }, "/2025-04/marketing-solutions/audiences/compute-sizes": { "post": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audiences/compute-sizes", "description": "Gets the size of all audiences. An error is returned for those whose size calculation is not supported.", "operationId": "ComputeAudiencesSizes", "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceComputeSizesInputV1" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "Success or partial success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSizeEntityV1ListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Manage" ] } ] } }, "/2025-04/marketing-solutions/audiences/create": { "post": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audiences/create", "description": "Creates all audiences with a valid configuration, and returns their IDs. For those that cannot be created, one or multiple errors are returned.", "operationId": "CreateAudiences", "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceBulkCreateInputV1" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "Success or partial success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceEntityV1ListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Manage" ] } ] } }, "/2025-04/marketing-solutions/audiences/delete": { "post": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audiences/delete", "description": "Deletes the audiences associated to the given audience IDs.", "operationId": "DeleteAudiences", "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceBulkDeleteInputV1" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceIdEntityV1ListResponse" } } } }, "204": { "description": "Success or partial success", "content": { "application/json": { } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Manage" ] } ] } }, "/2025-04/marketing-solutions/audiences/estimate-size": { "post": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audiences/estimate-size", "description": "Gets the size estimation of a non existent audience. An error is returned when size calculation is not supported.", "operationId": "EstimateAudiencesSizes", "requestBody": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceEstimateSizeInputV1" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "Success or partial success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSizeEstimationV1Response" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Manage" ] } ] } }, "/2025-04/marketing-solutions/audiences/search": { "post": { "tags": [ "Audience" ], "summary": "/2025-04/marketing-solutions/audiences/search", "description": "Returns a list of audiences that match the provided filters. If present, the filters are AND'ed together when applied.", "operationId": "SearchAudiences", "parameters": [ { "name": "limit", "in": "query", "description": "The number of elements to be returned. The default is 50 and the maximum is 100.", "schema": { "maximum": 100, "minimum": 0, "type": "integer", "format": "int32", "default": 50 } }, { "name": "offset", "in": "query", "description": "The (zero-based) offset into the collection. The default is 0.", "schema": { "type": "integer", "format": "int32", "default": 0 } } ], "requestBody": { "description": "Audience search filters.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceSearchInputV1" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AudienceEntityV1AudienceSearchMetadataV1ListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Audience_Read" ] } ] } }, "/2025-04/marketing-solutions/campaigns": { "patch": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/campaigns", "description": "Patch a list of Campaigns.\r\n \r\nA campaign, or in other words a marketing campaign, is an entity that defines advertising objectives and success criteria.", "operationId": "PatchCampaigns", "requestBody": { "description": "List of campaigns to patch.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchCampaignListRequest" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "List of patched campaigns.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchResultCampaignListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Manage" ] } ] }, "post": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/campaigns", "description": "Create the specified campaign\r\n \r\nA campaign, or in other words a marketing campaign, is an entity that defines advertising objectives and success criteria.", "operationId": "CreateCampaign", "requestBody": { "description": "the campaigns to create", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CreateCampaignRequest" } } }, "required": true, "x-bodyName": "marketingCampaign" }, "responses": { "201": { "description": "The campaign that has been created and errors / warnings", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CampaignV23Q1Response" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Manage" ] } ] } }, "/2025-04/marketing-solutions/campaigns/{campaign-id}": { "get": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/campaigns/{campaign-id}", "description": "Get the data for the specified campaign.\r\n \r\nA campaign, or in other words a marketing campaign, is an entity that defines advertising objectives and success criteria.", "operationId": "GetCampaign", "parameters": [ { "name": "campaign-id", "in": "path", "description": "ID of the marketing campaign; This field is required.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Returns the data of the specified marketing campaign.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CampaignV23Q1Response" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Read" ] } ] } }, "/2025-04/marketing-solutions/campaigns/search": { "post": { "tags": [ "Campaign" ], "summary": "/2025-04/marketing-solutions/campaigns/search", "description": "Search endpoint for campaigns\r\n \r\nA campaign, or in other words a marketing campaign, is an entity that defines advertising objectives and success criteria.", "operationId": "SearchCampaigns", "requestBody": { "description": "Filters for searching for campaigns", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CampaignSearchRequestV23Q1" } } }, "x-bodyName": "request" }, "responses": { "200": { "description": "Returns a list of marketing campaigns' data.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CampaignV23Q1ListResponse" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Campaign_Read" ] } ] } }, "/2025-04/marketing-solutions/creatives/{id}": { "delete": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/creatives/{id}", "description": "Delete a Creative if there are no ads binded to it", "operationId": "DeleteCreative", "parameters": [ { "name": "id", "in": "path", "description": "The creative identifier to delete.", "required": true, "schema": { "type": "string" } } ], "responses": { "204": { "description": "The creative was deleted." } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Manage" ] } ] }, "get": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/creatives/{id}", "description": "Get a Creative with its id", "operationId": "GetCreative", "parameters": [ { "name": "id", "in": "path", "description": "The creative identifier to retrieve.", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "The found creative is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceOutcomeOfCreative" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Read" ] } ] }, "put": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/creatives/{id}", "description": "Edit a specific Creative", "operationId": "EditCreative", "parameters": [ { "name": "id", "in": "path", "description": "The creative identifier to edit.", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceInputOfCreativeWrite" } } }, "required": true, "x-bodyName": "request" }, "responses": { "200": { "description": "The edited creative is returned.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResourceOutcomeOfCreative" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Manage" ] } ] } }, "/2025-04/marketing-solutions/creatives/{id}/preview": { "post": { "tags": [ "Creative" ], "summary": "/2025-04/marketing-solutions/creatives/{id}/preview", "description": "Get the preview of a specific Creative", "operationId": "GenerateCreativePreview", "parameters": [ { "name": "height", "in": "query", "description": "The height of the Creative to preview.", "schema": { "type": "integer", "format": "int32" } }, { "name": "id", "in": "path", "description": "The Creative identifier to preview.", "required": true, "schema": { "type": "string" } }, { "name": "width", "in": "query", "description": "The width of the Creative to preview.", "schema": { "type": "integer", "format": "int32" } } ], "responses": { "200": { "description": "The preview HTML of a specific Creative is returned.", "content": { "text/html": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "string" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Creative_Manage" ] } ] } }, "/2025-04/marketing-solutions/me": { "get": { "tags": [ "Gateway" ], "summary": "/2025-04/marketing-solutions/me", "description": "Get information about the currently logged application", "operationId": "GetCurrentApplication", "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApplicationSummaryModelResponse" } } } } }, "security": [ { "oauth": [ ] } ] } }, "/2025-04/placements/report": { "post": { "tags": [ "Analytics" ], "summary": "/2025-04/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

\r\nThis endpoint supports data retrieval for up to three months in the past.", "operationId": "GetPlacementsReport", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PlacementsReportQueryMessageListRequest" }, "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" } } ] } }, "application/xml": { "schema": { "$ref": "#/components/schemas/PlacementsReportQueryMessageListRequest" }, "example": "\r\n \r\n \r\n \r\n 2024-01-04T00:00:00\r\n 2024-01-01T00:00:00\r\n csv\r\n Europe/Paris\r\n \r\n \r\n 135\r\n 246\r\n 357\r\n 468\r\n \r\n \r\n \r\n \r\n 123\r\n 456\r\n 789\r\n \r\n \r\n \r\n \r\n 111\r\n 222\r\n 333\r\n 444\r\n \r\n \r\n EUR\r\n \r\n AdsetId\r\n AdvertiserId\r\n Placement\r\n \r\n false\r\n Web\r\n false\r\n \r\n Clicks\r\n Displays\r\n Cost\r\n \r\n MyPlacement\r\n \r\n report\r\n \r\n \r\n" }, "text/xml": { "schema": { "$ref": "#/components/schemas/PlacementsReportQueryMessageListRequest" }, "example": "\r\n \r\n \r\n \r\n 2024-01-04T00:00:00\r\n 2024-01-01T00:00:00\r\n csv\r\n Europe/Paris\r\n \r\n \r\n 135\r\n 246\r\n 357\r\n 468\r\n \r\n \r\n \r\n \r\n 123\r\n 456\r\n 789\r\n \r\n \r\n \r\n \r\n 111\r\n 222\r\n 333\r\n 444\r\n \r\n \r\n EUR\r\n \r\n AdsetId\r\n AdvertiserId\r\n Placement\r\n \r\n false\r\n Web\r\n false\r\n \r\n Clicks\r\n Displays\r\n Cost\r\n \r\n MyPlacement\r\n \r\n report\r\n \r\n \r\n" }, "application/*+xml": { "schema": { "$ref": "#/components/schemas/PlacementsReportQueryMessageListRequest" }, "example": "\r\n \r\n \r\n \r\n 2024-01-04T00:00:00\r\n 2024-01-01T00:00:00\r\n csv\r\n Europe/Paris\r\n \r\n \r\n 135\r\n 246\r\n 357\r\n 468\r\n \r\n \r\n \r\n \r\n 123\r\n 456\r\n 789\r\n \r\n \r\n \r\n \r\n 111\r\n 222\r\n 333\r\n 444\r\n \r\n \r\n EUR\r\n \r\n AdsetId\r\n AdvertiserId\r\n Placement\r\n \r\n false\r\n Web\r\n false\r\n \r\n Clicks\r\n Displays\r\n Cost\r\n \r\n MyPlacement\r\n \r\n report\r\n \r\n \r\n" } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "string", "format": "binary" } }, "text/csv": { "schema": { "type": "string", "format": "binary" } }, "text/xml": { "schema": { "type": "string", "format": "binary" } }, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": { "schema": { "type": "string", "format": "binary" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Analytics_Read" ] } ] } }, "/2025-04/statistics/report": { "post": { "tags": [ "Analytics" ], "summary": "/2025-04/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

\r\nThis endpoint supports data retrieval for up to two years in the past.", "operationId": "GetAdsetReport", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatisticsReportQueryMessage" }, "example": { "advertiserIds": "123,456,789", "adSetIds": [ "12345", "54321" ], "adSetNames": [ "myAdSet1", "myAdSet2" ], "adSetStatus": [ "Active" ], "dimensions": [ "CampaignId", "Campaign", "AdsetId", "Adset", "AdvertiserId", "Advertiser", "AdId", "Ad", "CouponId", "Coupon", "CategoryId", "Category", "Hour", "Day", "Week", "Month", "Year", "Os", "Device" ], "metrics": [ "Clicks", "Displays", "Cpc", "Visits" ], "currency": "EUR", "format": "csv", "timezone": "Europe/Paris", "startDate": "2024-01-01T00:00:00.0000000+00:00", "endDate": "2024-01-04T00:00:00.0000000+00:00" } } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "string", "format": "binary" } }, "text/csv": { "schema": { "type": "string", "format": "binary" } }, "text/xml": { "schema": { "type": "string", "format": "binary" } }, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": { "schema": { "type": "string", "format": "binary" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Analytics_Read" ] } ] } }, "/2025-04/transactions/report": { "post": { "tags": [ "Analytics" ], "summary": "/2025-04/transactions/report", "description": "This Transactions endpoint provides transactions id related data.\r\n

\r\nThis endpoint supports data retrieval for up to two years in the past.", "operationId": "GetTransactionsReport", "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TransactionsReportQueryMessageListRequest" }, "example": { "data": [ { "type": "report", "attributes": { "advertiserIds": "123,456,789", "eventType": "Display", "currency": "EUR", "format": "csv", "timezone": "Europe/Paris", "startDate": "2024-01-01T00:00:00.0000000+00:00", "endDate": "2024-01-04T00:00:00.0000000+00:00" } } ] } }, "application/xml": { "schema": { "$ref": "#/components/schemas/TransactionsReportQueryMessageListRequest" }, "example": "\r\n \r\n \r\n \r\n 2024-01-04T00:00:00\r\n 2024-01-01T00:00:00\r\n csv\r\n Europe/Paris\r\n \r\n \r\n 123\r\n 456\r\n 789\r\n \r\n \r\n EUR\r\n Display\r\n false\r\n \r\n report\r\n \r\n \r\n" }, "text/xml": { "schema": { "$ref": "#/components/schemas/TransactionsReportQueryMessageListRequest" }, "example": "\r\n \r\n \r\n \r\n 2024-01-04T00:00:00\r\n 2024-01-01T00:00:00\r\n csv\r\n Europe/Paris\r\n \r\n \r\n 123\r\n 456\r\n 789\r\n \r\n \r\n EUR\r\n Display\r\n false\r\n \r\n report\r\n \r\n \r\n" }, "application/*+xml": { "schema": { "$ref": "#/components/schemas/TransactionsReportQueryMessageListRequest" }, "example": "\r\n \r\n \r\n \r\n 2024-01-04T00:00:00\r\n 2024-01-01T00:00:00\r\n csv\r\n Europe/Paris\r\n \r\n \r\n 123\r\n 456\r\n 789\r\n \r\n \r\n EUR\r\n Display\r\n false\r\n \r\n report\r\n \r\n \r\n" } } }, "responses": { "200": { "description": "Success", "content": { "application/json": { "schema": { "type": "string", "format": "binary" } }, "text/csv": { "schema": { "type": "string", "format": "binary" } }, "text/xml": { "schema": { "type": "string", "format": "binary" } }, "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": { "schema": { "type": "string", "format": "binary" } } } } }, "security": [ { "oauth": [ "MarketingSolutions_Analytics_Read" ] } ] } } }, "components": { "schemas": { "Ad": { "type": "object", "properties": { "adSetId": { "type": "string", "description": "The id of the Ad Set binded to this Ad", "nullable": true }, "creativeId": { "type": "string", "description": "The id of the Creative binded to this Ad", "nullable": true }, "description": { "type": "string", "description": "The description of the ad", "nullable": true }, "endDate": { "type": "string", "description": "The date when when we will stop to show this ad. If the end date is not specified (i.e. null) then the ad will go on forever\r\nString must be in ISO8601 format", "nullable": true }, "id": { "type": "string", "description": "Unique identifier (duplicate of the parent id).", "nullable": true }, "inventoryType": { "enum": [ "Native", "Display", "Video" ], "type": "string", "description": "The inventory the Ad belongs to. Possible values are \"Display\" and \"Native\". This is optional since this doesn't make sense for every creative type but will throw an error if not set for a dynamic creative.", "nullable": true }, "name": { "type": "string", "description": "The name of the ad", "nullable": true }, "startDate": { "type": "string", "description": "The date when the ad will be launched\r\nString must be in ISO8601 format", "nullable": true } }, "description": "An ad is the binding that connects a creative with an ad set", "nullable": true }, "AdaptiveAttributes": { "required": [ "callsToAction", "colors", "descriptionFont", "descriptionText", "headlineFont", "headlineText", "landingPageUrl", "layouts", "logos" ], "type": "object", "properties": { "callsToAction": { "type": "array", "items": { "type": "string" }, "description": "A Call-to-Action (CTA) is an action-driven instruction to your audience intended to provoke an immediate\r\nresponse, such as “Buy now” or “Go!”." }, "colors": { "$ref": "#/components/schemas/AdaptiveColors" }, "descriptionFont": { "type": "string", "description": "Font of the description\r\nValid supported font like \"Arial\"" }, "descriptionText": { "type": "string", "description": "The description text of the banner" }, "headlineFont": { "type": "string", "description": "Font of the headline\r\nValid supported font like \"Arial\"" }, "headlineText": { "type": "string", "description": "The headline text of the banner" }, "imageDisplay": { "enum": [ "ShowFullImage", "ZoomOnImage" ], "type": "string", "description": "Value can be \"ShowFullImage\" or \"ZoomOnImage\". Choose whether your image set should fit inside the allocated\r\nspace (\"ShowFullImage\") or whether it should fill that space (\"ZoomOnImage\"). If you choose ZoomOnImage, there may be some\r\nimage cropping.", "nullable": true }, "imageSets": { "type": "array", "items": { "$ref": "#/components/schemas/ImageSet" }, "description": "Multiple image sets, each image set consists of multiple images and a headline text.", "nullable": true }, "landingPageUrl": { "type": "string", "description": "Web redirection of the landing page url", "format": "uri" }, "layouts": { "type": "array", "items": { "enum": [ "Editorial", "Montage", "InBannerVideo" ], "type": "string" }, "description": "The Adaptive layouts that are enabled.\r\nIt can contain any of the following values: \"Editorial\", “Montage“, \"InBannerVideo\"." }, "logos": { "type": "array", "items": { "$ref": "#/components/schemas/ImageShape" }, "description": "Logo images uploaded on demostatic.criteo.com when deploying and then static.criteo.net" }, "videos": { "type": "array", "items": { "$ref": "#/components/schemas/VideoDetail" }, "description": "Multiple videos potentially in different shapes.", "nullable": true } }, "description": "The attributes specific to Adaptive creatives", "nullable": true }, "AdaptiveColors": { "required": [ "backgroundColor", "ctaBackgroundColor", "ctaTextColor", "logoAreaAndTitleColor", "text1Color", "text2Color" ], "type": "object", "properties": { "backgroundColor": { "type": "string", "description": "Color of the creative's background.\r\nA valid RGB24 color in hexadecimal (e.g. \"AB00FF\")" }, "ctaBackgroundColor": { "type": "string", "description": "Color of the background of the CTA.\r\nA valid RGB24 color in hexadecimal (e.g. \"AB00FF\")." }, "ctaTextColor": { "type": "string", "description": "Color of the text of the CTA.\r\nA valid RGB24 color in hexadecimal (e.g. \"AB00FF\")." }, "logoAreaAndTitleColor": { "type": "string", "description": "Color of the creative's logo area.\r\nA valid RGB24 color in hexadecimal (e.g. \"AB00FF\")." }, "text1Color": { "type": "string", "description": "Color of the headline and the description texts.\r\nA valid RGB24 color in hexadecimal (e.g. \"AB00FF\")" }, "text2Color": { "type": "string", "description": "Color of the image set's headline text.\r\nA valid RGB24 color in hexadecimal (e.g. \"AB00FF\")" } }, "description": "Entity consists of the color aliases of the creative's elements", "nullable": true }, "AdaptiveReadAttributes": { "type": "object", "properties": { "callsToAction": { "type": "array", "items": { "type": "string" }, "description": "A Call-to-Action (CTA) is an action-driven instruction to your audience intended to provoke an immediate\r\nresponse, such as “Buy now” or “Go!”.", "nullable": true }, "colors": { "$ref": "#/components/schemas/AdaptiveColors" }, "descriptionFont": { "type": "string", "description": "Font of the description\r\nValid supported font like \"Arial\"", "nullable": true }, "descriptionText": { "type": "string", "description": "The description text of the banner", "nullable": true }, "headlineFont": { "type": "string", "description": "Font of the headline\r\nValid supported font like \"Arial\"", "nullable": true }, "headlineText": { "type": "string", "description": "The headline text of the banner", "nullable": true }, "imageDisplay": { "enum": [ "ShowFullImage", "ZoomOnImage" ], "type": "string", "description": "Value can be \"ShowFullImage\" or \"ZoomOnImage\". Choose whether your image set should fit inside the allocated\r\nspace (\"ShowFullImage\") or whether it should fill that space (\"ZoomOnImage\"). If you choose ZoomOnImage, there may be some\r\nimage cropping.", "nullable": true }, "imageSets": { "type": "array", "items": { "$ref": "#/components/schemas/ImageSet" }, "description": "Multiple image sets, each image set consists of multiple images and a headline text.", "nullable": true }, "landingPageUrl": { "type": "string", "description": "Web redirection of the landing page url", "format": "uri", "nullable": true }, "layouts": { "type": "array", "items": { "enum": [ "Editorial", "Montage", "InBannerVideo" ], "type": "string" }, "description": "The Adaptive layouts that are enabled.\r\nIt can contain any of the following values: \"Editorial\", “Montage“, \"InBannerVideo\".", "nullable": true }, "logos": { "type": "array", "items": { "$ref": "#/components/schemas/ImageShape" }, "description": "Logo images uploaded on demostatic.criteo.com when deploying and then static.criteo.net", "nullable": true }, "videos": { "type": "array", "items": { "$ref": "#/components/schemas/VideoDetail" }, "description": "Multiple videos potentially in different shapes.", "nullable": true } }, "description": "The attributes specific to Adaptive creatives read", "nullable": true }, "AdaptiveWriteAttributes": { "required": [ "callsToAction", "colors", "descriptionFont", "descriptionText", "headlineFont", "headlineText", "landingPageUrl", "layouts", "logoBase64String" ], "type": "object", "properties": { "callsToAction": { "minItems": 1, "type": "array", "items": { "type": "string" }, "description": "A Call-to-Action (CTA) is an action-driven instruction to your audience intended to provoke an immediate\r\nresponse, such as “Buy now” or “Go!”." }, "colors": { "$ref": "#/components/schemas/AdaptiveColors" }, "descriptionFont": { "type": "string", "description": "Font of the description\r\nValid supported font like \"Arial\"" }, "descriptionText": { "type": "string", "description": "The description text of the banner" }, "headlineFont": { "type": "string", "description": "Font of the headline\r\nValid supported font like \"Arial\"" }, "headlineText": { "type": "string", "description": "The headline text of the banner" }, "imageDisplay": { "enum": [ "ShowFullImage", "ZoomOnImage" ], "type": "string", "description": "Value can be \"ShowFullImage\" or \"ZoomOnImage\". Choose whether your image set should fit inside the allocated\r\nspace (\"ShowFullImage\") or whether it should fill that space (\"ZoomOnImage\"). If you choose ZoomOnImage, there may be some\r\nimage cropping.", "nullable": true }, "imageSetsBase64": { "type": "array", "items": { "$ref": "#/components/schemas/ImageSetBase64" }, "description": "Multiple image sets, each image set consists of multiple images as a base-64 encoded string and a headline text.", "nullable": true }, "landingPageUrl": { "type": "string", "description": "Web redirection of the landing page url.", "format": "uri" }, "layouts": { "minItems": 1, "type": "array", "items": { "enum": [ "Editorial", "Montage", "InBannerVideo" ], "type": "string" }, "description": "The Adaptive layouts that are enabled.\r\nIt can contain any of the following values: \"Editorial\", “Montage“, \"InBannerVideo\"." }, "logoBase64String": { "type": "string", "description": "Logo image as a base-64 encoded string" }, "videoBase64Strings": { "type": "array", "items": { "type": "string" }, "description": "Multiple videos potentially in different shapes, each video is a base-64 encoded string.", "nullable": true } }, "description": "The attributes specific to create or update an Adaptive creative" }, "AdSetAudienceLinkEntityV1": { "type": "object", "properties": { "audienceId": { "type": "string", "nullable": true } }, "description": "Link Audience with an ad set", "nullable": true, "x-criteo-canonical": { "infoType": "entity", "name": "AdSetAudience", "version": "v1" } }, "AdSetAudienceLinkEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AdSetAudienceLinkEntityV1" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API", "nullable": true }, "AdSetAudienceLinkEntityV1Response": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdSetAudienceLinkEntityV1Resource" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for a single entity" }, "AdSetAudienceLinkInputEntityV1": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AdSetAudienceLinkEntityV1Resource" } }, "description": "Input to set audience ad set link." }, "AdSetCategoryBid": { "type": "object", "properties": { "bidAmount": { "type": "number", "description": "The Bid amount applied to the given Category associated to an Ad Set. At most 4 decimals are supported. Additional decimals are rounded.", "format": "double", "nullable": true }, "categoryName": { "type": "string", "description": "The name of the Category to which the Category Bid has been applied.", "nullable": true } }, "description": "Category Bid information about a Category for a given Ad Set.", "nullable": true }, "AdSetCategoryBidListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AdSetCategoryBidResource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "Data model for a list of response resources" }, "AdSetCategoryBidResource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AdSetCategoryBid" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "description": "Canonical type name of the entity", "nullable": true, "example": "AdSetCategoryBid" } }, "description": "Data model for a Resource" }, "AdSetDeliveryLimitationsV24Q3": { "type": "object", "properties": { "devices": { "type": "array", "items": { "enum": [ "other", "desktop", "mobile", "tablet" ], "type": "string" }, "nullable": true }, "environments": { "type": "array", "items": { "enum": [ "web", "inApp" ], "type": "string" }, "nullable": true }, "operatingSystems": { "type": "array", "items": { "enum": [ "android", "ios", "unknown" ], "type": "string" }, "nullable": true } }, "description": "ad set delivery limitations model", "nullable": true }, "AdSetDisplayMultiplier": { "type": "object", "properties": { "categoryName": { "type": "string", "description": "The name of the Category to which the given for which the Display Multiplier has been applied.", "nullable": true }, "displayMultiplier": { "type": "number", "description": "The Display Multiplier applied to the given Category associated to an Ad Set.", "format": "double", "nullable": true } }, "description": "Display Multiplier information about a Category for a given Ad Set.", "nullable": true }, "AdSetDisplayMultiplierListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AdSetDisplayMultiplierResource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "Data model for a list of response resources" }, "AdSetDisplayMultiplierResource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AdSetDisplayMultiplier" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "description": "Canonical type name of the entity", "nullable": true, "example": "AdSetDisplayMultiplier" } }, "description": "Data model for a Resource" }, "AdSetFrequencyCappingV24Q3": { "type": "object", "properties": { "frequency": { "enum": [ "hourly", "daily", "lifetime", "advanced" ], "type": "string", "nullable": true }, "maximumImpressions": { "type": "integer", "format": "int32", "nullable": true } }, "description": "ad set frequency capping model", "nullable": true }, "AdSetGeoLocationV24Q3": { "type": "object", "properties": { "countries": { "$ref": "#/components/schemas/NillableAdSetTargetingRuleV24Q3" }, "subdivisions": { "$ref": "#/components/schemas/NillableAdSetTargetingRuleV24Q3" }, "zipCodes": { "$ref": "#/components/schemas/NillableAdSetTargetingRuleV24Q3" } }, "description": "ad set geolocation model", "nullable": true }, "AdSetIdV24Q3": { "type": "object", "description": "ad set id model", "nullable": true }, "AdSetSearchFilterV24Q3": { "type": "object", "properties": { "adSetIds": { "type": "array", "items": { "type": "string" }, "nullable": true }, "advertiserIds": { "type": "array", "items": { "type": "string" }, "nullable": true }, "campaignIds": { "type": "array", "items": { "type": "string" }, "nullable": true } }, "description": "filter on ad set ids" }, "AdSetSearchRequestV24Q3": { "type": "object", "properties": { "filters": { "$ref": "#/components/schemas/AdSetSearchFilterV24Q3" } }, "description": "request payload of the search endpoint" }, "AdSetTargetingRuleV24Q3": { "type": "object", "properties": { "operand": { "enum": [ "undefined", "in", "notIn" ], "type": "string" }, "values": { "type": "array", "items": { "type": "string" }, "nullable": true } }, "description": "ad set targeting rule model" }, "AdSetTargetingV24Q3": { "type": "object", "properties": { "deliveryLimitations": { "$ref": "#/components/schemas/AdSetDeliveryLimitationsV24Q3" }, "frequencyCapping": { "type": "object", "properties": { "value": { "$ref": "#/components/schemas/AdSetFrequencyCappingV24Q3" } }, "nullable": true }, "geoLocation": { "$ref": "#/components/schemas/AdSetGeoLocationV24Q3" } }, "description": "ad set targeting model", "nullable": true }, "AdWrite": { "required": [ "adSetId", "creativeId", "name", "startDate" ], "type": "object", "properties": { "adSetId": { "type": "string", "description": "The id of the Ad Set bound to this Ad" }, "creativeId": { "type": "string", "description": "The id of the Creative bound to this Ad" }, "description": { "type": "string", "description": "The description of the ad", "nullable": true }, "endDate": { "type": "string", "description": "The date when when we will stop to show this ad. If the end date is not specified (i.e. null) then the ad will go on forever\r\nString must be in ISO8601 format", "nullable": true }, "inventoryType": { "enum": [ "Display", "Native" ], "type": "string", "description": "The inventory the Ad to be created or updated belongs to. Possible values are \"Display\" and \"Native\". This is optional since this doesn't make sense for every creative type but will throw an error if not set for a dynamic creative.", "nullable": true }, "name": { "type": "string", "description": "The name of the ad" }, "startDate": { "type": "string", "description": "The date when the ad will be launched\r\nString must be in ISO8601 format" } }, "description": "Entity to create or update an ad" }, "AlgebraNodeV1": { "type": "object", "properties": { "and": { "type": "array", "items": { "$ref": "#/components/schemas/AlgebraNodeV1" }, "nullable": true }, "audienceSegmentId": { "type": "string", "nullable": true }, "not": { "$ref": "#/components/schemas/AlgebraNodeV1" }, "or": { "type": "array", "items": { "$ref": "#/components/schemas/AlgebraNodeV1" }, "nullable": true } }, "description": "Node in the audience algebra definition.", "nullable": true }, "ApplicationSummaryModel": { "type": "object", "properties": { "applicationId": { "type": "integer", "format": "int32", "nullable": true }, "criteoService": { "type": "string", "nullable": true }, "description": { "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "organizationId": { "type": "integer", "format": "int32", "nullable": true } }, "description": "Used for the /me endpoint. Contains information about the currently authenticated application that we accept to give to our clients", "nullable": true }, "ApplicationSummaryModelResource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/ApplicationSummaryModel" }, "type": { "type": "string", "nullable": true } }, "description": "A top-level object that encapsulates a Criteo API response for a single value", "nullable": true }, "ApplicationSummaryModelResponse": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ApplicationSummaryModelResource" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for a single value" }, "AudienceBulkCreateInputV1": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceCreateEntityV1Resource" } } }, "description": "Input to create one or more audiences." }, "AudienceBulkDeleteInputV1": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceDeleteEntityV1Resource" } } }, "description": "Input to delete one or more audiences." }, "AudienceBulkUpdateInputV1": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceUpdateEntityV1Resource" } } }, "description": "Input to update one or more audiences." }, "AudienceComputeSizeEntityV1": { "type": "object", "description": "Audience of people of interest for a marketer.", "x-criteo-canonical": { "infoType": "entity", "name": "Audience", "version": "v1" } }, "AudienceComputeSizeEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceComputeSizeEntityV1" }, "id": { "type": "string", "description": "Id of the entity" }, "type": { "type": "string" } }, "description": "A class that represents a domain entity exposed by an API" }, "AudienceComputeSizesInputV1": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceComputeSizeEntityV1Resource" } } }, "description": "Input to retrieve the size of one or more audiences." }, "AudienceCreateEntityV1": { "required": [ "advertiserId", "algebra", "name" ], "type": "object", "properties": { "advertiserId": { "type": "string", "description": "Advertiser associated to the audience" }, "algebra": { "$ref": "#/components/schemas/AlgebraNodeV1" }, "description": { "type": "string", "description": "Description of the audience" }, "name": { "type": "string", "description": "Name of the audience" } }, "description": "Audience of people of interest for a marketer." }, "AudienceCreateEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceCreateEntityV1" }, "type": { "type": "string" } }, "description": "A top-level object that encapsulates a Criteo API response for a single value" }, "AudienceDeleteEntityV1": { "type": "object", "description": "Audience to delete", "x-criteo-canonical": { "infoType": "entity", "name": "Audience", "version": "v1" } }, "AudienceDeleteEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceDeleteEntityV1" }, "id": { "type": "string", "description": "Id of the entity" }, "type": { "type": "string" } }, "description": "A class that represents a domain entity exposed by an API" }, "AudienceEntityV1": { "type": "object", "properties": { "adSetIds": { "uniqueItems": true, "type": "array", "items": { "type": "string" }, "description": "Ad sets associated to the audience", "nullable": true }, "advertiserId": { "type": "string", "description": "Advertiser associated to the audience", "nullable": true }, "algebra": { "$ref": "#/components/schemas/AlgebraNodeV1" }, "createdAt": { "type": "string", "description": "ISO-8601 timestamp in UTC of audience creation (read-only)", "format": "date-time", "nullable": true }, "description": { "type": "string", "description": "Description of the audience", "nullable": true }, "name": { "type": "string", "description": "Name of the audience", "nullable": true }, "updatedAt": { "type": "string", "description": "ISO-8601 timestamp in UTC of audience update (read-only)", "format": "date-time", "nullable": true } }, "description": "Audience of people of interest for a marketer.", "nullable": true, "x-criteo-canonical": { "infoType": "entity", "name": "Audience", "version": "v1" } }, "AudienceEntityV1AudienceSearchMetadataV1ListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceEntityV1Resource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "meta": { "$ref": "#/components/schemas/AudienceSearchMetadataV1" }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for several entities and metadata" }, "AudienceEntityV1ListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceEntityV1Resource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for several entities" }, "AudienceEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceEntityV1" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API" }, "AudienceError": { "required": [ "code", "instance", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "(REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case." }, "detail": { "type": "string", "description": "(RECOMMENDED) A human-readable explanation specific to this occurrence of the problem", "nullable": true }, "instance": { "type": "string", "description": "(REQUIRED) A URI reference that identifies the specific occurrence of the problem" }, "source": { "type": "object", "description": "(OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s)", "nullable": true }, "stackTrace": { "type": "array", "items": { "type": "string" }, "description": "(NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology", "nullable": true }, "title": { "type": "string", "description": "(RECOMMENDED) A short, human-readable summary of the problem type", "nullable": true }, "traceId": { "type": "string", "description": "(REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem.", "nullable": true }, "type": { "enum": [ "access-control", "authentication", "authorization", "availability", "deprecation", "quota", "validation" ], "type": "string", "description": "(REQUIRED) The classification of the error" } }, "description": "Definition of an audience error" }, "AudienceEstimateSizeEntityV1": { "required": [ "advertiserId", "algebra" ], "type": "object", "properties": { "advertiserId": { "type": "string", "description": "Advertiser associated to the audience" }, "algebra": { "$ref": "#/components/schemas/AlgebraNodeV1" } }, "description": "Audience of people of interest for a marketer." }, "AudienceEstimateSizeEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceEstimateSizeEntityV1" }, "type": { "type": "string" } }, "description": "A top-level object that encapsulates a Criteo API response for a single value" }, "AudienceEstimateSizeInputV1": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AudienceEstimateSizeEntityV1Resource" } }, "description": "Input to estimate the size of an audience." }, "AudienceIdEntityV1": { "type": "object", "description": "Audience entity with only its ID", "nullable": true, "x-criteo-canonical": { "infoType": "entity", "name": "Audience", "version": "v1" } }, "AudienceIdEntityV1ListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceIdEntityV1Resource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for several entities" }, "AudienceIdEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceIdEntityV1" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API" }, "AudienceNameDescription": { "type": "object", "properties": { "description": { "type": "string", "description": "The description of the audience", "nullable": true }, "name": { "type": "string", "description": "The name to designate the audience by", "nullable": true } }, "description": "Description of an audience with name and detailed description", "nullable": true }, "AudienceSearchEntityV1": { "type": "object", "properties": { "adSetIds": { "type": "array", "items": { "type": "string" }, "description": "List of AdSet ids" }, "advertiserIds": { "type": "array", "items": { "type": "string" }, "description": "List of advertiser ids" }, "audienceIds": { "type": "array", "items": { "type": "string" }, "description": "List of audience ids" }, "audienceSegmentIds": { "type": "array", "items": { "type": "string" }, "description": "List of segment ids (linked to the result audiences)" } }, "description": "Available filters to perform a search on segments. If present, the filters are AND'ed together when applied." }, "AudienceSearchEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceSearchEntityV1" }, "type": { "type": "string" } }, "description": "A top-level object that encapsulates a Criteo API response for a single value" }, "AudienceSearchInputV1": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AudienceSearchEntityV1Resource" } }, "description": "Audience search parameter" }, "AudienceSearchMetadataV1": { "type": "object", "properties": { "limit": { "type": "integer", "description": "Max item of the current page", "format": "int32", "nullable": true }, "offset": { "type": "integer", "description": "Number of item to skip", "format": "int32", "nullable": true }, "totalItems": { "type": "integer", "description": "Total number of items", "format": "int32", "nullable": true } }, "description": "Metadata for the audience search response.", "nullable": true }, "AudienceSegmentBulkCreateInputV1": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceSegmentCreateEntityV1Resource" } } }, "description": "Input to create one or more audience segments." }, "AudienceSegmentBulkDeleteInputV1": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceSegmentDeleteEntityV1Resource" } } }, "description": "Input to delete one or more segments." }, "AudienceSegmentBulkUpdateInputV1": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceSegmentUpdateEntityV1Resource" } } }, "description": "Input to update one or more segments." }, "AudienceSegmentComputeSizeEntityV1": { "type": "object", "description": "Set of rules that defines specific people to target.", "x-criteo-canonical": { "infoType": "entity", "name": "AudienceSegment", "version": "v1" } }, "AudienceSegmentComputeSizeEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceSegmentComputeSizeEntityV1" }, "id": { "type": "string", "description": "Id of the entity" }, "type": { "type": "string" } }, "description": "A class that represents a domain entity exposed by an API" }, "AudienceSegmentComputeSizesInputV1": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceSegmentComputeSizeEntityV1Resource" } } }, "description": "Input to retrieve the size of one or more segments." }, "AudienceSegmentCreateEntityV1": { "required": [ "advertiserId", "name" ], "type": "object", "properties": { "advertiserId": { "type": "string", "description": "Advertiser associated to the segment" }, "contactList": { "$ref": "#/components/schemas/ContactListCreateV1" }, "description": { "type": "string", "description": "Description of the segment" }, "inMarket": { "$ref": "#/components/schemas/InMarketCreateV1" }, "location": { "$ref": "#/components/schemas/LocationCreateV1" }, "lookalike": { "$ref": "#/components/schemas/LookalikeCreateV1" }, "name": { "type": "string", "description": "Name of the segment" }, "prospecting": { "$ref": "#/components/schemas/ProspectingCreateV1" }, "retargeting": { "$ref": "#/components/schemas/RetargetingCreateV1" } }, "description": "Set of rules that defines specific people to target." }, "AudienceSegmentCreateEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceSegmentCreateEntityV1" }, "type": { "type": "string" } }, "description": "A top-level object that encapsulates a Criteo API response for a single value" }, "AudienceSegmentDeleteEntityV1": { "type": "object", "description": "Segment to delete", "x-criteo-canonical": { "infoType": "entity", "name": "AudienceSegment", "version": "v1" } }, "AudienceSegmentDeleteEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceSegmentDeleteEntityV1" }, "id": { "type": "string", "description": "Id of the entity" }, "type": { "type": "string" } }, "description": "A class that represents a domain entity exposed by an API" }, "AudienceSegmentEntityV1": { "type": "object", "properties": { "advertiserId": { "type": "string", "description": "Advertiser associated to the segment", "nullable": true }, "behavioral": { "$ref": "#/components/schemas/BehavioralV1" }, "contactList": { "$ref": "#/components/schemas/ContactListV1" }, "createdAt": { "type": "string", "description": "ISO-8601 timestamp in UTC of segment creation (read-only)", "format": "date-time", "nullable": true }, "description": { "type": "string", "description": "Description of the segment", "nullable": true }, "inMarket": { "$ref": "#/components/schemas/InMarketV1" }, "location": { "$ref": "#/components/schemas/LocationV1" }, "lookalike": { "$ref": "#/components/schemas/LookalikeV1" }, "name": { "type": "string", "description": "Name of the segment", "nullable": true }, "prospecting": { "$ref": "#/components/schemas/ProspectingV1" }, "retargeting": { "$ref": "#/components/schemas/RetargetingV1" }, "type": { "enum": [ "Unknown", "InMarket", "Prospecting", "ContactList", "Location", "Behavioral", "Retargeting", "Lookalike" ], "type": "string", "description": "Type of segment (read-only)", "nullable": true }, "updatedAt": { "type": "string", "description": "ISO-8601 timestamp in UTC of segment update (read-only)", "format": "date-time", "nullable": true } }, "description": "Set of rules that defines specific people to target.", "nullable": true, "x-criteo-canonical": { "infoType": "entity", "name": "AudienceSegment", "version": "v1" } }, "AudienceSegmentEntityV1AudienceSegmentSearchMetadataV1ListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceSegmentEntityV1Resource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "meta": { "$ref": "#/components/schemas/AudienceSegmentSearchMetadataV1" }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for several entities and metadata" }, "AudienceSegmentEntityV1ListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceSegmentEntityV1Resource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for several entities" }, "AudienceSegmentEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceSegmentEntityV1" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API" }, "AudienceSegmentEstimateSizeInputV1": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AudienceSegmentSizeEstimationEntityV1Resource" } }, "description": "Input to estimate the size of an audience segment.." }, "AudienceSegmentIdEntityV1": { "type": "object", "description": "Audience Segment entity only with its ID", "nullable": true, "x-criteo-canonical": { "infoType": "entity", "name": "AudienceSegment", "version": "v1" } }, "AudienceSegmentIdEntityV1ListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceSegmentIdEntityV1Resource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for several entities" }, "AudienceSegmentIdEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceSegmentIdEntityV1" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API" }, "AudienceSegmentSearchEntityV1": { "type": "object", "properties": { "advertiserIds": { "type": "array", "items": { "type": "string" }, "description": "List of advertiser ids" }, "audienceSegmentIds": { "type": "array", "items": { "type": "string" }, "description": "List of segment ids" }, "audienceSegmentTypes": { "type": "array", "items": { "enum": [ "Unknown", "InMarket", "Prospecting", "ContactList", "Location", "Behavioral", "Retargeting", "Lookalike" ], "type": "string" }, "description": "List of segment types" } }, "description": "Available filters to perform a search on audience segments. If present, the filters are AND'ed together when applied." }, "AudienceSegmentSearchEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceSegmentSearchEntityV1" }, "type": { "type": "string" } }, "description": "A top-level object that encapsulates a Criteo API response for a single value" }, "AudienceSegmentSearchInputV1": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AudienceSegmentSearchEntityV1Resource" } }, "description": "Audience segment search parameter" }, "AudienceSegmentSearchMetadataV1": { "type": "object", "properties": { "limit": { "type": "integer", "description": "Max item of the current page", "format": "int32", "nullable": true }, "offset": { "type": "integer", "description": "Number of item to skip", "format": "int32", "nullable": true }, "totalItems": { "type": "integer", "description": "Total number of items", "format": "int32", "nullable": true } }, "description": "Metadata for the audience segment search response.", "nullable": true }, "AudienceSegmentSizeEntityV1": { "type": "object", "properties": { "size": { "type": "integer", "format": "int64", "nullable": true } }, "description": "Set of rules that defines specific people to target.", "nullable": true, "x-criteo-canonical": { "infoType": "entity", "name": "AudienceSegmentSize", "version": "v1" } }, "AudienceSegmentSizeEntityV1ListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceSegmentSizeEntityV1Resource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for several entities" }, "AudienceSegmentSizeEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceSegmentSizeEntityV1" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API" }, "AudienceSegmentSizeEstimationEntityV1": { "required": [ "advertiserId" ], "type": "object", "properties": { "advertiserId": { "type": "string", "description": "Advertiser associated to the segment" }, "inMarket": { "$ref": "#/components/schemas/InMarketSizeEstimationV1" }, "location": { "$ref": "#/components/schemas/LocationSizeEstimationV1" } }, "description": "Set of rules that defines specific people to target." }, "AudienceSegmentSizeEstimationEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceSegmentSizeEstimationEntityV1" }, "type": { "type": "string" } }, "description": "A top-level object that encapsulates a Criteo API response for a single value" }, "AudienceSegmentSizeEstimationV1": { "type": "object", "properties": { "size": { "type": "integer", "format": "int64", "nullable": true } }, "description": "Segment size estimation", "nullable": true }, "AudienceSegmentSizeEstimationV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceSegmentSizeEstimationV1" }, "type": { "type": "string", "nullable": true } }, "description": "A top-level object that encapsulates a Criteo API response for a single value", "nullable": true }, "AudienceSegmentSizeEstimationV1Response": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AudienceSegmentSizeEstimationV1Resource" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for a single value" }, "AudienceSegmentUpdateEntityV1": { "type": "object", "properties": { "description": { "$ref": "#/components/schemas/NillableString" }, "inMarket": { "$ref": "#/components/schemas/InMarketUpdateV1" }, "location": { "$ref": "#/components/schemas/LocationUpdateV1" }, "lookalike": { "$ref": "#/components/schemas/LookalikeUpdateV1" }, "name": { "type": "string", "description": "Name of the segment" }, "prospecting": { "$ref": "#/components/schemas/ProspectingUpdateV1" }, "retargeting": { "$ref": "#/components/schemas/RetargetingUpdateV1" } }, "description": "Set of rules that defines specific people to target.", "x-criteo-canonical": { "infoType": "entity", "name": "AudienceSegment", "version": "v1" } }, "AudienceSegmentUpdateEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceSegmentUpdateEntityV1" }, "id": { "type": "string", "description": "Id of the entity" }, "type": { "type": "string" } }, "description": "A class that represents a domain entity exposed by an API" }, "AudienceSizeEntityV1": { "type": "object", "properties": { "size": { "type": "integer", "format": "int64", "nullable": true } }, "description": "Audience entity only with its size", "nullable": true, "x-criteo-canonical": { "infoType": "entity", "name": "AudienceSize", "version": "v1" } }, "AudienceSizeEntityV1ListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceSizeEntityV1Resource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for several entities" }, "AudienceSizeEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceSizeEntityV1" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API" }, "AudienceSizeEstimationV1": { "type": "object", "properties": { "size": { "type": "integer", "format": "int64", "nullable": true } }, "description": "Audience size estimation", "nullable": true }, "AudienceSizeEstimationV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceSizeEstimationV1" }, "type": { "type": "string", "nullable": true } }, "description": "A top-level object that encapsulates a Criteo API response for a single value", "nullable": true }, "AudienceSizeEstimationV1Response": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/AudienceSizeEstimationV1Resource" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for a single value" }, "AudienceUpdateEntityV1": { "type": "object", "properties": { "algebra": { "$ref": "#/components/schemas/AlgebraNodeV1" }, "description": { "$ref": "#/components/schemas/NillableString" }, "name": { "type": "string", "description": "Name of the audience" } }, "description": "Audience of people of interest for a marketer.", "x-criteo-canonical": { "infoType": "entity", "name": "Audience", "version": "v1" } }, "AudienceUpdateEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceUpdateEntityV1" }, "id": { "type": "string", "description": "Id of the entity" }, "type": { "type": "string" } }, "description": "A class that represents a domain entity exposed by an API" }, "AudienceWarning": { "required": [ "code", "detail", "instance", "type" ], "type": "object", "properties": { "code": { "type": "string", "description": "(REQUIRED) A machine-readable unique error code, expressed as a string value. The format used must be kebab-case." }, "detail": { "type": "string", "description": "(REQUIRED) A human-readable explanation specific to this occurrence of the problem" }, "instance": { "type": "string", "description": "(REQUIRED) A URI reference that identifies the specific occurrence of the problem" }, "source": { "type": "object", "description": "(OPTIONAL) A machine-readable structure to reference to the exact location(s) causing the error(s)", "nullable": true }, "stackTrace": { "type": "array", "items": { "type": "string" }, "description": "(NEVER IN PRODUCTION) A human-readable stacktrace produced by the implementation technology", "nullable": true }, "title": { "type": "string", "description": "(RECOMMENDED) A short, human-readable summary of the problem type", "nullable": true }, "traceId": { "type": "string", "description": "(REQUIRED) The Correlation ID provided by the Gateway. It is also a unique identifier for this particular occurrence of the problem.", "nullable": true }, "type": { "enum": [ "access-control", "authentication", "authorization", "availability", "deprecation", "quota", "validation" ], "type": "string", "description": "(REQUIRED) The classification of the error" } }, "description": "Definition of the warning" }, "AutomatedBudgetConfigurationV23Q1": { "type": "object", "properties": { "adSetOptimizationObjective": { "enum": [ "conversions", "revenue", "visits", "videoViews" ], "type": "string", "description": "Optimization objective used to automate budget allocation across ad sets.\r\nExpected when budgetAutomation.enabled is true.\r\nPossible values are \"conversions\", \"revenue\", \"visits\", and \"videoViews\".", "nullable": true } }, "description": "Detailed configuration used when campaign budget automation is enabled.", "nullable": true }, "BasicAudienceDefinition": { "required": [ "id", "type" ], "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AudienceNameDescription" }, "id": { "type": "string", "description": "the id of the entity type" }, "type": { "type": "string", "description": "the name of the entity type" } }, "description": "Common definition of an audience" }, "BehavioralV1": { "required": [ "category" ], "type": "object", "properties": { "category": { "enum": [ "Unknown", "Lifestyles", "LifeEvents", "Seasonal", "BuyingPatterns" ], "type": "string", "description": "The type of behavioral" }, "country": { "type": "string", "description": "The users' country", "nullable": true }, "endDate": { "type": "string", "description": "Desired date when the behavioral will end", "format": "date-time", "nullable": true }, "startDate": { "type": "string", "description": "Desired date when the behavioral will start", "format": "date-time", "nullable": true } }, "description": "Settings of a behavioral set of users provided by Criteo.", "nullable": true }, "BudgetAutomation": { "type": "object", "properties": { "budgetConfiguration": { "$ref": "#/components/schemas/BudgetAutomationConfiguration" }, "enabled": { "type": "boolean", "description": "Whether budget automation is active for this marketing campaign.\r\n- true: budget automation is enabled and \"budgetConfiguration\" must be provided with a valid objective.\r\n- false (default when omitted): budget automation is disabled; \"budgetConfiguration\" is ignored if provided." } }, "description": "Budget automation, lets users configure budgets once at the campaign level while Criteo dynamically routes spend toward the best-performing ad sets.\r\nIf \"enabled\" is omitted and only \"budgetConfiguration\" is provided, \"enabled\" defaults to false — budget automation will not be activated.\r\nTo activate budget automation at creation, \"enabled\" must be explicitly set to true along with a valid \"budgetConfiguration\".\r\nIf the entire \"budgetAutomation\" object is omitted from the create request, the campaign is created with budget automation disabled." }, "BudgetAutomationConfiguration": { "type": "object", "properties": { "adSetObjectives": { "enum": [ "conversions", "revenue", "visits", "videoViews" ], "type": "string", "description": "The ad set optimization objective for budget automation. Determines how the automated budget allocates spend across ad sets in the campaign.\r\n- \"conversions\": optimize for conversion events.\r\n- \"revenue\": optimize for revenue.\r\n- \"visits\": optimize for site visits.\r\n- \"videoViews\": optimize for completed video views." } }, "description": "Configuration for budget automation. Only meaningful when \"enabled\" is true.\r\nWhen \"enabled\" is false or omitted, this field is ignored.", "nullable": true }, "CampaignBudgetAutomationV23Q1": { "type": "object", "properties": { "automatedBudgetConfiguration": { "$ref": "#/components/schemas/AutomatedBudgetConfigurationV23Q1" }, "enabled": { "type": "boolean", "description": "Whether budget automation is enabled for this campaign. This field is always present in the response.", "nullable": true } }, "description": "Budget automation, also known as automated budget or budget pacing, lets users configure KPIs and budgets once at the campaign level while Criteo dynamically routes spend toward the best-performing ad sets.\r\nWhen enabled is false, automatedBudgetConfiguration is null.\r\nWhen enabled is true, automatedBudgetConfiguration.adSetOptimizationObjective is expected.", "nullable": true }, "CampaignSearchFiltersV23Q1": { "type": "object", "properties": { "advertiserIds": { "type": "array", "items": { "type": "string" }, "description": "Advertiser IDs to filter on (string-encoded integers).", "nullable": true }, "campaignIds": { "type": "array", "items": { "type": "string" }, "description": "Campaign IDs to filter on (string-encoded integers).", "nullable": true } }, "description": "Filters for searching campaigns.\r\n \r\nMultiple filters are combined with an implicit AND operation.\r\nIdentifiers are string-encoded integers; invalid values are ignored.\r\nIf no filter is provided (both arrays are null or empty), the search returns all accessible campaigns." }, "CampaignSearchRequestV23Q1": { "type": "object", "properties": { "filters": { "$ref": "#/components/schemas/CampaignSearchFiltersV23Q1" } }, "description": "Request payload for the campaign search endpoint." }, "CampaignSpendLimitV23Q1": { "type": "object", "properties": { "spendLimitAmount": { "$ref": "#/components/schemas/NillableDecimal" }, "spendLimitRenewal": { "enum": [ "undefined", "daily", "monthly", "lifetime" ], "type": "string", "description": "The period over which the campaign spend limit is applied.\r\nWhen spendLimitType is \"capped\", this is \"daily\", \"monthly\", or \"lifetime\".\r\nWhen spendLimitType is \"uncapped\", this is \"undefined\".", "nullable": true }, "spendLimitType": { "enum": [ "capped", "uncapped" ], "type": "string", "description": "Controls whether the campaign has a spend limit.\r\n\"capped\" returns a non-null spendLimitAmount.value and a spendLimitRenewal of \"daily\", \"monthly\", or \"lifetime\".\r\n\"uncapped\" returns spendLimitAmount.value as null and spendLimitRenewal as \"undefined\".", "nullable": true } }, "description": "Campaign spend-limit configuration. A capped spend limit restricts campaign spending per renewal period. An uncapped spend limit does not impose a spending ceiling.", "nullable": true }, "CampaignV23Q1": { "type": "object", "properties": { "advertiserId": { "type": "string", "description": "Advertiser id of the campaign (string-encoded integer)", "nullable": true }, "budgetAutomation": { "$ref": "#/components/schemas/CampaignBudgetAutomationV23Q1" }, "goal": { "enum": [ "unspecified", "acquisition", "retention" ], "type": "string", "description": "Goal of the campaign\r\n \r\nSerialized values are {unspecified}, {acquisition} and {retention}.\r\n \r\nAcquisition and retention are defined as follows:\r\n- Acquisition: campaign with the goal of acquiring new customers. The success of an acquisition campaign is measured by the number of new customers it brings.\r\n- Retention: campaign with the goal of retaining existing customers. The success of a retention campaign is measured by the number of existing customers it retains.", "nullable": true }, "id": { "type": "string", "description": "Id of the entity (duplicate of the parent id).", "nullable": true }, "name": { "type": "string", "description": "Name of the campaign", "nullable": true }, "spendLimit": { "$ref": "#/components/schemas/CampaignSpendLimitV23Q1" } }, "description": "Campaign read model\r\n \r\nThe {id} field is the campaign identifier (string-encoded integer).", "nullable": true }, "CampaignV23Q1ListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/CampaignV23Q1Resource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "Data model for a list of response resources" }, "CampaignV23Q1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/CampaignV23Q1" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "description": "Canonical type name of the entity", "nullable": true, "example": "Campaign" } }, "description": "Data model for a Resource", "nullable": true }, "CampaignV23Q1Response": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/CampaignV23Q1Resource" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "Data model for response resource" }, "CommonProblem": { "type": "object", "properties": { "code": { "type": "string", "description": "A machine-readable error code, expressed as a string value.", "nullable": true }, "detail": { "type": "string", "description": "A human-readable explanation specific to this occurrence of the problem", "nullable": true }, "instance": { "type": "string", "description": "A URI that identifies the specific occurrence of the problem.", "nullable": true }, "source": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A machine-readable structure to reference to the exact location(s) causing the error(s)", "nullable": true }, "stackTrace": { "type": "string", "nullable": true }, "title": { "type": "string", "description": "A short human-readable description of the problem type", "nullable": true }, "traceId": { "type": "string", "description": "The request correlation ID this problem comes from.", "nullable": true }, "traceIdentifier": { "type": "string", "description": "The request correlation ID this problem comes from. (deprecated, use traceId instead)", "nullable": true }, "type": { "enum": [ "unknown", "access-control", "authentication", "authorization", "availability", "deprecation", "quota", "validation" ], "type": "string", "description": "The problem's category.", "nullable": true } }, "description": "Common problem object." }, "ContactlistAmendment": { "required": [ "attributes", "type" ], "type": "object", "properties": { "attributes": { "required": [ "identifiers", "operation" ], "type": "object", "properties": { "gumCallerId": { "type": "integer", "description": "The Gum caller id of the advertiser patching identifiers of type Gum" }, "identifiers": { "type": "array", "items": { "type": "string" }, "description": "The users to add or remove, each in the schema specified" }, "identifierType": { "enum": [ "email", "madid", "identityLink", "gum", "phoneNumber" ], "type": "string", "description": "What type of identifiers are used" }, "operation": { "enum": [ "add", "remove" ], "type": "string", "description": "Operation to add or remove users" } }, "description": "the name of the entity type" }, "type": { "type": "string", "description": "User List", "example": "ContactlistAmendment" } }, "description": "Parameters for the amendment of a contactlist" }, "ContactlistAmendmentRequest": { "required": [ "data" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ContactlistAmendment" } }, "description": "Request for a contactlist amendment" }, "ContactListCreateV1": { "type": "object", "description": "Settings to target users with your contact lists." }, "ContactlistOperation": { "required": [ "attributes", "type" ], "type": "object", "properties": { "attributes": { "required": [ "operation" ], "type": "object", "properties": { "contactListId": { "type": "integer", "description": "the affected user list id", "nullable": true }, "identifierType": { "type": "string", "description": "The schema specified for of the identifiers", "nullable": true }, "nbInvalidIdentifiers": { "type": "integer", "description": "How many identifiers were invalid for the specified schema", "nullable": true }, "nbValidIdentifiers": { "type": "integer", "description": "How many identifiers were valid for the specified schema", "nullable": true }, "operation": { "type": "string", "description": "The action recorded" }, "requestDate": { "type": "string", "description": "When the action was recorded", "format": "date-time", "nullable": true }, "sampleInvalidIdentifiers": { "type": "array", "items": { "type": "string" }, "description": "A sample of invalid identifiers if there is some", "nullable": true } }, "description": "the contactlist operation attributes" }, "type": { "type": "string", "description": "the name of the entity type" } }, "description": "Response definition of a contactlist operation" }, "ContactListStatisticsEntityV1": { "type": "object", "properties": { "matchRate": { "type": "number", "description": "Percentage of matched identifiers in the contact list.\r\nCan differ from matches/identifiers depending on the contact list type.", "format": "double", "nullable": true }, "numberOfIdentifiers": { "type": "integer", "description": "Number of identifiers in the contact list.", "format": "int32", "nullable": true }, "numberOfMatches": { "type": "integer", "description": "Number of matched identifiers in the contact list.", "format": "int32", "nullable": true } }, "description": "Contact list statistics.", "nullable": true, "x-criteo-canonical": { "infoType": "entity", "name": "ContactListStatistics", "version": "v1" } }, "ContactListStatisticsEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/ContactListStatisticsEntityV1" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API", "nullable": true }, "ContactListStatisticsEntityV1Response": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ContactListStatisticsEntityV1Resource" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for a single entity" }, "ContactListV1": { "type": "object", "properties": { "isReadOnly": { "type": "boolean", "description": "Is the segment read-only", "nullable": true } }, "description": "Settings to target users with your contact lists.", "nullable": true }, "Coupon": { "type": "object", "properties": { "adSetId": { "type": "string", "description": "The id of the Ad Set on which the Coupon is applied to", "nullable": true }, "advertiserId": { "type": "string", "description": "Advertiser linked to the Coupon", "nullable": true }, "author": { "type": "string", "description": "The login of the person who created this Coupon", "nullable": true }, "description": { "type": "string", "description": "The description of the Coupon", "nullable": true }, "endDate": { "type": "string", "description": "The date when when we will stop to show this Coupon. If the end date is not specified (i.e. null) then the Coupon will go on forever\r\nString must be in ISO8601 format", "nullable": true }, "format": { "type": "string", "description": "Format of the Coupon, it can have two values: \"FullFrame\" or \"LogoZone\"", "nullable": true }, "id": { "type": "string", "description": "Unique identifier (duplicate of the parent id).", "nullable": true }, "images": { "type": "array", "items": { "$ref": "#/components/schemas/ImageSlide" }, "description": "List of slides containing the image URLs", "nullable": true }, "landingPageUrl": { "type": "string", "description": "Web redirection of the landing page url", "nullable": true }, "name": { "type": "string", "description": "The name of the Coupon", "nullable": true }, "rotationsNumber": { "type": "integer", "description": "Number of rotations for the Coupons (from 1 to 10 times)", "format": "int32", "nullable": true }, "showDuration": { "type": "integer", "description": "Show Coupon for a duration of N seconds (between 1 and 5)", "format": "int32", "nullable": true }, "showEvery": { "type": "integer", "description": "Show the Coupon every N seconds (between 1 and 10)", "format": "int32", "nullable": true }, "startDate": { "type": "string", "description": "The date when the Coupon will be launched\r\nString must be in ISO8601 format", "nullable": true }, "status": { "type": "string", "description": "The status of the Coupon", "nullable": true } }, "description": "Coupons are static images applied on ad set which can be displayed within an ad and link to a landing page.", "nullable": true }, "CouponSupportedSizes": { "type": "object", "properties": { "fullFrame": { "type": "array", "items": { "type": "string" }, "description": "Array of FullFrame sizes as string in width x height format", "nullable": true }, "logoZone": { "type": "array", "items": { "type": "string" }, "description": "Array of LogoZone sizes as string in width x height format", "nullable": true } }, "description": "Entity containing the list of Coupon supported sizes", "nullable": true }, "CreateAdSetAttributionConfigurationV24Q3": { "type": "object", "properties": { "attributionMethod": { "enum": [ "unknown", "criteoAttribution", "googleAnalyticsLastClick", "googleAnalyticsDataDriven", "lastClick", "postClick" ], "type": "string", "description": "The attribution method." }, "lookbackWindow": { "enum": [ "unknown", "30M", "24H", "7D", "30D" ], "type": "string", "description": "The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick.", "nullable": true } }, "description": "Create model for an ad set's attribution configuration." }, "CreateAdSetBiddingV24Q3": { "required": [ "costController" ], "type": "object", "properties": { "bidAmount": { "type": "number", "description": "Decimal value target relating to the `bidStrategy` specified. May be `null` for strategies that do not require a target value. At most 4 decimals are supported. Additional decimals are rounded.", "format": "double", "nullable": true }, "costController": { "enum": [ "COS", "maxCPC", "CPI", "CPM", "CPO", "CPSV", "CPV", "dailyBudget", "targetCPM" ], "type": "string", "description": "How spend is controlled" } }, "description": "ad set bidding create model" }, "CreateAdSetBudgetV24Q3": { "required": [ "budgetStrategy" ], "type": "object", "properties": { "budgetAmount": { "type": "number", "format": "double", "nullable": true }, "budgetDeliverySmoothing": { "enum": [ "accelerated", "standard" ], "type": "string" }, "budgetDeliveryWeek": { "enum": [ "undefined", "mondayToSunday", "tuesdayToMonday", "wednesdayToTuesday", "thursdayToWednesday", "fridayToThursday", "saturdayToFriday", "sundayToSaturday" ], "type": "string" }, "budgetRenewal": { "enum": [ "undefined", "daily", "monthly", "lifetime", "weekly" ], "type": "string" }, "budgetStrategy": { "enum": [ "capped", "uncapped" ], "type": "string" } }, "description": "ad set budget create model" }, "CreateAdSetGeoLocationV24Q3": { "type": "object", "properties": { "countries": { "$ref": "#/components/schemas/AdSetTargetingRuleV24Q3" }, "subdivisions": { "$ref": "#/components/schemas/AdSetTargetingRuleV24Q3" }, "zipCodes": { "$ref": "#/components/schemas/AdSetTargetingRuleV24Q3" } }, "description": "Geolocation configuration of the ad set" }, "CreateAdSetScheduleV24Q3": { "required": [ "startDate" ], "type": "object", "properties": { "endDate": { "type": "string", "format": "date-time", "nullable": true }, "startDate": { "type": "string", "format": "date-time" } }, "description": "ad set schedule create model" }, "CreateAdSetTargetingV24Q3": { "required": [ "frequencyCapping" ], "type": "object", "properties": { "deliveryLimitations": { "$ref": "#/components/schemas/AdSetDeliveryLimitationsV24Q3" }, "frequencyCapping": { "$ref": "#/components/schemas/AdSetFrequencyCappingV24Q3" }, "geoLocation": { "$ref": "#/components/schemas/CreateAdSetGeoLocationV24Q3" } }, "description": "Targeting configuration of the ad set" }, "CreateAdSetV24Q3": { "required": [ "bidding", "campaignId", "datasetId", "mediaType", "name", "objective", "schedule", "targeting", "trackingCode" ], "type": "object", "properties": { "attributionConfiguration": { "$ref": "#/components/schemas/CreateAdSetAttributionConfigurationV24Q3" }, "bidding": { "$ref": "#/components/schemas/CreateAdSetBiddingV24Q3" }, "budget": { "$ref": "#/components/schemas/CreateAdSetBudgetV24Q3" }, "campaignId": { "type": "string", "description": "Campaign id this ad set belongs to", "nullable": true }, "datasetId": { "type": "string", "description": "Dataset id of this ad set" }, "mediaType": { "enum": [ "display", "video" ], "type": "string", "description": "Media type for the ad set" }, "name": { "type": "string", "description": "Name of the ad set", "nullable": true }, "objective": { "enum": [ "customAction", "clicks", "conversions", "displays", "appPromotion", "revenue", "storeConversions", "value", "reach", "visits", "videoViews" ], "type": "string", "description": "Objective of the ad set" }, "schedule": { "$ref": "#/components/schemas/CreateAdSetScheduleV24Q3" }, "targeting": { "$ref": "#/components/schemas/CreateAdSetTargetingV24Q3" }, "trackingCode": { "type": "string", "description": "The click tracking code associated to this Ad Set.", "nullable": true } }, "description": "ad set create model", "example": { "name": "test adset", "datasetId": "108002", "campaignId": "358313", "objective": "conversions", "schedule": { "startDate": "2026-04-04T16:21:06.3809615+02:00", "endDate": "2026-04-13T16:21:06.3809642+02:00" }, "bidding": { "costController": "dailyBudget" }, "targeting": { "deliveryLimitations": { "environments": [ "web" ], "devices": [ "desktop" ], "operatingSystems": [ "android" ] }, "geoLocation": { "countries": { "operand": "in", "values": [ "FR", "IT" ] } }, "frequencyCapping": { "frequency": "daily", "maximumImpressions": 1000 } }, "budget": { "budgetStrategy": "capped", "budgetRenewal": "weekly", "budgetDeliverySmoothing": "standard", "budgetDeliveryWeek": "mondayToSunday", "budgetAmount": 1000 }, "trackingCode": "Test123", "mediaType": "display", "attributionConfiguration": { "attributionMethod": "criteoAttribution" } } }, "CreateAdSetV24Q3Request": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/CreateAdSetV24Q3Resource" } }, "description": "Data model for an input resources" }, "CreateAdSetV24Q3Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/CreateAdSetV24Q3" }, "type": { "type": "string", "description": "Canonical type name of the entity", "example": "AdSet" } }, "description": "Data model for a Resource" }, "CreateCampaign": { "required": [ "advertiserId", "goal", "name", "spendLimit" ], "type": "object", "properties": { "advertiserId": { "type": "string", "description": "Advertiser ID this campaign belongs to (string-encoded integer).", "nullable": true }, "budgetAutomation": { "$ref": "#/components/schemas/BudgetAutomation" }, "goal": { "enum": [ "Unspecified", "Acquisition", "Retention" ], "type": "string", "description": "Goal of the campaign\r\n \r\nSerialized values are {Unspecified}, {Acquisition} and {Retention}.\r\n \r\nAcquisition and retention are defined as follows:\r\n- Acquisition: campaign with the goal of acquiring new customers. The success of an acquisition campaign is measured by the number of new customers it brings.\r\n- Retention: campaign with the goal of retaining existing customers. The success of a retention campaign is measured by the number of existing customers it retains." }, "name": { "type": "string", "description": "Name of the campaign", "nullable": true }, "spendLimit": { "$ref": "#/components/schemas/CreateCampaignSpendLimit" } }, "description": "Campaign create model." }, "CreateCampaignRequest": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/CreateCampaignResource" } }, "description": "Data model for an input resources" }, "CreateCampaignResource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/CreateCampaign" }, "type": { "type": "string", "description": "Canonical type name of the entity", "example": "Campaign" } }, "description": "Data model for a Resource" }, "CreateCampaignSpendLimit": { "required": [ "spendLimitType" ], "type": "object", "properties": { "spendLimitAmount": { "type": "number", "description": "Maximum spend amount in the advertiser's currency per renewal period. Non-null when capped. null when uncapped.", "format": "double", "nullable": true }, "spendLimitRenewal": { "enum": [ "undefined", "daily", "monthly", "lifetime" ], "type": "string", "description": "The period over which the spend limit is consumed.\r\n- \"daily\", \"monthly\": spend limit resets at the start of each period.\r\n- \"lifetime\": spend limit covers the entire campaign duration without resetting.\r\n- \"undefined\": only used when spendLimitType is \"uncapped\" (no renewal applies)." }, "spendLimitType": { "enum": [ "capped", "uncapped" ], "type": "string", "description": "Controls whether the campaign has a spending limit.\r\n- \"capped\": spending is limited to spendLimitAmount. Requires spendLimitAmount (non-null) and spendLimitRenewal (not \"undefined\").\r\n- \"uncapped\": no spending limit. spendLimitAmount is null and spendLimitRenewal is \"undefined\"." } }, "description": "Spend limit configuration for a marketing campaign. Controls how much can be spent and the renewal cadence.\r\nWhen spendLimitType is \"capped\": spendLimitAmount and spendLimitRenewal are required.\r\nWhen spendLimitType is \"uncapped\": spendLimitAmount is null and spendLimitRenewal is \"undefined\"." }, "CreateCoupon": { "required": [ "adSetId", "format", "images", "landingPageUrl", "name", "rotationsNumber", "showDuration", "showEvery", "startDate" ], "type": "object", "properties": { "adSetId": { "type": "string", "description": "The id of the Ad Set on which the Coupon is applied to" }, "description": { "type": "string", "description": "The description of the Coupon", "nullable": true }, "endDate": { "type": "string", "description": "The date when when we will stop to show this Coupon. If the end date is not specified (i.e. null) then the Coupon will go on forever\r\nString must be in ISO8601 format", "nullable": true }, "format": { "enum": [ "FullFrame", "LogoZone" ], "type": "string", "description": "Format of the Coupon, it can have two values: \"FullFrame\" or \"LogoZone\"" }, "images": { "type": "array", "items": { "$ref": "#/components/schemas/CreateImageSlide" }, "description": "List of slides containing the images as a base-64 encoded string" }, "landingPageUrl": { "type": "string", "description": "Web redirection of the landing page url" }, "name": { "type": "string", "description": "The name of the Coupon" }, "rotationsNumber": { "maximum": 10, "minimum": 1, "type": "integer", "description": "Number of rotations for the Coupons (from 1 to 10 times)", "format": "int32" }, "showDuration": { "maximum": 5, "minimum": 1, "type": "integer", "description": "Show Coupon for a duration of N seconds (between 1 and 5)", "format": "int32" }, "showEvery": { "maximum": 10, "minimum": 1, "type": "integer", "description": "Show the Coupon every N seconds (between 1 and 10)", "format": "int32" }, "startDate": { "type": "string", "description": "The date when the coupon will be launched\r\nString must be in ISO8601 format" } }, "description": "Entity to create a Coupon" }, "CreateImageSlide": { "type": "object", "properties": { "height": { "type": "integer", "description": "Height of the Coupon slide", "format": "int32" }, "slideBase64Strings": { "type": "array", "items": { "type": "string" }, "description": "Array of images of the same size as a base-64 encoded string", "nullable": true }, "width": { "type": "integer", "description": "Width of the Coupon slide", "format": "int32" } }, "description": "Slide containing the images of the same size as a base-64 encoded string" }, "Creative": { "required": [ "advertiserId", "author", "name", "status" ], "type": "object", "properties": { "adaptiveAttributes": { "$ref": "#/components/schemas/AdaptiveAttributes" }, "advertiserId": { "type": "string", "description": "Advertiser linked to the Creative" }, "author": { "type": "string", "description": "The login of the person who created this creative (" }, "datasetId": { "type": "string", "description": "Data set id linked to the Creative", "nullable": true }, "description": { "type": "string", "description": "The description of the creative", "nullable": true }, "dynamicAttributes": { "$ref": "#/components/schemas/DynamicAttributes" }, "format": { "type": "string", "description": "The format of the creative", "nullable": true }, "htmlTagAttributes": { "$ref": "#/components/schemas/HtmlTagAttributes" }, "id": { "type": "string", "description": "Unique identifier (duplicate of the parent id).", "nullable": true }, "imageAttributes": { "$ref": "#/components/schemas/ImageAttributes" }, "name": { "type": "string", "description": "The name of the creative" }, "status": { "type": "string", "description": "The status of the creative" } }, "description": "A creative is a project with the necessary information to display a creative", "nullable": true }, "CreativeRead": { "required": [ "advertiserId", "author", "name", "status" ], "type": "object", "properties": { "adaptiveAttributes": { "$ref": "#/components/schemas/AdaptiveReadAttributes" }, "advertiserId": { "type": "string", "description": "Advertiser linked to the Creative" }, "author": { "type": "string", "description": "The login of the person who created this creative (" }, "datasetId": { "type": "string", "description": "Data set id linked to the Creative", "nullable": true }, "description": { "type": "string", "description": "The description of the creative", "nullable": true }, "dynamicAttributes": { "$ref": "#/components/schemas/DynamicAttributes" }, "format": { "type": "string", "description": "The format of the creative", "nullable": true }, "htmlTagAttributes": { "$ref": "#/components/schemas/HtmlTagAttributes" }, "imageAttributes": { "$ref": "#/components/schemas/ImageAttributes" }, "name": { "type": "string", "description": "The name of the creative" }, "status": { "type": "string", "description": "The status of the creative" } }, "description": "A CreativeRead is a project with the necessary information to display a creative", "nullable": true }, "CreativeWrite": { "required": [ "datasetId", "format", "name" ], "type": "object", "properties": { "adaptiveWriteAttributes": { "$ref": "#/components/schemas/AdaptiveWriteAttributes" }, "datasetId": { "type": "string", "description": "Dataset linked to the Creative" }, "description": { "type": "string", "description": "The description of the creative", "nullable": true }, "dynamicWriteAttributes": { "$ref": "#/components/schemas/DynamicWriteAttributes" }, "format": { "enum": [ "Image", "HtmlTag", "Dynamic", "Adaptive" ], "type": "string", "description": "The format of the creative\r\nYou can use \"Image\", \" HtmlTag\", \"Dynamic\" or \"Adaptive\"" }, "htmlTagWriteAttributes": { "$ref": "#/components/schemas/HtmlTagWriteAttributes" }, "imageWriteAttributes": { "$ref": "#/components/schemas/ImageWriteAttributes" }, "name": { "type": "string", "description": "The name of the creative" } }, "description": "Entity to create or update a creative" }, "CriteoApiError": { "type": "object", "properties": { "code": { "enum": [ "internal-error", "deprecated-field", "endpoint-deprecated", "required-field", "invalid-date-format", "invalid", "invalid-ranged", "invalid-timespan" ], "type": "string", "description": "A machine-readable error code string in kabab-case. Unique across Criteo", "nullable": true, "example": "internal-error" }, "detail": { "type": "string", "description": "A human-readable explanation specific to this occurrence of the problem.", "nullable": true }, "instance": { "type": "string", "description": "A URI reference that identifies the specific occurrence of the problem", "nullable": true }, "source": { "type": "object", "additionalProperties": { "type": "string" }, "description": "A machine-readable structure to reference to the exact location(s) causing the error(s).", "nullable": true }, "title": { "type": "string", "description": "A short, human-readable remarks of the problem type.", "nullable": true }, "traceId": { "type": "string", "description": "The correlation ID provided by the gateway", "nullable": true }, "type": { "enum": [ "access_control", "authentication", "authorization", "availability", "deprecation", "quota", "validation" ], "type": "string", "description": "A machine-readable code specifying error category", "nullable": true, "example": "access_control" } }, "description": "Criteo API response error" }, "CriteoApiWarning": { "type": "object", "properties": { "code": { "enum": [ "internal-error", "deprecated-field", "endpoint-deprecated", "required-field", "invalid-date-format", "invalid", "invalid-ranged", "invalid-timespan" ], "type": "string", "description": "A machine-readable error code string in kabab-case. Unique across Criteo", "nullable": true, "example": "internal-error" }, "detail": { "type": "string", "description": "A human-readable explanation specific to this occurrence of the problem.", "nullable": true }, "instance": { "type": "string", "description": "A URI reference that identifies the specific occurrence of the problem", "nullable": true }, "title": { "type": "string", "description": "A short, human-readable remarks of the problem type.", "nullable": true }, "traceId": { "type": "string", "description": "The correlation ID provided by the gateway", "nullable": true }, "type": { "enum": [ "access_control", "authentication", "authorization", "availability", "deprecation", "quota", "validation" ], "type": "string", "description": "A machine-readable code specifying error category", "nullable": true, "example": "access_control" } }, "description": "Criteo API response warning" }, "DeleteAudienceContactListResponse": { "required": [ "data", "errors", "warnings" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/BasicAudienceDefinition" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceError" } }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceWarning" } } }, "description": "Response of a contactlist deletion" }, "DynamicAttributes": { "type": "object", "properties": { "bodyTextColor": { "type": "string", "description": "Color of the creative's body text\r\nValid hexadecimal color (e.g. \"AB00FF\")", "nullable": true }, "callsToAction": { "type": "array", "items": { "type": "string" }, "description": "A Call-to-Action (CTA) is an action-driven instruction to your audience intended to provoke an immediate\r\nresponse, such as “Buy now” or “Go!”.", "nullable": true }, "creativeBackgroundColor": { "type": "string", "description": "Color of the creative's background\r\nValid hexadecimal color (e.g. \"AB00FF\")", "nullable": true }, "logos": { "type": "array", "items": { "$ref": "#/components/schemas/ImageShape" }, "description": "Logo images uploaded on demostatic.criteo.com when deploying and then static.criteo.net", "nullable": true }, "pricesColor": { "type": "string", "description": "Color of the creative's prices\r\nValid hexadecimal color (e.g. \"AB00FF\")", "nullable": true }, "primaryFont": { "type": "string", "description": "Font of the primary font\r\nValid supported font like \"Arial\"", "nullable": true }, "productImageDisplay": { "enum": [ "ShowFullImage", "ZoomOnImage" ], "type": "string", "description": "Value can be \"ShowFullImage\" or \"ZoomOnImage\". Choose whether your product catalog images should fit inside the allocated\r\nspace (\"ShowFullImage\") or whether they should fill that space (\"ZoomOnImage\"). If you choose ZoomOnImage, there may be some\r\nimage cropping.", "nullable": true } }, "description": "The attributes specific to Dynamic creatives", "nullable": true }, "DynamicWriteAttributes": { "required": [ "bodyTextColor", "callsToAction", "logoBase64String", "pricesColor", "productImageDisplay" ], "type": "object", "properties": { "bodyTextColor": { "type": "string", "description": "Color of the creative's body text\r\nValid hexadecimal color (e.g. \"AB00FF\")" }, "callsToAction": { "minItems": 1, "type": "array", "items": { "type": "string" }, "description": "A Call-to-Action (CTA) is an action-driven instruction to your audience intended to provoke an immediate\r\nresponse, such as “Buy now” or “Go!”." }, "creativeBackgroundColor": { "type": "string", "description": "Color of the creative's background\r\nValid hexadecimal color (e.g. \"AB00FF\")", "nullable": true }, "logoBase64String": { "type": "string", "description": "Logo image as a base-64 encoded string" }, "pricesColor": { "type": "string", "description": "Color of the creative's prices\r\nValid hexadecimal color (e.g. \"AB00FF\")" }, "primaryFont": { "type": "string", "description": "Font of the primary font\r\nValid supported font like \"Arial\"", "nullable": true }, "productImageDisplay": { "enum": [ "ShowFullImage", "ZoomOnImage" ], "type": "string", "description": "Value can be \"ShowFullImage\" or \"ZoomOnImage\". Choose whether your product catalog images should fit inside the allocated\r\nspace (\"ShowFullImage\") or whether they should fill that space (\"ZoomOnImage\"). If you choose ZoomOnImage, there may be some\r\nimage cropping." } }, "description": "The attributes specific to create or update a Dynamic creative" }, "EntityOfPortfolioMessage": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/PortfolioMessage" }, "id": { "type": "string", "description": "A opaque string containing the unique Id of the entity", "nullable": true }, "meta": { "type": "object", "description": "A meta object that contains application-specific metadata", "nullable": true }, "type": { "enum": [ "campaign", "adset", "ad", "advertiser", "agency", "publisher", "address", "client", "contact", "industry" ], "type": "string", "description": "A string containing the entity type", "nullable": true, "example": "campaign" } }, "description": "Generic Criteo API successful data model" }, "GetPortfolioResponse": { "type": "object", "properties": { "data": { "uniqueItems": false, "type": "array", "items": { "$ref": "#/components/schemas/EntityOfPortfolioMessage" }, "description": "The response�s primary data", "nullable": true }, "errors": { "uniqueItems": false, "type": "array", "items": { "$ref": "#/components/schemas/CriteoApiError" }, "description": "Error list returned by the Criteo API\r\nFor successful requests it is empty", "nullable": true }, "warnings": { "uniqueItems": false, "type": "array", "items": { "$ref": "#/components/schemas/CriteoApiWarning" }, "description": "Warnings list returned by the Criteo API\r\nIn some situations the operations are successful but it may be useful to issue warnings to the API consumer.\r\nFor example the endpoint, entity or field is deprecated. Warnings are like compiler warnings, they indicate that problems may occur in the future.", "nullable": true } }, "description": "Portfolio fetch Response" }, "HtmlTagAttributes": { "type": "object", "properties": { "tags": { "type": "array", "items": { "$ref": "#/components/schemas/Tag" }, "description": "An array containing the html tags", "nullable": true } }, "description": "The attributes specific to HtmlTag creatives", "nullable": true }, "HtmlTagWriteAttributes": { "required": [ "tags" ], "type": "object", "properties": { "tags": { "type": "array", "items": { "$ref": "#/components/schemas/Tag" }, "description": "An array containing the html tags" } }, "description": "The attributes specific to create or update a HtmlTag creative" }, "ImageAttributes": { "type": "object", "properties": { "landingPageUrl": { "type": "string", "description": "Web redirection of the landing page url", "nullable": true }, "urls": { "type": "array", "items": { "type": "string" }, "description": "Array of images uploaded on demostatic.criteo.com when deploying and then static.criteo.net", "nullable": true } }, "description": "The attributes specific to Image creatives", "nullable": true }, "ImageSet": { "required": [ "images" ], "type": "object", "properties": { "headlineText": { "type": "string", "description": "The headline of the image set", "nullable": true }, "images": { "type": "array", "items": { "$ref": "#/components/schemas/ImageShape" }, "description": "The images' urls with their shapes." } }, "description": "Entity consists of multiple images in different ratios and a headline text." }, "ImageSetBase64": { "required": [ "imageBase64Strings" ], "type": "object", "properties": { "headlineText": { "type": "string", "description": "The headline of the image set", "nullable": true }, "imageBase64Strings": { "minItems": 1, "type": "array", "items": { "type": "string" }, "description": "Multiple images potentially in different shapes, each image is a base-64 encoded string." } }, "description": "Entity consists of multiple images in different ratios as a base-64 encoded and a headline text." }, "ImageShape": { "required": [ "shape", "url" ], "type": "object", "properties": { "shape": { "enum": [ "Horizontal", "Vertical", "Square" ], "type": "string", "description": "Ratio of the image" }, "url": { "type": "string", "description": "URL of the image uploaded on demostatic.criteo.com when deploying and then static.criteo.net", "format": "uri" } }, "description": "Entity containing the shape and url of the image" }, "ImageSlide": { "type": "object", "properties": { "height": { "type": "integer", "description": "Height of the Coupon slide", "format": "int32", "nullable": true }, "slideUrls": { "type": "array", "items": { "type": "string" }, "description": "Array of images of the same size uploaded on demostatic.criteo.com when deploying and then static.criteo.net", "nullable": true }, "width": { "type": "integer", "description": "Width of the Coupon slide", "format": "int32", "nullable": true } }, "description": "Slide containing the image URLs" }, "ImageWriteAttributes": { "required": [ "base64Strings", "landingPageUrl" ], "type": "object", "properties": { "base64Strings": { "minItems": 1, "type": "array", "items": { "type": "string" }, "description": "Array of images as a base-64 encoded string" }, "landingPageUrl": { "type": "string", "description": "Web redirection of the landing page url", "format": "uri" } }, "description": "The attributes specific to create or update an Image creative" }, "InMarketAudienceSegmentBrandEntityV1": { "type": "object", "properties": { "name": { "type": "string", "description": "Name of the in-market segment brand", "nullable": true }, "size": { "type": "integer", "description": "Size of the in-market segment brand", "format": "int32", "nullable": true } }, "description": "In-market segment brand entity", "nullable": true, "x-criteo-canonical": { "infoType": "entity", "name": "InMarketAudienceSegmentBrand", "version": "v1" } }, "InMarketAudienceSegmentBrandEntityV1ListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/InMarketAudienceSegmentBrandEntityV1Resource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for several entities" }, "InMarketAudienceSegmentBrandEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/InMarketAudienceSegmentBrandEntityV1" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API" }, "InMarketAudienceSegmentInterestEntityV1": { "type": "object", "properties": { "parentId": { "type": "string", "description": "Id of the parent in-market segment interest", "nullable": true } }, "description": "In-market segment interest entity", "nullable": true, "x-criteo-canonical": { "infoType": "entity", "name": "InMarketAudienceSegmentInterest", "version": "v1" } }, "InMarketAudienceSegmentInterestEntityV1ListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/InMarketAudienceSegmentInterestEntityV1Resource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for several entities" }, "InMarketAudienceSegmentInterestEntityV1Resource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/InMarketAudienceSegmentInterestEntityV1" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API" }, "InMarketCreateV1": { "required": [ "country" ], "type": "object", "properties": { "brandIds": { "uniqueItems": true, "type": "array", "items": { "type": "string" }, "description": "Choose the brands your segment might be interested in" }, "buyingPower": { "uniqueItems": true, "type": "array", "items": { "enum": [ "Low", "Medium", "High", "VeryHigh" ], "type": "string" }, "description": "Reach people who frequently purchase high price range items to lower price range items" }, "country": { "type": "string", "description": "Reach people of a specific country" }, "gender": { "enum": [ "Male", "Female" ], "type": "string", "description": "Reach people who’ve shown interest in products made for a specific gender" }, "interestIds": { "uniqueItems": true, "type": "array", "items": { "type": "string" }, "description": "Reach new people based on their interests" }, "priceRange": { "uniqueItems": true, "type": "array", "items": { "enum": [ "Low", "Medium", "High" ], "type": "string" }, "description": "Reach people who’ve shown interest in products within a specific price range" } }, "description": "Settings to target users based on high shopping intents and demographics." }, "InMarketSizeEstimationV1": { "required": [ "country" ], "type": "object", "properties": { "brandIds": { "uniqueItems": true, "type": "array", "items": { "type": "string" } }, "buyingPower": { "uniqueItems": true, "type": "array", "items": { "enum": [ "Low", "Medium", "High", "VeryHigh" ], "type": "string" } }, "country": { "type": "string" }, "gender": { "enum": [ "Male", "Female" ], "type": "string" }, "interestIds": { "uniqueItems": true, "type": "array", "items": { "type": "string" } }, "priceRange": { "uniqueItems": true, "type": "array", "items": { "enum": [ "Low", "Medium", "High" ], "type": "string" } } }, "description": "Settings to target users based on high shopping intents and demographics." }, "InMarketUpdateV1": { "type": "object", "properties": { "brandIds": { "uniqueItems": true, "type": "array", "items": { "type": "string" }, "description": "Choose the brands your segment might be interested in" }, "buyingPower": { "uniqueItems": true, "type": "array", "items": { "enum": [ "Low", "Medium", "High", "VeryHigh" ], "type": "string" }, "description": "Reach people who frequently purchase high price range items to lower price range items" }, "country": { "type": "string", "description": "Reach people of a specific country" }, "gender": { "$ref": "#/components/schemas/NillableGenderV1" }, "interestIds": { "uniqueItems": true, "type": "array", "items": { "type": "string" }, "description": "Reach new people based on their interests" }, "priceRange": { "uniqueItems": true, "type": "array", "items": { "enum": [ "Low", "Medium", "High" ], "type": "string" }, "description": "Reach people who’ve shown interest in products within a specific price range" } }, "description": "Settings to target users based on high shopping intents and demographics." }, "InMarketV1": { "type": "object", "properties": { "brandIds": { "uniqueItems": true, "type": "array", "items": { "type": "string" }, "description": "Choose the brands your segment might be interested in", "nullable": true }, "buyingPower": { "uniqueItems": true, "type": "array", "items": { "enum": [ "Unknown", "Low", "Medium", "High", "VeryHigh" ], "type": "string" }, "description": "Reach people who frequently purchase high price range items to lower price range items", "nullable": true }, "country": { "type": "string", "description": "Reach people of a specific country", "nullable": true }, "gender": { "enum": [ "Unknown", "Male", "Female" ], "type": "string", "description": "Reach people who’ve shown interest in products made for a specific gender", "nullable": true }, "interestIds": { "uniqueItems": true, "type": "array", "items": { "type": "string" }, "description": "Reach new people based on their interests", "nullable": true }, "priceRange": { "uniqueItems": true, "type": "array", "items": { "enum": [ "Unknown", "Low", "Medium", "High" ], "type": "string" }, "description": "Reach people who’ve shown interest in products within a specific price range", "nullable": true } }, "description": "Settings to target users based on high shopping intents and demographics.", "nullable": true }, "LocationCreateV1": { "required": [ "pointsOfInterest", "radiusInKm" ], "type": "object", "properties": { "pointsOfInterest": { "type": "array", "items": { "$ref": "#/components/schemas/PointOfInterestV1" }, "description": "Reach users which have been historically located in the given coordinates" }, "radiusInKm": { "type": "integer", "description": "The expected maximum distance in kilometers between a user and a point of interest", "format": "int32" } }, "description": "Settings to target users based on their location." }, "LocationSizeEstimationV1": { "required": [ "pointsOfInterest", "radiusInKm" ], "type": "object", "properties": { "pointsOfInterest": { "type": "array", "items": { "$ref": "#/components/schemas/PointOfInterestV1" } }, "radiusInKm": { "type": "integer", "format": "int32" } }, "description": "Settings to define your audience based on their location." }, "LocationUpdateV1": { "type": "object", "properties": { "pointsOfInterest": { "type": "array", "items": { "$ref": "#/components/schemas/PointOfInterestV1" }, "description": "Reach users which have been historically located in the given coordinates" }, "radiusInKm": { "type": "integer", "description": "Radius in kilometers", "format": "int32" }, "registryType": { "enum": [ "PointOfInterest" ], "type": "string", "description": "The kind of Location audience" } }, "description": "Settings to target users based on their location." }, "LocationV1": { "type": "object", "properties": { "pointsOfInterest": { "type": "array", "items": { "$ref": "#/components/schemas/PointOfInterestV1" }, "description": "Reach users which have been historically located in the given coordinates", "nullable": true }, "radiusInKm": { "type": "integer", "description": "The expected maximum distance in kilometers between a user and a point of interest", "format": "int32", "nullable": true }, "registryType": { "enum": [ "Unknown", "PointOfInterest" ], "type": "string", "description": "The kind of Location audience", "nullable": true } }, "description": "Settings to target users based on their location.", "nullable": true }, "LookalikeCreateV1": { "required": [ "seedSegmentId" ], "type": "object", "properties": { "seedSegmentId": { "type": "string", "description": "Segment from which the Lookalike segment will be generated" }, "targetSize": { "type": "integer", "description": "Desired size of the generated Lookalike segment", "format": "int64" } }, "description": "Settings to target users close to a given seed segment." }, "LookalikeUpdateV1": { "type": "object", "properties": { "targetSize": { "type": "integer", "description": "Desired size of the generated Lookalike segment", "format": "int64" } }, "description": "Settings to target users that behave like a given seed segment" }, "LookalikeV1": { "type": "object", "properties": { "seedSegmentId": { "type": "string", "description": "Segment from which the Lookalike segment will be generated", "nullable": true }, "targetSize": { "type": "integer", "description": "Desired size of the generated Lookalike segment", "format": "int64", "nullable": true } }, "description": "Settings to target users that behave like a given seed segment", "nullable": true }, "ModifyAudienceResponse": { "required": [ "data", "errors", "warnings" ], "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ContactlistOperation" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceError" } }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/AudienceWarning" } } }, "description": "Parameters to modify an audience" }, "NillableAdSetTargetingRuleV24Q3": { "type": "object", "properties": { "value": { "type": "object", "allOf": [ { "$ref": "#/components/schemas/AdSetTargetingRuleV24Q3" } ], "nullable": true } }, "description": "structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.", "nullable": true }, "NillableDateTime": { "type": "object", "properties": { "value": { "type": "string", "format": "date-time", "nullable": true } }, "description": "structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.", "nullable": true }, "NillableDecimal": { "type": "object", "properties": { "value": { "type": "number", "format": "double", "nullable": true } }, "description": "structure that encapsulates an object that have valid business null values. If the structure is provided (i.e. not null), then the value in it, even null, is provided.", "nullable": true }, "NillableGenderV1": { "type": "object", "properties": { "value": { "enum": [ "Male", "Female" ], "type": "string", "description": "The value. If missing or null the value is set to \"null\"", "nullable": true } }, "description": "Placeholder object for value for which \"null\" is a valid business value", "nullable": true }, "NillableInt32": { "type": "object", "properties": { "value": { "type": "integer", "description": "The value. If missing or null the value is set to \"null\"", "format": "int32", "nullable": true } }, "description": "Placeholder object for value for which \"null\" is a valid business value", "nullable": true }, "NillableString": { "type": "object", "properties": { "value": { "type": "string", "description": "The string's value. If missing or null the string's value is set to \"null\"", "nullable": true } }, "description": "Placeholder object for string value for which \"null\" is a valid business value", "nullable": true }, "PatchAdSetAttributionConfigurationV24Q3": { "type": "object", "properties": { "attributionMethod": { "enum": [ "unknown", "criteoAttribution", "googleAnalyticsLastClick", "googleAnalyticsDataDriven", "lastClick", "postClick" ], "type": "string", "description": "The attribution method.", "nullable": true }, "lookbackWindow": { "enum": [ "unknown", "30M", "24H", "7D", "30D" ], "type": "string", "description": "The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick.", "nullable": true } }, "description": "Patch model for an ad set's attribution configuration." }, "PatchAdSetBiddingV24Q3": { "type": "object", "properties": { "bidAmount": { "$ref": "#/components/schemas/NillableDecimal" } }, "description": "ad set bidding patch model" }, "PatchAdSetBudgetV24Q3": { "type": "object", "properties": { "budgetAmount": { "$ref": "#/components/schemas/NillableDecimal" }, "budgetDeliverySmoothing": { "enum": [ "accelerated", "standard" ], "type": "string", "nullable": true }, "budgetDeliveryWeek": { "enum": [ "undefined", "mondayToSunday", "tuesdayToMonday", "wednesdayToTuesday", "thursdayToWednesday", "fridayToThursday", "saturdayToFriday", "sundayToSaturday" ], "type": "string", "nullable": true }, "budgetRenewal": { "enum": [ "undefined", "daily", "monthly", "lifetime", "weekly" ], "type": "string", "nullable": true }, "budgetStrategy": { "enum": [ "capped", "uncapped" ], "type": "string", "nullable": true } }, "description": "ad set budget patch model" }, "PatchAdSetCategoryBid": { "type": "object", "properties": { "bidAmount": { "type": "number", "description": "The Bid amount applied to the given Category associated to an Ad Set. At most 4 decimals are supported. Additional decimals are rounded.", "format": "double" } }, "description": "Category Bid to update for a given combination of Ad Set and Category." }, "PatchAdSetCategoryBidListRequest": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PatchAdSetCategoryBidResource" }, "nullable": true } }, "description": "Data model for a list of input resources" }, "PatchAdSetCategoryBidResource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/PatchAdSetCategoryBid" }, "id": { "type": "string", "description": "Id of the entity" }, "type": { "type": "string", "description": "Canonical type name of the entity", "example": "AdSetCategoryBid" } }, "description": "Data model for a Resource" }, "PatchAdSetCategoryBidResultListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PatchAdSetCategoryBidResultResource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "Data model for a list of response resources" }, "PatchAdSetCategoryBidResultResource": { "type": "object", "properties": { "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "description": "Canonical type name of the entity", "nullable": true, "example": "AdSetCategoryBid" } }, "description": "Data model for a Resource" }, "PatchAdSetDisplayMultiplier": { "type": "object", "properties": { "displayMultiplier": { "type": "number", "description": "Any positive decimal value. To remove the impact of the Display Multiplier set it to 1. At most 4 decimals are supported. Additional decimals are rounded.", "format": "double" } }, "description": "Display Multiplier to update for a given combination of Ad Set and Category." }, "PatchAdSetDisplayMultiplierListRequest": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PatchAdSetDisplayMultiplierResource" }, "nullable": true } }, "description": "Data model for a list of input resources" }, "PatchAdSetDisplayMultiplierResource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/PatchAdSetDisplayMultiplier" }, "id": { "type": "string", "description": "Id of the entity" }, "type": { "type": "string", "description": "Canonical type name of the entity", "example": "AdSetDisplayMultiplier" } }, "description": "Data model for a Resource" }, "PatchAdSetDisplayMultiplierResultListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PatchAdSetDisplayMultiplierResultResource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "Data model for a list of response resources" }, "PatchAdSetDisplayMultiplierResultResource": { "type": "object", "properties": { "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "description": "Canonical type name of the entity", "nullable": true, "example": "AdSetDisplayMultiplier" } }, "description": "Data model for a Resource" }, "PatchAdSetSchedulingV24Q3": { "type": "object", "properties": { "endDate": { "$ref": "#/components/schemas/NillableDateTime" }, "startDate": { "$ref": "#/components/schemas/NillableDateTime" } }, "description": "ad set schedule patch model" }, "PatchAdSetV24Q3": { "type": "object", "properties": { "attributionConfiguration": { "$ref": "#/components/schemas/PatchAdSetAttributionConfigurationV24Q3" }, "bidding": { "$ref": "#/components/schemas/PatchAdSetBiddingV24Q3" }, "budget": { "$ref": "#/components/schemas/PatchAdSetBudgetV24Q3" }, "name": { "type": "string", "nullable": true }, "scheduling": { "$ref": "#/components/schemas/PatchAdSetSchedulingV24Q3" }, "targeting": { "$ref": "#/components/schemas/AdSetTargetingV24Q3" } }, "description": "ad set patch model" }, "PatchCampaign": { "type": "object", "properties": { "budgetAutomation": { "$ref": "#/components/schemas/PatchMarketingCampaignBudgetAutomation" }, "spendLimit": { "$ref": "#/components/schemas/PatchCampaignSpendLimit" } }, "description": "Campaign patch model.\r\nThe campaign identifier is provided in the resource {id} field (string-encoded integer) and is required." }, "PatchCampaignListRequest": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PatchCampaignWriteResource" }, "nullable": true } }, "description": "List of input resources" }, "PatchCampaignSpendLimit": { "type": "object", "properties": { "spendLimitAmount": { "$ref": "#/components/schemas/NillableDecimal" }, "spendLimitRenewal": { "enum": [ "undefined", "daily", "monthly", "lifetime" ], "type": "string", "description": "The period over which the campaign spend limit is applied.\r\nWhen spendLimitType is \"capped\", this is \"daily\", \"monthly\", or \"lifetime\".\r\nWhen spendLimitType is \"uncapped\", this is \"undefined\".", "nullable": true }, "spendLimitType": { "enum": [ "capped", "uncapped" ], "type": "string", "description": "Controls whether the campaign has a spend limit.\r\n\"capped\" returns a non-null spendLimitAmount.value and a spendLimitRenewal of \"daily\", \"monthly\", or \"lifetime\".\r\n\"uncapped\" returns spendLimitAmount.value as null and spendLimitRenewal as \"undefined\".", "nullable": true } }, "description": "Spend limit configuration for a marketing campaign (patch).\r\nOnly provided fields are updated; omitted fields are left unchanged.\r\nWhen spendLimitType is \"capped\": spendLimitAmount and spendLimitRenewal are required.\r\nWhen spendLimitType is \"uncapped\": spendLimitAmount is null and spendLimitRenewal is \"undefined\"." }, "PatchCampaignWriteResource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/PatchCampaign" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "description": "Canonical type name of the entity", "nullable": true, "example": "Campaign" } }, "description": "write model data for resources" }, "PatchMarketingCampaignBudgetAutomation": { "type": "object", "properties": { "budgetConfiguration": { "$ref": "#/components/schemas/BudgetAutomationConfiguration" }, "enabled": { "type": "boolean", "description": "Whether budget automation is enabled for this campaign. This field is always present in the response." } }, "description": "Budget automation, lets users configure budgets once at the campaign level while Criteo dynamically routes spend toward the best-performing ad sets.\r\nOnly provided fields are updated; omitted fields are left unchanged.\r\nIf \"enabled\" is omitted and only \"budgetConfiguration\" is provided, \"enabled\" defaults to false — budget automation will not be activated.\r\nTo activate budget automation, \"enabled\" must be explicitly set to true along with a valid \"budgetConfiguration\".\r\nTo deactivate, set \"enabled\" to false; \"budgetConfiguration\" can be omitted." }, "PatchResultCampaignListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PatchResultCampaignReadResource" }, "nullable": true, "readOnly": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "List of output resources" }, "PatchResultCampaignReadResource": { "type": "object", "properties": { "id": { "type": "string", "description": "Id of the entity", "nullable": true, "readOnly": true }, "type": { "type": "string", "nullable": true, "readOnly": true, "example": "Campaign" } }, "description": "read model data for resources" }, "PlacementsReportQueryMessage": { "required": [ "advertiserIds", "currency", "dimensions", "endDate", "metrics", "startDate" ], "type": "object", "properties": { "adsetIds": { "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.", "nullable": true }, "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": { "type": "string", "description": "Optional list of campaign IDs to filter on. The campaigns must already exist. If empty, all campaigns will be included.", "nullable": true }, "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": { "enum": [ "Web", "Android", "Ios" ], "type": "string", "description": "Optional type of environment to filter on. If empty, all environments will be included.", "nullable": true }, "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": { "type": "string", "description": "Optional filter on a specific placement domain name. If empty, all placements will be included.", "nullable": true }, "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": { "type": "string", "description": "Optional timezone used for the report. Timezone Database format (Tz).", "default": "UTC", "nullable": true } }, "additionalProperties": false, "description": "This is the message defining the query for Placements report" }, "PlacementsReportQueryMessageListRequest": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/PlacementsReportQueryMessageResource" }, "nullable": true } }, "additionalProperties": false, "description": "A top-level object that encapsulates a Criteo API request for several value objects." }, "PlacementsReportQueryMessageResource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/PlacementsReportQueryMessage" }, "type": { "type": "string", "description": "Type of the resource.", "nullable": true } }, "additionalProperties": false, "description": "A value resource exposed by the API." }, "PointOfInterestV1": { "type": "object", "properties": { "latitude": { "type": "number", "description": "ISO-6709 latitude (rounded at 5 decimals)", "format": "double", "nullable": true }, "longitude": { "type": "number", "description": "ISO-6709 longitude (rounded at 5 decimals)", "format": "double", "nullable": true }, "name": { "type": "string", "description": "Name of the point of interest", "nullable": true } }, "description": "Named coordinate defined by its latitude and longitude.\r\nLatitude and Longitude are rounded at 5 decimals." }, "PortfolioMessage": { "type": "object", "properties": { "advertiserName": { "type": "string", "nullable": true } }, "description": "Class with elementary info about advertiser", "nullable": true }, "ProspectingCreateV1": { "required": [ "usersType" ], "type": "object", "properties": { "daysSinceLastVisitMax": { "type": "integer", "description": "When non buyers are included, include users who visited your website after this number of days", "format": "int32" }, "daysSinceLastVisitMin": { "type": "integer", "description": "When non buyers are included, include users who visited your website before this number of days", "format": "int32" }, "usersType": { "enum": [ "Prospects", "ProspectsOrNonBuyers" ], "type": "string", "description": "Type of users to target" } }, "description": "Settings to target prospecting users to website visitors." }, "ProspectingUpdateV1": { "type": "object", "properties": { "daysSinceLastVisitMax": { "$ref": "#/components/schemas/NillableInt32" }, "daysSinceLastVisitMin": { "$ref": "#/components/schemas/NillableInt32" }, "usersType": { "enum": [ "Prospects", "ProspectsOrNonBuyers" ], "type": "string", "description": "Type of users to target" } }, "description": "Settings to target prospecting users to website visitors." }, "ProspectingV1": { "type": "object", "properties": { "daysSinceLastVisitMax": { "type": "integer", "description": "When non buyers are included, include users who visited your website after this number of days", "format": "int32", "nullable": true }, "daysSinceLastVisitMin": { "type": "integer", "description": "When non buyers are included, include users who visited your website before this number of days", "format": "int32", "nullable": true }, "usersType": { "enum": [ "Unknown", "Prospects", "ProspectsOrNonBuyers" ], "type": "string", "description": "Type of users to target", "nullable": true } }, "description": "Settings to target prospecting users to website visitors.", "nullable": true }, "ReadAdSetAttributionConfigurationV24Q3": { "type": "object", "properties": { "attributionMethod": { "enum": [ "unknown", "criteoAttribution", "googleAnalyticsLastClick", "googleAnalyticsDataDriven", "lastClick", "postClick" ], "type": "string", "description": "The attribution method.", "nullable": true }, "lookbackWindow": { "enum": [ "unknown", "30M", "24H", "7D", "30D" ], "type": "string", "description": "The lookback window. Optional, should be specified only for attribution methods PostClick and LastClick.", "nullable": true } }, "description": "Read model for an ad set's attribution configuration.", "nullable": true }, "ReadAdSetBiddingV24Q3": { "type": "object", "properties": { "bidAmount": { "type": "number", "description": "Decimal value target relating to the `adSetObjective` specified. May be `null` for objectives that do not require a target value. At most 4 decimals are supported. Additional decimals are rounded.", "format": "double", "nullable": true }, "costController": { "enum": [ "COS", "maxCPC", "CPI", "CPM", "CPO", "CPSV", "CPV", "dailyBudget", "targetCPM" ], "type": "string", "description": "How spend is controlled", "nullable": true } }, "description": "ad set bidding read model", "nullable": true }, "ReadAdSetBudgetV24Q3": { "type": "object", "properties": { "budgetAmount": { "type": "number", "format": "double", "nullable": true }, "budgetDeliverySmoothing": { "enum": [ "accelerated", "standard" ], "type": "string", "nullable": true }, "budgetDeliveryWeek": { "enum": [ "undefined", "mondayToSunday", "tuesdayToMonday", "wednesdayToTuesday", "thursdayToWednesday", "fridayToThursday", "saturdayToFriday", "sundayToSaturday" ], "type": "string", "nullable": true }, "budgetRenewal": { "enum": [ "undefined", "daily", "monthly", "lifetime", "weekly" ], "type": "string", "nullable": true }, "budgetStrategy": { "enum": [ "capped", "uncapped" ], "type": "string", "nullable": true } }, "description": "ad set budget read model", "nullable": true }, "ReadAdSetScheduleV24Q3": { "type": "object", "properties": { "activationStatus": { "enum": [ "on", "off" ], "type": "string", "nullable": true }, "deliveryStatus": { "enum": [ "draft", "inactive", "live", "notLive", "pausing", "paused", "scheduled", "ended", "notDelivering", "archived" ], "type": "string", "nullable": true }, "endDate": { "$ref": "#/components/schemas/NillableDateTime" }, "startDate": { "$ref": "#/components/schemas/NillableDateTime" } }, "description": "ad set schedule read model", "nullable": true }, "ReadAdSetV24Q3": { "type": "object", "properties": { "advertiserId": { "type": "string", "nullable": true }, "attributionConfiguration": { "$ref": "#/components/schemas/ReadAdSetAttributionConfigurationV24Q3" }, "bidding": { "$ref": "#/components/schemas/ReadAdSetBiddingV24Q3" }, "budget": { "$ref": "#/components/schemas/ReadAdSetBudgetV24Q3" }, "campaignId": { "type": "string", "nullable": true }, "datasetId": { "type": "string", "nullable": true }, "destinationEnvironment": { "enum": [ "undefined", "web", "app" ], "type": "string", "nullable": true }, "mediaType": { "enum": [ "display", "video" ], "type": "string", "nullable": true }, "name": { "type": "string", "nullable": true }, "objective": { "enum": [ "customAction", "clicks", "conversions", "displays", "appPromotion", "revenue", "storeConversions", "value", "reach", "visits", "videoViews" ], "type": "string", "nullable": true }, "schedule": { "$ref": "#/components/schemas/ReadAdSetScheduleV24Q3" }, "targeting": { "$ref": "#/components/schemas/AdSetTargetingV24Q3" }, "videoChannel": { "enum": [ "olv", "ctv" ], "type": "string", "nullable": true } }, "description": "ad set read model", "nullable": true }, "ReadModelAdSetId": { "type": "object", "properties": { "id": { "type": "string", "description": "Id of the entity", "nullable": true, "readOnly": true }, "type": { "type": "string", "nullable": true, "readOnly": true, "example": "AdSetId" } }, "description": "read model data for resources" }, "ReadModelAdSetIdV24Q3": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AdSetIdV24Q3" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true, "readOnly": true }, "type": { "type": "string", "nullable": true, "readOnly": true, "example": "AdSetIdV24Q3" } }, "description": "read model data for resources" }, "ReadModelReadAdSetV24Q3": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/ReadAdSetV24Q3" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true, "readOnly": true }, "type": { "type": "string", "nullable": true, "readOnly": true, "example": "ReadAdSetV24Q3" } }, "description": "read model data for resources", "nullable": true }, "RequestsAdSetId": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/WriteModelAdSetId" }, "nullable": true } }, "description": "List of input resources" }, "RequestsPatchAdSetV24Q3": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/WriteModelPatchAdSetV24Q3" }, "nullable": true } }, "description": "List of input resources" }, "ResourceCollectionOutcomeOfAd": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ResourceOfAd" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for several entities." }, "ResourceCollectionOutcomeOfCoupon": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ResourceOfCoupon" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for several entities." }, "ResourceCollectionOutcomeOfCreativeRead": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ResourceOfCreativeRead" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for several entities." }, "ResourceInputOfAdWrite": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ResourceOfAdWrite" } }, "description": "A top-level object that encapsulates a Criteo API request for a single entity." }, "ResourceInputOfCreateCoupon": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ResourceOfCreateCoupon" } }, "description": "A top-level object that encapsulates a Criteo API request for a single entity." }, "ResourceInputOfCreativeWrite": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ResourceOfCreativeWrite" } }, "description": "A top-level object that encapsulates a Criteo API request for a single entity." }, "ResourceInputOfUpdateCoupon": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ResourceOfUpdateCoupon" } }, "description": "A top-level object that encapsulates a Criteo API request for a single entity." }, "ResourceOfAd": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/Ad" }, "id": { "type": "string", "description": "Unique identifier of this resource.", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API.", "nullable": true }, "ResourceOfAdWrite": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/AdWrite" }, "id": { "type": "string", "description": "Unique identifier of this resource.", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API." }, "ResourceOfCoupon": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/Coupon" }, "id": { "type": "string", "description": "Unique identifier of this resource.", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API.", "nullable": true }, "ResourceOfCouponSupportedSizes": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/CouponSupportedSizes" }, "id": { "type": "string", "description": "Unique identifier of this resource.", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API.", "nullable": true }, "ResourceOfCreateCoupon": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/CreateCoupon" }, "id": { "type": "string", "description": "Unique identifier of this resource.", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API." }, "ResourceOfCreative": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/Creative" }, "id": { "type": "string", "description": "Unique identifier of this resource.", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API.", "nullable": true }, "ResourceOfCreativeRead": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/CreativeRead" }, "id": { "type": "string", "description": "Unique identifier of this resource.", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API." }, "ResourceOfCreativeWrite": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/CreativeWrite" }, "id": { "type": "string", "description": "Unique identifier of this resource.", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API." }, "ResourceOfUpdateCoupon": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/UpdateCoupon" }, "id": { "type": "string", "description": "Unique identifier of this resource.", "nullable": true }, "type": { "type": "string", "nullable": true } }, "description": "A class that represents a domain entity exposed by an API." }, "ResourceOutcomeOfAd": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ResourceOfAd" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for a single entity." }, "ResourceOutcomeOfCoupon": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ResourceOfCoupon" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for a single entity." }, "ResourceOutcomeOfCouponSupportedSizes": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ResourceOfCouponSupportedSizes" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for a single entity." }, "ResourceOutcomeOfCreative": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ResourceOfCreative" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "A top-level object that encapsulates a Criteo API response for a single entity." }, "ResponseReadAdSetV24Q3": { "type": "object", "properties": { "data": { "$ref": "#/components/schemas/ReadModelReadAdSetV24Q3" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "output resource" }, "ResponsesAdSetId": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ReadModelAdSetId" }, "nullable": true, "readOnly": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "List of output resources" }, "ResponsesAdSetIdV24Q3": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ReadModelAdSetIdV24Q3" }, "nullable": true, "readOnly": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "List of output resources" }, "ResponsesReadAdSetV24Q3": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ReadModelReadAdSetV24Q3" }, "nullable": true, "readOnly": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "nullable": true, "readOnly": true } }, "description": "List of output resources" }, "RetargetingCreateV1": { "required": [ "daysSinceLastVisitMax", "daysSinceLastVisitMin", "visitorsType" ], "type": "object", "properties": { "daysSinceLastVisitMax": { "type": "integer", "description": "Maximum number of days since last visit to partner.", "format": "int32" }, "daysSinceLastVisitMin": { "type": "integer", "description": "Minimum number of days since last visit to partner.", "format": "int32" }, "visitorsType": { "enum": [ "All", "Buyers", "NonBuyers" ], "type": "string", "description": "Types of visitors." } }, "description": "Settings to target users based on its type and days since last visit." }, "RetargetingUpdateV1": { "type": "object", "properties": { "daysSinceLastVisitMax": { "type": "integer", "description": "Maximum number of days since last visit to partner.", "format": "int32" }, "daysSinceLastVisitMin": { "type": "integer", "description": "Minimum number of days since last visit to partner.", "format": "int32" }, "visitorsType": { "enum": [ "All", "Buyers", "NonBuyers" ], "type": "string", "description": "Types of visitors." } }, "description": "Settings to target users based on its type and days since last visit." }, "RetargetingV1": { "type": "object", "properties": { "daysSinceLastVisitMax": { "type": "integer", "description": "Maximum number of days since last visit to partner.", "format": "int32", "nullable": true }, "daysSinceLastVisitMin": { "type": "integer", "description": "Minimum number of days since last visit to partner.", "format": "int32", "nullable": true }, "visitorsType": { "enum": [ "Unknown", "All", "Buyers", "NonBuyers" ], "type": "string", "description": "Types of visitors.", "nullable": true } }, "description": "Settings to target users based on its type and days since last visit.", "nullable": true }, "Size": { "type": "object", "properties": { "height": { "type": "integer", "format": "int32", "nullable": true }, "width": { "type": "integer", "format": "int32", "nullable": true } }, "description": "Size entity containing width and height of the creative", "nullable": true }, "StatisticsReportQueryMessage": { "required": [ "advertiserIds", "currency", "dimensions", "endDate", "metrics", "startDate" ], "type": "object", "properties": { "adSetIds": { "type": "array", "items": { "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 fetched.", "nullable": true }, "adSetNames": { "type": "array", "items": { "type": "string" }, "description": "Optional list of ad set names to filter on. If empty, all ad sets will be fetched.", "nullable": true }, "adSetStatus": { "type": "array", "items": { "enum": [ "Active", "NotRunning", "Dead" ], "type": "string" }, "description": "Optional list of ad set statuses to filter on. If empty, all ad sets will be fetched.", "nullable": true }, "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." }, "currency": { "type": "string", "description": "The currency used for the report. ISO 4217 code (three-letter capitals)." }, "dimensions": { "minItems": 1, "type": "array", "items": { "enum": [ "AdsetId", "Adset", "AdvertiserId", "Advertiser", "CategoryId", "Category", "Hour", "Day", "Week", "Month", "Year", "Os", "Device", "CampaignId", "Campaign", "AdId", "Ad", "CouponId", "Coupon", "MarketingObjectiveId", "MarketingObjective", "ChannelId", "Channel", "Goal", "AdChannel", "SocialPlatform" ], "type": "string" }, "description": "List of dimensions for the report. At least one dimension should be provided.

When an ID dimension is requested (e.g., AdsetId), the corresponding name dimension (e.g., Adset) is automatically included, and vice versa. This applies to the following pairs: AdsetId/Adset, AdId/Ad, AdvertiserId/Advertiser, CampaignId/Campaign, CategoryId/Category, CouponId/Coupon, MarketingObjectiveId/MarketingObjective, ChannelId/Channel." }, "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" }, "format": { "enum": [ "csv", "excel", "xml", "json" ], "type": "string", "description": "Optional file format of the generated report.", "default": "json" }, "metrics": { "type": "array", "items": { "enum": [ "Clicks", "Displays", "AdvertiserCost", "SalesPc30dClientAttribution", "SalesClientAttribution", "SalesPc30d", "SalesAllPc30dClientAttribution", "SalesAllClientAttribution", "SalesAllPc30d", "SalesPv24h", "SalesAllPv24h", "SalesPc30Pv24", "SalesAllPc30Pv24", "SalesPc30dPv24h", "SalesAllPc30dPv24h", "SalesPc7dPv24", "SalesAllPc7dPv24", "SalesLc", "SalesAllLc", "SalesPc7d", "SalesAllPc7d", "SalesPc1d", "SalesAllPc1d", "SalesPiPc", "SalesPiPv", "SalesPiPcPv", "PostInstallSales", "SalesOfflinePc", "SalesOfflinePv", "SalesOfflinePc30d", "SalesOfflinePv24h", "RevenueGeneratedPc30dClientAttribution", "RevenueGeneratedClientAttribution", "RevenueGeneratedPc30d", "RevenueGeneratedAllPc30dClientAttribution", "RevenueGeneratedAllClientAttribution", "RevenueGeneratedAllPc30d", "RevenueGeneratedPv24h", "RevenueGeneratedAllPv24h", "RevenueGeneratedPc30Pv24", "RevenueGeneratedAllPc30Pv24", "RevenueGeneratedPc30dPv24h", "RevenueGeneratedAllPc30dPv24h", "RevenueGeneratedPc7dPv24", "RevenueGeneratedAllPc7dPv24", "RevenueGeneratedLc", "RevenueGeneratedAllLc", "RevenueGeneratedPc7d", "RevenueGeneratedAllPc7d", "RevenueGeneratedPc1d", "RevenueGeneratedAllPc1d", "RevenueGeneratedOfflinePc", "RevenueGeneratedOfflinePv", "RevenueGeneratedOfflinePc30d", "RevenueGeneratedOfflinePv24h", "ConversionRatePc30dClientAttribution", "ConversionRateClientAttribution", "ConversionRatePc30d", "ConversionRateAllPc30dClientAttribution", "ConversionRateAllClientAttribution", "ConversionRateAllPc30d", "ConversionRatePv24h", "ConversionRateAllPv24h", "ConversionRatePc30Pv24", "ConversionRateAllPc30Pv24", "ConversionRatePc30dPv24h", "ConversionRateAllPc30dPv24h", "ConversionRatePc7dPv24", "ConversionRateAllPc7dPv24", "ConversionRatePc7d", "ConversionRateAllPc7d", "ConversionRatePc1d", "ConversionRateAllPc1d", "ConversionRatePiPcPv", "PostInstallConversionRate", "ECosPc30dClientAttribution", "ECosClientAttribution", "ECosPc30d", "ECosAllPc30dClientAttribution", "ECosAllClientAttribution", "ECosAllPc30d", "ECosPv24h", "ECosAllPv24h", "ECosPc30Pv24", "ECosAllPc30Pv24", "ECosPc30dPv24h", "ECosAllPc30dPv24h", "ECosPc7dPv24", "ECosAllPc7dPv24", "ECosPc7d", "ECosAllPc7d", "ECosPc1d", "ECosAllPc1d", "CostPerOrderPc30dClientAttribution", "CostPerOrderClientAttribution", "CostPerOrderPc30d", "CostPerOrderAllPc30dClientAttribution", "CostPerOrderAllClientAttribution", "CostPerOrderAllPc30d", "CostPerOrderPv24h", "CostPerOrderAllPv24h", "CostPerOrderPc30Pv24", "CostPerOrderAllPc30Pv24", "CostPerOrderPc30dPv24h", "CostPerOrderAllPc30dPv24h", "CostPerOrderPc7dPv24", "CostPerOrderAllPc7dPv24", "CostPerOrderPc7d", "CostPerOrderAllPc7d", "CostPerOrderPc1d", "CostPerOrderAllPc1d", "ExposedUsers", "Audience", "Reach", "AverageCartPc30dClientAttribution", "AverageCartAllPc30dClientAttribution", "AverageCartClientAttribution", "AverageCartAllClientAttribution", "AverageCartPc30d", "AverageCartAllPc30d", "AverageCartPv24h", "AverageCartAllPv24h", "AverageCartPc1d", "AverageCartAllPc1d", "AverageCartPc7d", "AverageCartAllPc7d", "AverageCartPc30Pv24", "AverageCartAllPc30Pv24", "AverageCartPc30dPv24h", "AverageCartAllPc30dPv24h", "AverageCartPc7dPv24", "AverageCartAllPc7dPv24", "ClickThroughRate", "ECpc", "Cpc", "ECpm", "ReturnOnAdvertisingSpendingClientAttribution", "ReturnOnAdvertisingSpendingAllClientAttribution", "AdvertiserValue", "AdvertiserAllValue", "CostOfAdvertiserValue", "CostOfAdvertiserValueAll", "AppInstallsPcPv", "AppInstalls", "QualifiedVisits", "Visits", "VisitsPV1D", "VisitsAllPv1d", "OrderValuePi", "PostInstallOrderValue", "BounceRate", "CostPerInstallPcPv", "CostPerInstall", "CostPerVisit", "CostPerVisitPV1D", "CostPerQualifiedVisit", "InstallRatePcPv", "InstallRate", "OmnichannelRoasPc30d", "OmnichannelRoasAllPc30d", "OmnichannelRevenuePc30d", "OmnichannelRevenueAllPc30d", "OmnichannelSalesPc30d", "OmnichannelSalesAllPc30d", "OmnichannelRoasAllPv24h", "OmnichannelRoasPv24h", "OmnichannelRevenueAllPv24h", "OmnichannelRevenuePv24h", "OmnichannelSalesAllPv24h", "OmnichannelSalesPv24h", "OmnichannelRoasClientAttribution", "OmnichannelRevenueClientAttribution", "OmnichannelSalesClientAttribution", "RoasAllPc30dClientAttribution", "RoasPc30dClientAttribution", "RoasAllClientAttribution", "RoasClientAttribution", "RoasAllPc30d", "RoasPc30d", "RoasAllPc7d", "RoasPc7d", "RoasAllPc1d", "RoasPc1d", "RoasAllPv24h", "RoasPv24h", "RoasPc30Pv24", "RoasAllPc30Pv24", "RoasPc30dPv24h", "RoasAllPc30dPv24h", "RoasPc7dPv24", "RoasAllPc7dPv24", "CostOfSalePi", "CostPerOrderPi", "PostInstallCostOfSale", "PostInstallCostPerOrder", "ReturnOnAdvertiserSpendingPi", "PostInstallRoas", "ReturnOnAdvertiserSpendingOfflinePc", "ReturnOnAdvertiserSpendingOfflinePv", "RoasOfflinePc30d", "RoasOfflinePv24h", "PotentialDisplays", "OverallCompetitionWin", "ViewableDisplays", "NonViewableDisplays", "UntrackableDisplays", "Frequency", "InvalidDisplays", "InvalidClicks", "ResultType", "VideoStarted", "VideoFirstQuartile", "VideoMidpoint", "VideoThirdQuartile", "VideoCompleted", "VideoAvoc", "VideoStartRate", "VideoCompletionRate", "VideoAverageViewRate", "VideoCpv", "VideoCpcv", "PotentialUsers", "RetailerMarginEuro", "PlatformFeeEuro", "AllInMediaCost", "NetMediaCost", "Cos" ], "type": "string" }, "description": "List of metrics for the report. Provide at least one metric to return performance data; otherwise, the response will include only dimension-related information." }, "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": { "type": "string", "description": "Optional timezone used for the report. Timezone Database format (Tz).", "default": "UTC", "nullable": true } }, "additionalProperties": false, "description": "This is the message defining the query for Adset report" }, "Tag": { "type": "object", "properties": { "htmlTag": { "type": "string", "description": "Html tag", "nullable": true }, "size": { "$ref": "#/components/schemas/Size" } }, "description": "Entity specifying the html of the tag and its size" }, "TransactionsReportQueryMessage": { "required": [ "advertiserIds", "currency", "endDate", "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." }, "currency": { "type": "string", "description": "The currency used for the report. ISO 4217 code (three-letter capitals)." }, "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" }, "eventType": { "enum": [ "Click", "Display" ], "type": "string", "description": "Optional event type to filter on. If empty, all event types will be included.", "nullable": true }, "format": { "enum": [ "csv", "excel", "xml", "json" ], "type": "string", "description": "Optional file format of the generated report.", "default": "json" }, "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": { "type": "string", "description": "Optional timezone used for the report. Timezone Database format (Tz).", "default": "UTC", "nullable": true } }, "additionalProperties": false, "description": "This is the message defining the query for Transaction report" }, "TransactionsReportQueryMessageListRequest": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/TransactionsReportQueryMessageResource" }, "nullable": true } }, "additionalProperties": false, "description": "A top-level object that encapsulates a Criteo API request for several value objects." }, "TransactionsReportQueryMessageResource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/TransactionsReportQueryMessage" }, "type": { "type": "string", "description": "Type of the resource.", "nullable": true } }, "additionalProperties": false, "description": "A value resource exposed by the API." }, "TransparencyQueryMessage": { "required": [ "endDate", "startDate" ], "type": "object", "properties": { "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" }, "shouldDisplayProductIds": { "type": "boolean", "description": "Specify if the product ids are displayed in the report.", "default": false }, "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" } }, "additionalProperties": false, "description": "This is the message defining the query for Transparency report" }, "TransparencyReport": { "required": [ "advertiserId", "files", "tokenValidUntil" ], "type": "object", "properties": { "advertiserId": { "type": "string" }, "files": { "type": "array", "items": { "$ref": "#/components/schemas/TransparencyReportFile" } }, "tokenValidUntil": { "type": "string", "format": "date-time" } }, "additionalProperties": false, "description": "This is the message defining the attribute response for Transparency report", "nullable": true }, "TransparencyReportFile": { "required": [ "fileName", "url" ], "type": "object", "properties": { "fileName": { "type": "string" }, "url": { "type": "string" } }, "additionalProperties": false, "description": "This is the message defining the file response for Transparency report" }, "TransparencyReportListResponse": { "type": "object", "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/TransparencyReportResource" }, "nullable": true }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "description": "Errors that occured during this call.", "nullable": true, "readOnly": true }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/CommonProblem" }, "description": "Warnings that occured during this call.", "nullable": true, "readOnly": true } }, "additionalProperties": false, "description": "A top-level object that encapsulates a Criteo API response for several value objects." }, "TransparencyReportResource": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/TransparencyReport" }, "type": { "type": "string", "description": "Type of the resource.", "nullable": true } }, "additionalProperties": false, "description": "A value resource exposed by the API." }, "UpdateCoupon": { "required": [ "startDate" ], "type": "object", "properties": { "endDate": { "type": "string", "description": "The date when when we will stop to show this Coupon. If the end date is not specified (i.e. null) then the Coupon will go on forever\r\nString must be in ISO8601 format", "nullable": true }, "startDate": { "type": "string", "description": "The date when the Coupon will be launched\r\nString must be in ISO8601 format" } }, "description": "Entity to edit a Coupon" }, "VideoDetail": { "required": [ "duration", "shape", "url" ], "type": "object", "properties": { "duration": { "type": "number", "description": "The duration of the video in milliseconds, the video could be trimmed if it is longer than 30000 ms.", "format": "double" }, "shape": { "enum": [ "Horizontal", "Vertical", "Square" ], "type": "string", "description": "Shape of the video" }, "url": { "type": "string", "description": "URL of the video uploaded on demostatic.criteo.com when deploying and then static.criteo.net", "format": "uri" } }, "description": "Entity consists of the url of the video, its duration and its shape." }, "WriteModelAdSetId": { "type": "object", "properties": { "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "description": "Canonical type name of the entity", "nullable": true, "example": "AdSetId" } }, "description": "write model data for resources" }, "WriteModelPatchAdSetV24Q3": { "type": "object", "properties": { "attributes": { "$ref": "#/components/schemas/PatchAdSetV24Q3" }, "id": { "type": "string", "description": "Id of the entity", "nullable": true }, "type": { "type": "string", "description": "Canonical type name of the entity", "nullable": true, "example": "PatchAdSetV24Q3" } }, "description": "write model data for resources" } }, "securitySchemes": { "oauth": { "type": "oauth2", "flows": { "clientCredentials": { "tokenUrl": "https://api.criteo.com/oauth2/token", "scopes": { } }, "authorizationCode": { "authorizationUrl": "https://api.criteo.com/oauth2", "tokenUrl": "https://api.criteo.com/oauth2/token", "scopes": { } } } } } }, "security": [ { "oauth": [ ] } ], "tags": [ { "name": "Advertiser" }, { "name": "Analytics" }, { "name": "Audience" }, { "name": "Campaign" }, { "name": "Creative" }, { "name": "Gateway" } ], "x-samples-languages": [ "java", "python", "php", "csharp", "javascript", "curl", "ruby" ] }