Follow these steps to connect your Rakuten Advertising data to Supermetrics and use your data in any of our data destinations — Google Sheets, Looker Studio, Excel, and data warehouses, as well as the Supermetrics API. You can also connect to data sources from the Supermetrics Hub.
You can share your data source connection with your team and use the connection across all data destinations you use with Supermetrics. Learn more about shared connections.
Before you begin
Supermetrics fetches performance data for affiliate campaign advertisers through Rakuten Advertising. It doesn't currently support the platform's publisher side.
To connect to Rakuten Advertising, you need to create a report, and then get your report key and API token. Follow the steps below to meet these prerequisites.
- Log in to Rakuten Advertising.
- Navigate to Reports, and then Reporting.
- Select an existing report, or build a new one. Select every column that you want to use in Supermetrics. You can alter the time range and other report settings at any time in Supermetrics itself.
- Save the report.
- Open the report you want to use in Supermetrics.
- Click the dropdown next to View report.
- Click Get API.
- You'll see your API URL. From it, pull:
- Report key: Copy the string that follows /reports/ in the URL. It should match the name you gave your report.
- API token: Copy the string that follows &token= in the URL.
- Here's an example: //ran-reporting.rakutenmarketing.com/en/reports/[REPORT-KEY]/filters?date_range=this-month&include_summary=Y&tz=GMT&date_type=transaction&token=[API-TOKEN]
- Save your report key and API token securely.
Instructions
Make sure you've installed the Supermetrics add-on before you connect.
- Open a new Google Sheets file.
- Navigate to Extensions → Supermetrics → Launch to open the Supermetrics sidebar.
- Click Create query.
- Under Data source, select Rakuten Advertising.
- Enter your report key and API token.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Choose to make this connection shared or private.
- Click Start.
Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Google Sheets.
Make sure you've connected Supermetrics to Looker Studio before following the steps below.
- Open the Supermetrics Looker Studio data source gallery.
- Navigate to Rakuten Advertising and click Start free trial.
- You'll see two buttons that read Authorize. If you're using Supermetrics for the first time, click the left-hand one and log in with the Google Account you use with Supermetrics.
- Once that's done, or if you've done it before, click the right-hand Authorize button (under "Rakuten Advertising requires authorization to connect to data").
- Select a team that has access to the account you want to connect.
- Enter your report key and API token.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Choose to make this connection shared or private.
- Click Start.
- 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.
- In the pane's top right, click Connect.
- Click Create report.
- Click Add to report.
Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Looker Studio.
Make sure you've installed the Supermetrics add-on before you connect.
- Open an Excel file.
- Click Data → Show Supermetrics.
- Under Data source, select Rakuten Advertising.
- Enter your report key and API token.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Choose to make this connection shared or private.
- Click Start.
Learn about advanced settings, best practices, and troubleshooting tips for Supermetrics for Excel.
Follow these instructions to set up a transfer with Supermetrics for BigQuery (marketplace). See the instructions below for other data warehouse destinations.
Set up transfer for BigQuery (marketplace)
Make sure you've enrolled the data source before you connect.
- Log in to the Google Cloud Platform.
- Navigate to BigQuery → Data transfers.
- Click + Create transfer.
- Select the Rakuten Advertising data source.
- Fill in the transfer details. See detailed instructions on how to set up a transfer.
- Under Third-party connection, click Connect source.
- Accept the agreement.
- Click Authorize with Rakuten Advertising.
- Enter your report key and API token.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Select the accounts you'd like to include in your reporting and define the transfer settings.
- Click Submit.
- Click Save.
Set up data warehouse transfer on the Supermetrics Hub
Make sure you've set up a data warehouse destination before you connect.
- Log in to the Supermetrics Hub.
- In the left-side menu, under Export, go to Data warehousing → Transfers.
- Click Create new.
- Select the Rakuten Advertising data source, and click OK.
- Fill in the transfer details. See detailed instructions on how to set up a transfer.
- In the Connections section, click Add new connection.
- Enter your report key and API token.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Click Start.
- In the transfer setup view, select the accounts you'd like to include in your reporting.
- Click Create transfer.
- Log in to the Supermetrics Hub.
- In the left-side menu, under Transform, click Query Manager (API).
- Select for Supermetrics API from the dropdown menu next to the page title.
- Click Select data source.
- Select the Rakuten Advertising data source.
- Enter your report key and API token.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Click Start.
- Fill in the query details. See detailed instructions on how to set up a Supermetrics API query in Query Manager.
- Click Run to test your query.
- Log in to the Supermetrics Hub.
- In the left-side menu, select Connect → Data sources.
- Scroll down to the list of data sources you haven't connected to. You see this list below your existing connections, under the title Connect to new data source.
- Hover over the Rakuten Advertising data source, and click Connect.
- Enter your report key and API token.
- Give your login a name. The name can be anything — its purpose is for you to recognize the login later in case you have multiple logins.
- Click Start.