# Guide: Using Snapchat Ads with Databox

## How to connect Snapchat Ads to Databox

![](/assets/guide-using-snapchat-ads-with-databox_1.853190bdd662599ba7839694b78f037cf4ae9efece8cbcc597ce10e02682f562.4783b0ec.gif)

To connect a Snapchat Ads Account in Databox, go to **Data Manager > + New connection.** Type**Snapchat Ads** in the search bar and click on the green **Connect**button. Next, click the green **Connect now** button.

This will open the **Authorization** window, which is where you will be prompted to enter your Snapchat Ads login credentials and select a Snapchat Ads organization account that you want to connect to Databox.

Each Snapchat Ads Account must be connected as a separate Data Source in Databox (1 Account = 1 Data Source). Learn more [here](/add-a-connection)

## What Snapchat Ads permissions do you need to connect to Databox?

To connect a Snapchat Ads account in Databox, it is recommended that you have Organization Admin or Member permissions in your organization account.

Learn more about Snapchat Ads roles and permissions [here](https://businesshelp.snapchat.com/s/article/roles-permissions).

## What's the maximum amount of historical data initially available when you use a new Snapchat Ads Data Source Metric in Databox?

Data is synced for the Metrics that are being used in your Account, so when you first use a new Snapchat Ads Metric, the maximum amount of historical data available is 36 months.

Certain Metrics may have more or less historical data available. For more information about the amount of historical data available for a specific Metric learn more [here](/guide-using-snapchat-ads-with-databox) or contact our Support Team via live chat or at [help@databox.com](mailto:help@databox.com).

In order to start syncing data for a Metric, you can add it to your Metrics screen, use it in a Scorecard, set a Goal around it, create an Alert for it, or add it to a Databoard. Learn more [here](/data-sync-storage-security-in-databox).
The amount of historical data you're able to access in Databox is dependent on your Databox plan. Learn more [here](/choose-a-subscription-plan).

## What time zone does Snapchat Ads data sync in?

Snapchat Ads data is synced in the time zone set in the Snapchat Ads Account. For example, if your Snapchat Ads Account time zone is set as EST, your Snapchat Ads data will sync with Databox in EST.

## How often does Snapchat Ads data sync?

All Snapchat Ads Data Sources will sync every hour with Databox. Learn more [here](/data-sync-storage-security-in-databox).

## How to build a Databoard

![](/assets/guide-using-snapchat-ads-with-databox_2.ad07eb53c54ac19e2ee7804a42aa2a117738c0275b9e66c3965a628b9293551a.4783b0ec.gif)

1. Navigate to  **Databoards** > **+ New Databoard** > **Start Blank**
2. Click on the **Metric Library** icon on the lefthand side of the Designer.
3. Select the appropriate Snapchat Ads Account from the **Data Source** drop-down list in the **Metric Library**
4. View the list of pre-built Snapchat Ads Datablocks in the **Metric Library**. Drag and drop your selected Datablock onto your Databoard
5. If a pre-built Datablock isn't available for your use case, click on the  **Visualization Types** icon under the **Metric Library**icon.
6. View the list of Visualizations available in Databox. Drag and drop your selected Visualization onto your Databoard
7. Click on the Datablock on the Databoard to open the corresponding **Datablock Editor**on the righthand side of the Designer.
8. In the  **Metrics** drop-down, click  **Data Source** to select the appropriate Data Source. This will filter out metrics from the specific Data Source.
9. In the main  **Metrics** drop-down, select the metric you'd like to display on the Datablock, using the Search bar if needed. This will update the Datablock and it will populate with the corresponding data.
10. Complete steps 4-9 until your Databoard is complete.


View a full list of Snapchat Ads Metrics available in Databox [here.](https://app.databox.com/metrics/library/SnapchatAds)

## How to use the Metric Builder for Snapchat Ads

With the Metric Builder for Snapchat Ads you can create Custom Snapchat Ads Metrics using a combination of Metrics, Dimensions, and Filters. Some popular use cases for the Metric Builder for Snapchat Ads include tracking Campaign, Ad Set and Ads performance data, like Total Impressions, Paid Reach, Cost per Lead, etc.

Learn more about the Metric Builder for Snapchat Ads [here](/master-overview-metric-builders-for-snapchat-ads).

## Metric Considerations

- Reach (''Total Reach,'' ''Paid Reach'') and Frequency (''Total Frequency,'', ''Paid Frequency'') metrics have only 92 days of historical data available when first used in Databox.


## Granularity Restrictions

- Yearly granularity is not supported. This may affect visualization options for Charts in Databox.
For example, if a Snapchat Ads Metric is used on a Line or Bar Chart with ''All Time'' Date Range and ''Yearly'' Granularity selected, the data won't be displayed on the Chart.
However, the big number above the Chart will accurately reflect the Metric value for the selected Date Range.
Learn more about Granularity [here](/overview-advanced-settings).
- Reach (''Total Reach,'' ''Paid Reach'') and Frequency (''Total Frequency,'', ''Paid Frequency'') metrics support only Daily granularity. If any other granularity (e.g. Monthly) is selected for these metrics, the visualization options for Charts may be affected
- For example, if a Snapchat Ads Metric is used on a Line or Bar Chart with ''Last Year" as the Date Range and ''Monthly'' as the Granularity selected, the data won't be displayed on the Chart.
However, the big number above the Chart will accurately reflect the Metric value for the selected Date Range.


Learn more about Granularity [here](/overview-advanced-settings)