Integrate with Semi-automated integration

Corina Alonso Updated by Corina Alonso

Semi-automated integration is a feature that allows you to easily track your campaigns at scale without using one of our predefined integrations. We have automated the process if you wish to measure your campaigns at scale, but work on an ad server for that we do not have a direct integration yet. This means, that semi-automated integrations make it possible for you to achieve a scalable tracking solution without an AudienceReport predefined integration.

We currently support semi-automated integrations to the following platforms: Freewheel, Xandr, SpotX, Sizmek, Spotify, Flashtalking, MediaMath, Adform, Google Ad Manager, Campaign Manager, DV 360, and The Trade Desk.

If you wish to get a semi-automated integration, please reach out to your Customer Success Manager.

Add a new semi-automated integration

In order to create a new semi-automated integration, you could achieve this by either clicking on the “Manage” button under the Items page

or the link “Semi-automated integrations“ under the profile menu

Regardless of which option you choose, you will be directed to the dedicated page for Semi-automated integrations. 

To create a new semi-automated integration, you just click the “+ Add new” button. Then you’re prompted with the setup wizard with an introduction step explaining how to use the feature.

Introduction 

The purpose of semi-automated integrations is to automate the process of creating custom items and implement tags each time you want to measure a campaign with AudienceReport. Please note that each client has their own tag. In order to proceed to the next step, simply click either the “Get started“ or “Next: Setup“ button. 

Setup

As a first option in the setup step, you’re prompted with a list of the platforms we currently support. These are Freewheel, Xandr, SpotX, Sizmek, Spotify, Flashtalking, MediaMath, Adform, Google Ad Manager, Campaign Manager, DV360, and The Trade Desk. Additionally, you can create your own platform and integrate it with AudienceReport. Depending on the selection, AudienceReport will automatically generate the corresponding macros for each platform. 

In the same step, you will also be able to select the clients for which will be possible to measure and download tags, as well as, the events you wish to measure tags. 

Once you complete the setup step, you will be able to proceed to the next step by clicking the “Next: Macros“ button.

Macros

In this step, you are able to configure the appearance of the created items and enter relevant macros. In this example, SpotX has been selected as the platform to set up a semi-automated integration. In this case, AudienceReport prepopulates the corresponding available macros such as ID Macro for the campaign as well as additional macros for Advertiser ID, App ID, Mobile Ad ID, IP Address, URL, and Cachebuster. You are able now to update/edit the macros or add new ones by clicking on the “Add parameter“ button. You are also able to control the granularity and appearance of the items created in AudienceReport by adding more levels.

The outcome of the first section called “Item level macros“ allows you to define how the item would look when ingested in AudienceReport. 

The outcome of the second section called “Additional macros“ allows you to collect more parameters in the measurement request so we have the most advanced measurement possible.  

There is also the ability to add a parameter if it doesn’t exist. By clicking the “Add parameter“ button, you are prompted with a modal window to insert a parameter name and corresponding macro. These will be inserted into the tracking pixel.

Next click on the “Next: Mappings” button to proceed with the next step.

Mappings

In this step, you are able to apply ID mappings using a Google sheet for convenience and in case you wish to work with mappings at scale. You are able to invite users to get access to the spreadsheet/mappings sheet in order to edit it. 

Also, an email is silently sent out to the CSM team at csmgroup@audienceproject.com so they are able to get access to the file in case an employee is not able to access it anymore or ownership of the file needs to be transferred. 

This action requires a Google account since the mappings sheet is created in Google Sheets.

In this example, a relevant mapping sheet is created and is used to make the created item names more understandable by applying the corresponding ID mappings. In the first sheet called “Introduction“, you can find all the relevant instructions on how to use the mappings

Below there is an example of various campaign IDs along with their corresponding campaign names that are being measured in AudienceReport coming from a semi-automated integration with Google Ad Manager (as an example). You should add Campaign ID(s) and Campaign name(s) to the sheet manually.

If you wanna change the name(s) of campaigns/line items/etc in the list please click the ‘Sync titles from mapping sheet’ button after you change them. We are of course updating the names automatically after we receive new events for that campaign, so the button ‘Sync titles from mapping sheet’ was created simply to speed up this process.

Implementation of the Tag

In the spreadsheet in the tab called 'Tags', you can find the tag created for your client. You have to take the needed format of the tag and implement it in your Adserver.

Some examples:

For DV360: you have to add pixels to each creative. HTML or Script format for Display campaigns, Pixel: Impression for Video ones.

For Adform: you have to add pixels to each tag

For Campaign Manager: you have to add pixels on the advertiser or campaign level

etc.

If you change in the Setup tab the list of clients you want to measure it will be reflected in the spreadsheet - new trackpoints will be added

Reporting of Semi-automated integrations

Every time an ad is delivered and a pixel is fired, AudienceReport identifies the data coming from the ad server and measures it.

In terms of reporting, it works like any other direct integration of AudienceReport. This includes all relevant metrics:

  • Reach in target group
  • Frequency
  • Hit rate
  • On-target percentage
  • Events in the target group

And all relevant demographics:

  • Gender
  • Age
  • Income
  • Employment
  • Education
  • Household size
  • Children in household

How did we do?

Contact