> 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.md).

# Advertising Platforms

Why Roivenue needs data from your advertising platforms, what the data is used for, and the two ways to connect your ad accounts during implementation.

Connecting your advertising platforms is one of the core steps of implementation. Roivenue measures customer journeys from your web data, but the money you spend and the data your ad platforms report live in the platforms themselves. Connectors bring that data into Roivenue, so attribution results can be turned into costs, returns, and decisions.

This page explains why the connection matters, what data comes in, and how to choose the way you connect your platforms. Your Client Success Manager (CSM) guides you through this step.

***

### Why connect your advertising platforms

Advertising platform data has three jobs in Roivenue.

#### 1. Costs for cost-based metrics

Roivenue attributes conversions and revenue to your channels and campaigns from web data alone. To say what those results cost, it needs your spend. Once the **Cost** from each platform is in Roivenue, you can see metrics such as:

<table data-search="false"><thead><tr><th>Metric</th><th>What it tells you</th></tr></thead><tbody><tr><td><strong>Return on Ad Spend</strong></td><td>Attributed revenue for every 1 EUR of ad spend</td></tr><tr><td><strong>Cost of Sales</strong></td><td>Share of attributed revenue spent on advertising</td></tr><tr><td><strong>Cost per Conversion</strong></td><td>How much one attributed conversion costs</td></tr><tr><td><strong>Cost per Click</strong></td><td>Average cost of one click</td></tr><tr><td><strong>Cost per Visit</strong></td><td>Average cost of one visit to your website</td></tr><tr><td><strong>Cost per Thousand Impressions</strong></td><td>Cost of 1,000 ad impressions</td></tr><tr><td><strong>Return on Marketing Investment</strong>, <strong>Marketing Profit</strong></td><td>Profitability of your marketing (requires margin or profit data)</td></tr></tbody></table>

Without platform costs, these metrics stay empty, and tools that work with spend, such as Budget Optimizer, cannot give you recommendations.

#### 2. Platform-reported data

Connectors also import what each platform reports about itself: **Impressions**, **Clicks**, **Conversions (by platform)**, and **Revenue (by platform)**, together with the campaign, ad group, and ad structure from the platform. You can compare what a platform claims with what Roivenue attributes to it, and analyze performance down to campaign or ad level.

#### 3. Synthetic impressions&#x20;

Platforms such as Meta (Facebook, Instagram), Snapchat, or Pinterest block third-party impression pixels. To still capture their view-through influence, Roivenue collects post-view conversion data from these platforms through the connector and matches it with conversions tracked by Roivenue Measurement. When both report the same conversion, Roivenue adds a **synthetic impression** to that customer journey. Learn more in [Click-based vs. Impression-based Touchpoints](https://docs.roivenue.com/roivenue-resources/roivenue-training/core-concepts/click-based-vs.-impression-based-touchpoints).

{% hint style="info" %}
**How costs meet your web data:** Roivenue pairs platform data with web visits by campaign name, so the campaign name in the platform should match the `utm_campaign` parameter on your website. The result is the **Campaign (auto)** dimension. Google Ads is paired through GCLID, so naming does not matter there. See [Campaign (auto) Dimension](https://docs.roivenue.com/roivenue-resources/roivenue-training/core-concepts/campaign-auto-dimension).
{% endhint %}

***

### What gets imported and when

| Data                  | Examples                                                              | Used for                                                      |
| --------------------- | --------------------------------------------------------------------- | ------------------------------------------------------------- |
| Costs                 | Cost                                                                  | Cost-based metrics, Budget Optimizer                          |
| Platform metrics      | Impressions, Clicks, Conversions (by platform), Revenue (by platform) | Platform performance, comparison with Roivenue attribution    |
| Platform structure    | Ad Campaign, Ad Group, and Ad Name (from platform), Campaign ID       | Reporting by campaign, ad group, or ad; pairing with web data |
| Post-view conversions | Conversions a walled garden reports after an ad view                  | Synthetic impressions                                         |

* Data is downloaded during a nightly run, typically completing between 2 and 8 AM, so yesterday's numbers are ready when you start your day.
* Each connector downloads data from the start date you set, so you can load history as well.
* What exactly a connector downloads is defined by its template of metrics and dimensions. The recommended template covers what Roivenue needs.

***

### Insight connectors and export connectors

Everything in the Implementation section is about **insight connectors**. An insight connector brings advertising platform data into Roivenue, where it is used for attribution, cost-based metrics, and synthetic impressions.

Roivenue also has **export connectors**. You connect the platform the same way, but the data does not enter Roivenue. An export connector only sends the platform data on to a destination you choose, for example Google Sheets. It works as a data hub between your platforms and your reporting tools.

In **Data → Connectors**, both types are listed separately under **Insight Connector** and **Export Connector**. Setting up an export connector has one extra step, **Destination**, where you choose where the data goes.

***

### How to connect your platforms

There are two ways. You can combine them; for example, connect most platforms yourself and share access for one that needs extra setup.

| Comparison                     | Connect platforms yourself (recommended)                                                                                                         | Share access with Roivenue                                                                                             |
| ------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------- |
| **Who sets up the connectors** | You, in the Roivenue interface                                                                                                                   | The Roivenue team                                                                                                      |
| **What you do**                | Log in to each platform and complete a short setup wizard. Your CSM walks you through it on a call.                                              | Add Roivenue to your ad accounts with the required access level and let your CSM know.                                 |
| **Access to your accounts**    | Stays fully with you. No third-party access to manage.                                                                                           | Roivenue keeps read access to your accounts.                                                                           |
| **Troubleshooting**            | Roivenue may need your help to reconnect or check a platform.                                                                                    | Roivenue can diagnose and fix connector issues directly.                                                               |
| **Guide**                      | [Connecting Platforms Yourself](https://docs.roivenue.com/roivenue-resources/implementation/advertising-platforms/connecting-platforms-yourself) | [Sharing Accesses](https://docs.roivenue.com/roivenue-resources/implementation/advertising-platforms/sharing-accesses) |

{% hint style="info" %}
**Not sure which approach to take?** Discuss it with your CSM during the Initial Implementation Call.
{% endhint %}

***

### How to prepare

* List all advertising platforms and ad accounts you want to measure.
* Check that campaign names in your platforms match the `utm_campaign` values on your website.
* 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 first, for example, an API token in Sklik, an allowlisted API call in Árukereső or Compari, or a report URI in Heureka.
* If you use a platform that is not in the list, tell your CSM. Roivenue may have a backend connector for it or another way to bring the data in.

***

### Where you find connectors in Roivenue

* **Data → Connectors** lists all connectors of your account by site. Here you add a new connector and open the settings of existing ones.
* **Account Configuration → Platform Credentials** keeps the logins you used to connect platforms, so you can reuse them for other connectors.
* **Data → Manual Costs** is for costs that no connector covers, such as offline campaigns or agency fees.

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

***

#### FAQ

<details>

<summary>1. Can I use Roivenue without connecting advertising platforms?</summary>

Yes, attribution works from your web data. Without platform data, you see attributed conversions and revenue, but no costs, no cost-based metrics such as Return on Ad Spend, no platform-reported metrics, and no synthetic impressions from walled gardens.

</details>

<details>

<summary>2. Which approach should I choose?</summary>

Connecting platforms yourself is recommended, because you keep full control of your accounts. Sharing access makes sense when you want Roivenue to handle setup and troubleshooting, or when a platform needs a setup that is easier for our team to do. Your CSM helps you decide on the Initial Implementation Call.

</details>

<details>

<summary>3. My platform is not in the list. What now?</summary>

The list covers platforms you can connect directly in the Roivenue interface. It is not a complete list of what Roivenue can connect to. Contact your CSM. There may be a backend connector, or the data can come in another way, for example through Manual Costs.

</details>

<details>

<summary>4. Why do I see costs under "(undefined)" in Campaign (auto)?</summary>

Platform costs were not paired with web data, usually because the campaign name in the platform does not match `utm_campaign` on your website, the campaign was renamed, or the web or platform source is missing. See [Campaign (auto) Dimension](https://docs.roivenue.com/roivenue-resources/roivenue-training/core-concepts/campaign-auto-dimension).

</details>

<details>

<summary>5. Why do platform conversions differ from Roivenue conversions?</summary>

Each platform reports conversions by its own rules and often claims the same conversion as other platforms. Roivenue attributes each conversion only once across the whole customer journey, based on your attribution model. Use **Conversions (by platform)** for comparison, not as the source of truth.

</details>

<details>

<summary>6. When will I see data after connecting a platform?</summary>

A new connector runs during the next nightly run and downloads data from the start date you set. Data is usually ready the next morning.

</details>

<details>

<summary>7. Do I need to connect platforms again if I change my password?</summary>

It depends on the platform. If a login expires or loses access, the connector stops downloading data and needs to be reauthorized. Contact your CSM if you are not sure.

</details>

<details>

<summary>8. Does Roivenue change anything in my ad accounts?</summary>

No. Roivenue only reads data. Some platforms, such as Criteo, require a higher access level to authorize API access, but Roivenue does not make changes to your campaigns.

</details>
