This guide will walk you through how to authenticate or reauthenticate Pinterest Ads and Pinterest Organic 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 Pinterest Organic, you need a user logged in with the profile's Owner account. Note that Supermetrics can only pull data from business profiles.
To connect Supermetrics to Pinterest Ads, you need a Pinterest user account with at least Admin or Campaign access to an ad account. Read Pinterest’s documentation for instructions on how to grant access to Pinterest Ad account.
Pinterest Organic: Query types
Profile lifetime metrics provide a snapshot view of your profile’s current data: followers, the number of pins, reach. Unfortunately, historical follower data cannot be queried with Pinterest Organic connector.
If you want to track the development of your follower and pin amount in Google Sheets, you can use the Combine new results with old feature in report configuration, and schedule a periodic refresh of your query. This way, previous query results are stored and new results are fetched automatically.
If you want to track the development of your metrics in Data Studio, you can schedule a query featuring "Combine new results with old" in Google Sheets, and import that data to Data Studio.
The profile data report type allows you to fetch and investigate key impressions and engagement metrics for your Pinterest profile over time. This data includes metrics of all pins, not just the top 100.
You can select a date range for which you want data to be returned. The time range in Top pins report type defines the time range of when metrics have been accumulated (impressions, clicks, saves, close-ups) and not when the pin has been created.
The report allows you to select if you want to see organic, paid, or both metrics for pins, and if you want to inspect pins created by you, pins that you re-pinned, or both.
The top pins report type returns data for the 100 best-performing pins in your profile based on the metric you select. You can define the sorting basis in report configuration.
You can select a date range for which you want data to be returned. The time range in Top pins report type defines the time range of when metrics have been accumulated (impressions, clicks, saves, close-ups) and not when the pin has been created.
The report allows you to select if you want to see organic, paid, or both metrics for pins, and if you want to inspect pins created by you, pins that you re-pinned, or both.
Instructions
- Open a new Google Sheets file.
- Navigate to Extensions → Supermetrics → Launch to open the Supermetrics sidebar.
- Under Data source, select Pinterest Ads or Pinterest Organic.
- Click Start.
- Enter your email address and password, and click Log in.
- Click Give access.
- Select the accounts you'd like to include in your reporting.
- Navigate to Report configuration.
- Select your query type.
- Open the Supermetrics data source gallery.
- Navigate to Pinterest Organic or Pinterest 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 email address and password, and click Log in.
- Click Give access.
- Select the accounts you want to include in your reporting.
- Navigate to Report configuration.
- Select your query type.
- 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 Pinterest Ads or Pinterest Organic.
- Choose to make this connection shared or private.
- Click Start.
- Enter your email address and password, and click Log in.
- Click Give access.
- Select the accounts you'd like to include in your reporting.
- Navigate to Report configuration.
- Select your query type.
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're missing an account from the drop-down list, follow these steps.
- If you encounter a permission error such as “user permission denied” or similar, follow this guide.