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.
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)
-
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 page to all Adverity users with permission to edit this .
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 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:
-
(Optional) Rename your datastream.
-
In Report type, select the type of data to collect from Adform (Buyer).
-
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.
-
In Dimensions and Metrics, change the list of fields that you want to see in your data extract.
-
(Optional) In Complex Metrics, specify the Adform (Buyer) metric settings using JSON code. For more information, see Advanced Adform (Buyer) tips.
What's next?
-
Apply Data Mapping to your collected data to harmonize data collected from different sources in Adverity.
-
Transform your data to meet your needs by creating and applying enrichments to your datastream.
-
Load your data into Explore & Present to visualize your data in Adverity
-
Load your data into an external destination of your choice
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:
-
Go to the Datastreams page.
-
In the Settings.
, click
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:
-
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):
-
Click Save.
-
In the top right corner, click Fetch now.
-
Choose the time period for which data is collected.
-
Click Fetch.
You can now edit the Data Mapping for the conversionSpecs
metric 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 visits
metric 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 |
|
mpAmountType |
|
mpCalculationTime |
|
viewSettings |
|
adUniqueness |
|
conversionType |
|
pageCategory |
|
visitUniqueness |
|
timeScope |
|
dataSource |
|
costDataSource |
|
costType |
|
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:
-
Go to the Datastreams page.
-
In the Settings.
, click -
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.
-