Integrate with Campaign Manager

Corina Alonso Updated by Corina Alonso

Setting up the integration

To connect your AudienceReport account to your Campaign Manager, you just need to follow these simple steps. The Campaign Manager integration will allow automatic tagging of your campaigns and ingest your campaigns as items in AudienceReport so that you can choose which ones to measure. 

Navigate to the upper right corner of your screen, click on your account and select “integrations”. You will land on the integrations’ overview, then scroll until you find the Campaign Manager logo. You will be guided through the integration flow.

First, you need to allow AudienceReport access to your Campaign Manager. To do so, invite the email shown on the screen to your Campaign Manager, by adding it as a user. You should grant access to all of the listed items, in order to measure your campaigns accordingly. Once you have done this, the screen will show you if the access was granted successfully or not. Then select the profile to manage this integration. 

This is an example email - you should invite the email that is shown in your own integration setup.

Now, you need to select which advertisers you would like to measure. Select from the dropdown which advertisers you would like to measure, or check which advertisers are already linked to client accounts.

Afterwards, you will have different options to set up the integration, depending on how you work within Campaign Manager. If you are unsure, click on the “guide” to see more information.

You can choose between measuring all campaigns (recommended), or only selected campaigns. Then, decide whether video metrics should be tracked automatically. 

Finally, confirm that all information for your integration is correct and click on “enable integration” to finish the process.

Actions the integration performs inside Campaign Manager

Setting up Event Tags on selected Advertisers

For each CM Advertiser selected for measurement, the worker will create two Impression Event tags and one Click Event tag.

If you have chosen to measure all campaigns, it will translate to Application type = Automatically; otherwise, it is Application type = Manually.

The integration worker updates the Application type to match the user-selected state in the AudienceReport interface as the first step in its work. So, if the user changes the setting in the AudienceReport interface, it will propagate to the Campaign Manager within an hour.

The worker creates event tags only once. If you delete the event tag or change the URL, the integration will not fix that. So you should not modify the tracker until you know what you do.

As an emergency break, you can change Enabled = No, then the Event tag will not apply to the placements. However, video quartile pixels will still be applied to Creatives. 

A campaign can have only one Click tracking tag enabled. Therefore we gave the power of applying it to the customer. If the customer wants to measure clicks, they need to tick the radio button near the Click tracker tag.

Setting up Video funnel events on Video creatives.

With the integration, impressions of video ads are measured regardless of the quartile setting.

To measure the video quartile, you need to make an active decision. In CM, quartile pixels need to be added to each Creative. The worker has the following logic.

  1. Find all future or active Video Ads with applied AudienceReport - Impression pixel (Integration v2) Event tag;
  2. Find all Creatives associated with these Ads, filter out previously processed Creatives;
  3. Add quartiles pixels to these Creatives;
  4. Remember the fact of adding pixels.

Given that Creative can be associated with multiple Ads, Placements or even Campaigns, we add pixel if at least one measured Ad references the Creative.

Real-life case explanation

Setup:

  • Campaign 1 has a single Video ad that references Creative 1 and Campaign 1 needs to be measured
  • Campaign 2 has a single Video ad that references the same Creative 1 and Campaign 2 should not be measured

Expected behaviour:

  • Video funnel pixels are added to Creative 1
  • When Campaign 1 is delivered, we receive impressions and video funnel events with Campaign 1 specific tailcode
  • When Campaign 2 is delivered, we video funnel events with Campaign 2 specific tailcodes. These events are not reported in the AudienceReport interface and don’t sum up to Campaign 1 funnel events.

If you remove pixels manually, the integration will not re-add them.

Usage guides

Caveats of working with Publisher hosted creatives (Display)

When you work with Publisher hosted creatives, you create Tracking ads and send codes to Publishers, there are a few options and one of them is Pixel. The Publisher needs to implement any option, except Pixel, as Pixel does not redirect to AudienceReport pixel.

If Publisher can't implement Script/iFrame options due to technical limitations, the publisher needs to implement two pixels:

  1. Your Campaign Manager pixel, so impressions are counted in Campaign Manager
  2. Placement pixel for this Campaign extracted in AudienceReport interface

If Publisher doesn't have the ability to implement multiple pixels, then the campaign can't be measured with AudienceReport.

Caveats of working with Publisher hosted creatives (Video)

In this case, the Publisher has to implement AudienceReport pixels manually.

Extract Placement pixel for this Campaign in the AudienceReport interface and send to Publisher.

How to enable Campaign for measurement in Manual mode

Open Campaign properties, navigate to Event tagsAdvertiser tags

Select AudienceReport - Impression pixel (Integration v2) and AudienceReport - Viewability script (Integration v2) event tags, and press “Always apply”. If there are no Display creatives on the campaign, then AudienceReport - Viewability script (Integration v2) may be omitted.

Once done, tags will appear on the Applied tags tab

How to disable AudienceReport pixels on part of the campaign?

Event tags can be disabled on Ad level. In the Campaign view:

  1. open Ad settings
  2. navigate to Event tag
  3. press Advertiser/Campaign tags
  4. select AudienceReport - Impression pixel (Integration v2) and AudienceReport - Viewability script (Integration v2) event tags
  5. press “Never apply”
  6. Save Ad settings

How to setup click tracking

You can do it for the whole advertiser or for just for the selected campaign.

How did we do?

What is the Campaign Manager integration?

Contact