> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Snapchat Ads Connector

## Intro

Snapchat Ads represents a new direction in social media, with its users, particularly millennials, craving a more in-the-moment way of sharing and communicating via technology. Use Domo's Snapchat Ads connector to receive details about organization, ads, campaigns and much more. To learn more about the Snapchat Ads API, visit their page ([https://developers.snapchat.com/api/docs](https://developers.snapchat.com/api/docs "https://developers.snapchat.com/api/docs") ).

You can connect to your Snapchat Ads account in the Data Center. This topic discusses the fields and menus that are specific to the Snapchat Ads connector user interface. To add DataSets, set update schedules, and edit DataSet information, see [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

## Prerequisites

To connect to your Snapchat Ads account and create a DataSet, you must have the following:

* Client ID
* Client Secret
* The Username and Password associated with your Snapchat Ads account.

## Connecting to Your Snapchat Ads Account

Snapchat Marketing API uses OAuth 2.0 authentication to control access and authenticate requests.

This section enumerates the options in the **Credentials** and **Details** panes in the Snapchat Ads Connector page. The components of the other panes in this page, **Scheduling** and **Name & Describe Your DataSet**, are universal across most connector types and are discussed in great detail in [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").

## Credentials Pane

This pane contains fields for entering credentials to connect to your Snapchat Ads account. The following table describes what is needed for each field:

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p><span class="s1"> Field </span></p></th><th colspan="1" rowspan="1"><p><span class="s1"> Description </span></p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Client ID </p></td><td colspan="1" rowspan="1"><p> Enter the Client ID created for your App. </p></td></tr><tr><td colspan="1" rowspan="1"><p> Client Secret </p></td><td colspan="1" rowspan="1"><p> Enter the Client Secret for your App. </p></td></tr></tbody></table>

Once you have entered valid Snapchat Ads credentials, you can use the same account at any time to create a new Snapchat Ads DataSet. You can manage connector accounts in the **Accounts** tab in the Data Center. For more information about this tab, see [Manage Connector Accounts](https://domo-support.domo.com/s/article/360042926054?language=en_US "Manage Connector Accounts").

## Details Pane

This pane contains a primary **Reports** menu, along with various other menus which may or may not appear depending on the report type you select.

<table border="1" cellpadding="1" cellspacing="1" data-aura-rendered-by="33:195;a"><thead><tr><th colspan="1" rowspan="1"><p> Menu </p></th><th colspan="1" rowspan="1"><p> Description </p></th></tr></thead><tbody><tr><td colspan="1" rowspan="1"><p> Report </p></td><td colspan="1" rowspan="1"><p> Select the Snapchat Ads report you want to run. The following reports are available: </p><p /><table border="1"><tbody><tr><td colspan="1" rowspan="1"><b> Report Name </b></td><td colspan="1" rowspan="1"><b> Description </b></td></tr><tr><td colspan="1" rowspan="1"> Object Info: Organizations </td><td colspan="1" rowspan="1"> Returns all the organizations the logged in user can access. </td></tr><tr><td colspan="1" rowspan="1"> Object Info: Ad Accounts </td><td colspan="1" rowspan="1"> This report returns all ad accounts for the specified Organization. </td></tr><tr><td colspan="1" rowspan="1"> Object Info: Campaigns </td><td colspan="1" rowspan="1"> This report returns all campaigns within a specified ad account. </td></tr><tr><td colspan="1" rowspan="1"> Object Info: All Campaigns </td><td colspan="1" rowspan="1"> This report returns all campaigns within the specified ad accounts. Supports multiple ad accounts. </td></tr><tr><td colspan="1" rowspan="1"> Object Info: Ad Squads </td><td colspan="1" rowspan="1"> This report returns all ad squads within a specified campaign or ad account. </td></tr><tr><td colspan="1" rowspan="1"> Object Info: All Ad Squads </td><td colspan="1" rowspan="1"> This report returns all ad squads within a specified campaign or ad account. Supports multiple ad accounts. </td></tr><tr><td colspan="1" rowspan="1"> Object Info: Ads </td><td colspan="1" rowspan="1"> This report returns all ads within a specified ad squad or ad account. </td></tr><tr><td colspan="1" rowspan="1"> Object Info: All Ads </td><td colspan="1" rowspan="1"> This report returns all ads within a specified ad squad or ad account. Supports multiple ad accounts. </td></tr><tr><td colspan="1" rowspan="1"> Statistics: Campaign (deprecated) </td><td colspan="1" rowspan="1"> This report returns statistics for the specified Campaign, or for all Ads or Ad Squads owned by that Campaign. </td></tr><tr><td colspan="1" rowspan="1"> Statistics: Campaign (Insights and Dimensions) </td><td colspan="1" rowspan="1"> This report returns statistics for the specified Campaign, or for all Ads or Ad Squads owned by that Campaign using the updated Insights and Dimensions query. </td></tr><tr><td colspan="1" rowspan="1"> Statistics: All Campaigns (Insights and Dimensions) </td><td colspan="1" rowspan="1"> This report returns statistics for the specified Campaign, or for all Ads or Ad Squads owned by that Campaign using the updated Insights and Dimensions query. Supports multiple ad accounts. </td></tr><tr><td colspan="1" rowspan="1"> Statistics: Ad Squad (deprecated) </td><td colspan="1" rowspan="1"> This report returns statistics for a single, specified Ad Squad. </td></tr><tr><td colspan="1" rowspan="1"> Statistics: Ad Squad (Insights and Dimensions) </td><td colspan="1" rowspan="1"> This report returns statistics for a single, specified Ad Squad using the updated Insights and Dimensions query. </td></tr><tr><td colspan="1" rowspan="1"> Statistics: All Ad Squads (Insights and Dimensions) </td><td colspan="1" rowspan="1"> This report returns statistics for specified Ad Squad using the updated Insights and Dimensions query. Supports multiple ad accounts. </td></tr><tr><td colspan="1" rowspan="1"> Statistics: Ad (deprecated) </td><td colspan="1" rowspan="1"> This report returns statistics for a single, specified Ad. </td></tr><tr><td colspan="1" rowspan="1"> Statistics: Ad (Insights and Dimensions) </td><td colspan="1" rowspan="1"> This report returns statistics for a single, specified Ad using the updated Insights and Dimensions query. </td></tr><tr><td colspan="1" rowspan="1"> Statistics: All Ads (Insights and Dimensions) </td><td colspan="1" rowspan="1"> This report returns statistics for specified Ad using the updated Insights and Dimensions query. Supports multiple ad accounts. </td></tr><tr><td colspan="1" rowspan="1"> Campaign Statistics Merge </td><td colspan="1" rowspan="1"> This report returns statistics for the requested campaigns as it is merged with organization and campaigns report. </td></tr><tr><td colspan="1" rowspan="1"> Ad Squads Statistics Merge </td><td colspan="1" rowspan="1"> This report returns statistics for the requested ad squads as it is merged with organization, ad account and ad squads report. </td></tr><tr><td colspan="1" rowspan="1"> Ads Statistics Merge </td><td colspan="1" rowspan="1"> This report returns statistics for the requested ads as it is merged with organization, ad account, ad squads and ads report. </td></tr></tbody></table></td></tr><tr><td colspan="1" rowspan="1"><p> Organization Selection Criteria </p></td><td colspan="1" rowspan="1"><p> Select the way you want to retrieve organizations. </p></td></tr><tr><td colspan="1" rowspan="1"> Organization </td><td colspan="1" rowspan="1"> Select the Organization to report. </td></tr><tr><td colspan="1" rowspan="1"> Ad Account </td><td colspan="1" rowspan="1"> Select the Ad Account to report. </td></tr><tr><td colspan="1" rowspan="1"> Ad Account Selection Criteria </td><td colspan="1" rowspan="1"> Select the way you want to retrieve ad accounts. </td></tr><tr><td colspan="1" rowspan="1"> Select Ad Squads By </td><td colspan="1" rowspan="1"> Select the type of object that owns the Ad Squads to return. </td></tr><tr><td colspan="1" rowspan="1"> Campaign Selection Criteria </td><td colspan="1" rowspan="1"> Select the way you want to retrieve campaigns. </td></tr><tr><td colspan="1" rowspan="1"> Campaign </td><td colspan="1" rowspan="1"> Select the Campaigns to report. </td></tr><tr><td colspan="1" rowspan="1"> Select Ads By </td><td colspan="1" rowspan="1"> Select the type of object that owns the Ads to return. </td></tr><tr><td colspan="1" rowspan="1"> Ad Squad Selection Criteria </td><td colspan="1" rowspan="1"> Select the way you want to retrieve Ad Squads. </td></tr><tr><td colspan="1" rowspan="1"> Ad Squad </td><td colspan="1" rowspan="1"> Select the Ad Squads to report on. </td></tr><tr><td colspan="1" rowspan="1"> Breakdown </td><td colspan="1" rowspan="1"> Select how data will be broken down in the results. </td></tr><tr><td colspan="1" rowspan="1"> Granularity </td><td colspan="1" rowspan="1"> Select how data will be aggregated in the results. </td></tr><tr><td colspan="1" rowspan="1"> Dimension </td><td colspan="1" rowspan="1"> Select how data will be grouped in the results. </td></tr><tr><td colspan="1" rowspan="1"> Pivot </td><td colspan="1" rowspan="1"> Select how data will be pivoted in the results. </td></tr><tr><td colspan="1" rowspan="1"> Fields </td><td colspan="1" rowspan="1"> Select the fields to include in the results <br /><b> Note: </b> Not all fields are available for all Granularity values. </td></tr><tr><td colspan="1" rowspan="1"> Swipe Up Attribution Window </td><td colspan="1" rowspan="1"> Select the Swipe Up attribution window for the results </td></tr><tr><td colspan="1" rowspan="1"> View Attribution Window </td><td colspan="1" rowspan="1"> Select the View Attribution window for the results <br /> Note that this must be equal to or smaller than the Swipe Up attribution window. </td></tr><tr><td colspan="1" rowspan="1"> Duration </td><td colspan="1" rowspan="1"> Select the duration for the report (a Single Date, or a Date Range) </td></tr><tr><td colspan="1" rowspan="1"> Report Date </td><td colspan="1" rowspan="1"> Select report date using relative or specific dates. Relative meaning number of days from today or a specific date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Select Specific Date </td><td colspan="1" rowspan="1"> Select the report date using the date selector.. </td></tr><tr><td colspan="1" rowspan="1"> Days Back </td><td colspan="1" rowspan="1"> The number of days back that you would like to get data. </td></tr><tr><td colspan="1" rowspan="1"> Start Date </td><td colspan="1" rowspan="1"> Select report start date using relative or specific dates. Relative meaning number of days from today or a specific date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Select Specific Start Date </td><td colspan="1" rowspan="1"> Select the report date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Days Back to Start From </td><td colspan="1" rowspan="1"> The number of days back that you would like to get data from (start day). Specify either today or 0, yesterday or 1, or today-7 or 7 to get data for 7 days into the past. </td></tr><tr><td colspan="1" rowspan="1"> End Date </td><td colspan="1" rowspan="1"> Select report end date using relative or specific dates. Relative meaning number of days from today or a specific date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Select Specific End Date </td><td colspan="1" rowspan="1"> Select the report date using the date selector. </td></tr><tr><td colspan="1" rowspan="1"> Days Back To End At </td><td colspan="1" rowspan="1"> The number of days back that you would like to get data to (end day). Specify either today or 0, yesterday or 1, or today-7 or 7 to get data for 7 days into the past. </td></tr><tr><td colspan="1" rowspan="1"> Ad Selection Criteria </td><td colspan="1" rowspan="1"> Select the way you want to retrieve Ads. </td></tr><tr><td colspan="1" rowspan="1"> Ad </td><td colspan="1" rowspan="1" /></tr></tbody></table>

## Other Panes

For information about the remaining sections of the connector interface, including how to configure scheduling, retry, and update options, see [Adding a DataSet Using a Connector](https://domo-support.domo.com/s/article/360042926274?language=en_US "Adding a DataSet Using a Connector").
