> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tryprofound.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Usage

> Import data into Tableau using Web Data Connector 3.0

## System Requirements

<Card>
  **Minimum required version**

  * Tableau Desktop 2023.3 or higher
</Card>

### Compatible Operating Systems

* Windows 10 or higher
* macOS 12 (Monterey) or higher

## Download

The connector is available on our [releases page](/rest-api/integrations/tableau/releases). Download the latest version of `profound-connector.taco` from there.

## Installation

<Tabs>
  <Tab title="Windows">
    ### Windows Installation

    1. **Locate the Tableau connectors directory**

       Open Windows Explorer and navigate to:

       ```
       C:\Users\[YourUsername]\Documents\My Tableau Repository\Connectors
       ```

           <Note>
             If the `Connectors` folder doesn't exist, create it manually
           </Note>

    2. **Copy the .taco file**
       * Copy the downloaded `profound-connector.taco` file
       * Paste it into the Connectors folder
       * **Important**: Do not unzip the .taco file

    3. **Restart Tableau Desktop**
       * Completely close Tableau Desktop if it's open
       * Reopen the application

    4. **Verify the installation**
       * The connector will appear as "AEO Connector by Profound" in the connectors list
  </Tab>

  <Tab title="macOS">
    ### macOS Installation

    1. **Locate the Tableau connectors directory**

       * Open Finder
       * Press `Cmd + Shift + G`
       * Enter the following path:

       ```
       ~/Documents/My Tableau Repository/Connectors
       ```

           <Note>
             If the `Connectors` folder doesn't exist, create it
           </Note>

    2. **Copy the .taco file**
       * Drag the `profound-connector.taco` file to the Connectors folder
       * **Important**: The file must keep the .taco extension

    3. **Restart Tableau Desktop**
       * Completely close Tableau Desktop if it's open
       * Reopen the application

    4. **Verify the installation**
       * The connector will appear as "AEO Connector by Profound" in the connectors list
  </Tab>
</Tabs>

## First Connection

<Steps>
  <Step title="Open Tableau Desktop">
    Launch Tableau Desktop 2023.3 or higher
  </Step>

  <Step title="Select the Connector">
    1. On the start page, click **"More..."** in the left panel under "To a Server"
    2. Look for **"AEO Connector by Profound"** in the list
    3. Click to select it

           <img src="https://mintcdn.com/profound-37face47/Gnsk1t-l2OsDCIqT/images/rest-api/tableau/wdc-3/more_connectors.png?fit=max&auto=format&n=Gnsk1t-l2OsDCIqT&q=85&s=c46b742b1e73b211630e0f136e042974" alt="More Connectors" width="3060" height="2404" data-path="images/rest-api/tableau/wdc-3/more_connectors.png" />
  </Step>

  <Step title="Authenticate">
    The connector UI will open with an API Key field:

    * Enter your **API Key** generated from the platform
    * Click **"Access"** to proceed

          <img src="https://mintcdn.com/profound-37face47/Gnsk1t-l2OsDCIqT/images/rest-api/tableau/wdc-3/enter_key.png?fit=max&auto=format&n=Gnsk1t-l2OsDCIqT&q=85&s=4c9c7a7791c64214855b594f591c0ff4" alt="Enter Key" width="1624" height="1268" data-path="images/rest-api/tableau/wdc-3/enter_key.png" />
  </Step>

  <Step title="Select Data Source">
    Once authenticated, you can choose between:

    * **Raw Answer**: Access raw data with custom filtering options
    * **Report Types**: Select from available pre-configured aggregated reports

    Select your preferred data source and apply any filters as needed

    <img src="https://mintcdn.com/profound-37face47/Gnsk1t-l2OsDCIqT/images/rest-api/tableau/wdc-3/select_data.png?fit=max&auto=format&n=Gnsk1t-l2OsDCIqT&q=85&s=c66bd0cb54dcc2ad7fe2bf9ca821b7a6" alt="Select Data Source" width="1624" height="1522" data-path="images/rest-api/tableau/wdc-3/select_data.png" />
  </Step>

  <Step title="Import to Tableau">
    Click **"Import to Tableau"** to load the selected data into Tableau

    <img src="https://mintcdn.com/profound-37face47/Gnsk1t-l2OsDCIqT/images/rest-api/tableau/wdc-3/imported_table.png?fit=max&auto=format&n=Gnsk1t-l2OsDCIqT&q=85&s=148b4e98607f599581ac501c93ce5b86" alt="Imported Table" width="3060" height="2404" data-path="images/rest-api/tableau/wdc-3/imported_table.png" />
  </Step>
</Steps>

## Troubleshooting

### The connector doesn't appear in Tableau

<AccordionGroup>
  <Accordion title="Check Tableau version">
    * Go to **Help → About Tableau**
    * Confirm you have version 2023.3 or higher
  </Accordion>

  <Accordion title="Verify file location">
    **Windows:**

    * Confirm the file is in `C:\Users\[YourUsername]\Documents\My Tableau Repository\Connectors`

    **macOS:**

    * Confirm the file is in `~/Documents/My Tableau Repository/Connectors`
  </Accordion>

  <Accordion title="Fully restart Tableau">
    Make sure to close all Tableau Desktop windows before reopening
  </Accordion>
</AccordionGroup>

### Connection Errors

<AccordionGroup>
  <Accordion title="Invalid API Key">
    * Verify you've copied the complete API Key without spaces
    * Check that your API Key is active
    * Generate a new API Key if necessary
  </Accordion>

  <Accordion title="No data appears">
    * Verify the selected endpoint contains data for your filters
    * Check date ranges aren’t too restrictive
    * Confirm API key has access to the requested data
  </Accordion>
</AccordionGroup>

## Updating the Connector

When a new version is available:

1. Download the new version of the .taco file from the releases page
2. Delete the old file from the Connectors folder
3. Copy the new .taco file
4. Restart Tableau Desktop

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Where do I generate my API Key?">
    [Here you can refer to the API Key generation documentation](/rest-api/authentication)
  </Accordion>

  <Accordion title="How do I know which version of the connector I have?">
    The version is included in the .taco filename you downloaded.
  </Accordion>
</AccordionGroup>