---
schema_version: "1"
id: 4512bc85db2ec44cc36a687f23ee0cbb849d616317d6e9ebbdcaeacbae3e7e62
title: Adform API Connector
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/mktg/264-0-0/dato_data_streams_api_connect_adform.md
canonical_url: https://help.salesforce.com/s/articleView?id=mktg.dato_data_streams_api_connect_adform.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: fc7d0e7af90e686f7d963727ce064cc645ad340513aa82e98e9c163e0846a44f
description: The Adform API connector retrieves Leads data. The data is aggregated and can only be seen at the campaign level.
products:
  - Marketing
  - Marketing Cloud Intelligence
release: "264"
---
# Adform API Connector

The Adform API connector retrieves Leads data. The data is aggregated and can only be seen at the campaign level.

You might see some discrepancies in the Media Cost data, due to a difference between the API report and the report sent to the user.

- Channel: Display
- Cost Data lagging: 1 Day back

## Prerequisites

- A valid Adform username and password with user level API access enabled. To enable API access, go to your user profile screen and check the 'External API' checkbox
- If your username and password don’t grant you access to the API, contact your Adform representative.
- Adform has password complexity requirements for API users. If these requirements aren’t fulfilled, an ‘Invalid credentials’ error appears and you won’t be able to create the OAuth.
- Password requirements:
    - Minimum 6 symbols
    - Upper and lower case letters
    - Numbers
    - At least 1 Special character

## Additional Details

- The maximum date range accessible through the API is 365 days from today. For example, last year's data is available through the Adform API.
- If the same credentials used to set this API are used in an additional Workspace, make sure to set the Level to 'Account' through the Authentication edit window.

## Extended Properties

- **Cost Type** – Set the Cost type to match the Cost Type set in your Adform account. You can see the cost type set in your Adform account be clicking the Cost column.
- **Get Banner Data** – This checkbox pulls Creative Level Dimensions from Adform. After choosing this checkbox, the following Dimensions are pulled to the Data Stream:
    - Creative Key (AdID)
    - Creative Name (AdName)
    - Creative Category (bannerFormat)
    - Creative Format (AdType)
    - Creative Custom Attribute 01 (AdWidthxAdHeight)
    - Creative Custom Attribute 02 (AdFileSize)
- **Get Conversion Data** – This checkbox pulls Conversion Data to the ‘Conversion Tag’ Bucket. The following Dimensions and Measurements are pulled to the Data Stream:
    - Conversion Tag Key (pageID)
    - Conversion Tag Name (page)
    - Total Conversions (conversions)
    - Post Impression Conversions (PostImpressionLeads)
    - Post Click Conversions (PostClickLeads)
    - Post Impression Revenue (PostImpressionSales)