Track Changes

Greta
Greta
  • Updated

View Your DMP Account Change Log With API

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"}]

Track Progress and Get Notifications With API

You can track your DMP account activity by using notifications. Differently from the change log that tracks all changes within the account, the notifications show information about higher-level, non-user activities, such as generated reports. Each activity includes the date and time, as well as completion status, if applicable.

Use notifications to keep track of account activities that happen in the background and can take longer to finish, such as creating audiences in bulk, onboarding audience data, and generating reports. You can check them to see if all actions are completed or if there are any issues that need to be fixed.

With the Event section of the Data Management Platform API, you can retrieve a list of all notifications and mark each of them as acknowledged.

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 track progress using notifications, Adform DMP user account must have this permission assigned by the business account admin:

  • Manage 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.events: Grants access to the Event 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 notifications with API, use the following IDs in your requests:

ID

Used To

Retrieve From

dataProviderId

Specify the data provider account for which to get notifications

DataProvider section in Data Management Platform API

Note

Additional IDs might be used, but the listed ones are required to pass a request.

Workflow

If you've imported a taxonomy file for bulk audience creation, uploaded an audience data file, or sent a DMP report request, you can track the progress using notifications.

Tip

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

To track progress using notifications with API, use this endpoint:

Endpoints

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

Was this article helpful?

/
How can we make it better?

Thank you for your feedback!