Menu | Description | ||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Report | Select the Snapchat Ads OAuth report you want to run. The following reports are available:
| ||||||||||||||||||||||||||||||||||||||||
Organization Selection Criteria | Select the way you want to retrieve organizations. | ||||||||||||||||||||||||||||||||||||||||
Organization | Select the organization you want to retrieve data for. | ||||||||||||||||||||||||||||||||||||||||
Ad Account | Select the ad account you want to retrieve data for. | ||||||||||||||||||||||||||||||||||||||||
Ad Account Selection Criteria | Select whether you want to retrieve ad data from a selected ad account or all ad accounts. | ||||||||||||||||||||||||||||||||||||||||
| Select Ads By | Select the type of object that owns the Ads to return. | ||||||||||||||||||||||||||||||||||||||||
Select Ad Squads By | Select the type of object that owns the Ad Squads to return. | ||||||||||||||||||||||||||||||||||||||||
| Campaign Selection Criteria | Select whether you want to retrieve selected campaigns or all campaigns. | ||||||||||||||||||||||||||||||||||||||||
Campaign | Select the campaign you want to retrieve data for. | ||||||||||||||||||||||||||||||||||||||||
| Ad Squad Selection Criteria | Select whether you want to retrieve data for all Ad Squads or selected Ad Squads. | ||||||||||||||||||||||||||||||||||||||||
Ad Squad | Select the ad squad you want to retrieve data for. | ||||||||||||||||||||||||||||||||||||||||
| Ad Selection Criteria | Select whether you want to retrieve data for all Ads or selected Ads. | ||||||||||||||||||||||||||||||||||||||||
Ad | Select the ad you want to retrieve data for. | ||||||||||||||||||||||||||||||||||||||||
Breakdown | Select whether you want to break down results by ad, ad squad, or campaign. | ||||||||||||||||||||||||||||||||||||||||
Granularity | Select how data will be aggregated in your report. | ||||||||||||||||||||||||||||||||||||||||
Dimension | Select how your data will be grouped in your report. | ||||||||||||||||||||||||||||||||||||||||
Pivot | Select how your data will be pivoted in your report. | ||||||||||||||||||||||||||||||||||||||||
Fields | Select the fields (columns) you want to include in your report: | ||||||||||||||||||||||||||||||||||||||||
| Conversion Source Types | App, Offline, Total, or Web | ||||||||||||||||||||||||||||||||||||||||
Swipe Up Attribution Window | Select a Swipe Up Attribution Window of 1, 7, or 28 days. | ||||||||||||||||||||||||||||||||||||||||
View Attribution Window | Select the desired View Attribution Window. Note that this value must be smaller than the Swipe Up Attribution Window . | ||||||||||||||||||||||||||||||||||||||||
Duration | Select whether you want to pull data for a specific date or a date range. | ||||||||||||||||||||||||||||||||||||||||
Report Date | Select whether the report data is for a specific date or for a relative number of days back from today. | ||||||||||||||||||||||||||||||||||||||||
Select Specific Date | Select the date for the report. | ||||||||||||||||||||||||||||||||||||||||
Days Back | Enter the number of past days that should appear in the report. | ||||||||||||||||||||||||||||||||||||||||
Start Date | Specify whether the first date in your date range is a specific or relative date. You select the last date in your range in End Date . | ||||||||||||||||||||||||||||||||||||||||
End Date | Specify whether the second date in your date range is a specific or relative date. You select the first date in your range in Start Date . | ||||||||||||||||||||||||||||||||||||||||
Select Specific Start Date | Select the first date in your date range. | ||||||||||||||||||||||||||||||||||||||||
Select Specific End Date | Select the second date in your date range. | ||||||||||||||||||||||||||||||||||||||||
Days Back to Start From | Enter the number of the farthest day back that should be represented in the report. Combine with Days Back to End At to create a range of represented days. For example, if you entered 10 for Days Back to Start From and 5 for Days Back to End At , the report would contain data for 10 days ago up until 5 days ago. | ||||||||||||||||||||||||||||||||||||||||
Days Back to End At | Enter the number of the most recent day back that should be represented in the report. Combine with Days Back to Start From to create a range of represented days. For example, if you entered 10 for Days Back to Start From and 5 for Days Back to End At , the report would contain data for 10 days ago up until 5 days ago. |
| Report Name | Endpoint URL(s) |
|---|---|
| Object Info: Organizations | /me/organizations |
| Object Info: Ad Accounts | /organizations/{organization-id}/adaccounts |
| Object Info: Campaigns | /adaccounts/{ad_account_id}/campaigns |
| Object Info: All Campaigns | /adaccounts/{ad_account_id}/campaigns |
| Object Info: Ad Squads | adSquadsBy/{campaignId}/adsquads |
| /adSquadsBy/{adSquadId}/adsquads | |
| Object Info: All Ad Squads | /adSquadsBy/{campaignId}/adsquads |
| /adSquadsBy/{adAccountId}/adsquads | |
| Object Info: Ads | /AdsVia/{ad_squad_id}/ads |
| /AdsVia/{Id}/ads | |
| Object Info: All Ads | /AdsVia/{ad_squad_id}/ads |
| /AdsVia/{adAccountId}/ads | |
| Statistics: Campaign (deprecated) | /campaigns/{campaign-id}/stats |
| Statistics: Campaign (Insights and Dimensions) | /campaigns/{campaignId}/stats |
| Statistics: All Campaign (Insights and Dimensions) | /campaigns/{adAccIdAndTimeZone}/stats |
| Statistics: Ad Squad (deprecated) | /adsquads/{adsquad-id}/stats |
| Statistics: Ad Squad (Insights and Dimensions) | /adsquads/{adSquadId}/stats |
| Statistics: All Ad Squads (Insights and Dimensions) | /adsquads/{adAccIdAndTimeZone}/stats |
| Statistics: Ad (deprecated) | /ads/{ad-id}/stats |
| Statistics: Ad (Insights and Dimensions) | /ads/{adId}/stats |
| Statistics: All Ads (Insights and Dimensions) | /ads/{adAccIdAndTimeZone}/stats |
| Campaign Statistics Merge | /getAndWriteCampaignStatsData |
| Ad Squads Statistics Merge | /getAndWriteAdSquadsStatsData |
| Ads Statistics Merge | /getAndWriteAdsStatsData |