# How to Integrate Rakuten with Daton

### Pre-requisites

Before starting, ensure you have 

* An active Daton and Rakuten Advertising account. 
* Rakuten API token.

### Task 1**: Get your** Rakuten **API Token and Report Names** 

1. Sign in to your Rakuten Account and access the **Advertiser Dashboard**.
2. Navigate to the **Reports** section and click on **Reporting**. 

   <figure><img src="/files/eFNjkJxbF51eMfShHyoV" alt="" width="375"><figcaption></figcaption></figure>
3. Click on **Choose Report** and choose the specific **Report Name** you intend to integrate with Daton.&#x20;

   <figure><img src="/files/cN4dWMgi12TZCTUFajIF" alt="" width="375"><figcaption></figcaption></figure>
4. After selecting the report, its details will appear on the screen. Now, go to **View Report** and click **Get API**.&#x20;

   <figure><img src="/files/51HnSzo6pfYV0TrSv3wA" alt="" width="375"><figcaption></figcaption></figure>
5. Your API URL will be displayed in the following format:\
   `https://reporting.rakutenmarketing.com/en/reports/`**`report-name`**`/filters?date_range=this-summary=Y&tz=GMT&date_type=transaction&token=`**`YourAPIToken`**

   <figure><img src="/files/AXKiyX5glm6nZRmf1YIE" alt=""><figcaption></figcaption></figure>

   Be sure to copy both the Report Name and the API Token for future use in your system.

### Task &#x32;**:** Integrate Daton with Rakuten

1. Log in to your [Daton account](https://daton.sarasanalytics.com/u/integrations-list) and search for Rakuten in the list of Connectors, then click **Configure**.
2. Enter or select the following details and click **Authenticate**:&#x20;

   * Integration Name. Note that the Integration Name will be used to create the integration tables and cannot be modified later.
     * Optionally, add a description to identify the integration.
   * Replication Frequency&#x20;
   * Replication Start Date
   * Attribution Window
   * Optionally, expand the **Advanced Configuration Options** section and, based on your requirements, modify the options to control the loading behavior of Daton.

   <figure><img src="/files/EBqOWBIJdsLxAl79TWFF" alt=""><figcaption></figcaption></figure>
3. Provide the following in the required fields to authenticate the integration. Then click **Authenticate**.&#x20;

   * Rakuten API Token&#x20;
   * Report Names&#x20;

   <figure><img src="/files/Ggn8yMZ7lqX6X4xZkYXG" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
It's important to note that:

* The Report Name field is the determining factor for table data in the destination schema.&#x20;
* Tables in the destination will be named as Report\_1, Report\_2, and so forth.&#x20;
* &#x20;A maximum of 5 reports can be allocated in a single integration.
  {% endhint %}

4. After successful authentication, you will be prompted to choose from the list of the reports provided in the 3rd step. Select the reports you want to replicate and click **Next**.&#x20;

   * Based on your requirement, select specific options for each selected table.

   <figure><img src="/files/rqtzLerMFVKgVDkal6ws" alt=""><figcaption></figcaption></figure>

   * **Note** that you will be prompted to select the destination for your account.
5. Select the destination for extracting Rakuten data for replication and click **Confirm**. An integration successful message will be displayed.

## Important Note

* Integrations would begin in the Pending state and change to the Active state once the first job successfully loaded data into the configured warehouse.&#x20;
* Users can check job status and process logs from the integration details page by clicking on the integration name in the active list.&#x20;
* Users can Re-Authenticate, Edit, Clone, Pause, or Delete the integration at any moment by clicking on settings. You can also adjust the frequency and history of the integration.&#x20;
* On the Sources page, click Integration to access each table in your integration. The page also shows the state of each table, the last replicated time, and the Reload access buttons.&#x20;


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://daton-sarasanalytics.gitbook.io/daton/integrations/data-sources/advertising/rakuten/how-to-integrate-rakuten-with-daton.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.