# Pinterest Ads

Pinterest Ads is Pinterest's advertising platform that helps you promote pins, products, and drive traffic to your website. With Coupler.io, you can automatically export your Pinterest Ads performance data—campaigns, ad groups, promoted pins, keywords, and more—to Google Sheets, Excel, BigQuery, Looker Studio, or AI destinations like Claude and ChatGPT.

## Why connect Pinterest Ads to Coupler.io?

* **Automate reporting** — Pull campaign performance, conversions, and spend data on a schedule without manual exports
* **Multi-account management** — Combine data from multiple ad accounts in one place for unified analysis
* **Flexible granularity** — Choose report types ranging from account-level summaries to individual promoted pin performance
* **Conversion attribution** — Customize conversion windows and attribution models (click, engagement, view) to match your business
* **Real-time analysis** — Feed data into BI tools like Looker Studio or send insights directly to AI models for pattern detection

## Prerequisites

* A Pinterest Business or Ads Manager account with at least one active ad account
* Access to grant Coupler.io permission to read your ad account data via OAuth
* Destination account (Google Sheets, Excel, BigQuery, Looker Studio, or an AI destination)

## Quick start

{% hint style="success" %}
Start with a **Campaign performance** report for your primary ad account, split by **Daily** to track spend and conversions over time. Once you've validated the data, expand to other report types like ad groups or keywords.
{% endhint %}

## How to connect

{% stepper %}
{% step %}
**Click "Add source"** and select **Pinterest Ads**.
{% endstep %}

{% step %}
**Authorize your Pinterest account.** You'll be redirected to Pinterest's login. Sign in and approve Coupler.io's access to read your ad account data.
{% endstep %}

{% step %}
**Select a report type.** Choose from performance reports (campaign, ad group, promoted pin, account, product group, keywords, etc.) or list reports (accounts, campaigns, ad groups, ads, keywords). Performance reports include metrics like spend, impressions, clicks, and conversions. List reports show your account structure without metrics.
{% endstep %}

{% step %}
**If you selected a performance report:** Choose your **ad accounts** (if you have multiple), then set a **start date** and **end date** for the reporting period. You can use date macros like `{{today}}` or `{{30daysago}}` for dynamic ranges.
{% endstep %}

{% step %}
**Select metrics.** Pinterest offers hundreds of metrics across conversion types (checkout, add to cart, signup, etc.), attribution models (web, in-app, offline), and engagement types (clicks, impressions, video plays, etc.). Pick the ones most relevant to your business.
{% endstep %}

{% step %}
**Configure conversion settings.** Choose whether conversions are reported by **time of ad action** (default) or **time of conversion**, and select a **conversion window** (how many days after a click, engagement, or view counts as a conversion). Default is 30/1/1 (30 days post-click, 1 day post-engagement, 1 day post-view).
{% endstep %}

{% step %}
**For targeting analysis reports only:** Select a **dimension** (age bucket, gender, location, device, placement, keyword, interest, etc.) to break down your metrics by audience or placement characteristics.
{% endstep %}

{% step %}
**Choose your destination.** Select where you want the data: Google Sheets, Excel, BigQuery, Looker Studio, or send to an AI destination (Claude, ChatGPT, Cursor, Gemini, Perplexity, OpenClaw) for automated analysis.
{% endstep %}

{% step %}
**Run the data flow manually** to verify the data looks correct before scheduling. Once you've confirmed the output, you can set up a schedule in the data flow settings.
{% endstep %}
{% endstepper %}

## Report types overview

| Report Type                   | Best For                         | Includes                                                             |
| ----------------------------- | -------------------------------- | -------------------------------------------------------------------- |
| Campaign performance          | High-level campaign metrics      | Campaign name, spend, impressions, clicks, conversions               |
| Ad group performance          | Ad group-level analysis          | Ad group, campaign, spend, CTR, conversions by type                  |
| Ad (promoted pin) performance | Individual pin performance       | Pin ID, creative, spend, engagement, saves, outbound clicks          |
| Ad account performance        | Account-level KPIs               | Total spend, impressions, reach, conversions across all campaigns    |
| Product group performance     | Product-level metrics (shopping) | Product group, order value, ROAS, quantity sold                      |
| Keywords performance          | Keyword bidding & ROI            | Keyword, search volume, CPC, conversions                             |
| Targeting analysis            | Audience insights by dimension   | Metrics segmented by age, location, device, placement, interest      |
| List reports                  | Account structure                | All campaigns, ad groups, ads, keywords in your account (no metrics) |