> For the complete documentation index, see [llms.txt](https://docs.roivenue.com/roivenue-resources/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.roivenue.com/roivenue-resources/implementation/advertising-platforms/connecting-platforms-yourself.md).

# Connecting Platforms Yourself

Set up advertising platform connectors directly in the Roivenue interface, step by step, without sharing access to your ad accounts.

Connecting platforms yourself is the recommended way to bring advertising platform data into Roivenue. You log in to each platform from the Roivenue interface and complete a short setup wizard. No access sharing is needed, and your accounts stay fully under your control.

Your Client Success Manager (CSM) walks you through the setup on one of your implementation calls.

Before you start:

* Have login details for each platform ready, with at least read access to the ad accounts you want to connect.
* Check the **Additional requirements** column in [Sharing Accesses](https://docs.roivenue.com/roivenue-resources/implementation/advertising-platforms/sharing-accesses). Some platforms need an extra step inside the platform first, such as generating an API token, configuring a report URI, or allowlisting incoming API calls.

***

### How to add a connector

Go to **Data → Connectors** and click **Add New Connector**. The wizard has five steps. Almost all settings can be changed later.

1. **Select the Data Source Platform.** Pick the platform from the list. Use **Find** to search by name.
2. **Log in to the Marketing Platform.** Give Roivenue access to the platform. Depending on the platform, you log in on the platform's own page (OAuth), or paste an API key or token you generated in the platform. If you connected the platform before, choose **Use Previous Login** to reuse the saved login.
3. **Select Data Source.** Choose the ad account, property, or profile you want to pull data from. If you do not see it, choose **Authenticate to an other account** and log in with a user that has access.
4. **Select Metrics and Dimension Template.** The template defines what data the connector imports. On your first setup, select the template marked with a star ★. It is the recommended default for the platform.
5. **Connector Settings.** Check the connector name and set the **Start Date**, the first day of data to download. Fill in any platform-specific settings and check **Preview Data**. Then save the connector.

What each platform asks for at the login step appears on screen as soon as you select it. There is nothing to prepare in advance, unless the platform has additional requirements.

{% hint style="info" %}
**Insight vs. export connectors:** This guide sets up an insight connector, which brings platform data into Roivenue. Export connectors are set up the same way, with one extra **Destination** step, but their data does not enter Roivenue. It is only sent on to the destination you choose. See [Advertising Platforms](https://docs.roivenue.com/roivenue-resources/implementation/advertising-platforms).
{% endhint %}

***

### What happens after you save

* The connector runs automatically the next morning and starts downloading data from the **Start Date**.
* After the first run, data is updated every night, typically between 2 and 8 AM.
* Your login is saved in **Account Configuration → Platform Credentials**, so you can reuse it for other connectors.
* Let your CSM know which platforms you connected, so they can validate the data with you.

For details on working with connectors for individual platforms, see the [Connectors](https://docs.roivenue.com/roivenue-resources/roivenue-connectors/connectors-overview) section.

***

#### FAQ

<details>

<summary>1. I can't find my platform in the list. What now?</summary>

The list shows platforms you can connect yourself. Contact your CSM. Roivenue may have a backend connector for it, or another way to bring the data in.

</details>

<details>

<summary>2. My ad account does not appear in the Select Data Source step. Why?</summary>

The user you logged in with does not have access to that account. Grant the user access in the platform, or choose **Authenticate to an other account** and log in with a user who has it.

</details>

<details>

<summary>3. Which template should I choose?</summary>

The one marked with a star ★. It contains the metrics and dimensions Roivenue needs. Use a different template only if your CSM recommends it.

</details>

<details>

<summary>4. How far back can I load data?</summary>

Set the **Start Date** in the connector settings. How much history is available depends on the platform's API. Ask your CSM what start date makes sense for your account.

</details>

<details>

<summary>5. I saved the connector but I don't see any data. Why?</summary>

The connector downloads data during the nightly run, so data appears the next morning. If it is still missing, contact your CSM.

</details>

<details>

<summary>6. Should I share access as well?</summary>

It is not required. Sharing access in addition lets Roivenue troubleshoot connector issues directly. See [Sharing Accesses](https://docs.roivenue.com/roivenue-resources/implementation/advertising-platforms/sharing-accesses).

</details>
