# Rakuten Advertising

<a href="https://dbdiagram.io/e/68371607c07db17e778a23a0/68371711c07db17e778a5f0a" class="button primary" data-icon="table-tree">Prebuilt reports and definition</a>

***

## <mark style="background-color:blue;">Prerequisites</mark>

To connect Rakuten to QUANTI, you need an [Rakuten Advertising](https://rakutenadvertising.com/fr-fr/?utm_source=quanti.io\&utm_medium=partnership) account. In the last version of this connector, you cannot retrieve datas from any reports. You have to follow steps below including respect fields requested on the rakuten report.

***

## <mark style="background-color:blue;">Setup instructions</mark>

### Create a Rakuten Report and find the generated link

1. Log in to your [Rakuten account](https://auth.rakutenmarketing.com/auth/realms/rakuten-advertising/protocol/openid-connect/auth?client_id=security-admin-console\&redirect_uri=https%3A%2F%2Fauth.rakutenmarketing.com%2Fauth%2Fadmin%2Frakuten-advertising%2Fconsole%2F\&state=0bfc7308-d6d6-411a-a3a2-c858f86852ac\&response_mode=fragment\&response_type=code\&scope=openid\&nonce=37498c3d-5f4c-4dbd-826f-da13d0cb7827\&code_challenge=isEfEnMMx8QHWhWZptlAkdHIxfB3UrcJcjFMuWFf07o\&code_challenge_method=S256).
2. Click on tab Reporting < Statistics\ <br>

   <figure><img src="https://1847929239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoRN0sxIyI0UJdSqkwdBu%2Fuploads%2Fgit-blob-a53927cd7918e502d0bc87b07ea1e1057fc161d1%2Frakuten1.png?alt=media" alt="Access path to custom report tool"><figcaption><p>Access path to custom report tool</p></figcaption></figure>
3. Click on the button "+ Build a new report"\ <br>

   <figure><img src="https://1847929239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoRN0sxIyI0UJdSqkwdBu%2Fuploads%2Fgit-blob-39c858fd55dd1753c6ad2384d93b0729bae03aec%2Frakuten2.png?alt=media" alt="Build a new report" width="563"><figcaption><p>Build a new report</p></figcaption></figure>
4. Click on button "Add and Remove columns" and add the only and entire list below :<br>

   * Transaction Date
   * \# of impressions
   * \# of Clicks
   * \# of orders
   * Gross Commissions
   * Total Commissions
   * Sales
   * Order ID
   * Sub-Publihser ID
   * Sub-Publisher Name
   * Sub-Publisher URL
   * Publisher Group ID
   * Publisher Group Name
   * Publisher ID
   * Publisher Name
   * Publisher URL
   * Offer ID
   * Offer Name
   * Link Id
   * Link Name<br>

   <figure><img src="https://1847929239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoRN0sxIyI0UJdSqkwdBu%2Fuploads%2Fgit-blob-39db7e267ea2b30dfc96d5c756c698c2a86f9676%2Frakuten3.png?alt=media" alt="&#x22;Add and Remove Columns&#x22; pop-in" width="306"><figcaption><p>"Add and Remove Columns" pop-in</p></figcaption></figure>
5. Near the blue button "View Report", click on the arrow and "Get API" and copy the url generated.\ <br>

   <figure><img src="https://1847929239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoRN0sxIyI0UJdSqkwdBu%2Fuploads%2Fgit-blob-fad28b87fb17d1b19e94e8a9689c18f047744e27%2Frakuten4.png?alt=media" alt="Access path to the generated link"><figcaption><p>Access path to the generated link</p></figcaption></figure>

<figure><img src="https://1847929239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoRN0sxIyI0UJdSqkwdBu%2Fuploads%2F4BPY6Ew5oVxXp7PGIOyM%2FLinkShare-08-01-2025_03_31_PM.png?alt=media&#x26;token=0aecd15f-3896-42a6-bbb7-7fe1a44471f5" alt=""><figcaption></figcaption></figure>

### Importante information

If you have several Rakuten accounts and want to fill a unique table, you have to create several Rakuten connectors of course and especially respect the list's order and metrics's names. You can change the list order by moving column headings.\ <br>

<figure><img src="https://1847929239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoRN0sxIyI0UJdSqkwdBu%2Fuploads%2Fgit-blob-1403091c195bc1a1d53a6f1da93ed191378ca36f%2Frakuten5.png?alt=media" alt="" width="563"><figcaption></figcaption></figure>

### Finish Quanti: configuration

```bash
//ran-reporting.rakutenmarketing.com/en/reports/[<API-REPORT>]/filters?
date_range=this-month&include_summary=Y&tz=GMT&date_type=transaction&token=[<API-KEY>]
```

1. In the connector setup form, enter the name of your choice.
2. Paste the Report key from the URL generated.
3. Paste the API token from the URL generated.

<figure><img src="https://1847929239-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoRN0sxIyI0UJdSqkwdBu%2Fuploads%2Fdy1JyoSkriHDS32VY2SB%2FQuanti-App-08-01-2025_03_29_PM.png?alt=media&#x26;token=6e1420d6-30ba-406e-886b-7669ad54d45c" alt=""><figcaption></figcaption></figure>

1. Settings : In most cases, you will need use
   1. Date type : transaction
   2. Timezone : UTC
2. Click Save & Test. Quanti: will take it from here and sync your Rakuten data.

***

## <mark style="background-color:blue;">Prebuilt reports</mark>

* Affiliate report : Ad performance tracking with campaign metrics and attribution details

***

<a href="https://dbdiagram.io/e/68371607c07db17e778a23a0/68371711c07db17e778a5f0a" class="button primary" data-icon="table-tree">Prebuilt reports and definition</a>
