Snapchat Ads API Configuration
Request
POST https://api.fivetran.com/v1/connections
{
"group_id": "group_id",
"service": "snapchat_ads",
"trust_certificates": true,
"trust_fingerprints": true,
"run_setup_tests": true,
"paused": false,
"pause_after_trial": false,
"sync_frequency": 1440,
"data_delay_sensitivity": "NORMAL",
"data_delay_threshold": 0,
"daily_sync_time": "14:00",
"schedule_type": "auto",
"connect_card_config": {
"redirect_uri": "https://your.site/path",
"hide_setup_guide": true
},
"proxy_agent_id": "proxy_agent_id",
"private_link_id": "private_link_id",
"networking_method": "Directly",
"hybrid_deployment_agent_id": "hybrid_deployment_agent_id",
"config": {
"sync_mode": "AllOrganizations | SpecificOrganizations",
"view_attribution_window": "NONE | HOUR_1 | HOUR_3 | HOUR_6 | DAY_1 | DAY_7 | DAY_28",
"swipe_attribution_window": "NONE | HOUR_1 | HOUR_3 | HOUR_6 | DAY_1 | DAY_7 | DAY_28",
"timeframe_months": "THREE | SIX | TWELVE | TWENTY_FOUR | ALL_TIME",
"organizations": [
"string"
],
"custom_reports": [
{
"sk_ad_metrics_fields": [
"conversion_total_installs_sk_ad_network | conversion_ios_installs_sk_ad_network | conversion_purchases_sk_ad_network | conversion_save_sk_ad_network | conversion_start_checkout_sk_ad_network | conversion_add_cart_sk_ad_network | conversion_view_content_sk_ad_network | conversion_add_billing_sk_ad_network | conversion_sign_ups_sk_ad_network | conversion_searches_sk_ad_network | conversion_level_completes_sk_ad_network | conversion_app_opens_sk_ad_network | conversion_page_views_sk_ad_network | conversion_subscribe_sk_ad_network | conversion_ad_click_sk_ad_network | conversion_ad_view_sk_ad_network | conversion_complete_tutorial_sk_ad_network | conversion_invite_sk_ad_network | conversion_login_sk_ad_network | conversion_share_sk_ad_network | conversion_reserve_sk_ad_network | conversion_achievement_unlocked_sk_ad_network | conversion_add_to_wishlist_sk_ad_network | conversion_spend_credits_sk_ad_network | conversion_rate_sk_ad_network | conversion_start_trial_sk_ad_network | conversion_list_view_sk_ad_network | custom_event_1_sk_ad_network | custom_event_2_sk_ad_network | custom_event_3_sk_ad_network | custom_event_4_sk_ad_network | custom_event_5_sk_ad_network | unknown_sk_ad_network | conversion_assist_install_sk_ad_network | conversion_null_sk_ad_network | conversion_total_installs_sk_ad_network_total | conversion_ios_installs_sk_ad_network_total | conversion_purchases_sk_ad_network_total | conversion_save_sk_ad_network_total | conversion_start_checkout_sk_ad_network_total | conversion_add_cart_sk_ad_network_total | conversion_view_content_sk_ad_network_total | conversion_add_billing_sk_ad_network_total | conversion_sign_ups_sk_ad_network_total | conversion_searches_sk_ad_network_total | conversion_level_completes_sk_ad_network_total | conversion_app_opens_sk_ad_network_total | conversion_page_views_sk_ad_network_total | conversion_subscribe_sk_ad_network_total | conversion_ad_click_sk_ad_network_total | conversion_ad_view_sk_ad_network_total | conversion_complete_tutorial_sk_ad_network_total | conversion_invite_sk_ad_network_total | conversion_login_sk_ad_network_total | conversion_share_sk_ad_network_total | conversion_reserve_sk_ad_network_total | conversion_achievement_unlocked_sk_ad_network_total | conversion_add_to_wishlist_sk_ad_network_total | conversion_spend_credits_sk_ad_network_total | conversion_rate_sk_ad_network_total | conversion_start_trial_sk_ad_network_total | conversion_list_view_sk_ad_network_total | custom_event_1_sk_ad_network_total | custom_event_2_sk_ad_network_total | custom_event_3_sk_ad_network_total | custom_event_4_sk_ad_network_total | custom_event_5_sk_ad_network_total | unknown_sk_ad_network_total | conversion_assist_install_sk_ad_network_total | conversion_null_sk_ad_network_total | conversion_total_installs_sk_ad_network_view | conversion_ios_installs_sk_ad_network_view | conversion_purchases_sk_ad_network_view | conversion_save_sk_ad_network_view | conversion_start_checkout_sk_ad_network_view | conversion_add_cart_sk_ad_network_view | conversion_view_content_sk_ad_network_view | conversion_add_billing_sk_ad_network_view | conversion_sign_ups_sk_ad_network_view | conversion_searches_sk_ad_network_view | conversion_level_completes_sk_ad_network_view | conversion_app_opens_sk_ad_network_view | conversion_page_views_sk_ad_network_view | conversion_subscribe_sk_ad_network_view | conversion_ad_click_sk_ad_network_view | conversion_ad_view_sk_ad_network_view | conversion_complete_tutorial_sk_ad_network_view | conversion_invite_sk_ad_network_view | conversion_login_sk_ad_network_view | conversion_share_sk_ad_network_view | conversion_reserve_sk_ad_network_view | conversion_achievement_unlocked_sk_ad_network_view | conversion_add_to_wishlist_sk_ad_network_view | conversion_spend_credits_sk_ad_network_view | conversion_rate_sk_ad_network_view | conversion_start_trial_sk_ad_network_view | conversion_list_view_sk_ad_network_view | custom_event_1_sk_ad_network_view | custom_event_2_sk_ad_network_view | custom_event_3_sk_ad_network_view | custom_event_4_sk_ad_network_view | custom_event_5_sk_ad_network_view | unknown_sk_ad_network_view | conversion_assist_install_sk_ad_network_view | conversion_null_sk_ad_network_view"
],
"add_metric_variants": true,
"base_metrics_fields": [
"impressions | swipes | view_time_millis | screen_time_millis | quartile_1 | quartile_2 | quartile_3 | view_completion | spend | video_views | android_installs | attachment_avg_view_time_millis | attachment_frequency | attachment_quartile_1 | attachment_quartile_2 | attachment_quartile_3 | attachment_total_view_time_millis | attachment_uniques | attachment_view_completion | attachment_video_views | avg_view_time_millis | avg_screen_time_millis | frequency | ios_installs | swipe_up_percent | total_installs | uniques | video_views_time_based | video_views_15s | story_opens | story_completes | profile_clicks | position_impressions | position_screen_time_millis | position_swipe_up_percent | avg_position_screen_time_millis | shares | saves | paid_impressions | earned_impressions | total_impressions | play_time_millis | total_reach | earned_reach | native_leads | landing_page_views | conversion_purchases | conversion_purchases_value | conversion_save | conversion_save_value | conversion_start_checkout | conversion_start_checkout_value | conversion_add_cart | conversion_add_cart_value | conversion_view_content | conversion_view_content_value | conversion_add_billing | conversion_add_billing_value | conversion_sign_ups | conversion_sign_ups_value | conversion_searches | conversion_searches_value | conversion_level_completes | conversion_level_completes_value | conversion_app_opens | conversion_app_opens_value | conversion_page_views | conversion_page_views_value | conversion_subscribe | conversion_subscribe_value | conversion_ad_click | conversion_ad_click_value | conversion_ad_view | conversion_ad_view_value | conversion_complete_tutorial | conversion_complete_tutorial_value | conversion_invite | conversion_invite_value | conversion_login | conversion_login_value | conversion_share | conversion_share_value | conversion_reserve | conversion_reserve_value | conversion_achievement_unlocked | conversion_achievement_unlocked_value | conversion_add_to_wishlist | conversion_add_to_wishlist_value | conversion_spend_credits | conversion_spend_credits_value | conversion_rate | conversion_rate_value | conversion_start_trial | conversion_start_trial_value | conversion_list_view | conversion_list_view_value | conversion_visit | conversion_visit_value | custom_event_1 | custom_event_1_value | custom_event_2 | custom_event_2_value | custom_event_3 | custom_event_3_value | custom_event_4 | custom_event_4_value | custom_event_5 | custom_event_5_value"
],
"breakout": "total | web | app | offline | total_off_platform | total_on_platform",
"granularity": "DAY | HOUR",
"breakdown": "CAMPAIGN | AD_SQUAD | AD",
"report_name": "some_report_name",
"dimension": "COUNTRY | REGION | DMA | DEVICE_OS | DEVICE_MAKE | DEMOGRAPHIC | INTEREST"
}
],
"schema": "schema_name"
},
"auth": {
"refresh_token": "my_refresh_token",
"client_access": {
"client_secret": "my_client_secret",
"client_id": "my_client_id"
}
}
}Config parameters
| Name | Description |
|---|---|
sync_mode | Whether to sync all organizations or specific organizations. Default value: AllOrganizations. |
view_attribution_window | The time period to attribute conversions based on views. Default value: DAY_1 |
swipe_attribution_window | The time period to attribute conversions based on swipes. Default value: DAY_28 |
timeframe_months | Number of months' worth of reporting data you'd like to include in your initial sync. This cannot be modified once the connector is created. Default value: TWELVE. |
organizations | Specific organizations IDs to sync. Must be populated if syncMode is set to SpecificOrganizations. |
custom_reports | Custom reports for Snapchat Ads connector. |
custom_reports[0].sk_ad_metrics_fields | List of SKAd Metrics fields in custom report. |
custom_reports[0].add_metric_variants | Add fields for separate "swipe-up" and "view" variants of selected metrics |
custom_reports[0].base_metrics_fields | List of Core, Additional and Conversion Metrics Stats Fields. |
custom_reports[0].breakout | Sets Breakout on custom report. |
custom_reports[0].granularity | Sets Granularity on custom report. |
custom_reports[0].breakdown | Sets Breakdown on custom report. |
custom_reports[0].report_name | Custom report name (must be unique) |
custom_reports[0].dimension | Sets Dimension on custom report. |
schema | Destination schema name. Schema name is permanent and cannot be changed after connection creation |
Authorization
There are two ways to authorize this connector type:
By specifying the values for the
client_accessandrefresh_tokenparameters in theauthsection.POST https://api.fivetran.com/v1/connections{ "service": "snapchat_ads", "group_id": "group_id", "auth": { "client_access": { "client_secret": "my_client_secret", "client_id": "my_client_id" }, "refresh_token": "my_refresh_token" } }Auth Parameters
Name Description refresh_tokenThe long-lived Refresh tokenalong with theclient_idandclient_secretparameters carry the information necessary to get a new access token for API resources.client_accessYour application client access fields. client_access.client_secretClient Secretof your Snapchat Ads client application.client_access.client_idClient IDof your Snapchat Ads client application.By using the Connect Card or the Fivetran dashboard.