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. 

First, navigate to the upper right corner of your screen, click on your initials, and select “Integrations”. Then click on '+Add new' and select Campaign Manager integration. After that, you will be guided through the integration flow.

Please note that if there is already existing Campaign Manager integration in the list of integrations you can continue using it

After you click 'Get started', 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 with the following permissions:

  • Ads: read-only access
  • Advertiser management: modify access
  • Creatives: full access
  • Placement costs: read-only access
  • Sites: read-only access to properties
  • Subaccounts: read-only access
  • Tags

For example, the user role “Agency Trafficker” includes all the needed permissions mentioned above to measure your campaigns.

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

Once you have done this, click on 'Continue' and the screen will show you if the access was granted successfully or not. Then select the profile to manage this integration. 

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 the 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, and 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 quartile 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 behavior:

  • 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 a Publisher that hosts creatives, you create Tracking Ads and send codes to Publishers. There are a few options and one of them is Impression Tag in Image format. The Publisher needs to implement any option, except Image, as the tag in Image format does not redirect to AudienceReport pixel. The Publisher should implement Script or iFrame options.

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

  1. Your Campaign Manager pixel, so impressions are counted in Campaign Manager (it's the Impression Tag in Image format)
  2. The placement pixel for this Campaign that should be extracted from the AudienceReport interface (the format - Pixel URL: Impression). When doing that, you should ask a Publisher what ad-server they are using and pick it when exporting pixels. Then AudienceReport adds all the recommended macroses automatically

If the Publisher doesn't have the ability to implement multiple pixels, then you have to build a pixel manually that is Campaign Manager's pixel plus AudienceReport Impression Pixel URL. Here is an example:

Then the pixel to implement is https://doubleclick..../ad=12;crid=123?https://visitanalytcs.../hit?t=XXXtailcode&...

You don't need to make any changes to any of pixel - no need to add spaces or anything else.

Caveats of working with Publisher hosted creatives (Video)

In this case, you have to provide the Publisher with two pixels and they have to implement them:

  1. Your Campaign Manager pixel, so impressions are counted in Campaign Manager (it's the Impression Tag in Image format)
  2. The placement pixel for this Campaign that should be extracted from the AudienceReport interface (the format - Pixel URL: Impression). When doing that, you should ask a Publisher what ad-server they are using and pick it when exporting pixels. Then AudienceReport adds all the recommended macroses automatically

If the Publisher doesn't have the ability to implement multiple pixels, then you have to build a pixel manually that is Campaign Manager's pixel plus AudienceReport Impression Pixel URL. Here is an example:

Then the pixel to implement is https://doubleclick..../ad=12;crid=123?https://visitanalytcs.../hit?t=XXXtailcode&...

You don't need to make any changes to any of pixel - no need to add spaces or anything else.

How to enable a 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

If you have Video creatives: after you press 'Always apply' to the above-mentioned event tag(s), the integration understands that this campaign is measuring and then finds all video creatives and adds to them video pixels automatically

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 just for the selected campaign.

How did we do?

What is the Campaign Manager integration?

Contact