This guide will walk you through how to authenticate or reauthenticate Microsoft Advertising in Supermetrics with Google Sheets, Data Studio, and Excel, as well as data warehouse destinations like Google Cloud Storage, BigQuery, and the Supermetrics API.
Before you begin
To connect Supermetrics to Microsoft Advertising, you need:
- A Microsoft user account with at least Advertiser Campaign Manager access to an ad account. Learn how to grant access to Microsoft Advertising account.
- Multi-factor authentication enabled for the Microsoft user account — this is a requirement for access to Microsoft Advertising via its API. See Microsoft's account security information for more details.
Instructions
Before you can authenticate the data source in Google Sheets, you need to install the Supermetrics add-on.
- Open a new Google Sheets file.
- Navigate to Extensions → Supermetrics → Launch to open the Supermetrics sidebar.
- Under Data source, select the data source.
- Click Start.
- Enter your Microsoft email address and click Next.
- Enter your Microsoft password and click Sign in.
- Select the accounts you'd like to include in your reporting.
- Open the Supermetrics data source gallery.
- Navigate to Microsoft Advertising and click Try.
- Click Authorize.
- If you're authenticating the data source for the first time, log in with the Google Account you use with Supermetrics. Click Allow.
- Click Authorize.
- Enter your Microsoft email address and click Next.
- Enter your Microsoft password and click Sign in.
- Select the accounts you'd like to include in your reporting.
- Scroll down to the bottom of the page. To create a report with our template, select Use report template for new reports. To create a blank report, deselect this option.
- Click Connect on the top right-hand side.
- Click Create report.
- Click Add to report.
Add or remove a user account in Data Studio
- Click the edit icon next to the data source's name in the Data Studio sidebar.
- At the top left of the connection pane, click Edit connection.
- Scroll down to Parameters.
- Browse team, account, and license management options in the section beginning "To add more/manage accounts..."
Connections
If you use Excel and no other Supermetrics products, you’ll be able to connect accounts to data sources and share these connections with your team. You can manage connections either within the add-in sidebar or via the Supermetrics Team Site. Learn more about shared connections.
Before you can authenticate the data source in Excel, you need to install the Supermetrics add-in.
- Open an Excel file.
- Click Data → Show Supermetrics.
- Under Data source, select Microsoft Advertising.
- Choose to make this connection shared or private.
- Click Start.
- Enter your Microsoft email address and click Next.
- Enter your Microsoft password and click Sign in.
- Under Select accounts, select the accounts.
Explore our guides to set up data transfers to various destinations.
- BigQuery
- Data warehouses and cloud storage (Amazon S3, Google Cloud Storage, Snowflake, Azure Storage, or Azure Synapse)
- The Supermetrics API
Reauthenticate the data source
Troubleshooting
- If you encounter an authentication error such as “authentication failed”, “you need to reauthenticate” or similar, see this guide.
- If you encounter a permission error such as “user permission denied” or similar, follow this guide.