# Integrate Pinterest Ads with Databox Pinterest Ads is a visual advertising platform that enables businesses to reach high-intent audiences who are actively searching for ideas, products, and inspiration. Unlike traditional social networks, Pinterest users engage with content specifically because they are planning purchases or projects, making it a strong channel for discovery-led campaigns. Connecting Pinterest Ads to Databox lets you monitor campaign performance, track spend efficiency, and build dashboards that surface ad analytics and report data alongside your other paid channels — all in one place. ## Connection ### Before you begin ### Step 1: Confirm your business account and connect If you've already established a connection, you can [reuse](/add-a-data-source) it to add new accounts, as long as those accounts are accessible with the existing connection's credentials. 1. In the Databox connect modal, check the **I confirm I'm using a business account** checkbox. Before connecting, make sure you are logged in to Pinterest as your Business account. If you are already logged in with your personal account, navigate to the Pinterest homepage and switch to your Business account first. 2. Click **Connect**. pinterest-ads-connect-modal A Pinterest Business account is required to connect. If you have not yet converted your personal Pinterest account to a business account, you can do so at [pinterest.com/business/convert](https://www.pinterest.com/business/convert/). ### Step 2: Log in to Pinterest Sign in with your Pinterest email and password, or choose **Continue with Google** or **Use QR code**. pinterest-ads-oauth-login ### Step 3: Select the ad account Choose the Pinterest Ads account you want to report on. If you manage multiple ad accounts, you will be prompted to select the specific account you want to connect to Databox. ### Step 4: Select the conversion window Select the conversion window — the number of days after a click or engagement view in which a conversion is counted. This setting must match your Pinterest Ads account configuration so that data in Databox aligns with what you see in Pinterest. You can verify the current conversion window in Pinterest under **Account Overview** > **Conversion settings**. ## Metric Builder The Pinterest Ads integration allows you to create custom metrics using the metric builder, ideal for visualizing data not included in the basic metrics offered by the integration. metric-builder To create a custom metric, start by selecting a metric from the **Metric** selector. Next, customize your metric by optionally adding a dimension and applying one or more filters. The available options depend on the selected entity and data type (e.g., number, text, etc.). The Pinterest Ads metric builder offers two modes: **Ad Analytics** and **Report**. Each mode gives access to a different set of entities and metrics. ### Ad Analytics Ad Analytics provides pin-level performance data for individual ads. Use this mode to track metrics such as engagement rate, spend, impressions, 3-second video views, and other ad-level signals. After selecting a metric, you can set the **Conversion Report Time** to anchor your data on either the time of the ad action or the time of conversion. **In Pinterest Ads:** Go to the [Ads Manager](https://ads.pinterest.com/) and select the **Ads** tab. ### Report Report mode provides aggregated data broken down by the entity type you select from the **Type** dropdown. The available types are **Ad Account**, **Ad Groups**, and **Campaigns**. After selecting a type and metric, you can optionally add a dimension, apply filters (such as campaign status or objective type), and set the **Conversion Report Time**. #### Ad Account Provides aggregated metrics for the entire ad account. Use this type to get a top-level view of total spend, impressions, and conversions across all campaigns and ad groups running in the account. **In Pinterest Ads:** Go to the [Ads Manager](https://ads.pinterest.com/) and select the **Overview** tab. #### Ad Groups Provides metrics at the ad group level, allowing you to analyze performance and compare targeting strategies across different ad groups within your campaigns. **In Pinterest Ads:** Go to the [Ads Manager](https://ads.pinterest.com/) and select the **Ad groups** tab. #### Campaigns Provides metrics at the campaign level, making it easy to track spend, ROAS, and performance for each individual campaign and compare results across your marketing objectives. **In Pinterest Ads:** Go to the [Ads Manager](https://ads.pinterest.com/) and select the **Campaigns** tab. ## ![lock](/assets/lock.2fb1bbc208afcc03d15a0a45f22bdf7f830322016e038e5721965851130807af.419bb737.svg) Datasets The Pinterest Ads integration supports the creation of [datasets](/understanding-datasets), which allow you to structure and format your Pinterest Ads data for more flexible reporting in Databox. By organizing your data into a tabular format, datasets make it easier to filter, segment, and visualize key metrics across projects, clients, and team members. The entity relationship diagram (ERD) below illustrates how data is organized within the Pinterest Ads integration, displaying the available **views** and **columns**, as well as the relationships between them (primary and foreign keys). This diagram represents the **schema**, or structure, of the data and helps you understand the underlying data model. With this context, you can create datasets using the relevant views and columns to build custom metrics tailored to your reporting needs. ## Resources For comprehensive details on metrics, data availability, templates, specifications, usage guidelines, and other key information, refer to the resources listed below. The Conversion Report Time option determines how conversion data is attributed in your custom metric. Choosing **Time of Ad Action** counts conversions based on when the user interacted with your ad, while **Time of Conversion** counts them based on when the conversion event actually occurred. This setting is available in both Ad Analytics and Report modes. Learn more in the [Pinterest Help Center](https://help.pinterest.com/en/business/article/report-offline-conversion-events). Ad Analytics provides pin-level performance data pulled directly from individual ad records, without dimension segmentation. Report mode lets you select a type (Ad Account, Ad Groups, or Campaigns) and optionally apply dimensions and filters, making it better suited for segmented or aggregated views of your performance data. The Pinterest Ads API only grants access to advertising data for business accounts. Personal accounts do not have access to Ads Manager or the underlying API endpoints that Databox uses to sync campaign data. You can convert your personal account to a business account for free at [pinterest.com/business/convert](https://www.pinterest.com/business/convert/).   Ask Genie Get instant answers or help with your data using the in-app AI assistant. Talk to an expert For customers: Get help with your setup, strategy, or making the most of Databox. Book a demo New to Databox? See how it works and get guidance on getting started. Send an email Reach out to support for help with your account, data, or technical issues.