View Your DMP Account Change Log With API

Solveiga
Solveiga
  • Updated

The change log helps you keep track of changes made in your Data Management Platform (DMP) account. For example, it shows newly created audiences, added categories, and recently changed permissions, descriptions, or fees.

Tip

For more information about DMP change log, see Use Change Log.

You can access the change log to review recent activity on your DMP account or verify who made specific updates. This helps you monitor account activity, oversee access control, or troubleshoot audience performance issues.

Note

The change log stores records from the past 3 months.

With the Change Log section of the Data Management Platform API, you can retrieve a list of change log records for a DMP account.

Authentication

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 retrieve the change log, 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.auditlog.readonly: Grants access to the ChangeLog 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.

Prerequisites

To retrieve the change log of your DMP account with API, use the following IDs in your requests:

ID

Used To

Retrieve From

dataProviderId

Specify the DMP account ID for which you want to view the change log

DataProvider section in Data Management Platform API

Workflow

Tip

To learn how to use Adform APIs, read Guide to Using Adform APIs.

To retrieve the change log of your DMP account with API, use this endpoint:

  1. GET endpoint in ChangeLog section of Data Management Platform API: To retrieve a list of change log entries for the past 3 months.

    Note

    To retrieve change log data for a shorter period, for example, only the past 1 or 2 months, add the "from" parameter to your query and specify a date and time.

Endpoints

[{"api":"Data Management Platform","titles":"ChangeLog"}]

Was this article helpful?

/
How we can make it better?

Thank you for your feedback!