Skip to main content

Change Log

DateDescription
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