Discard
GuidesAPI ReferenceChangelogDiscussions
GuidesAPI ReferenceChangelogDiscussionsLog In

Placement Report Dimensions, Metrics and Filters

Dimensions

Dimensions requested in the API call will return data detailing delivery. The dimensions requested in the POST call will be returned for each row of data returned in the report. There are no restrictions on the number of dimensions or the order of dimensions. Dimensions are provided as an array of strings in the POST request. The full list is below:

Field

Description

advertiserId

Id of the advertiser

adsetId

Id of the ad set

adsetName

Name of the ad set

environment

Web/Android/iOS

placement

The name of the ad placement

The dimensions array of the request should contain all requested dimensions as strings in an array.

For example: ['placement','adsetId','environment']

Metrics

The metrics requested in the POST call will be returned for each available row of data. Metrics are provided as an array of strings in the data payload of the POST request to the API endpoint. The full list of metrics is below:

Field

Description

clicks

The number of clicks driven by the add.

displays

The number of displays/impressions of ads served on sites through the Criteo Publisher Network.

cost

The amount of money spent on Criteo advertising.

salesPc30d

The number of completed e-commerce transactions or purchases. Attribution model pc30d

salesPv1d

The number of completed e-commerce transactions or purchases. Attribution model pv1d

revenuePc30d

The amount of money generated by the online sales. Attribution model pc30d

revenuePv1d

The amount of money generated by the online sales. Attribution model pv1d

cosPc30d

Cost Of Sales - the ratio between the cost generated by the campaign(s) vs. the revenue generated by the sales, figured as a percentage. Attribution model pc30d

cosPv1d

Cost Of Sales - the ratio between the cost generated by the campaign(s) vs. the revenue generated by the sales, figured as a percentage. Attribution model pv1d

roasPc30d

Return On Ad Spend - the ratio between the revenue generated and the cost. Attribution model pc30d

roasPv1d

Return On Ad Spend - the ratio between the revenue generated and the cost. Attribution model pv1d

cpoPc30d

Cost Per Order - the amount of money that needs to be spent to get one order or transaction. Attribution model pc30d

cpoPv1d

Cost Per Order - the amount of money that needs to be spent to get one order or transaction. Attribution model pv1d

cvrPc30d

ConVersion Rate - the percentage of completed purchases compared to the clicks that occurred. Attribution model pc30d

cvrPv1d

ConVersion Rate - the percentage of completed purchases compared to the clicks that occurred. Attribution model pv1d

The metrics array of the request uses the same format as the dimensions array.

For example: ['clicks','displays','roasPc30d']

Filters

Filters can be used to be more selective about the data returned in the response and produce a more focused report. A number of filters are required to make a query to the Placement Report endpoint. Filters are provided as properties to the "attributes" object in the data payload of the POST request to the API.

Field

Description

Optional/Required

Type

Default Value

startDate

start of the period

required

DateTime

endDate

end of the period

required

DateTime

advertiserIds

List of Advertiser Ids separated by commas

required

string of ID's separated by commas

adsetIds

List of Ad Set Ids separated by commas

optional

string of ID's separated by commas

adsetName

Filter for Ad Set names

optional

string

environment

Web/Android/iOS

optional

string

timezone

Time zone used for dates

required

Timezone

currency

Currency used for amounts

required

ISO 4217 Currency Code

placement

Filter the value of the placement

optional

string

format

Format of the report provided in the response (json, xml, csv, xls)

optional

string

CSV

disclosed

undisclosed exchanges for which we don't have the domain

required

string

true


Did this page help you?