> 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/roivenue-training/roivenue-app/data/connectors-overview/list-of-connectors/amazon-ads.md).

# Amazon Ads

How to connect Amazon Ads to Roivenue, what the default setup downloads, and how the figures are put together.

Amazon Ads Sponsored Products. The Roivenue connector downloads daily impressions, clicks and cost per campaign, plus the purchases Amazon attributes to them.

## Setting up the connector

Add a Amazon Ads connector in Roivenue and choose Connect to Amazon Ads. Roivenue sends you to Amazon Ads to sign in and approve access. There are no keys to copy.

### Setup options

| Option                    | Default            | What it does                                      |
| ------------------------- | ------------------ | ------------------------------------------------- |
| Conversion type name      | `purchase`         | What Amazon purchases are called inside Roivenue. |
| UTM Source and UTM Medium | `amazon` and `cpc` | How Amazon traffic should be recognised.          |

## What the default setup downloads

Three jobs. One brings impressions, clicks and cost per campaign and day, a second brings purchases and sales, and a third downloads the feed behind synthetic impressions.

### Where the values land

| Amazon Ads field            | Roivenue column                 |
| --------------------------- | ------------------------------- |
| `campaignName`              | adCampaign                      |
| `impressions`               | impressions                     |
| `clicks`                    | clicks                          |
| `cost`                      | cost                            |
| `purchases1d` and `sales1d` | conversions and conversionValue |

{% hint style="info" %}
Amazon conversions use a one day attribution window. A purchase more than 24 hours after the click is not counted, so these figures are conservative next to platforms using a 28 day window.
{% endhint %}

The connector covers Sponsored Products campaigns grouped at campaign level, so there is no ad group or keyword breakdown. Sponsored Brands and Sponsored Display are not included.

Display campaigns bought through Amazon DSP are a separate connector.

The jobs reprocess the last three days on every run.

## Available columns

The table above is what the recommended template downloads. Every column this connector can bring back is listed on [Amazon Ads - Supported Columns](/roivenue-resources/roivenue-training/roivenue-app/data/connectors-overview/list-of-connectors/amazon-ads/amazon-ads-supported-columns.md).

Adding one means editing the connector in the Advanced Editor, which stops that connector receiving template updates.

## Synthetic impressions

Alongside the daily figures, this connector downloads a conversion feed that Roivenue uses to build synthetic impressions.

Ad platforms report conversions that Roivenue never saw as a web session, because of ad blockers, cross-device journeys or conversions uploaded from a CRM. Left alone those orders look like they came from nowhere, and paid media gets undercounted. The synthetic impression stands in for the missing visit so path analysis and attribution see a complete journey.

There is nothing to configure. It comes with the connector, and it is why the setup creates more than one job.

## How far back the data goes

The connector will request up to three years of history. How much arrives depends on what the platform holds for the account.

## Troubleshooting

<details>

<summary>Sponsored Brands or Sponsored Display spend is missing</summary>

The connector reads Sponsored Products only. Other Amazon ad products are not included in this template.

</details>

<details>

<summary>Conversions are lower than Amazon reports</summary>

Amazon's own interface often defaults to a longer attribution window. The connector requests the one day window, so later purchases are excluded.

</details>