Collecting data from Adform (Buyer)

This guide explains how to collect data from Adform (Buyer). To learn how to collect data from a different data source, go back to the Available data sources in Adverity overview.

  • Adform (Buyer) can collect a maximum of 1 million rows per single report. To fetch more data than this, split your fetch into smaller date ranges in the Initial Fetch step of creating a datastream.

Creating a datastream to collect data from Adform (Buyer)

The basics of creating a datastream to collect data from any data source are explained in our guide to Creating a datastream. This guide contains information about the specific steps to create a datastream to fetch data from Adform (Buyer).

Authorization: Allow Adverity to access Adform (Buyer)

  1. If you choose Access using your credentials or Access using someone else's credentials, in Set up or edit Advertisers, you or the person granting access must choose one of the following options:

    • Choose Grant access to all Advertisers, including those created in the future to allow Adverity to access all existing Advertisers and all Advertisers created in the future.

    • Choose Select specific Advertisers to which you want to grant access to determine the specific Advertisers that you want Adverity to access. Adverity will not automatically have access to Advertisers created in the future. You will need to grant Adverity access to any Advertisers created in the future.

    If you use your credentials to grant Adverity access to Adform (Buyer), all the Advertisers available to you using your credentials will be visible in the Authorizations page to all Adverity users with permission to edit this authorization.

    If someone else uses their credentials to grant Adverity access to Adform (Buyer), the same applies to the Advertisers available using their credentials.

    This is important to consider if you do not want all Adverity users with permission to edit the authorization to be able to see the details of the Advertisers. For more information about user permissions, see Managing user permissions.

Configuration: Choose the data you want to collect from Adform (Buyer)

To choose what data to collect and customize the Adform (Buyer) datastream configuration, follow these steps:

  1. (Optional) Rename your datastream.

  1. In Report type, select the type of data to collect from Adform (Buyer).

  1. In Advertisers, Campaign statuses and Campaigns, select the advertisers, campaign statuses and campaigns for which to collect data. If you do not select any items in a drop-down list, Adverity collects data for all items in the drop-down list.

  1. In Dimensions and Metrics, change the list of fields that you want to see in your data extract.

  1. (Optional) In Complex Metrics, specify the Adform (Buyer) metric settings using JSON code. For more information, see Advanced Adform (Buyer) tips.

What's next?

Troubleshooting Adform (Buyer)

My Adform (Buyer) fetch is taking a long time

Adform (Buyer) has a daily request limit per customer. Once this limit is reached, Adverity has to wait until the next day to continue the fetch. Your fetch will continue the next day.

Advanced Adform (Buyer) tips

Collecting advanced metrics from Adform (Buyer)

Adverity allows you to fetch advanced metrics from Adform (Buyer) connector by entering the JSON code in the Complex Metrics field in the datastream configuration page.

Finding the Complex Metrics field

To find the Complex Metrics field, follow these steps:

  1. Select the workspace you work with in Adverity and then, in the platform navigation menu, click Datastreams.

  2. Open the Adform (Buyer) datastream by clicking on its name.

  3. In the top navigation panel, click Settings.

Find the Complex Metrics field at the bottom of the configuration page.

Editing Complex Metrics field

In Adverity, you can edit the advanced metric settings in Complex Metrics field. To change the advanced metric settings, there are various parameters and values you can use in JSON format. To edit the Complex Metrics field, follow these steps:

  1. In the Complex Metrics field, paste the following code:

    [
        {
            "metric":"conversionsSpecs",
            "specs":{
                "pageCategory":"download",
                "adInteraction":"all",
                "visitUniqueness":"noRepeat",
                "conversionType":"conversionType2"
            }
        }
    ]

    Note: This code is identical to the following settings in Adform user interface (advanced metric settings):

  2. Click Save.

  3. In the top right corner, click Fetch now.

  4. Choose the time period for which data is collected.

  5. Click Fetch.

You can now edit the Data Mapping for the conversionSpecsmetric in Data Mapping configuration page.

The example above specifies just one metric. However, you can include multiple metrics in the Complex Metrics field. See the example of JSON code with three metrics with various parameters and values below:

[
    {
        "metric":"conversionsSpecs",
        "specs":{
            "pageCategory":"download",
            "adInteraction":"all",
            "visitUniqueness":"noRepeat",
            "conversionType":"conversionType2"
        }
    },
    {
        "metric":"conversionsSpecs",
        "specs":{
            "pageCategory":"infoPages",
            "adInteraction":"all",
            "visitUniqueness":"noRepeat",
            "conversionType":"conversionType3"
        }
    },
    {
        "metric":"visits",
        "specs":{
            "pageCategory":"allPages",
            "adInteraction":"recentClick"
        }
    }
]

Available parameters and values

This section lists all available values and parameters you can combine for use in the Complex Metrics field. Some combinations metrics and parameters may not be possible in Adform (Buyer) connector. For example, the visitsmetric cannot be used with the parameter visitUniqueness.

If you enter an unsupported combination of parameters and values for a specific metric, Adverity displays an error message during the fetch. Edit the Complex Metrics field and remove any parameters and values which are not provided for a specific metric and fetch the data again.

Parameter

Values

adInteraction

  • all

  • postClick

  • postImpression

  • recentClick

  • recentImpression

  • allCampaign

  • allNonCampaign

mpAmountType

  • net

  • net2

  • gross

mpCalculationTime

  • reportingPeriod

  • total

viewSettings

  • viewSettings1

  • viewSettings2

  • viewSettings3

adUniqueness

  • all

  • campaignUnique

  • campaignDayUnique

  • mediaUnique

  • lineItemUnique

  • lineItemDayUnique

  • bannerUnique

  • notCampaignUnique

conversionType

  • allConversionTypes

  • conversionType1

  • conversionType2

  • conversionType3

pageCategory

  • allPages

  • landingPages

  • infoPages

  • signUpPages

  • none

  • homepage

  • productPage

  • thankYouPage

  • download

visitUniqueness

  • noRepeat

  • all

  • pointSession

  • pointCampaign

  • allSitesCampaign

  • orders

  • sessions

timeScope

  • days

  • weeks

  • months

  • years

dataSource

  • adform

  • se

costDataSource

  • adform

  • se

costType

  • maxCost

  • fixedCost

  • fixedPrice

  • rtb

Filtering Adform tracking points

Adform enables you to configure tracking points on your website to track user interaction. You can filter and sort the tracking points with tracking filters. For more information, see the Adform documentation.

To configure data collection about tracking filters, follow these steps:

  1. Select the workspace you work with in Adverity and then, in the platform navigation menu, click Datastreams.

  2. Open the Adform (Buyer) datastream by clicking on its name.

  3. In the top navigation panel, click Settings.

  4. Fill in the following fields:

    Include tracking campaigns

    Select this checkbox to collect website event data about users who did not visit the website through Adform campaigns.

    All tracking filters

    Select this checkbox to collect data about all tracking filters.

    Tracking filters

    Select specific tracking filters you created in the Adform user interface.

    Isolate tracking filters

    Select this checkbox to create separate rows in your data extract for each tracking filter. You will most likely retrieve different results in the data extract compared to the default configuration.