# 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="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2F0rvBTEOX7h8uNBn56Yd7%2F4RakutenAPI.png?alt=media&#x26;token=abd9c0be-61f6-48d3-8e28-e7806842aeef" 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="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FsSwOkc35VJavs4cJqxRM%2F5RakutenAPI.png?alt=media&#x26;token=f6d8a9d8-a1a5-4001-a772-5ed8f44c0597" 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="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2F0EgXqpcgyRXUPWn3TGkP%2F6RakutenAPI.png?alt=media&#x26;token=d3778575-1857-44bf-9283-a8abe276a2bb" 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="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FwiW0Jc6gdZjdvi76g3tQ%2FRakutenAPI%20LAst.png?alt=media&#x26;token=f8186f32-9622-4fdd-9018-62035f4d6fae" 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="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FHqFLhLYJrvZlq3WFnYns%2F1Rakuten.png?alt=media&#x26;token=99bf9f11-f9c3-44d6-8ac2-316620a2179f" 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="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FNqCdBrrUoHpOCpZCYCJR%2F2Rakuten.png?alt=media&#x26;token=ebc283a0-d407-449c-9add-77d72fda62f4" 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="https://15515196-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LbJ1eMq5M51cIpU163R%2Fuploads%2FUpGpIubqiVbEMBnOxVNC%2FRakutenupdate%20(1).png?alt=media&#x26;token=d5ee93bc-0f28-41ce-bd7b-3603d99bba3d" 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;