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