Non-CM360-Integrated Tags: Creation, Implementation, and Reporting
Edited

Note: "CM360-integrated" refers to our platform's CM360 integration. If you're using CM360 as your primary ad server, please integrate your CM360 Campaign(s) and proceed with this tagging article instead.

If CM360 is not your primary ad server, please proceed with the tagging instructions below. 

Overview

Upwave’s Tag Manager makes it fast and easy for you to create tags on-demand for measuring your campaign. We’ve worked with hundreds of media platforms to build a comprehensive tagging library that pass creative and placement-level details from your ad server directly into the Upwave platform. This allows you to achieve cut-level insights for monitoring the performance of your campaign.

This article shows you how to use Upwave’s Tag Manager and implement those tags successfully! You may also watch the video below, which gives you a full walkthrough of this process. 

Measure Your Campaign with Upwave Tags

Create Your Tags

Log into your account on app.upwave.com. Here, you'll see any 'Campaign Cards' associated with your account: 

Note: If you don’t have a login, ask the person who created the campaign to invite you to their Team using the Team dropdown in the upper-right of the dashboard. When they do, you’ll receive an email that you can use to login.

Click the ellipses in the top-right of the Campaign Card that you would like to create tags for. Then, select "Tag Management": 

If this is the first time generating tags for that campaign, you'll be redirected to our non-integrated Tag Management page: 

Click "Manage Media Platforms", where you can select the Media Platforms where tags will be implemented for that campaign. These Media Platform represent what ad servers/publishers that Upwave's tag code(s) will be physically copy/pasted into. 

Once you've made your selections, your Tag Management page will update to reflect your Media Platforms (as seen below).

To retrieve your Upwave tag code(s), select the checkbox(es) next to your tag(s). Then click "Activate and Download Tags" (this is what triggers all of the routines and notifications mentioned above). 

Note: "Activating and downloading" tags triggers a variety of routines and notifications associated with QAing that tag. As such, please only select Media Platforms if and when you plan on using them to avoid extraneous notifications to your Team. If you're not sure, no problem! The Tag Manager is always available, so you can come back later once they're confirmed.

Doing this will download an Upwave Tag File to your desktop:

Within your Tag File, you'll find the following columns: 

  1. Created: This is the date that the tag was created.

  2. Media Platform: This is the Media Platform in which that tag should be implemented. 

    1. Note: If the tag is implemented within a Media Platform that does not match this selection, it will not function correctly. This is because tags use proprietary macros that only expand when implemented within their designated ad servers. Please ensure you make the correct selections in your Tag Manager, and implement tags based on that selection, to avoid missed measurement.

  3. Tag Name: This name is automatically generated by the platform, and can be used to quickly reference each tag. 

  4. EID: This is the unique identifier for each tag (you will also see this value in the tag code). 

  5. Upwave Measurement Tag: This is the tag code that you will implement within your ad server/publisher. It is a standard image tag. 

  6. Reporting Email: This is where you must schedule impression reports for each tag to ensure accurate measurement. Please see the section below, "Schedule Required Impression Reporting", for more information on how to set these up.

Implement Your Tags

Now that you have your tag(s), it's time to implement! Navigate to your ad server to implement the Upwave Measurement Tag (or distribute the Upwave Measurement Tag to your designated partner(s) that will be implementing).

Implementation instructions vary across ad server. We have assembled more detailed implementation instructions for our most common ad servers if these are the Media Platforms that you are working with: The Trade Desk (TTD), Google Ad Manager (GAM), and Campaign Manager 360 (CM360).

Tips for implementation 

  1. Tags must be implemented within the Media Platform specified on your Tag File. Tags won’t function properly in Media Platforms that they're not intended. 

  2. Confirm that the macros generated in your tag will pass back the IDs necessary for mapping your audiences (these are the first 2 macros listed after &cid= in your tag code). We keep the most common macros on file, but it's always a good idea to confirm prior to implementation. 

    1. The first macro is your Creative level macro. When this macro expands, it should produce IDs that you’ll map to Creative Level Dimensions - like Creative Concept and Banner Size. 

    2. The next macro is your Placement level macro. When this macro expands, it should produce IDs that you’ll use to map Placement Level Dimensions - like Audience and Environment.

  3. Don’t modify the tag’s macros, or macro order, as it impacts how we parse your data. Tags must be implemented as provided in the Tag File. 

  4. The tag should be implemented on all placements you want to measure, and none of the placements you don’t.

  5. Tags fire in sequential order, so ensure the tag is implemented within the top 4 firing positions for most accurate measurement.

  6. Please note that when implementing, our tag returns a "204 No Content" status. This is a success code, not an error code. The tag will function as intended when placed in a live placement.

Schedule Required Ad Server Reporting

How Does My Tag Inform Ad Server Reporting?

Ad server reporting must be scheduled promptly after the Media Start Date you have inputted on your Campaign Information form for that campaign; this date informs our platform when to start QAing your tag(s). Reporting facilitates that QA (via Discrepancy Reports), as well as assists with mapping your audiences shortly after launch. 

To better understand our reporting requirements, let's first examine what an Upwave Event tag looks like. Below is an example for DFP/GAM, which includes that ad server's default macros for Creative ID, Placement ID and Site ID:

The IDs that flow through your first 2 macros are what we map your audiences to: 

  1. Macro #1: Mapped to Creative Dimensions such as Creative Concept, Banner Size, etc. (in this example, the IDs that flow through %ecid! would be mapped here).

  2. Macro #2: Mapped to Placement Dimensions such as Audience, Environment, Geo, etc. (in this example, the IDs that flow through %epid! would be mapped here).

Other ad servers may use different types of IDs (such as Ad Unit IDs or Campaign IDs), but the general concept remains the same: The IDs used to map your audiences are those that flow through Macro #1 and Macro #2. The only way we're able to identify those IDs, however, is through your reporting.

Reporting instructions vary across ad server. We have assembled more detailed reporting instructions for our most common ad servers if these are the Media Platforms that you are working with: The Trade Desk (TTD), Google Ad Manager (GAM), and Campaign Manager 360 (CM360).

Ad Server Report Requirements

Details

Notes/Comments

Delivery Address:

Please send to the 'Reporting Email' designated for each tag's Media Platform (Fig.1).

   

Delivery Cadence:

Automated daily

Data Source:

The report MUST come from the ad server in which the Upwave tag was implemented.

NOTE: If you're working with multiple partners and/or platforms, a separate report must be scheduled for each.

For example, if you have a DFP tag and a TTD tag, you'll need to schedule 2 reports: 1x from DFP and 1x from The Trade Desk.

Date Range:

Campaign to Date (or Last 30 Days minimum) 

Filters:

Please only include placements in which the Upwave tag was implemented.

Required
Dimensions:

  • Creative ID *

  • Creative Name 

  • Placement ID **

  • Placement Name

  • Date

  • Impressions

* IDs must match IDs coming through Macro #1

** IDs must match IDs coming through Macro #2

Please ensure your report doesn't include a "total" row at the bottom. 

Fig. 1: Reporting Email

The Reporting Email for each tag can be found on your Tag Management page, as well as your downloaded Tag File. Your reports must be sent to these Reporting Emails in order for our system to find them. 

Please do not send multiple reports to the same alias as that could result in the wrong report being used. 

Suggested Reporting Dimensions by Media Platform 

  1. Find the 'Media Platform' from the list below that corresponds to your tag. This Media Platform can be found on your Tag Management page, or, your downloaded Tag File. 

  2. Confirm that the 'Macros in Tag' below correspond to what you have implemented. 

  3. Reference the 'Ad Server Report Dimensions' for that Media Platform below. These are the reporting dimensions that we've found historically provide the necessary information in your report(s). Note: Report Dimensions are suggested based on historical data and are subject to change.

*Table is scrollable

Tag Manager Information

Macros in Tag

Ad Server Report Dimensions

Ad Server

Media Platform

Creative ID Macro
(Macro position #1)

Placement ID Macro
(Macro position #2)

Creative ID

Creative Name

Placement ID

Placement Name

Date

Impressions

AdColony

AdColony

[RAW_AD_CREATIVE_ID]

[RAW_AD_GROUP_ID]

Ad ID

Ad Name

Ad Group ID

Ad Group Name

Date

Impressions

Adelphic

GumGum - Adelphic

${ADELPHIC_CREATIVEID}

${ADELPHIC_ADORDERID}

Creative ID

Creative Name

Order ID

Order Name

Date

Impressions

Adswizz

Adswizz

{bannerid}

{campaignid}

Ad ID

Ad

Campaign ID

Campaign

Time

Audio Impressions

AdTheorent

AdTheorent

noValue

[CREATIVEID]

N/A

N/A

creative id

creative concept

date

impressions

Amobee

Amobee

$!{CREATIVE_ID}

$!{LINE_ITEM_ID}

creative_id

creative_name

line_item_id

line_item_name

data_date

impressions

Amobee

Tremor---Amobee

$!{CREATIVE_ID}

$!{LINE_ITEM_ID}

creative_id

creative_name

line_item_id

line_item_name

data_date

impressions

Beeswax

Beeswax

{{CREATIVE_ID}}

{{PLACEMENT_ID}}

Creative ID

Creative Name

Line Item Alternative ID

Line Item Name

Day

Impressions

Beeswax

Adsmovil - Beeswax

{{CREATIVE_ID}}

{{LINE_ITEM_ID}}

Creative ID

Creative Name

Line Item ID

Line Item Name

Day

Impressions

Beeswax

VideoAmp - Beeswax

{{CREATIVE_ID}}

{{LINE_ITEM_ID}}

Creative ID

Creative Name

Line Item ID

Line Item Name

Day

Impressions

Cadent

Cadent

[4info_creative_id]

[4info_lineitem_id]

Creative ID

Creative Name

Line Item Id (Parent Ad Group)

Line Item Name (Parent Ad Group)

Time (day)

Impressions - Actual

Celtra

Celtra

{celtraCreativeId}

{celtraPlacementId}

Creative ID

Creative name

Placement ID

Placement name

Date (UTC)

Requested impressions

Celtra

Kargo - Celtra

{celtraCreativeId}

{celtraPlacementId}

Creative ID

Creative name

Placement ID

Placement name

Date (UTC)

Requested impressions

Crackle

Crackle

#{ad.creative.id}

#{ad.placement.id}

Creative ID

Creative Name

Placement ID

Placement Name

Event Date

Gross Counted Ads

Dailymotion

Dailymotion

{{CREATIVE_ID}}

{{LINE_ITEM_ID}}

Creative ID

Creative Name

Line Item ID

Line Item Name

Day

Impressions

CM360

CM360

%ecid!

%epid!

Creative ID

Creative

Placement ID

Placement

Date

Impressions

GAM

GAM

*publisher variations of GAM that produce these macros

%ecid!

%eaid!

Creative ID

Creative

Line item ID

Line item

Date

Ad server impressions

GAM

GAM

*standalone option for GAM that produces these macros

%ecid!

%epid!

Creative ID

Creative

Ad unit ID

Ad unit

Date

Ad server impressions

GAM

Adsmovil - GAM

%ecid!

%eaid!

Creative ID

Creative

Line item ID

Line item

Date

Total impressions

GAM

Bustle - GAM

%ecid!

%eaid!

Creative ID

Creative

Line item ID

Line item

Date

Total impressions

GAM

Forbes - GAM

%ecid!

%eaid!

Master and Companion creative ID

Master and Companion creative

Line item ID

Line item

Date

Total impressions

GAM

Kargo - GAM

%ecid!

%eaid!

Upwave Creative ID

Creative

Upwave Line ID

Line Item

Reporting Date

Advertiser Impressions

GAM

TuneIn - GAM

%ecid!

%eaid!

Master and Companion creative ID

Master and Companion creative

Line item ID

Line item

Date

Ad server impressions

GAM

Vizio - GAM

%ecid!

%eaid!

Creative ID

Creative

Line item ID

Line item

Date

Total impressions

GAM

Vox - GAM

%ecid!

%epid!

Creative ID

Creative

Ad unit ID

Ad unit

Date

Ad Server impressions

DV360

DV360

${CREATIVE_ID}

${CAMPAIGN_ID}

Creative ID

Creative

Line Item ID

Line Item

Date

Impressions

Extreme Reach

Extreme Reach

{{er_creative_id}}

{{er_line_item_id}}

Video ID

Customer Creative ID

Placement ID

Placement Name

Day

Total Served Ads

FlashTalking

FlashTalking

[%creativeID%]

[%placementID%]

Creative ID

Creative

Placement ID

Placement

Date

Total Ads Requested

Freewheel

Freewheel

#{ad.creative.id}

#{ad.placement.id}

Creative ID

Creative Name

Placement ID

Placement Name

Event Date

Impressions

GumGum

GumGum

[creativeId]

[packageId]

Ad Creative ID

Ad Creative

Package ID

Package Name

Date

Ad Impressions

InMarket

InMarket

[creativeId]

[placementId]

[creativeID]

Creative Name

[placementID]

Placement Name

Date Aggregation

Impressions

Innovid

Innovid

{iv_creativeid}

{iv_placementid}

Creative ID

Creative Name

Placement ID

Placement Name

Day

Impressions

LiquidM

LiquidM

{AD_ID}

{CAMPAIGN_ID}

Ad ID

Ad

Campaign ID

Campaign

Timestamp

Ad Impressions

Madhive

Madhive

{creative.id}

{lineitem.id}

Creative ID

Creative Name

Line Item ID

Line Item Name

Timestamp Date

Impressions

Pandora

Pandora - Adswizz/Haymaker/GAM/Braze

CREATIVEID

PLACEMENTID

Adserver Creative ID

Creative Name

Adserver Line ID

Ad Comments

Name

Impressions

Pandora

Pandora - Sizmek

[%tp_AdID%]

[%tp_PlacementID%]

Ad ID

Ad Name

Placement ID

Placement Name

Day

Impressions (Net)

Pandora

Pandora - The Trade Desk

%%TTD_CREATIVEID%%

%%TTD_ADGROUPID%%

Creative ID

Creative

Ad Group ID

Ad Group

Date

Impressions

Simpli

PadSquad - Simpli

{eCreativeId}

{ePlacementId}

Adserver Creative ID

Creative Name

Adserver Line ID

Ad Comments

Breakdown

Impressions Delivered

Sizmek

Sizmek

[%tp_AdID%]

[%tp_PlacementID%]

Ad ID

Ad Name

Placement ID

Placement Name

Day

Impressions (Net)

SpotX

SpotX

$CHANNEL_ID

$DEAL_ID

Channel ID

Channel Name

Deal ID

Deal Name

Date

Impressions

SpringServe

Springserve

{{DEMAND_TAG_ID}}

{{SUPPLY_TAG_ID}}

Demand Tag ID

Demand Tag

Supply Tag ID

Supply Tag

Date

Impressions

SpringServe

Canela Media - SpringServe

{{DEMAND_TAG_ID}}

{{SUPPLY_TAG_ID}}

Demand Tag ID

Demand Tag

Supply Tag ID

Supply Tag

Date

Impressions

SpringServe

Vizio - SpringServe

{{DEMAND_TAG_ID}}

{{SUPPLY_TAG_ID}}

Demand Tag ID

Demand Tag

Supply Tag ID

Supply Tag

Date

Impressions

Teads

Teads

[CID]

[PID]

creative_id

creative

ad_id

ad

day

impression

The Trade Desk

The Trade Desk

%%TTD_CREATIVEID%%

%%TTD_ADGROUPID%%

Creative ID

Creative

Ad Group ID

Ad Group

Date

Impressions

The Trade Desk

Kargo - The Trade Desk

%%TTD_CREATIVEID%%

%%TTD_ADGROUPID%%

Creative ID

Creative

Ad Group ID

Ad Group

Date

Impressions

The Trade Desk

Tremor - The Trade Desk

%%TTD_CREATIVEID%%

%%TTD_ADGROUPID%%

Creative ID

Creative

Ad Group ID

Ad Group

Date

Impressions

The Trade Desk

Xaxis - The Trade Desk

%%TTD_CREATIVEID%%

%%TTD_ADGROUPID%%

Creative ID

Creative

Ad Group ID

Ad Group

Date

Impressions

Tinder

Tinder

[LR_RUNTIME_CREATIVE_ID]

[LR_RUNTIME_ORDER_LINE_ID]

Creative ID

Creative

Line item ID

Line item

Date

Ad server impressions

Tremor

Tremor - DSP

[CREATIVE_ID]

[PLACEMENT_ID]

Creative ID

Creative

Placement ID

Placement Name

Date

Impressions

Verizon DSP

Verizon DSP

{CREATIVE_ID}

${PLACEMENTID}

Creative ID

Creative Name

Placement ID

Placement Name

Day

Impressions

Viant

Viant

${ADELPHIC_CREATIVEID}

${ADELPHIC_CAMPAIGNID}

Creative ID

Creative Name

Campaign ID

Campaign Name

Date

Impressions

Xandr

Canela Media - Xandr

${CREATIVE_ID}

${CPG_ID}

creative_id

creative_name

line_item_id

line_item_name

day

imps

Xandr

Xandr

${CREATIVE_ID}

${CPG_ID}

creative_id

creative_name

line_item_id

line_item_name

day

imps

Yahoo

Yahoo

${LIBRARYADID}

${PLACEMENTID}

Creative Id

Creative

Line Id

Line

Day

Impressions

Yahoo

Vizio - Yahoo

${LIBRARYADID}

${PLACEMENTID}

Creative Id

Creative

Line Id

Line

Day

Impressions