Skip to main content

Change Log

DateDescription
2025-11-12Updated the Campaign section to include Smart Budgets - Smart Budget Campaigns dynamically allocates budget to better performing Ad Squads
2025-11-12Added new Bid Recommendations endpoint to the Ad Squad - this allows bid recommendations to be fetched for the TARGET_COST bid strategy
2025-11-12Updated the Ad section with Third-Party tracking options and Macros
2025-10-25Updated Announcements calling out change in validation for the CHAT_FEED placement
2025-10-25Added new section for Product Level Video Ads with instructions on how to use Video media with Dynamic Ads
2025-10-25Updated the section Dynamic Product Ads with preferred_video_tags and updated the example for preferred_image_tags
2025-10-25Updated the Event Details section - the event_start_time is now an ISO format date
2025-10-25Updated the Ad Squad section for Sponsored Snaps (CHAT_FEED) to include the newly launched Optimization Goals
2025-10-25Updated the Measurement section to include all variants of conversions that capture value
2025-10-25Updated the Targeting section to include SMART_TARGETING as a part of the auto-expansion options
2025-10-25Updated the Creatives section with instructions on how to generate Snap hosted preview page
2025-10-25Updated the Creatives section to include the new Playables option for APP_INSTALL Creatives
2025-10-25Updated the Media section to include the new Media type PLAYABLE
2025-10-25Updated the Creatives section to include the new AR Extension option for WEB_VIEW and DEEP_LINK Creatives
2025-10-25Updated the Creatives section with the new Fetch multiple Creatives method, this allows the fetching of up to 2,000 Creatives with a single POST request
2025-10-25Added new sort method to the individual sections for Campaign, Ad Squad, Ad, Creative and Media entities, this allows sorting by creation time or by last update
2025-10-25Updated the API Patterns section to include new sort method for the Campaign, Ad Squad, Ad, Creative and Media entities, this allows sorting by creation time or by last update
2025-10-25Updated the Public Profile API Sharing Policies to include mobile_apps, allowing mobile_apps to be shared across Ad Accounts and Organizations
2025-10-01Added the media_copy method which allows copying of Media entities between different Ad Acounts in the same Organization
2025-08-11Renamed Ad Code page to Claim Media. Added a section describing how to claim media by Snap Id (also known as Snap Promote)
2025-06-17A 23 September 2025 launch date has been announced for eligibility checks for Pixel and App events, also for the switch to the Compact style of targeting in Snap Ads Manager
2025-06-17Added section about Offer Disclaimers (Dynamic and Static) for Creatives
2025-06-17Added section for the Ad Squad Outcomes estimation endpoint
2025-06-17Added section for fetching reporting at Creative and Media level
2025-05-21Updated Sponsored Snaps section and Creative section for Story Ads (COMPOSITE), Story Ads are now eligible to serve as Sponsored Snaps and can use the chat_properties attribute
2025-05-20The bid_strategy MIN_ROAS and the attribute roas_value_micro were marked as deprecated as of 10 February 2025
2025-05-02Updated Sponsored Snaps with the latest valid optimization goals and conversion windows
2025-05-02Updated the Optimization goals available to Housing Credit Employment (HCE) windows, LEAD_GENERATION and LANDING_PAGE_VIEW are now allowed in addition to existing optimization goals
2025-04-04Added Audience Creation types (Website Events, Mobile App Events, and Ad Engagement)
2025-03-26Added Targeting style changes (expanded, compact) to the announcements, the targeting section and the targeting examples section
2025-03-26Added Pixel/App eligibility changes to the announcements and to the Ad Squad section
2025-03-26Added new Reminder type Creative to Creatives section
2025-03-26Added new Section for Event Details entity
2025-03-26Added Engaged View conversion metrics to the Measurement section
2025-03-26Updated Ad Squad section - the SKAd network opt-in has been updated and has had the SKOverlay for App Install Ads added to it
2025-03-21Added a new section for Custom Conversion reporting in the Measurement section
2025-03-10Updated the Campaign section with new timelines for objective_v2_properties launch and backfill
2025-03-10Updated "Sponsored Snaps" section, placement_v2 CHAT_FEED has to be combined with INTERSTITIAL_CONTENT or INTERSTITIAL_USER when using custom placements
2025-03-10Updated Ad Squad and Targeting section - added the parameter targeting_v2
2025-03-10Added announcement about age_bucket breakdown up to 55+
2025-03-10Updated Measurement section - added age_bucket breakdown for new age ranges
2025-03-10Updated Measurement section - added new metric video_views_5s
2025-02-12Added "Sponsored Snaps" entry to Announcements
2025-02-12Updated Ad Squad section with "Sponsored Snaps" section and new placement_v2 CHAT_FEED
2025-02-12Updated Creative section with new attribute chat_properties
2025-02-12Updated Measurement section - uniques and attachment_uniques are now availble to be broken down by Insights (report_dimension)
2025-02-12Updated Targeting section for Demographics - max_age has now increased to 55 from 49
2025-02-12Updated the Dynamic Product Ads Guide - product_audiences are not required when setting up a Prospecting audience
2025-02-06Added Reach Overlap Reporting as a part of Measurement - Asynchronous Reporting Requests
2025-01-01Updated Creative section - The parameters type and review_status are now available when fetching Creatives under an Ad Account
2025-01-01Updated Lens section - The Lens section was revamped to include the new AR Filter format, lens_package_metadata and the new placement POST_CAPTURE_CAROUSEL
2025-01-01Updated Measurement section - Added new metrics coupon_used_local and coupon_used_usd
2025-01-01Updated Product Feeds in the Dynamic Ads section, instructions and an example for how to create SUPPLEMENTAL product feeds are now available
2025-01-01Updated Insights in the Measurement section, insights are available for landing_page_views from the 10 December 2024
2025-01-01Corrected the ATT entry in the Measurement section, insights for Region/DMA/Device Make/SLC/Product are available for opted-in users
2025-01-01Updated the multi-delivery section for Ad Squads to include APP_REENGAGE_PURCHASE and SKAdnetwork enabled Ads Squads
2024-11-25Updated the Campaign section with new options for the objective_v2_properties business logic table
2024-11-25Updated the Ad Squad UI Render Data entity to include new options CALL, TEXT and PUBLIC_PROFILE for the conversion_location
2024-11-25Updated the Ad Squad section with a table specifying when Story Ads are available to different Delivery Optimisation Windows
2024-11-25Updated the Media entity to include the new attribute media_usages which specifies which Creatives the Media can be used with
2024-11-25Updated the Creative entity to include the new attribute favorite_display_mode which allows users to favorite Creatives they are served
2024-10-25Updated the Measurement section introducing Asynchronous reporting requests
2024-10-25Added new section for Ad Codes, allowing for creator content to be used in Ads
2024-10-25Updated Ad Squad section to include new table for Delivery Optimization Windows, Optimization goal and Ad type availability
2024-10-25Updated the Lead Generation Ads guide introducing the new Lead Generation form entity
2024-09-18Updated Campaign section to include the new attribute objective_v2_properties, also added several tables explaining the business logic when using the new attribute
2024-09-18Added section for new entity Ad Squad UI Render Data, for use with the Campaign level objective_v2_properties
2024-09-18Updated Ad Squad section to include Ad Squad Conversion window eligibility endpoint
2024-09-18Updated Ad Squad Optimization Goals to include new value LANDING_PAGE_VIEW
2024-09-18Updated Ad Squad Optimization Goals to list valid goals for Ad Squads targeting Housing Credit and Employment (HCDE)
2024-09-18Updated Targeting section to include WEB targeting for Snapchat on Web
2024-09-18Updated Creative section to include new attribute cta_color_display_mode
2024-09-18Updated Creative section - Preview Creative, the attribute logo_media_id is now optional
2024-09-18Updated Media section to include new endpoint lens_preview, used to fetch resources attached to a Lens
2024-09-18Updated Measurement section - Added new metric landing_page_views
2024-09-18Updated Auth section - Access token expiry is now 3600 seconds = 60 minutes
2024-06-14Documents the Conversions API V2 Partner ID feature
2024-03-21Announcement for Conversions API v3 and links to new docs site
2024-02-29Updated Creatives to require the profile_properties field
2024-02-08Added new Organization level Role data_admin , this is a reporting only role
2024-02-08Added new placement PUBLIC_STORIES_INSTREAM
2024-01-30Added new delivery_status LEARNING_PHASE for Ad Squads
2024-01-30Added method to update Pixel at Organization level
2024-01-30Removed deprecated attributes allow_snap_javascript_sdk and use_immersive_mode from webview properties
2024-01-30Added new call to action VIEW_PROFILE
2024-01-27Added Public Profile stats supported granularities, SPOTLIGHT stats fields, and new authorized data sharing endpoints
2023-12-26Added FAVORITES to the list of supported metrics for STORY and SAVED_STORY
2023-01-10Added documentation for Public Profile Search API tier parameter
2023-01-09Added documentation for visibility parameter in Public Profile Saved Stories API
2023-11-17Added new section introducing the Public Profile Search API
2023-11-06Added new section introducing the Transactions entity
2023-10-24Document Dynamic Template Changelogs
2023-07-24Added update on the European Digital Service Act
2023-07-24Added CAROUSEL and SLIDESHOW layout for Dynamic Collection Ads
2023-07-24Updated the Ad Squad section, added conversion_window, updated Placement to Ad type, Optimisation goal to Ad type
2023-07-24Snapcode Preview now supports Dynamic Ads
2023-07-24Following deprecation in February Audience filters (FILTER), Longform video (LONGFORM_VIDEO) and Lens Longform video (LENS_LONGFORM_VIDEO) have been removed from the docs, Ad type specific metrics associated with these Ad types can still be fetched
2023-06-08Added discover Public Profile stats documentation
2023-06-08Update documentation of the Profile media upload API
2023-06-01Added discover Public Profile Lenses documentation
2023-05-29Added discover Public Profile Saved Stories documentation
2023-05-25Added discover Public Profile Spotlights documentation
2023-05-22Updated documentation for spotlight posting
2023-05-18Added discover Public Profile documentation
2023-05-04Added announcement for pagination enforcement
2023-04-03Added possible objective values for campaign creation
2023-02-28Add new INTERSTITIAL_SPOTLIGHT position to PlacementV2
2023-01-24Updated CAPI Business SDK copy and removed beta
2022-12-23Added Targeting Auto Expansion update in Announcements and Targeting section
2022-12-23Added Long form Video deprecation in Announcements
2022-12-23Added new First party Shopper Interest targeting (shp)
2022-12-23Added new Dynamic Template option AUTOMATIC
2022-12-23Updated Reporting Insights and Dimensions, breakdown by Country and Operating System is now available
2022-12-23Deprecated Placed Interest targeting (plc)
2022-12-23Deprecated the reporting parameter platform_stats
2022-12-23Deprecated the placement_v2 snapchat_positions option GAMES
2022-12-23Deprecated the placement_v2 snapchat_positions option AUDIENCE_EXTENSION
2022-09-29Updated Ad Squad section, added currency aware bids, maximum value of bid_micro is now dependent on the currency of the Ad account
2022-09-29Updated Measurement Section, all conversion events now have an equivalent value metric
2022-09-29Updated Measurement section, added new metric profile_clicks
2022-09-29Updated Role Section, how to update the Role type
2022-09-29Updated User section, the response now includes the snapchat_username of the user
2022-09-29Updated Interest Targeting section, interest targeting for SCLS and VAC now has a new endpoints and parameters
2022-09-29Updated Targeting section, fetching targeting options per Country now has a new endpoint and a new parameter for non-US countries
2022-09-15Added "post saved story" documentation in Profile API.
2022-09-14Add "locale" in the post spotlight documentation in Profile API.
2022-09-02Added "get spotlight" and "post spotlight" documentation in Profile API.
2022-08-24Corrected some parameter terms in curl example and Best Practices section.
2022-08-22Update Conversion API docs to improve language and fix typos on how to get started
2022-08-18Corrected Snap Lifestyle Categories API to reflect updated country code param
2022-07-14Updated Conversion API event_type with LEVEL_COMPLETE
2022-07-13Updated public profile APIs
2022-07-06Updated parameter best practices information
2022-07-06Updated Product Search and Facets sections to include new travel endpoints (/products/search, /flights/search, /hotels/search) and associated attributes
2022-05-24Updated creatives section to include instructions on attaching a profile
2022-05-23Updated AdSquad SKAdNetwork section with critical changes to SKAdnetwork tracking and introduction of ecid_status
2022-05-23Updated Measurement section, deprecated Reporting Insights for Conversion metrics for region, dma, lifestyle_category, product and make
2022-05-23Added new section for the Marketing API Newsletter
2022-04-07Renamed SAM (Snap Audience Match) to "Customer List" to align naming with other parts of the platform.
2022-01-10Updated Ad Squad Section, Pixel/App Optimization goals no longer require conversions to unlock
2022-01-06Updated Measurement section to include Lead Gen Reporting
2021-11-12Added a new scopes table for coversion API and updated the auth docs to support multiple scopes
2021-10-25Updated announcements, timelines and reference documentation for Ad squad targeting updates
2021-10-25Updated entire Conversion API section
2021-10-25Updated Ad Squad section, placement_v2, Story Ads can now serve in between User stories and Publisher stories
2021-10-05Added the new Showcase Creative type to the Dynamic Collections Ads Guide
2021-10-05Updated the Targeting Spec entity to include behaviour pre- and post 27 November 2021
2021-09-23Updated Ad Squad section, the bid_strategy AUTOBID is now available to all App and Pixel Optimization Goals
2021-09-13Updated Measurement section, SKAd reporting section updated with Ad level metrics (estimated) availability
2021-08-23Added new section for Dynamic Story Ads
2021-08-23Updated Measurement section, the granularity TOTAL is now available for frequency, uniques, attachment_uniques, attachment_frequency, total_reach, earned_reach
2021-08-23Updated Measurement section, deprecated the HOUR granularity for frequency, uniques, attachment_uniques, attachment_frequency, total_reach, earned_reach
2021-08-23Updated Measurement section, deprecated the metrics position_uniques and position_frequency
2021-08-23Updated Entity Pagination section to include additional entities where pagination is supported
2021-06-17Updated Ad Squad section with new attributes child_ad_type and forced_view_setting
2021-05-26Updated SKAd Network Reporting to include VIEW conversions
2021-05-25Deprecation of Story Ad metrics position_uniques and position_frequency announced
2021-05-25Added new metric native_leads under Additional Metrics in the Measurement section
2021-05-25Added new Media Rating Council accredited metrics in the Measurement section
2021-05-25Updated Snap App ID section to include method to fetch all Snap App IDs under an Ad Account
2021-05-25Updated Creative section specifying Snapcode Preview availability
2021-05-25Updated Creative section, Story Ads now hold 1-20 individual Snaps
2021-05-25Updated the Measurement section to consolidate Lens and Filter specific metrics under Additional metrics
2021-04-27Added Apple Transparent Tracking changes to the Reporting and measurement API docs
2021-04-22Updated DPA creative creation with url macros information
2021-04-12Updated Ad, Ad Squad and Campaign sections to include new deleted attribute and new parameter read_deleted_entities
2021-04-12Updated Roles section to include Catalog Roles
2021-03-12Updated Ad Squad section to include SKAd Network attributes
2021-03-12Updated Measurement section to include SKAd Network metrics and reporting
2021-03-03Added new CTAs and delivery statuses
2021-02-03Added a new section for Snap App ID
2021-02-03Updated Ad Squad section to include new attribute event_sources
2021-02-03Updated Dynamic Product Ads Guide to include new attribute event_sources
2021-02-03Updated Targeting section to include new targeting option app_install_states
2021-02-03Updated Targeting examples to include several examples of using app_install_states
2021-02-03Updated available countries for Reach & Frequency Campaigns
2021-01-08Added a new section for collection ads for DPA
2020-11-18Added a new section under measurement for DPA reporting
2020-10-29Updated section on Dynamic Ad products - Feed Upload to include UPSERT option
2020-10-23Updated section on lookalike audience creation spec to support multi country targetting
2020-10-22Added the parameter action_report_time (conversion, impression) for measurement requests
2020-10-22Added the offline dimension to conversion_source_types for measurement requests
2020-10-19Added new section for Conversion API
2020-10-12Added new section for Dynamic Product Ads, introducing Feed Upload
2020-10-12Added new section for Dynamic Product Ads, introducing Product Feeds
2020-10-12Updated Dynamic Product Ads catalog section to include Create/Update/Delete
2020-09-22Added test attribute for Ad Account creation in the /adaccounts endpoint
2020-09-22Updated authentication section to call out the expiry of the Access token
2020-09-22Updated section on Lookalike audience creation to include information on lookalike updating when seed audience is updated
2020-08-17Updated Measurement section to include platform_stats attribute for use with the Snapchat Audience Network
2020-08-17Updated Ad Squad section, placement_v2, Automatic Placement now mentions the Snapchat Audience Network
2020-07-27Updated Dynamic Product Ads introducing Product Search and examples
2020-07-27Added new section introducing the attribute delivery_status
2020-07-27Added new section introducing the Invoice entity
2020-06-18Updated Dynamic Product Ads introducing Dynamic Templates
2020-06-18Updated Dynamic Product Ads introducing Catalog Diagnostics
2020-06-18Updated Dynamic Product Ads with new examples of Prospecting and Retargeting Ad Squads
2020-06-18Updated Creative and Lens section with new values for the Call To Action attribute
2020-06-18Updated Ad Squad section to include clarification and example use of MIN_ROAS
2020-06-18Updated Ad Squad section with additional Optimization Goals for use with Frequency Capping
2020-06-18Updated Optimization Goals to include new goal APP_REENGAGE_OPEN
2020-06-18Added example of SLC targeting exclusion to Example Targeting Spec section
2020-06-18Added new table listing INCLUDE/EXCLUDE options for Targeting spec
2020-05-04Added new section introducing the Role entity
2020-05-04Added new section introducing the Member entity
2020-05-04Added new section introducing the Billing Center entity
2020-05-04Updated Ad Account Section with Ad Account Creation, Updating an Ad Account, assigning a Funding Source
2020-05-04Updated the Ad Account attributes, to include political advertising, CHE and French Advertisers
2020-05-04Updated Targeting section for Demographics, Age Range to list deprecated 35+ setting
2020-04-09Updated bid_strategy section to clarify details on the sunsetting of auto_bid and target_bid
2020-04-09Updated AdSquad spec daily_budget_micro, lowered from 20000000 to 5000000 (from £/€/$20 to 5)
2020-04-09Updated AdSquad spec to clarify possible values of delivery_constraint
2020-04-02Updated Commercials section to include videos longer than six seconds
2020-03-30Updated targeting section to include multi-country targeting
2020-03-30Updated targeting spec examples to include an example of multi-country targeting
2020-03-30Added GAMES to placement_v2 including an example for GAMES placement via snapchat_positions
2020-03-30Updated Commercials section based on new GAMES placement_v2 for snapchat_positions
2020-03-20Added new section announcing upcoming breaking changes
2020-03-20Added new section on bid_strategy and the new bid type MIN_ROAS
2020-03-20Added new Creative types, AD_TO_CALL and AD_TO_MESSAGE
2020-03-20Added new section for verifying phone number for AD_TO_CALL, AD_TO_MESSAGE Creative types
2020-03-20Added new Insights and Dimensions section including new parameter report_dimension
2020-03-20Updated placement_v2 section to include more examples and table comparing with placement
2020-03-20Updated Ad Squad section with list of available Ad Types / Optimization Goal
2020-03-02Updated Commercials section, two new countries Kuwait and Ireland
2020-03-02Updated Creative section to list Filter and Lens
2020-02-13Added docs for Lenses
2020-02-13Updated Reach and Frequency to include additional launched countries
2020-02-13Updated Audience source type to include MOBILE audiences
2020-01-21Updated Authentication section - App set up and access to the API is now managed via Snap Business Manager
2019-12-19Added docs for Dynamic Product Ads
2019-11-29Added conversion_source_types parameter for breakout of conversions
2019-11-29Added omit_empty parameter for reporting requests
2019-11-07Added new section Commercials - How to set up and target Creatives to run as Commercials
2019-11-07Updated Snap Audience Match - Update an Audience Segment
2019-11-07Updated Targeting Demographics - Added min_age and max_age to Age Range
2019-11-07Updated Targeting Section - Added enable_targeting_expansion
2019-11-07Updated Measurement - Metrics and supported granularities table updated
2019-11-07Updated Measurement section - Added 19 new Pixel conversion events
2019-11-07Updated Measurement API patterns - Added Pagination
2019-11-07Updated Ad Squad - pacing_type attribute at is now immutable
2019-11-07Updated Audience Geofilters - Optimization goal IMPRESSIONS is now available
2019-11-07Updated Bid Estimate - Added additional optimization goals
2019-11-07Updated AdSquad - New measurement_provider_names DOUBLEVERIFY
2019-11-07Updated AdSquad - New Third-Party Tracking Tags DOUBLEVERIFY
2019-11-01Updated Ad - Upcoming changes to Third-party tracking fields
2019-10-03Added new AdSquad optimization goal, video_views_15s
2019-10-03Added new metrics video_views_time_based, video_views_15s
2019-10-03Removed MOAT from Ad level third party tracking
2019-09-19Updated Ad Account, Ad entities - added paying_advertiser_name for political ads
2019-09-19Updated Campaign - added attribute candidate_ballot_information for political ads
2019-09-19Updated Ad Account to include billing type attribute,
2019-09-10Added new section under AdSquad - Third-Party tracking tags - MOAT
2019-09-10Updated AdSquad - added attribute measurement_provider_names for Third-Party tracking
2019-09-10Updated AdSquad - added parameter to return placement_v2
2019-09-10Updated AdSquad - added content type GAMING
2019-09-10Updated AdSquad - pacing_type is immutable once set
2019-09-10Updated Campaign - added regulations attribute for Credit/Housing/Employment Ads
2019-08-09Added On Demand Geofilter sunsetting announcement
2019-07-31Added redirect_uri parameter to access token call
2019-07-31Added docs for pacing_type
2019-07-31Removed Innovid
2019-07-26Added new section for Audit logs
2019-07-26Updated pagination section to include change logs
2019-07-26Updated metrics additional metrics available in real time
2019-07-26Updated metrics removed WEEK and MONTH granularities
2019-07-18Added docs for placement v2
2019-06-26Added information on Entity Request Limits for Creating/Updating Entities
2019-06-26Additional information on multipart media upload v2
2019-06-26Pagination support for additional endpoints, All accounts under Organization, All Segments under Ad account
2019-06-26Additional Optimization Goals for pixel and app added
2019-06-13Updated multipart media upload to v2
2019-01-30Changed daily_budget_micro to minimum value 20000000
2019-01-30Added definition for response attribute finalized_data_end_time
2019-01-30Updated campaign measurement_spec with relevant ad types
2019-01-30Added clarification position_stats metric only available at LIFETIME granularity
2019-01-24Updated the styling
2019-01-11Added documentation for target cost bidding
2019-01-11Added method for updating a Creative
2018-11-15Added documentation for Collection creatives
2018-11-15Added documentation for AdSquad mutability
2018-11-15Removed targeting by country table in favor of the targeting by country endpoint
2018-11-06Added Story Ad position metrics and updated Audience Filter bidding properties
2018-10-18Added new Creative and Ad types for Lens with attachments
2018-10-18Autobidding is allowed for Audience filters
2018-10-18Added API method to retrieve SLC by country
2018-10-18Added new source types PIXEL and FOOT_TRAFFIC_INSIGHTS for SAM audience
2018-10-08Added documentation for Measurement for retrieving position metrics for Snap Ads within a Story Ad
2018-09-13Added documentation for retrieving Placed Visitation Segments
2018-09-13Added AUCTION as a buy_model type on Campaigns
2018-09-13Added PHONE_SHA256 as a new schema for adding users to SAM segments
2018-09-12Added documentation for Measurement for Ad types LENS, AD_TO_LENS, FILTER
2018-09-12Added method for deleting an Audience segment
2018-09-12Added method to retrieve roles for Ad Accounts for currently logged in user
2018-09-12Added method for retrieving a thumbnail from Media of VIDEO type
2018-09-12Called out our preferred gender targeting method in targeting examples
2018-09-12Corrected the required fields for AdSquad creation and updating
2018-09-12Corrected the http method for Audience Size v2
2018-08-01Added documentation for Reach and Frequency buying
2018-08-01Added documentation for fallback to webview for deeplink ads
2018-08-01Added documentation for Audience Size v2
2018-07-01Corrected minimum for radius targeting to 96 meters
2018-07-19Added documentation for new optimization goals for pixel and app conversions
2018-07-19Added documentation for new creative type and ad type AD_TO_LENS and media type LENS_PACKAGE
2018-07-19Added documentation for min/max age targeting and modified targeting spec examples to include min_age and max_age
2018-07-19Removed auto-fill SDK guidelines. Auto-fill no longer requires SDK to be installed
2018-07-06Added documentation in API Patterns on how to retrieve paginated results when fetching many entities
2018-07-03Added optimizaton goal STORY_OPENS
2018-06-26Added documentation for Nielsen targeting categories
2018-06-26Removed the word DLX from Advanced Demographics targeting options as it also includes Experian categories now
2018-06-26Updated max radius for radius targeting to 100km
2018-06-26Added documentation for auto bidding
2018-06-25Added documentation for fetching a single audience segment by id
2018-06-13Added documentation for audience insights
2018-06-13Added documentation for new metric conversion_purchases_value
2018-06-13Added note that new geofilter integrations will not be supported
2018-06-13Added information about deprecated boolean flag for targeting dimensions
2018-06-13Added link to supported currencies
2018-06-13Ad Account timezones no longer need to be America/Los Angeles
2018-04-30Added documentation for Story Ads, new creative types PREVIEW and COMPOSITE, new ad type STORY, new placement DISCOVER_FEED
2018-04-30Added story_opens and story_completes metrics for Story Ads
2018-04-30Added that for Story Ads the only optimization_goal supported is IMPRESSIONS
2018-04-30Updated that Ad Scheduling is now available
2018-04-05Added that Integral Ad Science (IAS) tags are now supported
2018-04-05Added documentation for location categories
2018-04-05Added documentation for point radius targeting
2018-03-15Added measurement_spec into the campaign object attributes, required for all ads that need app tracking and post install conversion reporting
2018-03-15Added notice that python SDK is not available yet and coming soon
2018-03-13Added documentation on how to retrieve a preview for a Media
2018-03-08Added documentation on how to retrieve a Snapcode preview for a Creative
2018-03-05Added documentation that top snap media can now be of type IMAGE
2018-02-22Added documentation for ad scheduling
2018-02-22Updated that bid estimate can be used for all optimization goals
2018-02-22Updated default retention_in_days for SAM is lifetime
2018-02-22Updated that headline is required for geofilters and audience filters but never displayed
2018-02-22Added FOOD, SPORTS, YOUNG_BOLD to included and excluded content types
2018-02-07Updated call for generating a new access token from refresh token
2018-02-07Updated that audience size endpoint returns estimated sizes
2018-02-07Updated instructions for getting OAuth credentials
2017-11-30Updated frequency cap time_interval maximum to 30 days or 720 hours
2017-11-28Added documentation for attribution windows
2017-11-28Added Paypal as a funding source option
2017-11-28Updated that audience filters and geofilter media needs to be at least 50% transparent
2017-11-28Removed granularity from Additional metrics table, refer Metrics and supported granularities table
2017-11-28Removed goal_type from old API responses for Ad Squad object
2017-11-22Updated MOAT tag
2017-11-20Added lifetime_spend_cap_micro for the Campaign object
2017-11-20Added DEEP_LINK to ad type options
2017-11-20Added note that MOAT tagging is available for all snap ads products
2017-11-20Updated geofilter and audience filter creative dimensions
2017-11-13Added block_preload property for creatives with web view
2017-11-07Removed pixel implementation details and added reference to Business Help Center guide for Snap Pixel
2017-11-07Updated output for Get Pixel endpoint with pixel_javascript parameter
2017-11-07Added new countries supported for Geofilters
2017-11-07Updated impressions_composition and uniques_composition to impression_composition and unique_composition
2017-10-11Updated that frequency caps can be edited once they are live
2017-10-10Added documentation for frequency caps
2017-10-10Added geopolygon support for geofilters
2017-10-10Updated audience filter documentation to show zipcode targeting is allowed
2017-09-13Updated fields for audience filter stats
2017-09-07Added documentation for pixel stats endpoints
2017-09-07Added documentation for reporting insights breakdowns
2017-09-07Added new fields for Geofilter stats
2017-08-20Added USER_STORIES placement option
2017-08-20Added image specifications for app icon
2017-08-20Added new countries: Oman, Bahrain, Malaysia, Philippines and Thailand
2017-08-20Added note about campaign budgets being at least 0.25 of sum of its ad squad budgets
2017-08-20Added minimum for ad squads daily budgets
2017-08-10Added documentation for Audience Filters
2017-08-01Added documentation for deep link creative type
2017-07-31Added information about age_min targeting for geofilters
2017-07-31Added geofilter schedule information. Geofilters can be bought 3 hours in advance on weekdays.
2017-07-31Added note about max number of SAM segments allowed per ad account
2017-07-31Updated third party tags section with examples and more information
2017-07-31Updated language targeting example
2017-07-19Added new fields upload_status and targetable_status for SAM segments
2017-07-12Updated targeting geo matrix with new countries
2017-07-10Added documentation for device make targeting
2017-07-10Update documentation for creating an organization
2017-06-28Added documentation and example for zipcode targeting
2017-06-28Added note that deep_link_urls field is no longer needed
2017-06-21Added new metrics fields video_views, screen_time_millis, avg_screen_time_millis
2017-06-20Corrected examples for web view creatives to use "VIEW" call to action
2017-06-19Removed pixel deletion
2017-06-16Added that credit card funding sources can now be created via Business Manager
2017-06-16Corrected content type enum from BEAUTY to BEAUTY_FASHION
2017-06-16Added start_date and end_date fields for coupons in the funding source documentation
2017-06-12Added that currency field on funding source object is only returned for line of credit and coupons
2017-06-09Added documentation for included_content_types and excluded_content_types
2017-06-06Added GBB for video views
2017-05-25Added advertiser_organization_id to Ad Account attributes
2017-05-25Corrected HTTP Request for creating pixels
2017-05-25Updated targeting by country matrix with new countries
2017-05-25Added documentation for new types of funding sources and updated GET fundingsources output
2017-05-25Updated OS version targeting example to include os_version_min and os_version_max
2017-05-25Added information that geofilters can now be bought 90 days in advance
2017-05-25Updated geofilter radius limit
2017-05-18Added documentation for language targeting
2017-05-18Added OS version targeting and language example
2017-05-18Added timestamp macro to supported macros for third party tracking urls
2017-05-11Updated Pixel SDK code
2017-05-11Added CONTENT placement
2017-05-11Added OS version targeting
2017-05-11Added information about creating ad accounts in Business Manager
2017-05-11Removed old breaking change section
2017-05-11Added documentation for conversion stats
2017-05-11Updated old links
2017-05-03Added documentation for Snap Pixel
2017-05-03Added measurement spec field on the campaign object
2017-05-02Modified MOAT tag example with new MOAT tag
2017-05-02Added new countries support to the targeting options matrix
2017-05-02Added new currecies supported
2017-05-02Added details about DLXP targeting
2017-05-02Added the stats granularity matrix
2017-05-02Added Apsalar to the list of supported mobile measurement partner intergrations
2017-05-02Added the supported countries for geofilters
2017-05-02Corrected dimensions for geofilter creative spec
2017-04-20Added default retention days for SAM
2017-04-20Added min and max for geofilter targeting radius
2017-04-20Added note that geofilters should run at least for an hour
2017-04-20Added note that geofilters need to start and end by the hour
2017-04-20Updated that geofilters need to be purchased at least 16 hours before intended delivery
2017-04-20Clarified geofilter Ad Squads can only have one location in the targeting spec
2017-04-17Updated SLC targeting abilities in the targeting by country matrix
2017-04-17Updated SAM and Lookalike targeting abilities in the targeting by country matrix
2017-04-17Added upload image media example for app icon and app icon specifications
2017-04-17Added tracking_urls to attributes that can be updated for Ad object
2017-04-17Added WATCH as CTA option for webview
2017-04-17Added brand_name and headline to the creative example
2017-04-17Added example for metro targeting
2017-04-07Fixed example for geofilter price quote endpoint
2017-04-06Added documentation for geofilter stats
2017-04-06Added information about pausing geofilter ads
2017-04-04Added docs for Geofilters
2017-03-29Added note that Ad Squads targeting cannot be updated after review
2017-03-29Added documentation for targeting options by country endpoint
2017-03-29Added documentation for deep linking
2017-03-29Added documentation for auto-fill
2017-03-17Added example for third party view tracking
2017-03-17Added documentation for lookalike type enum
2017-03-17Added documentation for source_type ENGAGEMENT
2017-03-17Fixed date for upcoming breaking changes to 1st April
2017-03-17Added Finland to the targeting geo matrix
2017-03-15Added GBB for APP_INSTALLS as an option coming soon
2017-03-09Added list of allowed Third Party tracking URLs
2017-03-09Added matrix for targeting types allowed by country
2017-03-09Fixed example for targeting using carrier_id
2017-03-09Fixed formatting issue in DLX targeting doc
2017-03-09Fixed formatting in rate limits doc
2017-03-08Added breaking change about Creative brand_name and headline
2017-03-08Added Upcoming Breaking Changes section
2017-02-28Fixed examples for bid estimate by targeting spec
2017-02-28Added lifetime_spend_cap_micro
2017-02-28Added DLXC examples
2017-02-28Fixed errors in examples with bid_type
2017-02-28Added delete and remove all users for SAM
2017-02-28Added bid estimate API
2017-02-28Update examples from daily_budget to daily_budget_micro
2017-02-15Updated measurement metric availability details
2017-02-15Added new CTA options for Web View Creative
2017-02-08Added Mobile Measurement Setup Help Links to App Install Creative section
2017-02-06Removed note regarding limited country availability
2017-02-02Added Brand Name & Headline optional properties to Creative section
2017-01-18Added OPTIMIZED crop option
2017-01-18Added Bulk Fetch details for Ad Squads & Ads
2017-01-12Added Third-Party Tracking details to Ad section
2017-01-05Added targeting examples for DLX
2017-01-05Added DLX Interests targeting details
2017-01-05Added DLX Advanced Demographics targeting details
2017-01-05Fixed typo in carrier targeting spec & example
2016-12-07Added Audience Size section & usage examples
2016-12-07Added Metro / DMA Targeting section & usage example
2016-12-07Added Carrier Targeting section & usage example
2016-11-11Added Goal-Based Bidding details to Ad Squad section
2016-11-02Additional metrics (including attachment metrics) details updated
2016-11-02Rate Limits section added
2016-09-23Added Chunked Upload details to Media section
2016-09-20Added Lookalike creation details to Snap Audience Match section
2016-09-20Removed Creative Update section
2016-09-20Added allowable "call_to_action" values for each Creative attachment type
2016-09-16Changed "icon_media_id" property for App Install creative to Required
2016-09-16Updated Ad Type options & Ad Type <-> Creative Type Mapping
2016-09-14Added full web redirect OAuth2 Flow
2016-09-14Added "review_status" and "review_status_reason" properties on Ad
2016-09-14Added "total_budget_micro" and "budget_spent_micro" properties on Funding Source
2016-09-14Added "breakdown" parameter to Measurement requests
2016-09-14Added "test" parameter to Measurement requests for sample/fake stats response
2016-09-14Added "regulated_content" property to Targeting on Ad Squad
2016-09-14Removed "category_type" property from Interest Targeting on Ad Squad
2016-09-08Updated targeting examples with updated age values
2016-09-01Removed third party tracking URLs from Ad
2016-08-30SAM - Added details on adding users + normalizing/hashing identifiers
2016-08-30SAM - Removed "source_subtype" property
2016-08-30Media objects now have a "download_link" property with full URL to file
2016-08-15Snap Audience Segments ID property is now "id" instead of "segment_id"
2016-08-15Updated Measurement examples
2016-08-15Added Access Token Expiration section
2016-08-15Fixed SCLS targeting examples
2016-08-15Initial documentation released to partners
Was this page helpful?
Yes
No