Embed a report in an Iframe
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 | YES | string |
from | NO | yyyy-mm-dd |
to | NO | yyyy-mm-dd |
To filter the report, you can add one or n query parameters: | ||
any-dimension-slug | NO | value1|||value2|||value3 |
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 | Category |
sea-ad-name | Ad name |
sea-adgroup-label | Adgroup Name |
sea-campaign-label | Campaign Name |
sea-keyword | Keyword |
sea-match-type | Match Type |
seo-query | Query |
shopping-adgroup-label | Adgroup Name |
shopping-campaign-label | Campaign Name |
shopping-network | Network |
shopping-product | Product |
social-ad-name | Ad Name |
social-adgroup-name | Adgroup Name |
social-campaign-name | Campaign Name |
social-organic-description | Post Description |
social-organic-format | Post Format |
social-organic-name | Account Name |
social-organic-placement | Post Placement |
social-organic-platforme | Platform |
social-placement | Placement |
video-ad-id | Ad name |
video-adgroup-label | Adgroup Name |
video-campaign-label | Campaign Name |
video-network | Network |
video-site | Site |
video-title | Title |
Data source dimensions | |
active-campaign-campaign-id | Campaign ID |
active-campaign-campaign-name | Campaign Name |
active-campaign-segment-id | Segment ID |
active-campaign-send-date | Send date |
active-campaign-send-date | Send date |
active-campaign-send-id | Send ID |
active-campaign-source | Source |
active-campaign-type | Type |
adform-ad-id | Ad id |
adform-ad-name | Ad name |
adform-campaign-id | Campaign id |
adform-campaign-name | Campaign name |
adform-campaign-type | Campaign type |
adform-client | Client |
adform-country | Country |
adform-creative | Creative |
adform-creative-format | Creative format |
adform-creative-global-id | Creative global id |
adform-creative-id | Creative id |
adform-creative-size | Creative size |
adform-creative-type | Creative type |
adform-network | Network |
adform-site-name | Site name |
affilae-affiliate | Affiliate |
affilae-affiliate-id | Affiliate ID |
attr-device | Device |
attr-tracking-destination-page | Destination page |
attr-tracking-device | Device |
attr-tracking-search-engine | Search engine |
attr-tracking-utm-campaign | Adloop UTM campaign |
attr-tracking-utm-content | Adloop UTM content |
attr-tracking-utm-keyword | Adloop UTM keyword |
attr-tracking-utm-medium | Adloop UTM medium |
attr-tracking-utm-source | Adloop UTM source |
awin-device | Device |
awin-publisher-id | Affiliate ID |
awin-publisher-name | Affiliate |
bing-ads-ad-group-id | Adgroup ID |
bing-ads-ad-group-name | Adgroup name |
bing-ads-ad-id | Ad ID |
bing-ads-ad-network-type | Network |
bing-ads-campaign-id | Campaign ID |
bing-ads-campaign-name | Campaign name |
bing-ads-device | Device |
bing-ads-keyword-info-text | Keyword |
bing-ads-match-type | Match type |
bing-shopping-ad-group-id | Adgroup ID |
bing-shopping-ad-group-name | Adgroup name |
bing-shopping-campaign-id | Campaign ID |
bing-shopping-campaign-name | Campaign name |
bing-shopping-device | Device |
bing-shopping-network-type | Network |
bing-shopping-product-id | Product ID |
bing-shopping-product-name | Product name |
criteo-adset | Adset |
criteo-adset-id | Campaign ID |
criteo-device | Device |
facebook-account-id | Account ID |
facebook-account-name | Account name |
facebook-ad-id | Ad ID |
facebook-ad-name | Ad name |
facebook-adgroup-id | Adgroup ID |
facebook-adgroup-name | Adgroup name |
facebook-campaign-id | Campaign ID |
facebook-campaign-name | Campaign name |
facebook-country | Country |
facebook-organic-account-id | [Account] ID |
facebook-organic-account-name | [Account] Name |
facebook-organic-post-date-created | [Post] Date created |
facebook-organic-post-id | |