Adform Data Management Platform (DMP) reports provide you with data to understand your audience usage and size. You can start generating DMP reports once you have active audiences that are being targeted.
Tip
For more information, see articles about DMP reporting.
DMP reports provide a comprehensive overview of audience performance. Use these reports to understand your audience behavior and growth. These insights can help refine your targeting or audience setup, and ultimately improve audience performance through data-driven insights.
With the Report V2 section of the Data Management Platform API, you can generate these reports:
-
Data Usage: Provides data about audience activity and performance, including generated impressions, click-through rates, generated leads, and revenue.
-
Audience: Provides data about audience growth.
Additionally, you can generate overall audience data reports for all data providers or a particular one.
To authenticate and use Adform APIs, your user account must have the necessary permissions and your OAuth client must have the required scopes assigned to it.
To generate DMP reports, Adform DMP user account must have this permission assigned by the business account admin:
-
View DMP Entities
You also need the following scope assigned to your OAuth client by Adform Support (dmp@adform.com):
-
https://api.adform.com/scope/dmp.reports.readonly: Grants access to the ReportV2 section of the Data Management Platform API. -
https://api.adform.com/scope/dmp.accountpermissions.readonly: Grants access to Advertiser section of the Data Management Platform API. -
https://api.adform.com/scope/dmp.agencies.readonly: Grants access to Agency section of the Data Management Platform API.
Tip
If you don't have an OAuth client yet, follow the procedure in Get Authentication Credentials for Adform APIs to register one.
To generate DMP reports with API, use the following IDs in your requests:
|
ID |
Used To |
Retrieve From |
|---|---|---|
|
|
Specify the DMP account for which the reports will be generated |
DataProvider section in Data Management Platform API |
Note
Additional IDs might be used, but the listed ones are required to pass a request.
Tip
To learn how to use Adform APIs, read Guide to Using Adform APIs.
To generate DMP reports with API, use these endpoints:
-
(Optional) GET endpoint in Advertiser section of Data Management Platform API: To retrieve the list of available advertisers that you might see in Data Usage reports.
-
(Optional) GET Endpoints in Agency section of Data Management Platform API: To retrieve the list of available agencies that you might see in Data Usage reports.
-
GET endpoints in Report V2 section of Data Management Platform API: To retrieve the Data Usage or Audience reports of a DMP account.
Tip
See examples of how to retrieve audience and data usage reports in DMP Postman collection.
[{"api":"Data Management Platform","titles":"Advertiser, Agency, ReportV2"}]