Skip to main content
Version: v3

Campaign Objective Migration

On September 30th, Reddit will roll out updated campaign objective values to align more closely with industry naming and conventions.

Although legacy enums will continue to be supported for the foreseeable future, developers are recommended to use the following guidance to minimize disruptions to existing integrations.

Legacy enumNew enumOptimization goals
IMPRESSIONSBRAND_AWARENESSnull
VIDEO_VIEWABLE_IMPRESSIONSBRAND_AWARENESSVIDEO_VIEW_6S
CONVERSIONSSALES
  • CLICKS
  • PURCHASE
  • ADD_TO_CART
  • PAGE_VISIT
  • SIGN_UP
  • ADD_TO_WISHLIST
  • VIEW_CONTENT
  • LEAD
CATALOG_SALESSALES
  • CLICKS
  • PURCHASE
LEAD_GENERATIONLEAD_GENERATION
  • LEAD
  • SIGN_UP
CLICKSCLICKSCLICKS
APP_INSTALLSAPP_INSTALLS
  • MOBILE_CONVERSION_INSTALL
  • MOBILE_CONVERSION_SIGN_UP
  • MOBILE_CONVERSION_ADD_PAYMENT_INFO
  • MOBILE_CONVERSION_ADD_TO_CART
  • MOBILE_CONVERSION_PURCHASE
  • MOBILE_CONVERSION_COMPLETED_TUTORIAL
  • MOBILE_CONVERSION_LEVEL_ACHIEVED
  • MOBILE_CONVERSION_SPEND_CREDITS
  • MOBILE_CONVERSION_REINSTALL
  • MOBILE_CONVERSION_UNLOCK_ACHIEVEMENT
  • MOBILE_CONVERSION_START_TRIAL
  • MOBILE_CONVERSION_SUBSCRIBE
  • MOBILE_CONVERSION_ONBOARD_STARTED
  • MOBILE_CONVERSION_FIRST_TIME_PURCHASE

Objective-specific changes

  • objective must be SALES.
  • use_catalog=true is required to use a product catalog. When this value is set, product_set_id must also be set for all ad groups in the campaign. Catalog usage applies uniformly across ad groups in a SALES campaign: either every ad group uses one, or none do.
  • Depending on the optimization_goal set:
    • PURCHASE: view_through_conversion_type must be set to SEVEN_DAY_CLICKS_ONE_DAY_VIEW
    • CLICKS: view_through_conversion_type must be null.
  • shopping_ad_type is required for all ad groups.
  • Reddit Pixel or CAPI setup is still required.