1 of 100

Adloop Documentation

README

Everything you need to know

[[Start your Adloop discovery|I---Start-your-Adloop-discovery!]]

[[Quick start|Quick-start]]

[[Basic informations|Basic-informations]]

[[What’s new in Adloop’s world|0---What's-new-in-Adloop's-world--(changelog)]]

[[FAQ|FAQ]]

![](.gitbook/download (1).png) Data sources

[[Data sources page|Data-Sources-page]]

[[Data Sources (Workflow)|Data-Sources-(Workflow)]]

[[Metrics & dimensions per data source|Metrics-&-dimensions-per-Data-Source]]

[[Data Quality|Data-Quality]]

[[Data destinations|Data-destinations-(Exports-or-Notifications)]]

[[Data Sources page|Data-Sources-page]]

[[Data Sources (Workflow)|Data-Sources-(Workflow)]]

[[Metrics & dimensions per data source|Metrics-&-dimensions-per-Data-Source]]

[[Data Quality|Data-Quality]]

[[Data destinations|Data-destinations-(Exports-or-Notifications)]]

![](.gitbook/download (3).png) Data management

[[Data management|VI---Data-Management-📁]]

[[Dimensions management|Dimensions-management-page]]

[[Metrics management|Metrics-management-page]]

[[Matching|Matching]]

[[Marketing budgets|Marketing-budgets-(coming-soon)]]

![](.gitbook/download (2).png) Exports

[[Export destinations|Export-Destinations]]

[[Exports|7---Exports]]

![](.gitbook/download (4).png) Notifications

[[Notification destinations|Integrations]]

[[Notifications|8---Notifications]]

I - Start your Adloop discovery!

What is Adloop?

Adloop is a data marketing hub and, at the same time, a set of features designed to make digital marketing professionals' lives easier.

![Adloop Iverview](.gitbook/I - adloop_overview.png)

It all starts with data

Adloop does not collect data itselft, but we are retrieving data from external sources such as :

Your Ad Platforms , that provide data generally called Ad-Centric : impressions, clicks, ad spends, ad name, campaign type etc..
Your Analytics tool feed Adloop with behavioural data on your websites and your apps ( Site-Centric data) : pageviews, add to cart, account creation, purchase, sources of traffic etc.
Your CRM or transactionnal apps, used for identifying clients or prospects, communicating with them, knowing what they bought etc. This is User-Centric data.

0d48fb58-907b-4e9f-a908-0e9372c035d6DECIDEDbc6e6512-26fe-45f4-b6ac-9a89e8b11a77The Data Source Adloop Tracking & Attribution will collect data that are specific to Adloop. It must be activated in order to enjoy the Attribution and Recommendations features.

The Data Source Adloop Tracking & Attribution will collect data that are specific to Adloop. It must be activated in order to enjoy the Attribution and Recommendations features.

All those data are sent to Adloop thanks to API data connections without any manual intervention.

To connect a Data Source to Adloop, go to the Data Sources menu!

Introducing Adloop

https://www.youtube.com/watch?time_continue=2&v=UTmafJrDreU&feature=emb_logo

Quick start

Don’t forget that adding data sources to Adloop is mandatory!

Keep an eye on my advertising data

Create a performance report of the channel (and/or campaign) with chosen performance indicators
This report can be sent to you by email on a regular basis

Create a dashboard
[[Share the dashboard|Reports-saving-&-sharing-system]]

[[Create a graph report|Chart-reports]]

Email or Instant Message notifications

Analyze my ads performances

Create a dashboard

[[|Dashboard]][[|Reports-saving-&-sharing-system]][[|Export-Destinations]]

Improve my reporting

Dashboard for… dashboarding!
Performances to see my data in a table
Graph to see trends & repartition
[[Cycles|Cycle-reports-(Premium)]] to analyse the position of an element in a path to conversion (only with Attribution!)

Use the templates
[[Create your report from scratch|III---Adloop-reports-system-📈]]

Understand the dimensions in Adloop
Understand the metrics in Adloop

Channel overview with main KPI
Keywords with 0 conversions
Social Ads with CPC higher than the desired threshold

Optimize my digital marketing campaigns

[[|D--Attribution-KPI-for-marketing-optimization]][[|Attributed-conversions-&-revenue]][[|Useful-clicks-1]]

Keep an eye on my campaigns (without connecting to Adloop)

[[|Advanced-Alerts]][[|Real-time-notifications-(premium)-(depleted)]][[|Exports]]

Understand my paths to conversion

[[|Cycle-reports-(Premium)]][[|Channel-affinity-(Premium)]][[|Path-Explorer-(Premium)]][[|Order-ID-(Premium)]]

Basic informations

[[|6-key-functions-of-Adloop]][[|Workspace-and-Sites]][[|Users-and-Administrators]][[|Overview-of-Data-available-in-Adloop]]

6 key functions of Adloop

Adloop is a marketing data storage unit with a set of functionnalities here to help digital marketers' everydays' life.

For better clarity, we have ranked Adloop functionnalities in 6 broad categories.

CONNECT : Everything starts with a Data Source

Adloop does not collect data directly, it feeds itself from external Data sources which are :

Your Ad platforms which give you data that we usually call Ad-Centric : Impressions, clicks, ad names, campaign types, etc.
Your Analytics tools feeding Adloop in users behavior’s data on your sites and apps (Site-Centric data) : Pages viewed, add to the basket, account setup, purchase, visits demographic, etc.
Your CRM or business apps used to identify clients or prospects, communicate with them, know what they bought, etc. That is User-Centric .

All those data are sent to Adloop via API data connectors which are updated automatically every 3 hours.

To connect a Data Source to Adloop, go check out the Data Source page.

ANALYZE : A powerful reports system

Have you ever dreamed of being able to analyzing all your Platforms, Analytics and Attributed data in one single place ? Are you a wonderful analyst who wants to see 5 UTM then 12 metrics or KPIs in one single report ? You are getting tired or doing copy-paste in Excel to compare your Google Ads and Facecook Ads campaigns ?

Adloop is going to be your best friend!

To be more efficient, we put at your disposal a set of reports templates . You can save them, share them with your team or simply look at shared reports.

noteTo analyze data, go check out the Reports page.

To analyze data, go check out the Reports page.

ATTRIBUTE: Data-driven marketing attribution

Years of R&D to offer you the best attribution algorithm on the market. Data-driven and based on users behavior analysis, the Adloop Tracking & Attribution technology is going to put together the conversion paths (or non conversion paths) and build several reports based on those :

Conversions and revenues attributed with all KPIs related to the conversion : Attributed CPA, attributed ROAS…
Complete conversion path linked with order ID
Most frequent conversion path with a search system to identify winning scenarios.
Recommendations of calculated actions for each ad updated in real time

fc6c24c9-aa5f-4d09-9f6a-0218406d80362ba761d4-dd38-4dca-9cc8-a5bbdc974848DECIDEDThe Data Source Adloop Tracking & Attribution collect specific data from Adloop. It has to be activated and set up to be able to use the Attribution and the Recommandations tools.

The Data Source Adloop Tracking & Attribution collect specific data from Adloop. It has to be activated and set up to be able to use the Attribution and the Recommandations tools.

DISTRIBUTE : feeding external apps data

A data-extract system allowing to feed external systems in real time.

With DISTRIBUTE, no need to lose time doing copy-paste or looking for data in various platforms, everything is automatized .

Export destinations' connectors make possible to send data :

By mail, FTP or shared storages like Google Drive
To Data visualization apps like Google Data Studio , Tableau , or Power BI
To Datamarts like Google Big Query , AWS , Azure or Snowflake

Distribute the metrics and KPIs that you need in real time using our Export center.

NOTIFY : For informed and reactive teams

You always need to be notified about your campaigns without the burden of login to the ad plaforms or to Analytics tools? NOTIFY allows you to create alarms on whichever Data sources with whichever KPIs you need and to send them to yourself by mail or on any messaging app you want like Slack , Google Chat or MS Teams .

Set up the notifications and keep your teams informed and alert with the Notification center .

MANAGE : A global management of the marketing data

To organize your data menus as you want, to create matching rules between platforms and Analytics tools, to define calculated metrics that are specific to your activity, Adloop will offer you a simple interface to manage your data.

Workspace and Sites

Data structure in Adloop

The data structure of Adloop is organized in two layers:

The Workspace , accessible at an address such as https://company.adloop.co
Sites (previously Datasets ) which contain data, reports, exports, notifications etc.

To put it simply, the Workspace is the company and the Sites represent the brands or markets.

An example with an emblematic brand: Apple (Tim, if you are reading this...): the Workspace will be https://apple.adloop.co and the Sites: Apple France, Apple US, Apple UK - in which we will look at campaign info on these markets.

Workspace

The Adloop Account of a company

An Adloop Workspace allows a Company to manage all of its markets or an Agency to manage some of its customers.

It is created by an Administrator through the available creation processes (Free Trial, Token sent by Adloop, ...).

An Adloop Workspace login address is always following this model : https://company.adloop.co . The subdomain (host) ' company ' is freely chosen by the user who creates it.

Billing Unit

The Workspace is the Adloop billing unit: the duration of access rights and subscriptions are active for all Sites .

When the Subscription is terminated: an error message will be displayed when attempting to connect to the Workspace and access will no longer be possible unless renewed.

If the monthly Ad Spend amount of the Subscription is reached during the month, access will still be possible but the Data Source APIs will pause until the beginning of the next month. An informational email will be sent to the Administrator and an error message will be displayed for all Users .

The Ad Spend amount of the workspace can be found in the Sites section ( the total amount is only accessible to the Administrators ).

Sites

The Site contains the data from the Data Sources you have connected and all of Adloop's functionality on that data (Reports, Exports, Notifications etc.).

The list of Sites you have access to in the current Workspace is shown in the top left menu as shown below:

Sites are completely 'watertight' between each other: a User or an Administrator can have access to one Site but not another within the same Workspace .

Users and Administrators

Users in Adloop

There are 3 levels of access in Adloop: User, Dataset Administrator and Responsible Administrator.

User : Has access to the Datasets to which they have been invited and can use the Reporting, Export and Notifications features. However, they cannot create Data Sources or Destinations or manage data or act on other Users.

Dataset Administrator : has full access to all features in the Dataset(s) for which he is the Administrator. He can create new Users or Administrators in the context of the Dataset.

Main Administrator : has full access to the entire Workspace for which he is responsible. He manages the billing and can create new Datasets.

Details of user rights in Adloop

Functionalities

Users

Dataset Administrator

Main Administrator

REPORTS

Saved reports

New reports

DATA MANAGEMENT

Data sources

Metrics and KPIs

Dimensions

Matching

EXPORT CENTER

Exports

Export destination

NOTIFICATION CENTER

Notifications

Notification destination

ADMINISTRATION

Users

Datasets

Subscribing / Billing

Overview of Data available in Adloop

A small synthetic diagram to understand

Hi, I'm Adloop!

Let's try to explain this simply.

A. For starters we import data from Data Sources

You set the API connectors in Data Sources that will retrieve information from the Ad Platforms and Analytics.

First we retrieve 1 year of data and then every day we add fresh data.

The 'raw' data retrieved from the platforms is stored and identified by the small logo of the Data Source and a name. An example for the metrics :

Impressions: these are the Impressions retrieved from Google Ads
Conversions: the conversions indicated by Facebook Ads

It's the same for the Dimensions from the Data Sources :

Campaign name: identifies the name of the campaigns Google Ads
Name of the ad: the ads from Facebook Ads

noteAt this point, we have just retrieved the information from the data sources without changing anything. A kind of copy and paste of what is in the platforms (but without manual intervention).

At this point, we have just retrieved the information from the data sources without changing anything. A kind of copy and paste of what is in the platforms (but without manual intervention).

B. We then make a Normalization to simplify the reading

As you operate many marketing channels, you will import a lot of data. Now it happens that some Dimensions or Metrics are common to several Data Sources .

For example, we have Impressions in Google Ads and Facebook Ads, as well as Clicks, for the distribution costs (called Ad spend in Adloop). The same goes for campaign names, ad names, etc.

We therefore operate a Normalization to arrange Dimensions or Metrics of the same nature in a common place.

Source variable

Normalized Variable

The metrics :

Impressions

Impressions
Impressions

| Normalized (copied) into :

Impressions

| | Dimensions :

Campaign name
Campaign name

| Normalize (copy) to:

Campaign name - SEA

This operation allows you to have several Variables of the same nature gathered in a single Variable, which considerably simplifies the reporting.

The origin of the normalized variables is indicated by two icons:

Advertising Sources ( etc.) are normalized in the Ad Centric, icon

Analytics Sources ( etc.) are normalized in the Site Centric, icon

And to complete the explanation, Adloop specific Variables are illustrated by the icon

C. Matching or how to make sure that the Ad and Analytics or Adloop Source understand each other

Adloop's goal is to offer the most appropriate KPIs for all levels of campaign granularity. In order to match a campaign name coming from an Advertising Source with indicators coming from Analytics or Adloop, it is necessary to make sure that the two worlds recognize each other, this is the purpose of Matching .

As an example:

Let’s say I want to see the number of Sessions in my Data Source Facebook Ads

In Google Analytics, the Facebook channel is identified when the Source dimension is 'facebook' and the Medium dimension is 'paid social'.

Matching allows you to create this connection:

D. Attribution ( function) for optimal quality indicators

Adloop offers a Data-Driven Attribution feature that allows you to reconstruct the conversion and engagement paths of users and calculate attributed metrics and KPIs.

The Adloop Tracking & Attribution feature will generate many new metrics in Adloop, all of which will be identified by an icon. For example:

Conversions attr. (for Attributed Conversions)
Income attr. (for Attributed income)
etc.

Adloop's attribution functionality takes the form of a Data Source that needs to be activated and configured. A subscription to Adloop is required to activate it.

E. Data is available for use

All data presented here is available for use in Reports , Exports and Notifications .

More information in the following sections:

[[ Dimensions |Dimensions-in-Adloop]]
[[ Metrics |Metrics-in-Adloop]]
[[ Matching |Matching]]

II - Data Sources and Destinations

[[Data Sources page|Data-Sources-page]]

[[Data Sources (workflow)|Data-Sources-(Workflow)]]

[[Destinations (Exports or Notifications)|Destinations-(Exports-or-Notifications)]]

[[Data quality|Data-Quality]]

Data Sources page

On the Data Sources page, you can see quickly all the data sources you set-up and their status.

Data-sources are separated in 3 categories:

Data-sources : sources for which Adloop has an API connection - data is gathered automatically several times a day.
Custom sources : sources for which there is no API connection - external data is then imported by file droping, email or FTP.
Organic sources : sources for which there is no Advertising data to import.

We will explain here what is the purpose of every zone and what you can find in them:

![](.gitbook/Screenshot (29).png)

Area 1 : to add a Data Source

Opens a pop-in with the available Data Sources connections.

See the dedicated pages to Ad Sources or Analytics Sources for more information on adding Data Sources.

Area 2 : Data Sources already in your Dataset

The names and logos of the Data Sources you added to your Dataset .

Area 3 : Data Sources details

You will find here the details of every Data Source you added, especially its number in the ad platform, its name but also the timezone and the currency.

We convert currencies when we import the data in the currency you chose for the Dataset. For more information, see the [[ Data Quality |Data-Quality]] page.

Area 4 : Data Sources status

This zone is important to check the quantity and quality of the imported data.

For each Data Source, you will find:

History of the data in Adloop
Date and time of the last data import
A small graph with the imported data over the last 14 days

For more information about the frequency of the data import, see the [[ Data Quality |Data-Quality]] page.

Area 5 : Activate / Deactivate a Data Source

With this switch button you can stop the data import for Data Source without deleted the imported history.

noteThis function is interesting if you stop a contract with a partner but you want to keep a coherent data history.

This function is interesting if you stop a contract with a partner but you want to keep a coherent data history.

Area 6 : set-up or delete a Data Source

Both controls enables you to change the parameters or to delete a Data Source .

Deleting a Data Source will delete all the data history.

Data Sources (Workflow)

Adloop imports data stocked in outside apps thanks to our Data Sources .

The Ad Sources are Data Sources connected to Ad platforms.

Add a Data Source

Adding a Data Source, nothing simpler! In the Data Source page, you just have to click on the button, a popin with the available connections appears.

You can search the connection by its name.

A small label appears on some Data Sources :

Connection types

Before connection a Data Source , you must have a access rights.

Each Data Source uses a specific connection mode, but there are 3 main types:

Connection type

Detail

Oauth

Delegation connection system. Adloop inherits reading authorisation for data.

Token API

You will have to enter an API key you got from the ad platform itself or through your account manager.

Simply login and password for an Adloop user you will have created in the ad platform.

Dimensions and Metrics choice

Once the connection is effective, you have to choose the [[ Dimensions |Dimensions-in-Adloop]] and the [[ Metrics |Metrics-in-Adloop]] we have to get from the Data Source .

The default Dimensions or the default Metrics will be imported no matter what, because they are main elements of our reports. It is not possible to delete them.

The Other dimensions and the Other metrics can be selected if you need them.

noteIf you don’t find a Dimension or a Metric, ask the Adloop Support!

If you don’t find a Dimension or a Metric, ask the Adloop Support!

Imported period and import frequency

Adloop imports a year of data when a Data Source is added.

Once added, data are updated every 3 hours or 8 times a day.

Depending on the Data Sources and the API quotas, importing a year of data can take between 2 and 72 hours. Sometimes, you have to be patient!

Data Quality

See our page dedicated to [[ Data Quality |Data-Quality]].

API Data Sources

For the main Advertising Platforms, we are able to fetch automatically the data, several times a day, after the source is added in your Adloop space.

A data source is missing? Contact our Support Team to add it on our road map!

1. Add a data source

In the Data Sources tab, click on "Add" and select the desired data source.

The most popular ones can be found at the top and after they are organized per categories: Search, Shopping, Social…

You can also use the search bar to find directly the source you are looking for.

If the source is not yet available, you can use our [[custom data source function|Custom-data-sources]] to import data!

Once you have found your data source, click on it and follow the instructions on the screen.

1- Dimensions selection

Normalized dimensions are imported by default, but you can choose to import additionnal dimensions by ticking them.

2- Metrics selection

Normalized metrics are imported by default, but you can choose to import additionnal metrics by ticking them.

3- Data-sources specific steps

Some connectors have optional steps.

Google & Facebook: custom conversions import

If you have set-up custom conversions on Google and Facebook thanks to conversion pixels, you can import them in Adloop as well.

4- Filter the data (optional)

You can choose to filter the entering data based on the naming of the campaigns, adgroups etc.

This is very useful if you have all your countries campaigns regrouped in the same Ad Account but you want to split your Adloop data per country.

It’s important to note! When adding more than one filter on the dimensions it’s either AND/OR depending on which operator you are using!

if it is a "positive" operator (eg: contains, equals), it will be an OR
if it is a "negative" operator (eg: is not equal to, does not contain), it will be an AND

So imagine you are doing something like the screen, it will be: IF the campaign begins with "Black Friday" or "Xmas" AND does not contain EN AND HU

![](.gitbook/image (5).png)

5- Import

At the end of the process, click on the Start Import button and the data will start flowing in!

We will gather a full year of data history.

Connecting data sources

https://www.youtube.com/watch?v=BiBYYhq1tPg&list=PLQ4YExrLQZJK_n0ICcYT5ijp1bY743qYP&index=2&ab_channel=AdloopMediaOptimizationPlatform

Custom data sources

It may happen that a data source you are using is not available in our list of API connectors. In this case, you can create a custom data source.

For each custom data source, you will be able to download external data files for full data completeness.

Only create a custom data source if you plan to import external data! Otherwise you can use the Organic Sources tab in the Matching section.

1. Create a custom data source

In the Data Sources tab, click on "Add" and select "Custom Ad Source".

You will then have to give a name to your data source as well as fill in its type (Affiliate, Social, SEO etc.)

Next you will need to import the file containing the data for the desired source into Adloop. This file must have headers and raw data (no formulas).

Supported formats are : XLSX, XLS, ODS and CSV (UTF-8 encoding).

It is better if your file contains a date column! This allows you to add the data of several days at once. Otherwise, you will have to upload one file per day.

This file can be used as a template for future imports. This will facilitate the import process the next time. It is therefore better if you upload a file directly from the advertising platform (unmodified).

You can click "Submit" to upload your file.

Next, Adloop asks you to indicate which row is the header: choose the column with the title of your columns.

You will now be presented with a screen asking you to map your column titles to Adloop dimensions or metrics. For each column you have to indicate which dimension or metric corresponds to.

Example: For my column called "Cost" in my file I choose the corresponding Adloop metric "Ad Spend".

For my column called "Campaign", I choose the corresponding Adloop dimension "Campaign Name".

If the metric or dimension is not available in the list, you can create custom ones. These will then be specific (not standardized) items. To do this, use the "Add metric" or "Add dimension" buttons.

If you don't want to import a column, choose the "Will not import" option. The data in the column will then be left out.

Choose the currency in which the data in the file is entered and, if applicable, the date.

At the end of the set-up you can choose between overwrite & add data options.

Overwrite: a new imported file on the same dates will erase the previous one

Add data: data on the same dates will be summed.

Your data source is now created!

2. Importing new data from a custom source

In the Data Source tab, select the data source for which you want to import data and click on the "Load new file" button

By clicking on this button, you have two options: upload a new file (and therefore make the column matches again) or use the configuration of a previous import. (By clicking on the arrow)

3. Manage the list of manual imports

By clicking on the button "Display custom imports", you access the list of imports for a given source.

From this list, you can delete one or more imports if the data are no longer up to date.

https://www.youtube.com/watch?v=n3ZbwelZeQ0

Rakuten Affiliation Data Source

In order for Adloop to connect to your Rakuten Account and obtain the relevant data, we need you to create a specific report and give us the report's API url.

Dont' worry, we will guide you through the process !

Go to your Advertiser Dashboard
Go to the "Report" tab, click on "Choose Reports" and select "Revenue Report by Day"
Select the following columns:

Transaction Date
Publisher Name
Publisher ID
Number of Impressions
Number of Clicks
Total Commission
Number of Orders
Sales

Select the same timezone as your dataset, by clicking on the date picker.
Save your report
Click on "View Report" and select "Get API". This will give you an URL.
Copy the given URL and paste it in the field provided by Adloop.

That's it, well done !

How to get my AT Internet/Piano Analytics tokens?

Metrics & dimensions per Data Source

Active Campaign metrics & dimensions

Metric name in Adloop

Metric name in Source

Definition

Clicks

Number of unique contacts that clicked on any link in a campaign. This metric includes only one click per contact.

Open mails

Opens

Unique number of opens for that Campaign.

Hard bounces

A hard bounce is an email that cannot be delivered because of a permanent issue.

Soft bounces

A soft bounce is an email that cannot be delivered due to a temporary issue.

Email unsubscribes

Unsubscribes

Unsubscribe or 'opt-out' means that a contact has expressed their desire to be removed from an email list.

Total amount sent

Sent

The total number of campaigns sends. This includes campaigns created in the Campaigns section in your account that were sent to a list(s), as well as campaigns created within automations that were sent to at least one contact.

Forwards

Total forwards of an email.

Link clicks

Total link clicks

Total number of clicks across all links in an email.

Total opens

Total opens/Reads

Total number of opens.

Total replies

Total number of contact replies to your campaigns.

Dimension name in Adloop

Dimension name in Source

Definition

Campaign name

Name of the campaign

Type

Campaign type

ActiveCampaign has created several Campaign types to simplify your marketing automation. Using Standard, Automated, Auto Responder, Split Testing, RSS Triggered, and Date Based campaigns offer a variety of specialized options.

Send date

Refers to the time period of when a campaign was last sent.

Campaign ID

ID of the campaign

Analytics campaign name

Segment ID

ID of your segment

Send ID

ID of the campaign sending

Source

Source type

Adobe Analytics metrics & dimensions

Dimension name in Adloop

Dimension name in Source

Definition

Evar Name

eVars are custom variables that you can use however you’d like. Since eVars contain custom strings in your implementation, your organization determines what the dimension items are for each eVar.

Transaction ID

Purchase ID

Unique ID for each purchase.

Additional dimensions

Custom dimensions linked to the eVar you chose in the first configuration step.

Metric name in Adloop

Metric name in Source

Definition

Visits

The ‘Visits’ metric shows the number of sessions across all visitors on your site.

Click-throughs

Or Tracking code instances. It shows the number of times a dimension was explicitly defined in an image request. This metric is useful when you want to see the number of times a dimension item was set without the hits where that value persisted.

Page views

The ‘Page views’ metric shows the number of times a given dimension item was set or persisted on a page. It is one of the most common and basic metrics in reports.

Conversions

The ‘Orders’ metric shows the total number of purchase events made on your site.

Bounces

The ‘Bounces’ metric shows the number of visits that contained exactly one hit. You can use this metric to understand the ratio of bounce to non-bounce traffic you get, to see the top entry pages that cause visitors to bounce, or to see how the total number of bounces trend over time.

Visitors

The ‘Unique visitors’ metric shows the number of visitor IDs for the dimension item. It is one of the most common metrics used when determining traffic, as it gives a high-level overview of the popularity of a dimension item. For example, a visitor can come to your site every day for a month, but they still count as a single unique visitor.

Revenue

The ‘Revenue’ metric shows the monetary amount of products purchased within all orders. This metric is vital for eCommerce sites in measuring conversion. You can combine this metric with any dimension to see what which dimension items contributed to revenue.

Cart additions

The ‘Cart additions’ metric shows the number of times a visitor added something to their cart. This metric is helpful when you want to understand the part of the conversion funnel where customers are interested enough in a product to add it to their cart.

Cart creation

The ‘Carts’ metric shows the number of hits where a visitor added their first product to a cart.

Cart view

The ‘Cart views’ metric shows the number of times a visitor viewed their shopping cart. This metric is helpful when you want to understand the part of the conversion funnel where customers view the contents in their cart.

Checkouts

The ‘Checkouts’ metric shows the number of times a visitor started the checkout process. This metric is helpful when you want to understand the part of the conversion funnel where customers have a cart of products and are ready to purchase them.

Time spent (visit)

The ‘Time spent per visit (seconds)’ metric shows the average amount of time that visitors interact with a given dimension item during each visit.

Searches

The ‘Searches’ metric shows the number of hits that match Adobe’s external search detection. This metric is useful when you want to look at non-search dimension items and see how they contributed to search engine traffic.

Reload

The ‘Reloads’ metric shows the number of times a dimension item was present during a reload. A visitor refreshing their browser is the most common way to trigger a reload.

Site exits

The ‘Exits’ metric shows the number of times a given dimension item is captured as the last value in a visit. This metric is helpful when you want to understand more about the last thing visitors see before leaving your site. Seeing the last values of a dimension can help you understand and optimize the experience a visitor gets before they leave.

Site entries

The ‘Entries’ metric shows the number of times a given dimension item is captured as the first value in a visit. This metric is helpful when you want to understand more about the first impressions visitors have on your site. Seeing the first values of a dimension can help you understand and optimize the experience a new visitor gets.

Adloop Attribution metrics & dimensions

Metric name in Adloop

Metric name in Source

Definition

Landed clicks

Clicks that arrived on your website, measured by our script. This metric is normalized.

Useful clicks

Number of clicks that bring value to your business. Useful clicks are personalised: the definition can be found in your Adloop Tracking & Attribution data-source setting. This metric is normalized.

Bounces

Clicks that bounced (single pageview) measured by our script.

Visit score

Attributed score for a visit to a website.

Attr. Conversions

Conversions

Conversions measured by our script using our data and the selected attribution model (data-driven, rule-based…).

Attr. Revenue

Revenue

Revenue measured by our script using our data and the selected attribution model (data-driven, rule-based…).

Cost per landed click

Calculated by Adloop, based on our attributed data. This metric shows the average cost for clicks that arrived on your website, measured by us. To be compared with the Advertising CPC.

Cost per useful click

Calculated by Adloop, based on our attributed data. This metric shows the average cost for clicks that bring value to your business. To be compared with the Advertising CPC and the cost per landed click.

Arrival rate

Calculated by Adloop, based on our attributed data. This metric shows the proportion of landed clicks compared to the advertising clicks.

Engagement rate

Calculated by Adloop, based on our attributed data. This metric shows the proportion of users that engaged with your website.

CPA

Calculated by Adloop, based on our attributed data. This CPA is based on the selected attribution model.

ROAS

Calculated by Adloop, based on our attributed data. This ROAS is based on the selected attribution model.

Conversion rate

Calculated by Adloop, based on our attributed data. This conversion rate is based on the selected attribution model.

Dimension name in Adloop

Dimension name in Source

Definition

Destination page

Landing page (only for SEO & direct channels)

Search engine

Search engine used for the SEO query.

Affilae metrics & dimensions

Metric name in Adloop

Metric name in Source

Definition

Ad Spend

All commissions

Potential cost.

Revenue

Revenue on conversions

Total value of orders.

Conversions

All conversions

Number of potential sales.

Confirmed ad spend

Cost validated.

Pending ad spend

Cost waiting.

Dimension name in Adloop

Dimension name in Source

Definition

Affiliate

Partner

Name of the affiliate

AT Internet metrics & dimensions

Dimension name in Adloop

Dimension name in Source

Definition

Source

Source that generated a visit on your site. This source is based on several parameters (referrer, campaign marker) with priority rules between each of them. Information within “visit” range (only 1 value per visit, duplicated on all its events)

Medium

Global family for campaign. Information within “visit” range (only 1 value per visit, duplicated on all its events). It should have value only when the type of source is “Marketing”.

Campaign Name

Campaign

All marketing campaigns, all categories combined, that generated a visit on your site. Information within “visit” range (only 1 value per visit, duplicated on all its events). It should have value only when the type of source is “Marketing”.

Keyword

Details of the keywords purchased for your SEA campaigns that generated a visit on your site. Information within “visit” range (only 1 value per visit, duplicated on all its events). It should have value only when the ‘Source’ property contains the value “Sponsored links”.

Content

The name of the content being displayed

Metric name in Adloop

Metric name in Source

Definition

Visits

A visit is defined as a set of event that occurred on your site (“onsite event) by the same visitor. If no event is measured during a defined period of time (usually 30 minutes), the visit ends.

Bounces

Number of visits with less than 2 pages (0 or 1, regardless of the number of events).

Bounce rate

Ratio between bounces and all visits.

Visitors

Number of visitors (each people recognized mainly with a cookie and who has made at least 1 visit). These visitors are distinct of the period.

Page views

All the pages viewed during a visit.

Transactions

Number of transaction confirmation events

Average session duration

Average time spent on apps sessions for the site.

Awin metrics & dimensions

Bing Search (Bing Ads) metrics & dimension

Bing Shopping (Bing Ads) metrics & dimensions

Criteo metrics & dimensions

Metric name in Adloop

Metric name in Source

Definition

Ad Spend

Cost

The overall cost of your ads or videos ads.

Clicks

The number of clicks driven by the ads.

Impressions

Displays

The number of times your ads have been shown on a screen.

Impression Share

Win Rate

The number of displays divided by the total number of display opportunities.

Viewed Impressions

The number of ads that have been viewed. A display is considered viewed if at least 50% of the ad appears on the screen for at least one second

Conversions PC 30

Sales

The number of completed e-commerce transactions or purchases. Attribution window: 30 days post-click.

Revenue PC 30

Revenue

The amount of money generated by the online sales. Attribution window: 30 days post-click.

Conversions PV 24h

Sales

The number of completed e-commerce transactions or purchases. Attribution window: 24 hours post-view.

Conversions PC 30 PV 24h

Sales

The number of completed e-commerce transactions or purchases. Attribution window: 30 days post-click+ 24 hours post-view.

Conversions PC 1

Sales

The number of completed e-commerce transactions or purchases. Attribution window: 1 day post-click.

Conversions PC 7

Sales

The number of completed e-commerce transactions or purchases. Attribution window: 7 days post-click.

Revenue PV 24h

Revenue

The amount of money generated by the online sales. Attribution window: 24 hours post-click.

Revenue PC 30 PV 24h

Revenue

The amount of money generated by the online sales. Attribution window: 30 days post-click + 24 hours post-view

Revenue PC 1

Revenue

The amount of money generated by the online sales. Attribution window: 1 day post-click.

Revenue PC 7

Revenue

The amount of money generated by the online sales. Attribution window: 7 days post-click.

Dimension name in Adloop

Dimension name in Source

Definition

Campaign name

Campaign

Name of the campaign.

Campaign ID

This is the unique ID associated with your campaign.

Meta metrics & dimensions

Metric name in Adloop

Metric name in Source

Definition

Ad Spend

Amount spent

The estimated total amount of money you've spent on your campaign, ad set or ad during its schedule.

Clicks

Clicks (all)

The number of clicks on your ads.

Impressions

The number of times your ads were on screen.

Conversions

Website purchases

The number of purchase events tracked by the pixel on your website and attributed to your ads.

Revenue

Number of purchases.

Videos completed

Video plays at 100%

The number of times your video was played at 100% of its length, including plays that skipped to this point.

Videos started

Video plays

Reactions

Post reactions

The number of reactions on your ads. The reactions button on an ad allows people to share different reactions to its content: Like, Love, Care, Haha, Wow, Sad or Angry.

Reach

The number of people who saw your ads at least once. Reach is different from impressions, which may include multiple views of your ads by the same people. This metric is estimated.Attention! You may not see the same data between Adloop & Facebook because Facebook is counting the Reach per “unique people reached” and they are not sending out this information.

Comments

Post comments

The number of comments on your ads.

Post shares

The number of shares of your ads. People can share your ads or posts on their own or friends' Timelines, in groups and on their own Pages.

Engagement

Post Engagement

Post engagement includes all actions that people take involving your ads while they're running. Post engagements can include actions such as reacting to, commenting on or sharing the ad, claiming an offer, viewing a photo or video, or clicking on a link.

Engagement rate

Engagement Rate on Facebook for a post is calculated as the number of Engaged Users divided by the total reach of that post.

Conversions post view

Omni-purchase

Refers to a conversion where the user has previously been delivered an impression but not clicked on it.

Revenue post view

Values omni-purchase\view

Number of purchases. (post-view).

Conversions post click

Omni-purchase

A conversion that occurs after a user has clicked on an ad.

Revenue post click

Values omni-purchase\click

Number of purchases. (post-click).

Views videos 25%

Video plays at 25%

The number of times your video was played at 25% of its length, including plays that skipped to this point.

Views videos 50%

Video plays at 50%

The number of times your video was played at 50% of its length, including plays that skipped to this point.

Views videos 75%

Video plays at 75%

The number of times your video was played at 75% of its length, including plays that skipped to this point.

Outbound clicks

Outbond clicks

The number of clicks on links that take people off Facebook-owned properties.

Thruplays

ThruPlay is an optimization and billing option for video ads in the video views objective. It measures completion for videos shorter than 15 seconds or videos played at least 15 seconds for longer videos.

Dimension name in Adloop

Dimension name in Source

Definition

Campaign name

Campaign

The name of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.

Adgroup name

Ad set

The name of the ad set you're viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.

Ad name

The name of the ad you're viewing in reporting.

Campaign ID

The unique ID number of the ad campaign you're viewing in reporting. Your campaign contains ad sets and ads.

Adgroup ID

Ad set ID

The unique ID of the ad set you're viewing in reporting. An ad set is a group of ads that share the same budget, schedule, delivery optimization and targeting.

Ad ID

The unique ID of the ad you're viewing in reporting.

Account name

Account ID

The name of your ad account, which groups your advertising activity. Your ad account includes your campaigns, ads and billing.

Facebook Account organic metrics & dimensions

It’s important to note that Facebook uses an “estimated metric”.

An estimated metric is derived through statistical sampling or modelling, rather than a straight count. Which means that there will be differences between the data in Adloop and the source when fetching the data for more than a day.

Metric name in Adloop

Metric name in Source

Definition

Impressions [Account] Impressions

(Organic) Impressions

The number of times any content from your Page or about your Page entered a person's screen. This includes posts, stories, ads, as well other content or information on your Page.

Videos started [Account] Videos started

Organic) Video views

The number of times your Page's videos played for at least 3 seconds, or for nearly their total length if they're shorter than 3 seconds. During a single instance of a video playing, we'll exclude any time spent replaying the video.

Subscribed [Account] Subscribed

New page fans

The number of new people who have liked your Page.

Unsubscribed [Account] Unsubscribed

Removed page fans

Unlikes of your Page.

Total reactions [Account] Total reactions

Total page actions\post reactions

Daily total post reactions of a page by type.

Total engagements [Account] Total engagements

Total page engagements

The number of times people have engaged with your posts through reactions, comments, shares and more.

Reach [Account] Reach

Facebook page reach

The number of your fans who saw any posts on Facebook on a given day.

[Account] Total followers

Page likes

People who have liked your Page.

[Account] Engaged users

Page engaged user

The number of people who engaged with your Page. Engagement includes any click.

[Account] Impressions (posts)

Organic page post impressions

The number of times any content from your Page or about your Page entered a person's screen. This includes posts, stories, ads, as well other content or information on your Page.

[Account] Reactions like

Page action,post reactions - Like

Daily total post "like" reactions of a page.

[Account] Reactions love

Page action,post reactions - Love

Daily total post "love" reactions of a page.

[Account] Reactions wow

Page action,post reactions - Wow

Daily total post "wow" reactions of a page.

[Account] Reactions haha

Page action,post reactions - Haha

Daily total post "haha" reactions of a page.

[Account] Reactions sorry

Page action,post reactions - Sorry

Daily total post "sorry" reactions of a page.

[Account] Reactions angry

Page action,post reactions - Anger

Daily total post "angry" reactions of a page.

[Account] Clicks

Page consumption

The number of times people clicked on any of your content.

Dimension name in Adloop

Dimension name in Source

Definition

Name [Account] Name

Page name

The name of the Page

[Account] ID

Page ID

The ID representing a Facebook Page.

Facebook Post organic metrics & dimensions

It’s important to note that Facebook uses an “estimated metric”.

Google Analytics metrics & dimensions

Google Campaign Manager metrics & dimensions

Google Discovery (Ads) metrics & dimensions

Google Perf Max (Ads) metrics & dimensions

Google Shopping (Ads) metrics & dimensions

Yahoo Search metrics & dimensions

Line metrics & dimensions

Data destinations (Exports or Notifications)

Channel affinity (Premium)

Google Search (Ads) metrics & dimensions

Metric name in Adloop

Source name in Adloop

Definition

Ad Spend

Cost

Cost is the total of your spend during this period.

Clicks

When someone clicks your ad, it's counted here. This metric is accredited by the Media Rating Council (MRC) in desktop and mobile environments for the Search and Display Networks.

Impression

Impr.

An impression is counted each time your ad is served on Google's ad networks, such as on , YouTube or other publisher websites and apps. Impressions help you understand how often your ad is being seen.

Impression share

Search impr. share

"Search impression share" is the impressions that you’ve received on the Search Network divided by the estimated number of impressions that you were eligible to receive.Eligibility is based on your current ads' targeting settings, approval statuses, bids and quality. Impression share data is updated daily.

Conversions

"Conversions" shows the number of conversions you received after ad interactions (such as text ad clicks or video ad views).The conversion settings “Include in ‘Conversions’” and “Count” affect the number you see here.

Revenue

Conv. value

Conversion value is the sum of conversion values for your conversions. This metric is useful only if you entered a value for your conversion actions.

Store visits

Shop visits

Store visits is the number of visits to your physical shops after ad interactions, such as text ad clicks or video ad views.

View through conversions

View-through conv.

View-through conversions are conversions that are recorded when users view (but don’t interact with) an ad and then convert later. These conversions are counted based on a period of time called a view-through conversion window.This metric automatically excludes conversions from people who have also interacted with any of your other ads.

Dimension name in Adloop

Dimension name in Source

Definition

Campaign name

Campaign

The name of the campaign.

Adgroup name

Ad groups

The name of the ad group.

Keyword

Keywords

The keyword that was matched to a search.

Match Type

Matchtype

The keyword match types dictate how closely the keyword needs to match with the user’s search query so that the ad can be considered for the auction.

Campaign labels

Campaign label

“Labels” that are created and assigned to campaigns.

Adgroup label

Ad group label

“Labels” that are created and assigned to ad groups.

Ad ID

The unique identifier of an ad.

Campaign ID

The unique identifier of a campaign.

Adgroup ID

Ad group ID

The unique identifier of an ad group.

Network

The is a group of search-related websites and apps where your ads can appear.

Snapchat Ads metrics & dimension

Metric name in Adloop

Metric name in Source

Definition

Ad spend

Amount spent

Spend based on delivery.

App installs

App Installs

Number of times your app was installed.

Clicks

Swipes

The total number of times a user has clicked on an ad in your app or website.

Conversions

Conversion Purchases

The total number of purchases made in your app or website.

Conversions post click

The total number of purchases made in your app or website (post-click).

Conversions post view

The total number of purchases made in your app or website (post-view).

Impressions

Total Impressions

The sum of paid impressions and earned impressions (paid impressions + earned impressions).

Revenue

Conversion Purchases Value

The total value of purchases made in your app or website.

Revenue post click

The total value of purchases made in your app or website (post-click).

Revenue post view

The total value of purchases made in your app or website (post-view).

Saves

Camera Save

The total number of saves made in your app or website

Camera Shares

The total number of times a Snapchatter has shared in your app or website

Videos completed

Video completions

Number of times your Top Snap was viewed to 97%.

Videos started

Total video views

The total number of impressions that meet the qualifying video view criteria of at least 2 seconds of consecutive watch time or a swipe up action on the Top Snap.

Reach

Total Reach

The number of unique Snapchatters who viewed your ad, either by receiving a paid or earned impression. Attention! You may not see the same data between Adloop & Snapchat because Snapchat is counting the Reach per “unique Snapchatters” and they are not sending out this information.

Video view 25%

Video Plays at 25%

Number of times your Top Snap was viewed to 25%.

Video view 50%

Video Plays at 50%

Number of times your Top Snap was viewed to 50%.

Video view 75%

Video Plays at 75%

Number of times your Top Snap was viewed to 75%.

Dimension name in Adloop

Dimension name in Source

Definition

Account ID

Ad Account ID

Unique identifier for the ad account

Name of the ad

Adgroup ID

Ad set ID

Unique identifier for ad squad

Adgroup name

Ad set

Name of the ad set

Ad ID

Unique identifier for ad

Campaign ID

Unique identifier for campaign

Campaign name

Name of the campaign

Campaign objective

Report template system

The Adloop report template system is very useful as it offers empty as well as already filled out reports for each report type that is available. It aims to serve the user to have a more seamless experience when using Adloop.

On the left-hand side, you can see 3 segments Data source, Report type, Funnel .

These aim to bring a clear order within the reporting system. All data sources, report types and funnels are displayed with an icon and a different colour to show the type of the report and the data sources that are included.

There are two main segments of the reporting page: Empty reports, Report templates.

1- Empty reports

The empty reports can be found at the top of the page. There are 6 different types of reports:

Table report
Chart report
Dashboard report
Cycle report
Channel Affinity report
Transaction ID report

By clicking on the Open button an empty report will open.

2- Report templates

Below you can access some of the report templates that were created by the Adloop team to provide basic templates for the different types of reports.

There are 16 types of report templates available:

Google Analytics Key Google Analytics data by source/medium
Channels overview Quick overview of your channels
Chart clicks & CPC Click related data in a graph
Dashboard channels Channel perfomances in a dashboard
Analytics Dashboard Google Analytics data in a dashboard
Detailed SEA performances Performances at keyword level
Detailed Shopping performances Performances at product level
Detailed Display performances Performances at creative level
Detailed Affiliates performances Performances at affiliate level
SEA Dashboard SEA campaign performances in a dashboard
Shopping dashboard Shopping campaign performances in a dashboard
Display dashboard Display campaign performances in a dashboard
Affiliates dashboard Affiliates campaign performances in a dashboard
Affiliates / Channels Conversion Cycle Affilites autonomy
Channels conversion cycle Channel roles in the path to conversion
Chart Ad Spend & Revenue Ad-centric KPI’s

Dashboard

Welcome to your new dashboard

Use it to create a dashboard with your most important datas and informations.

Down below you can find a detailed description on how to create each widget and all the information you need to create the best dashboard for your reporting.

On Adloop you can customize your dashboard how you want your data to show using different types of widgets.

To create an empty dashboard go to New report and select Empty dashboard report.

After the empty dashboard is created click on the + Add widget button to visualize your data.

Text
Totals
Line / Bar / Area
Pie
Table

1. Text

The text widget allows the user to place text content on the dashboard, for example setting goals and agendas for your upcoming campaign:

2. Totals

With the Totals widget you can add up to 4 totals

The totals are filtered by dimension.

Want to know more about dimensions? [[Dimensions|Dimensions]]

After selecting your dimension, you can select your metric and give a name to your first total figure:

Want to know more about metrics? [[Metrics|Metrics]]

You can continue the selecting process as shown above until you create the Total that shows the data you wanted to configure.

After applying the selected parameters your second widget will appear on your dashboard:

3. Line / Bar / Area

When creating an axis chart you can add up to 2 charts.

The chart configuration is filtered similar as before, based on dimensions and metrics.

After selecting these dimensions and metrics you can choose the type of your chart you want to use which can be the following 3 types: Area, Bar, Line

After selecting the type you can select the grouping by Day, Week, Month and Year based on your preference.

And now your dashboard is starting to come together!

The same data can look these 3 ways based on the type of the axis chart:

Area

Bar

Line

4. Pie

Creating a pie chart is similar to creating the previous ones using dimensions and metrics for the data configuration. After selecting these you can also select the time frame and name the chart and your pie chart is created.

5. Table

When creating a Table the same process should be followed as above: choosing the specific Dimensions & Metrics

You can change the order the lenght and the width of the charts and tables and reorganize it based on how you want them to appear on your dashboard.

If you are not content with a widget you can easily edit by clicking on the configuration ( ) icon or delete them by clicking on the ( ) icon.

Dashboard report

https://www.youtube.com/watch?v=tfFhXB8NWhg&list=PLQ4YExrLQZJK_n0ICcYT5ijp1bY743qYP&index=7&ab_channel=AdloopMediaOptimizationPlatform

Transaction ID Report

The transaction ID report aims to show the conversion path by displaying a detailed path to conversion with attributed measures.

To create a Transaction ID report click on the New report tab and select Empty transaction ID

To create a Transaction ID report you have to choose 4 elements:

Conversion metrics
Channel
Time period
Filters (optional)

I- Metrics

Choosing a conversion metric is compulsory. The Conversion metric is there by default but it is possible to choose other custom attributed metrics that were defined previously in the attribution setting up process.

Important to note that at the same time you can only choose one conversion metric!

noteYou want to know more about attribution settings? Visit our dedicated page!

You want to know more about attribution settings? Visit our dedicated page!

II- Channels

After choosing the metric the channel has to be selected as well. You can either select one specific channel or choose “All”.

III- Time period

Using the calendar you can choose the period you want to see in your report. We offer standard periods (last 30 days, this month, last week etc.) but you can also choose a custom period.

IV- Filters (optional)

Clicking on the funnel icon opens the filters menu.

You will find the list of all the dimensions available in your site. You can then select for each dimension the desired values you want to use as filters.

Only data corresponding to the filters will appear in the report.

You can use the search bar either to search for dimensions or for values (once a dimension is chosen) using the switch in the search bar:

If choosing a dimension with lots of possible values (like keyword or ad ID), the loading can be a bit long. Please be patient! Or use another dimension (like ad group or campaign)

You can now click on the Go! button and generate your report!

In the report you can see the source of the conversion and the attributed % in the conversion process. By clicking on the arrow you will see a detailed report with a more granular view on the conversion.

Table reports

Table report is your basic go-to table kind of report! They can be used either for macro overview of your performances or for micro granula r analysis of your digital marketing.

To create an empty table reports, click on the New report button in the left-hand menu and choose Empty table report.

To create a table you have to choose 4 elements :

dimensions
metrics
time period
filters (optionnal)

1- Dimensions

Choose the dimensions you want to use in your report thanks to the dimension menu. You can select a maximum of 5 dimensions.

One of your dimension will be the main dimension of your report. You can change which dimension is the main using the switch.

noteYou want to know more about dimensions? [[Visit our dedicated page!|Dimensions-in-Adloop]]

You want to know more about dimensions? Visit our dedicated page!

2- Metrics

Choose the metrics you want to use in the report thanks to the metrics menu. You can choose a maximum of 20 metrics.

noteYou want to know more about metrics? [[Visit our dedicated page!|Metrics-in-Adloop]]

You want to know more about metrics? Visit our dedicated page!

3- Time period

Using the calendar you can choose the period you want to want to see in your report. We offer standard periods (last 30 days, this month, last week etc.) but you can also choose a custom period.

Using the comparison switch you can compare two different periods :

The initial period is identified with the purple colour, while the comparison period is in yellow.

4- Filters (optionnal)

Clicking on the funnel icon opens the filters menu.

Only data corresponding to the filters will appear in the report.

You can use the search bar either to search for dimensions or for values (once a dimension is chosen) using the switch in the search bar:

If choosing a dimension with lots of possible values (like keyword or ad ID), the loading can be a bit long. Please be patient! Or use another dimension (like ad group or campaign)

You can now click on the Go! button and generate your report!

Table report

https://www.youtube.com/watch?v=E6xFmxmPjUc&list=PLQ4YExrLQZJK_n0ICcYT5ijp1bY743qYP&index=11&ab_channel=AdloopMediaOptimizationPlatform

Embed a report in an Iframe

1- How to build an Iframe link
2- URL query parameters
3- Examples
4- Available dimensions for filters

Adloop give you the possibility to embed a report in an iframe.

To do so, you first need to contact us so that we can make the necessary technical adjustements.

Indeed, by default and for security reasons, the Adloop solution does not accept external requests.

1- How to build an Iframe link

Here is a basic example of how to build the Iframe link

<iframe src="https://{{workspace_url}}/iframe-reports/{{data_set_id}}/ad-reports/{{report_type}}/saved/{{report_id}}?auth_token={{auth_token}}&from={{from_date}}&to={{to_date}}"></iframe>

The easiest way is to go on one of your saved reports, copy the link then add /iframe-reports after the workspace domain name and ?auth_token=YOUR_TOKEN at the end of the URL.

Other parameters aren’t required.

How to find my auth token?

Your auth token can be found in your profile, under the “Security” part:

2- URL query parameters

URL query parameter name

Mandatory

Format

auth_token

YESRed

string

from

NOGreen

yyyy-mm-dd

NOGreen

yyyy-mm-dd

To filter the report, you can add one or n query parameters:

any-dimension-slug

NOGreen

value1

3- Examples

Date: 2022-07-28

Report type: Dashboard

Filters:

SEA campaign name: Awesome campaign OR Amazing campaign
SEA keyword: Magnificent product

<iframe src="https://fake.adoop.co/iframe-reports/1/ad-reports/dashboard/saved/1?auth_token=abcd123&from=2022-07-28&to=2022-07-28&sea-campaign-label=Awesome campaign|||Amazing campaign&sea-keywork=Magnificent product"></iframe>

Date: From 2022-07-01 to 2022-07-31

Report type: Performance

Filters:

Channel: Facebook Ads
Facebook adgroup name: Breathtaking adgroup

<iframe src="https://fake.adoop.co/iframe-reports/1/ad-reports/performance/saved/2?auth_token=abcd123&from=2022-07-01&to=2022-07-31&channel=Facebook Ads&facebook-adgroup-name=Breathtaking adgroup"></iframe>

4- Available dimensions for filters

Slug

Name

General dimensions

channel

Channel

channel-group

Channel group

campaign

Campaign name

device

Device

Date dimensions

day

Day

week

Week

month

Month

year

Year

month_number

Month number

month_by_week

Month and week

Normalized dimensions

affiliate-aft

Affiliate

affiliate-type-aft

Affiliate Type

display-ad-name

Ad name

display-adgroup

Adgroup ID

display-campaign-name

Campaign

display-crea

Ad Creative

display-network

Network

display-placement

Placement

display-site

Site

email-campaign-name

Campaign

email-send-date

Send date

email-type

Type

rtg-campaign

Campaign Name

rtg-category-id-rtg

Category ID

rtg-category-rtg

I- Metrics

Important to note that at the same time you can only choose one conversion metric!

II- Time period

Using the calendar you can choose the period you want to see in your report. We offer standard periods (last 30 days, this month, last week etc.) but you can also choose a custom period.

III- Filters

Clicking on the funnel icon opens the filters menu.

There are two conditions you can use to filter your report. The filtering process starts with setting your first condition. For conditions you can select from the following: contain / does not contain / begins with / ends with. And then choose the values of the 1st dimension. If you want to have a second filter you can choose and/or and do the same process.

For example here the report will be filtered to show path to conversions that contain a social channel.

You can now click on the Go! button and generate your report!

In the report, you can see the number of conversions and the amount of revenue each conversion path represents.

At the top of the page there are additional filterst that can be used:

You can set to see the report on a channel level view:

Or on a campaign level view:

You can select to display different numbers of touchpoints:

And lastly you can display the selected amount of channels:

At the bottom of the page can be found a colour glossary. This aims to make the report more readable. There are different colours to represent the different types of channels in the report.

![](.gitbook/Screenshot 2022-10-05 at 15.22.32.png)

Advanced Alerts

Notifications allow teams to be informed about events that have taken place on their campaigns without having to log in to Adloop. #timesavings

1 - Our goal: tell you what’s happening on your campaigns

Adloop tells you what is happening on your campaigns without having to access your Ads or Analytics platforms.

What kind of informations will I get?

One or ore marketing channels at the same time, or Campaign or even a Creative

What triggers Notifications?

Notifications are triggered according to the parameters you set up. It can be a threshold or just following changes on a Metric.

How frequently?

You choose the frequency, or, if you choose the threshold or objectif reached kind of notification, Adloop will notify you immediately.

Where will I get those Notifications?

Several Destinations are available, we aim at notifying a person but also a team. Email is a mean of Notifications, but also professional chat apps like Slack, Google Chat or Teams.

2 - Building Notifications in Adloop

Prerequisite - For Notifications to work, you must have set-up:

One or several Data Sources
One or several [[ Integrations |Integrations]]

A notification requires several elements in order to function properly:

if you select **Conversion** , we trigger a notification based on the number of conversions coming from **Bing Ads**

| | **Frequency** | How frequently you will be receive the Notification. | | **Period** | Period on which the metrics will be analyzed. | | **Name** | The notification name, you can choose what you want, but we advise you to be precise, because if you receive 15 notifications per day, you will be glad you named them well. |

3 - Notifications available in Adloop

Receive each day the **Facebook Ads** ads with 0 click yesterday.

| | **THRESHOLD** | Receive a notification when a threshold is reached or surpassed Examples:

Receive a Notification when my spends ( **Ad Spend** Metric) are more than 10 000€ in 7 days on **Google Ads**

| | **OBJECTIVE** | Receive a notification to follow a progression towards a goal (in % of the goal). Examples:

Receive each monday how my spends ( **Ad Spend** Metric) are progressing towards my goal of 10 000€ in 7 days on **Google Ads**

noteThe Goal Notification is different from the Threshold Notification as it tells you regularly how you are doing regarding your goal and not only when it is reached.

The Goal Notification is different from the Threshold Notification as it tells you regularly how you are doing regarding your goal and not only when it is reached.

| | VARIATION | Receive a notification when a Metric is changing by a certain %, either up or down, as compared to a previous period. Examples:

Receive a notification when the Google ads, ad spend varies by more than 10% in 7 over the past week.

| | **MONITORING** | Receive a notification indicating the value of a Metric on a certain period. Examples:

Recieve a notification on how many **Conversions** you have done in **Google Ads** in a set time period.

Daily notifications

Anomalies and variations (WIP)

Our Smart Alerts are highlighting important variations on your key metrics and indicators, to draw your attention on what really matters.

In our Budget Alerts, you’ll find some elements highlighted in red or in green, on addition of the variation in % that are available for all the metrics in the alert.

Those highlighted elements show an unsual, unexpected, abnormal variation in regards of the Ad Spend variation.

In the example above, the Ad Spend increased by 36%, while the conversions number remained stable with a 2.89% increase. This stability in conversions is not considered normal given that the investments increased quite a lot during this same period.

This is a negative anomaly - a positive anomaly would just be the opposite.

In our Weekly / Monthly Recap Alert, you’ll find some changes in channels performances outlined. In this Alert, we don’t list channels performances that remained stable for the period or that didn’t significant Ad Spend.

In this focus, we’ll present first the positive anomalies, then negative anomalies, then positive changes and finally negative changes.

In the Smart Alert Weekly Recap, the anomaly detection is also based on the Ad Spend variation.

If we look closely at the Meta Data which presents a positive anomaly: the Ad Spend was stable while the revenue grew by 56%: this performance is not what could have been expected with the budget change. This is why we are drawing attention on it.

We also have a positive anomaly for Google Perf Max, given the stable Ad Spend and the Revenue increasing by 253%

But why don’t we flag an anomaly for Google Search ? Its Ad Spend decreased by 16% while the revenue grew by 12%. Well, we use thresholds based on the variation difference between the Ad Spend and the measured metric to flag anomalies.

The thresholds are the following:

| Label | Variation compared to the Ad Spend variation | | Negative anomaly | Normal sensitivity: -40 points Low sensitivity: beyond -55 points High sensitivity: beyond -25 points | | Decrease | Normal sensitivity: between -15 points & -40 points Low sensitivity: between -20 & -55 points High sensitivity: between -25 & -10 pts | | Stable | Normal sensitivity: between -15 points and +15 points Low sensitivity: between -20 & +20 points High sensitivity: between -10 & +10 points | | Increase | Normal sensitivity: between +15 points & +40 points Low sensitivity: between +20 & +55 points High sensitivity: between +10 & +25 points | | Positive Anomaly | Normal sensitivity: +40 points Low sensitivity: beyond +55 points High sensitivity: beyond +25 points |