facebookbusiness 0.16.0.0 → 0.16.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ab556b892927ec0c49fe039c2f5d3583bb8a72d92424b73e431dd7f29ce357c9
-  data.tar.gz: d7a6d7ff350690498302d0e55238c42af4b7b36e6501b6826df20a91e7cac1d6
+  metadata.gz: a4f10d2cd1da0aae6374af9d499c3bce68acbbf34274da8ab8f31c7a3346779a
+  data.tar.gz: 9191aedf5b076c1b19fb814cb3c81ec4d7889e69b5e6e64ee7d3a077f53a3484
 SHA512:
-  metadata.gz: 0f66afb534cb6ca59e8785249ab986801df965ff845fb925b94173f628766c41a2d5d06259712dcc0035e4e2af5079fead24c49e3f70b492402938cc2ba102a7
-  data.tar.gz: aee3d13a547677556169948b09af6998356ecd51aa280d7d8c7a6e56d9191fd3961428c167ad82aca15a00ffdb3d0bee8db5e056ec3cff0d503d826a6dd015e7
+  metadata.gz: d9601c88ca634566e4a93437543d76e030dc0a9d02753d7bbdd0b305f0199d91b7d15001d11d0f5d35fd6bffb961eea701309e890bb15196c1317a313914f67e
+  data.tar.gz: cbeb1553b885405f126e87a623d3e315e4778f65154a8ec719f573b61ecfd6019db9decfc52efbd62bd32b11929f03e0126f47bdbe4cce534ce407868d02c92c

data/lib/facebook_ads/ad_objects/business.rb

@@ -120,6 +120,206 @@ module FacebookAds
       "VIEW_MONETIZATION_INSIGHTS",
     ]
 
+    SUBVERTICAL_V2 = [
+      "ACCOUNTING_AND_TAX",
+      "ACTIVITIES_AND_LEISURE",
+      "AIR",
+      "APPAREL_AND_ACCESSORIES",
+      "ARTS_AND_HERITAGE_AND_EDUCATION",
+      "AR_OR_VR_GAMING",
+      "AUDIO_STREAMING",
+      "AUTO",
+      "AUTO_INSURANCE",
+      "AUTO_RENTAL",
+      "BABY",
+      "BALLOT_INITIATIVE_OR_REFERENDUM",
+      "BEAUTY",
+      "BEAUTY_AND_FASHION",
+      "BEER_AND_WINE_AND_LIQUOR_AND_MALT_BEVERAGES",
+      "BOOKSTORES",
+      "BROADCAST_TELEVISION",
+      "BUSINESS_CONSULTANTS",
+      "BUYING_AGENCY",
+      "CABLE_AND_SATELLITE",
+      "CABLE_TELEVISION",
+      "CALL_CENTER_AND_MESSAGING_SERVICES",
+      "CANDIDATE_OR_POLITICIAN",
+      "CAREER",
+      "CAREER_AND_TECH",
+      "CASUAL_DINING",
+      "CHRONIC_CONDITIONS_AND_MEDICAL_CAUSES",
+      "CIVIC_INFLUENCERS",
+      "CLINICAL_TRIALS",
+      "COFFEE",
+      "COMPUTER_AND_SOFTWARE_AND_HARDWARE",
+      "CONSOLE_AND_CROSS_PLATFORM_GAMING",
+      "CONSULTING",
+      "CONSUMER_ELECTRONICS",
+      "COUNSELING_AND_PSYCHOTHERAPY",
+      "CREATIVE_AGENCY",
+      "CREDIT_AND_FINANCING_AND_MORTAGES",
+      "CRUISES_AND_MARINE",
+      "CULTURE_AND_LIFESTYLE",
+      "DATA_ANALYTICS_AND_DATA_MANAGEMENT",
+      "DATING_AND_TECHNOLOGY_APPS",
+      "DEPARTMENT_STORE",
+      "DESKTOP_SOFTWARE",
+      "DIETING_AND_FITNESS_PROGRAMS",
+      "DIGITAL_NATIVE_EDUCATION_OR_TRAINING",
+      "DRINKING_PLACES",
+      "EDUCATION_RESOURCES",
+      "ED_TECH",
+      "ELEARNING_AND_MASSIVE_ONLINE_OPEN_COURSES",
+      "ELECTION_COMMISSION",
+      "ELECTRONICS_AND_APPLIANCES",
+      "ENGINEERING_AND_DESIGN",
+      "ENVIRONMENT_AND_ANIMAL_WELFARE",
+      "ESPORTS",
+      "EVENTS",
+      "FARMING_AND_RANCHING",
+      "FILE_STORAGE_AND_CLOUD_AND_DATA_SERVICES",
+      "FINANCE",
+      "FIN_TECH",
+      "FISHING_AND_HUNTING_AND_FORESTRY_AND_LOGGING",
+      "FITNESS",
+      "FOOD",
+      "FOOTWEAR",
+      "FOR_PROFIT_COLLEGES_AND_UNIVERSITIES",
+      "FULL_SERVICE_AGENCY",
+      "GOVERNMENT_CONTROLLED_ENTITY",
+      "GOVERNMENT_DEPARTMENT_OR_AGENCY",
+      "GOVERNMENT_OFFICIAL",
+      "GOVERNMENT_OWNED_MEDIA",
+      "GROCERY_AND_DRUG_AND_CONVENIENCE",
+      "HEAD_OF_STATE",
+      "HEALTH_INSURANCE",
+      "HEALTH_SYSTEMS_AND_PRACTITIONERS",
+      "HEALTH_TECH",
+      "HOME_AND_FURNITURE_AND_OFFICE",
+      "HOME_IMPROVEMENT",
+      "HOME_INSURANCE",
+      "HOME_TECH",
+      "HOTEL_AND_ACCOMODATION",
+      "HOUSEHOLD_GOODS_DURABLE",
+      "HOUSEHOLD_GOODS_NON_DURABLE",
+      "HR_AND_FINANCIAL_MANAGEMENT",
+      "HUMANITARIAN_OR_DISASTER_RELIEF",
+      "INDEPENDENT_EXPENDITURE_GROUP",
+      "INSURANCE_TECH",
+      "INTERNATIONAL_ORGANIZATON",
+      "INVESTMENT_BANK_AND_BROKERAGE",
+      "ISSUE_ADVOCACY",
+      "LEGAL",
+      "LIFE_INSURANCE",
+      "LOGISTICS_AND_TRANSPORTATION_AND_FLEET_MANAGEMENT",
+      "MANUFACTURING",
+      "MEDICAL_DEVICES_AND_SUPPLIES_AND_EQUIPMENT",
+      "MEDSPA_AND_ELECTIVE_SURGERIES_AND_ALTERNATIVE_MEDICINE",
+      "MINING_AND_QUARRYING",
+      "MOBILE_GAMING",
+      "MOVIES",
+      "MUSEUMS_AND_PARKS_AND_LIBRARIES",
+      "MUSIC",
+      "NETWORK_SECURITY_PRODUCTS",
+      "NEWS_AND_CURRENT_EVENTS",
+      "NON_PRESCRIPTION",
+      "NOT_FOR_PROFIT_COLLEGES_AND_UNIVERSITIES",
+      "OFFICE",
+      "OFFICE_OR_BUSINESS_SUPPLIES",
+      "OIL_AND_GAS_AND_CONSUMABLE_FUEL",
+      "ONLINE_ONLY_PUBLICATIONS",
+      "PACKAGE_OR_FREIGHT_DELIVERY",
+      "PARTY_INDEPENDENT_EXPENDITURE_GROUP_US",
+      "PAYMENT_PROCESSING_AND_GATEWAY_SOLUTIONS",
+      "PC_GAMING",
+      "PEOPLE",
+      "PERSONAL_CARE",
+      "PET",
+      "PHOTOGRAPHY_AND_FILMING_SERVICES",
+      "PIZZA",
+      "PLANNING_AGENCY",
+      "POLITICAL_PARTY_OR_COMMITTEE",
+      "PRESCRIPTION",
+      "PROFESSIONAL_ASSOCIATIONS",
+      "PROPERTY_AND_CASUALTY",
+      "QUICK_SERVICE",
+      "RADIO",
+      "RAILROADS",
+      "REAL_ESTATE",
+      "REAL_MONEY_GAMING",
+      "RECREATIONAL",
+      "RELIGIOUS",
+      "RESELLER",
+      "RESIDENTIAL_AND_LONG_TERM_CARE_FACILITIES_AND_OUTPATIENT_CARE_CENTERS",
+      "RETAIL_AND_CREDIT_UNION_AND_COMMERCIAL_BANK",
+      "RIDE_SHARING_OR_TAXI_SERVICES",
+      "SAFETY_SERVICES",
+      "SCHOLARLY",
+      "SCHOOL_AND_EARLY_CHILDREN_EDCATION",
+      "SOCIAL_MEDIA",
+      "SOFTWARE_AS_A_SERVICE",
+      "SPORTING",
+      "SPORTING_AND_OUTDOOR",
+      "SPORTS",
+      "SUPERSTORES",
+      "T1_AUTOMOTIVE_MANUFACTURER",
+      "T1_MOTORCYCLE",
+      "T2_DEALER_ASSOCIATIONS",
+      "T3_AUTO_AGENCY",
+      "T3_AUTO_RESELLERS",
+      "T3_DEALER_GROUPS",
+      "T3_FRANCHISE_DEALER",
+      "T3_INDEPENDENT_DEALER",
+      "T3_PARTS_AND_SERVICES",
+      "T3_PORTALS",
+      "TELECOMMUNICATIONS_EQUIPMENT_AND_ACCESSORIES",
+      "TELEPHONE_SERVICE_PROVIDERS_AND_CARRIERS",
+      "TICKETING",
+      "TOBACCO",
+      "TOURISM_AND_TRAVEL_SERVICES",
+      "TOURISM_BOARD",
+      "TOY_AND_HOBBY",
+      "TRADE_SCHOOL",
+      "TRAVEL_AGENCIES_AND_GUIDES_AND_OTAS",
+      "UTILITIES_AND_ENERGY_EQUIPMENT_AND_SERVICES",
+      "VETERINARY_CLINICS_AND_SERVICES",
+      "VIDEO_STREAMING",
+      "VIRTUAL_SERVICES",
+      "VITAMINS_OR_WELLNESS",
+      "WAREHOUSING_AND_STORAGE",
+      "WATER_AND_SOFT_DRINK_AND_BAVERAGE",
+      "WEBSITE_DESIGNERS_OR_GRAPHIC_DESIGNERS",
+      "WHOLESALE",
+      "WIRELESS_SERVICES",
+    ]
+
+    VERTICAL_V2 = [
+      "ADVERTISING_AND_MARKETING",
+      "AGRICULTURE",
+      "AUTOMOTIVE",
+      "BANKING_AND_CREDIT_CARDS",
+      "BUSINESS_TO_BUSINESS",
+      "CONSUMER_PACKAGED_GOODS",
+      "ECOMMERCE",
+      "EDUCATION",
+      "ENERGY_AND_NATURAL_RESOURCES_AND_UTILITIES",
+      "ENTERTAINMENT_AND_MEDIA",
+      "GAMING",
+      "GOVERNMENT",
+      "HEALTHCARE_AND_PHARMACEUTICALS_AND_BIOTECH",
+      "INSURANCE",
+      "NON_PROFIT",
+      "ORGANIZATIONS_AND_ASSOCIATIONS",
+      "POLITICS",
+      "PROFESSIONAL_SERVICES",
+      "PUBLISHING",
+      "RESTAURANTS",
+      "RETAIL",
+      "TECHNOLOGY",
+      "TELECOM",
+      "TRAVEL",
+    ]
+
     ACTION_SOURCE = [
       "PHYSICAL_STORE",
       "WEBSITE",
@@ -670,6 +870,16 @@ module FacebookAds
       end
     end
 
+    has_edge :setup_managed_partner_adaccounts do |edge|
+      edge.post 'Business' do |api|
+        api.has_param :credit_line_id, 'string'
+        api.has_param :marketplace_business_id, 'string'
+        api.has_param :subvertical_v2, { enum: -> { Business::SUBVERTICAL_V2 }}
+        api.has_param :vendor_id, 'string'
+        api.has_param :vertical_v2, { enum: -> { Business::VERTICAL_V2 }}
+      end
+    end
+
     has_edge :system_users do |edge|
       edge.get 'SystemUser'
       edge.post 'SystemUser' do |api|

data/lib/facebook_ads/ad_objects/server_side/app_data.rb

@@ -0,0 +1,269 @@
+# Copyright (c) 2017-present, Facebook, Inc. All rights reserved.
+#
+# You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
+# copy, modify, and distribute this software in source code or binary form for use
+# in connection with the web services and APIs provided by Facebook.
+#
+# As with any software that integrates with the Facebook platform, your use of
+# this software is subject to the Facebook Platform Policy
+# [http://developers.facebook.com/policy/]. This copyright notice shall be
+# included in all copies or substantial portions of the software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+# FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+# COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+# IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+module FacebookAds
+    module ServerSide
+      # AppData which contains app data and device information for events happening from an app.
+      class AppData
+        # Use this field to specify ATT permission on an iOS 14.5+ device. Set to 0 for disabled or 1 for enabled.
+        attr_accessor :application_tracking_enabled
+
+        # A person can choose to enable ad tracking on an app level. Your SDK should allow an app developer to put an opt-out setting into their app. Use this field to specify the person's choice. Use 0 for disabled, 1 for enabled. `
+        attr_accessor :advertiser_tracking_enabled
+
+        # Specifies that view through data should be considered when determining the ad to attribute this install to. Clicks will always be considered first before views and views will only be returned if there was not a click on an ad for the app
+        attr_accessor :consider_views
+
+        # Extended device information, such as screen width and height.
+        attr_accessor :extinfo
+
+        # Specifies that view dwell ms should be returned as part of view through data
+        attr_accessor :include_dwell_data
+
+        # Specifies that video view completion percentages should be returned as part of view through data
+        attr_accessor :include_video_data
+
+        # Third party install referrer, currently available for Android only, see here for more.
+        attr_accessor :install_referrer
+
+        # Used internally by the Android SDKs
+        attr_accessor :installer_package
+
+        # Used internally by the iOS and Android SDKs.
+        attr_accessor :url_schemes
+
+        # Attribution token used for Windows 10.
+        attr_accessor :windows_attribution_id
+
+        # @param [Boolean] application_tracking_enabled
+        # @param [Boolean] advertiser_tracking_enabled
+        # @param [Boolean] consider_views
+        # @param [ExtendedDeviceInfo] extinfo
+        # @param [Boolean] include_dwell_data
+        # @param [Boolean] include_video_data
+        # @param [String] install_referrer
+        # @param [String] installer_package
+        # @param [Array<String>] url_schemes
+        # @param [String] windows_attribution_id
+        def initialize(application_tracking_enabled: nil,
+          advertiser_tracking_enabled: nil,
+          consider_views: nil,
+          extinfo: nil,
+          include_dwell_data: nil,
+          include_video_data: nil,
+          install_referrer: nil,
+          installer_package: nil,
+          url_schemes: nil,
+          windows_attribution_id: nil)
+
+          unless application_tracking_enabled.nil?
+            self.application_tracking_enabled = application_tracking_enabled
+          end
+          unless advertiser_tracking_enabled.nil?
+            self.advertiser_tracking_enabled = advertiser_tracking_enabled
+          end
+          unless consider_views.nil?
+            self.consider_views = consider_views
+          end
+          unless extinfo.nil?
+            self.extinfo = extinfo
+          end
+          unless include_dwell_data.nil?
+            self.include_dwell_data = include_dwell_data
+          end
+          unless include_video_data.nil?
+            self.include_video_data = include_video_data
+          end
+          unless install_referrer.nil?
+            self.install_referrer = install_referrer
+          end
+          unless installer_package.nil?
+            self.installer_package = installer_package
+          end
+          unless url_schemes.nil?
+            self.url_schemes = url_schemes
+          end
+          unless windows_attribution_id.nil?
+            self.windows_attribution_id = windows_attribution_id
+          end
+        end
+
+        # build the object using the input hash
+        # @param [Hash] attributes  attributes in the form of hash
+        def build(attributes = {})
+          return unless attributes.is_a?(Hash)
+
+          # convert string to symbol for hash key
+          attributes = attributes.each_with_object({}) { |(k, v), h| h[k.to_sym] = v }
+
+          if attributes.has_key?(:'application_tracking_enabled')
+            self.application_tracking_enabled = attributes[:'application_tracking_enabled']
+          end
+
+          if attributes.has_key?(:'advertiser_tracking_enabled')
+            self.advertiser_tracking_enabled = attributes[:'advertiser_tracking_enabled']
+          end
+
+          if attributes.has_key?(:'consider_views')
+            self.consider_views = attributes[:'consider_views']
+          end
+
+          if attributes.has_key?(:'extinfo')
+            self.extinfo = attributes[:'extinfo']
+          end
+
+          if attributes.has_key?(:'include_dwell_data')
+            self.include_dwell_data = attributes[:'include_dwell_data']
+          end
+
+
+          if attributes.has_key?(:'include_video_data')
+            self.include_video_data = attributes[:'include_video_data']
+          end
+
+          if attributes.has_key?(:'install_referrer')
+            self.install_referrer = attributes[:'install_referrer']
+          end
+
+          if attributes.has_key?(:'installer_package')
+            self.installer_package = attributes[:'installer_package']
+          end
+
+          if attributes.has_key?(:'url_schemes')
+            self.url_schemes = attributes[:'url_schemes']
+          end
+
+          if attributes.has_key?(:'windows_attribution_id')
+            self.windows_attribution_id = attributes[:'windows_attribution_id']
+          end
+        end
+
+      # Checks equality by comparing each attribute.
+      def ==(o)
+        return true if self.equal?(o)
+        self.class == o.class &&
+            application_tracking_enabled == o.application_tracking_enabled &&
+            advertiser_tracking_enabled == o.advertiser_tracking_enabled &&
+            consider_views == o.consider_views &&
+            extinfo == o.extinfo &&
+            include_dwell_data == o.include_dwell_data &&
+            include_video_data == o.include_video_data &&
+            install_referrer == o.install_referrer &&
+            installer_package == o.installer_package &&
+            url_schemes == o.url_schemes &&
+            windows_attribution_id == o.windows_attribution_id
+      end
+
+      # @see the `==` method
+      def eql?(o)
+        self == o
+      end
+
+      # Calculates hash code according to all attributes.
+      # @return [Fixnum] Hash code
+      def hash
+        [
+            application_tracking_enabled,
+            advertiser_tracking_enabled,
+            consider_views,
+            extinfo,
+            include_dwell_data,
+            include_video_data,
+            install_referrer,
+            installer_package,
+            url_schemes,
+            windows_attribution_id
+        ].hash
+      end
+
+      # Returns the string representation of the object
+      # @return [String] String presentation of the object
+      def to_s
+        hash = {}
+        unless vapplication_tracking_enabledalue.nil?
+          hash['application_tracking_enabled'] = application_tracking_enabled
+        end
+        unless advertiser_tracking_enabled.nil?
+          hash['advertiser_tracking_enabled'] = advertiser_tracking_enabled
+        end
+        unless consider_views.nil?
+          hash['consider_views'] = consider_views
+        end
+        unless extinfo.nil?
+          hash['extinfo'] = extinfo.to_s
+        end
+        unless include_dwell_data.nil?
+          hash['include_dwell_data'] = include_dwell_data
+        end
+        unless include_video_data.nil?
+          hash['include_video_data'] = include_video_data
+        end
+        unless install_referrer.nil?
+          hash['install_referrer'] = install_referrer
+        end
+        unless installer_package.nil?
+          hash['installer_package'] = installer_package
+        end
+        unless url_schemes.nil?
+          hash['url_schemes'] = url_schemes.to_s
+        end
+        unless windows_attribution_id.nil?
+          hash['windows_attribution_id'] = windows_attribution_id
+        end
+        hash.to_s
+      end
+
+      # Normalize input fields to server request format.
+      def normalize
+        hash = {}
+        unless application_tracking_enabled.nil?
+          hash['application_tracking_enabled'] = application_tracking_enabled
+        end
+        unless advertiser_tracking_enabled.nil?
+          hash['advertiser_tracking_enabled'] = advertiser_tracking_enabled
+        end
+        unless consider_views.nil?
+          hash['consider_views'] = consider_views
+        end
+        unless include_dwell_data.nil?
+          hash['include_dwell_data'] = include_dwell_data
+        end
+        unless include_video_data.nil?
+          hash['include_video_data'] = include_video_data
+        end
+        unless install_referrer.nil?
+          hash['install_referrer'] = install_referrer
+        end
+        unless installer_package.nil?
+          hash['installer_package'] = installer_package
+        end
+        unless url_schemes.nil?
+          hash['url_schemes'] = url_schemes
+        end
+        unless windows_attribution_id.nil?
+          hash['windows_attribution_id'] = windows_attribution_id
+        end
+
+        unless extinfo.nil?
+          hash['extinfo'] = extinfo.normalize
+        end
+        hash
+      end
+      end
+    end
+end

data/lib/facebook_ads/ad_objects/server_side/event.rb

@@ -18,6 +18,7 @@
 
 require_relative './user_data'
 require_relative './custom_data'
+require_relative './app_data'
 
 module FacebookAds
   module ServerSide
@@ -52,6 +53,9 @@ module FacebookAds
       # An Object that includes additional business data about the event.
       attr_accessor :custom_data
 
+      # An Object that contains app data.
+      attr_accessor :app_data
+
       # Processing options you would like to enable for a specific event.
       # For more details see https://developers.facebook.com/docs/marketing-apis/data-processing-options
       attr_accessor :data_processing_options
@@ -74,6 +78,7 @@ module FacebookAds
       # @param [String] event_id
       # @param [FacebookAds::ServerSide::UserData] user_data
       # @param [FacebookAds::ServerSide::CustomData] custom_data
+      # @param [FacebookAds::ServerSide::AppData] app_data
       # @param [Array<String>] data_processing_options
       # @param [int] data_processing_options_country
       # @param [int] data_processing_options_state
@@ -85,6 +90,7 @@ module FacebookAds
                      event_id: nil,
                      user_data: nil,
                      custom_data: nil,
+                     app_data: nil,
                      data_processing_options: nil,
                      data_processing_options_country: nil,
                      data_processing_options_state: nil,
@@ -111,6 +117,9 @@ module FacebookAds
         unless custom_data.nil?
           self.custom_data = custom_data
         end
+        unless app_data.nil?
+          self.app_data = app_data
+        end
         unless data_processing_options.nil?
           self.data_processing_options = data_processing_options
         end
@@ -161,6 +170,10 @@ module FacebookAds
           self.custom_data = attributes[:'custom_data']
         end
 
+        if attributes.has_key?(:'app_data')
+          self.app_data = attributes[:'app_data']
+        end
+
         if attributes.has_key?(:'data_processing_options')
           self.data_processing_options = attributes[:'data_processing_options']
         end
@@ -217,6 +230,7 @@ module FacebookAds
             event_id == o.event_id &&
             user_data == o.user_data &&
             custom_data == o.custom_data &&
+            app_data == o.app_data &&
             data_processing_options == o.data_processing_options &&
             data_processing_options_country == o.data_processing_options_country &&
             data_processing_options_state == o.data_processing_options_state &&
@@ -232,7 +246,7 @@ module FacebookAds
       # @return [Fixnum] Hash code
       def hash
         [
-          event_name, event_time, event_source_url, opt_out, event_id, user_data, custom_data,
+          event_name, event_time, event_source_url, opt_out, event_id, user_data, custom_data, app_data,
           data_processing_options, data_processing_options_country, data_processing_options_state,
           action_source,
         ].hash
@@ -261,6 +275,9 @@ module FacebookAds
         unless custom_data.nil?
           hash['custom_data'] = custom_data.to_s
         end
+        unless app_data.nil?
+          hash['app_data'] = app_data.to_s
+        end
         unless data_processing_options.nil?
           hash['data_processing_options'] = data_processing_options.to_s
         end
@@ -301,6 +318,9 @@ module FacebookAds
         unless custom_data.nil?
           hash['custom_data'] = custom_data.normalize
         end
+        unless app_data.nil?
+          hash['app_data'] = app_data.normalize
+        end
         unless data_processing_options.nil?
           hash['data_processing_options'] = data_processing_options
         end

data/lib/facebook_ads/ad_objects/server_side/extended_device_info.rb

@@ -0,0 +1,344 @@
+# Copyright (c) 2017-present, Facebook, Inc. All rights reserved.
+#
+# You are hereby granted a non-exclusive, worldwide, royalty-free license to use,
+# copy, modify, and distribute this software in source code or binary form for use
+# in connection with the web services and APIs provided by Facebook.
+#
+# As with any software that integrates with the Facebook platform, your use of
+# this software is subject to the Facebook Platform Policy
+# [http://developers.facebook.com/policy/]. This copyright notice shall be
+# included in all copies or substantial portions of the software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+# FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+# COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+# IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+# CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+
+module FacebookAds
+  module ServerSide
+    # ExtendedDeviceInfo, such as screen width and height. This parameter is an array and values are separated by commas.
+    class ExtendedDeviceInfo
+
+        attr_accessor :ext_info_version,
+                      :app_package_name,
+                      :short_version,
+                      :long_version,
+                      :os_version,
+                      :device_model_name,
+                      :locale,
+                      :timezone_abbreviation,
+                      :carrier,
+                      :screen_width,
+                      :screen_height,
+                      :screen_density,
+                      :cpu_core_count,
+                      :total_disk_space_gb,
+                      :free_disk_space_gb,
+                      :device_time_zone
+
+        # Initializes the object
+        # @param [String] ext_info_version
+        # @param [String] app_package_name
+        # @param [String] short_version
+        # @param [String] long_version
+        # @param [String] os_version
+        # @param [String] device_model_name
+        # @param [String] locale
+        # @param [String] timezone_abbreviation
+        # @param [String] carrier
+        # @param [String] screen_width
+        # @param [String] screen_height
+        # @param [String] screen_density
+        # @param [String] cpu_core_count
+        # @param [String] total_disk_space_gb
+        # @param [String] free_disk_space_gb
+        # @param [String] device_time_zone
+        def initialize(ext_info_version: nil, app_package_name: nil, short_version: nil, long_version: nil, os_version: nil, device_model_name: nil, locale: nil, timezone_abbreviation: nil,
+            carrier: nil, screen_width: nil, screen_height: nil, screen_density: nil, cpu_core_count: nil, total_disk_space_gb: nil, free_disk_space_gb: nil, device_time_zone: nil)
+            unless ext_info_version.nil?
+              self.ext_info_version = String(ext_info_version)
+            end
+            unless app_package_name.nil?
+              self.app_package_name = String(app_package_name)
+            end
+            unless short_version.nil?
+              self.short_version = String(short_version)
+            end
+            unless long_version.nil?
+              self.long_version = String(long_version)
+            end
+            unless os_version.nil?
+              self.os_version = String(os_version)
+            end
+            unless device_model_name.nil?
+              self.device_model_name = String(device_model_name)
+            end
+            unless locale.nil?
+              self.locale = String(locale)
+            end
+            unless timezone_abbreviation.nil?
+              self.timezone_abbreviation = String(timezone_abbreviation)
+            end
+            unless carrier.nil?
+                self.carrier = String(carrier)
+            end
+            unless screen_width.nil?
+                self.screen_width = String(screen_width)
+            end
+            unless screen_height.nil?
+                self.screen_height = String(screen_height)
+            end
+            unless screen_density.nil?
+                self.screen_density = String(screen_density)
+            end
+            unless cpu_core_count.nil?
+                self.cpu_core_count = String(cpu_core_count)
+            end
+            unless total_disk_space_gb.nil?
+                self.total_disk_space_gb = String(total_disk_space_gb)
+            end
+            unless free_disk_space_gb.nil?
+                self.free_disk_space_gb = String(free_disk_space_gb)
+            end
+            unless device_time_zone.nil?
+                self.device_time_zone = String(device_time_zone)
+            end
+        end
+
+        # build the object using the input hash
+        # @param [Hash] attributes  attributes in the form of hash
+        def build(attributes = {})
+            return unless attributes.is_a?(Hash)
+
+            # convert string to symbol for hash key
+            attributes = attributes.each_with_object({}) { |(k, v), h| h[k.to_sym] = v }
+
+            if attributes.has_key?(:'ext_info_version')
+                self.ext_info_version = attributes[:'ext_info_version']
+            end
+
+              if attributes.has_key?(:'app_package_name')
+                self.app_package_name = attributes[:'app_package_name']
+              end
+
+              if attributes.has_key?(:'short_version')
+                self.short_version = attributes[:'short_version']
+              end
+
+              if attributes.has_key?(:'long_version')
+                self.long_version = attributes[:'long_version']
+              end
+
+              if attributes.has_key?(:'os_version')
+                self.os_version = attributes[:'os_version']
+              end
+
+              if attributes.has_key?(:'device_model_name')
+                self.device_model_name = attributes[:'device_model_name']
+              end
+
+              if attributes.has_key?(:'locale')
+                self.locale = attributes[:'locale']
+              end
+
+              if attributes.has_key?(:'timezone_abbreviation')
+                self.timezone_abbreviation = attributes[:'timezone_abbreviation']
+              end
+
+              if attributes.has_key?(:'carrier')
+                self.carrier = attributes[:'carrier']
+              end
+
+              if attributes.has_key?(:'screen_width')
+                self.screen_width = attributes[:'screen_width']
+              end
+
+              if attributes.has_key?(:'screen_height')
+                self.screen_height = attributes[:'screen_height']
+              end
+
+              if attributes.has_key?(:'screen_density')
+                self.screen_density = attributes[:'screen_density']
+              end
+
+              if attributes.has_key?(:'cpu_core_count')
+                self.cpu_core_count = attributes[:'cpu_core_count']
+              end
+
+              if attributes.has_key?(:'total_disk_space_gb')
+                self.total_disk_space_gb = attributes[:'total_disk_space_gb']
+              end
+
+              if attributes.has_key?(:'free_disk_space_gb')
+                self.free_disk_space_gb = attributes[:'free_disk_space_gb']
+              end
+
+              if attributes.has_key?(:'device_time_zone')
+                self.device_time_zone = attributes[:'device_time_zone']
+              end
+        end
+
+
+        # Checks equality by comparing each attribute.
+        def ==(o)
+            return self.class == o.class &&
+                ext_info_version == o.ext_info_version &&
+                app_package_name == o.app_package_name &&
+                short_version == o.short_version &&
+                long_version == o.long_version &&
+                os_version == o.os_version &&
+                device_model_name == o.device_model_name &&
+                locale == o.locale &&
+                timezone_abbreviation == o.timezone_abbreviation &&
+                carrier == o.carrier &&
+                screen_width == o.screen_width &&
+                screen_height == o.screen_height &&
+                screen_density == o.screen_density &&
+                cpu_core_count == o.cpu_core_count &&
+                total_disk_space_gb == o.total_disk_space_gb &&
+                free_disk_space_gb == o.free_disk_space_gb &&
+                device_time_zone == o.device_time_zone
+        end
+
+        # @see the `==` method
+        def eql?(o)
+            self == o
+        end
+
+        # Calculates hash code according to all attributes.
+        # @return [Fixnum] Hash code
+        def hash
+            [
+                ext_info_version,
+                app_package_name,
+                short_version,
+                long_version,
+                os_version,
+                device_model_name,
+                locale,
+                timezone_abbreviation,
+                carrier,
+                screen_width,
+                screen_height,
+                screen_density,
+                cpu_core_count,
+                total_disk_space_gb,
+                free_disk_space_gb,
+                device_time_zone
+            ].hash
+        end
+
+        # Returns the string representation of the object
+        # @return [String] String presentation of the object
+        def to_s
+          hash = {}
+          unless ext_info_version.nil?
+            hash['ext_info_version'] = ext_info_version
+          end
+          unless app_package_name.nil?
+            hash['app_package_name'] = app_package_name
+          end
+          unless short_version.nil?
+            hash['short_version'] = short_version
+          end
+          unless long_version.nil?
+            hash['long_version'] = long_version
+          end
+          unless os_version.nil?
+            hash['os_version'] = os_version
+          end
+          unless device_model_name.nil?
+            hash['device_model_name'] = device_model_name
+          end
+          unless locale.nil?
+            hash['locale'] = locale
+          end
+          unless timezone_abbreviation.nil?
+            hash['timezone_abbreviation'] = timezone_abbreviation
+          end
+          unless carrier.nil?
+            hash['carrier'] = carrier
+          end
+          unless screen_width.nil?
+            hash['screen_width'] = screen_width
+          end
+          unless screen_height.nil?
+            hash['screen_height'] = screen_height
+          end
+          unless screen_density.nil?
+            hash['screen_density'] = screen_density
+          end
+          unless cpu_core_count.nil?
+            hash['cpu_core_count'] = cpu_core_count
+          end
+          unless total_disk_space_gb.nil?
+            hash['total_disk_space_gb'] = total_disk_space_gb
+          end
+          unless free_disk_space_gb.nil?
+            hash['free_disk_space_gb'] = free_disk_space_gb
+          end
+          unless device_time_zone.nil?
+            hash['device_time_zone'] = device_time_zone
+          end
+          hash.to_s
+        end
+
+        # Normalize input fields to server request format.
+        def normalize
+          ext_info_array = []
+          unless ext_info_version.nil?
+            ext_info_array.push(ext_info_version)
+          end
+          unless app_package_name.nil?
+            ext_info_array.push(app_package_name)
+          end
+          unless short_version.nil?
+            ext_info_array.push(short_version)
+          end
+          unless long_version.nil?
+            ext_info_array.push(long_version)
+          end
+          unless os_version.nil?
+            ext_info_array.push(os_version)
+          end
+          unless device_model_name.nil?
+            ext_info_array.push(device_model_name)
+          end
+          unless locale.nil?
+            ext_info_array.push(locale)
+          end
+          unless timezone_abbreviation.nil?
+            ext_info_array.push(timezone_abbreviation)
+          end
+          unless carrier.nil?
+            ext_info_array.push(carrier)
+          end
+          unless screen_width.nil?
+            ext_info_array.push(screen_width)
+          end
+          unless screen_height.nil?
+            ext_info_array.push(screen_height)
+          end
+          unless screen_density.nil?
+            ext_info_array.push(screen_density)
+          end
+          unless cpu_core_count.nil?
+            ext_info_array.push(cpu_core_count)
+          end
+          unless total_disk_space_gb.nil?
+            ext_info_array.push(total_disk_space_gb)
+          end
+          unless free_disk_space_gb.nil?
+            ext_info_array.push(free_disk_space_gb)
+          end
+          unless device_time_zone.nil?
+            ext_info_array.push(device_time_zone)
+          end
+          ext_info_array
+        end
+    end
+  end
+end

data/lib/facebook_ads/ad_objects/server_side/user_data.rb

@@ -216,6 +216,27 @@ module FacebookAds
       # The date of birth year.
       attr_accessor :doby
 
+      # Your Install ID. This field represents unique application installation instances.
+      attr_accessor :anon_ids
+
+      def anon_id
+        @anon_ids ? @anon_ids[0] : nil
+      end
+      def anon_id=(anon_id)
+        @anon_ids = [anon_id]
+      end
+
+      # Your mobile advertiser ID, the advertising ID from an Android device or the Advertising Identifier (IDFA) from an Apple device.
+      attr_accessor :madids
+
+      def madid
+        @madids ? @madids[0] : nil
+      end
+      def madid=(madid)
+        @madids = [madid]
+      end
+
+
       #UserData is a set of identifiers Facebook can use for targeted attribution
       # @param [String] email
       # @param [Array<String>] emails
@@ -251,13 +272,17 @@ module FacebookAds
       # @param [String] dobd
       # @param [String] dobm
       # @param [String] doby
+      # @param [String] anon_id
+      # @param [Array<String>] anon_ids
+      # @param [String] madid
+      # @param [Array<String>] madids
       def initialize(email: nil, emails: nil, phone: nil, phones: nil, gender: nil, genders: nil,
                      date_of_birth: nil, dates_of_birth: nil, last_name: nil, last_names: nil,
                      first_name: nil, first_names: nil, city: nil, cities: nil, state: nil, states: nil,
                      country_code: nil, country_codes: nil, zip_code: nil, zip_codes: nil,
                      external_id: nil, external_ids: nil, client_ip_address: nil,
                      client_user_agent: nil, fbc: nil, fbp: nil, subscription_id: nil, lead_id: nil,
-                     f5first: nil, f5last: nil, fi: nil, dobd: nil, dobm: nil, doby: nil)
+                     f5first: nil, f5last: nil, fi: nil, dobd: nil, dobm: nil, doby: nil, anon_id: nil, anon_ids: nil, madid:nil, madids: nil)
         validate_constructor_values(emails, email, 'emails', 'email')
         validate_constructor_values(phones, phone, 'phones', 'phone')
         validate_constructor_values(genders, gender, 'genders', 'gender')
@@ -372,6 +397,18 @@ module FacebookAds
         unless doby.nil?
           self.doby = doby
         end
+        unless anon_id.nil?
+          self.anon_id = anon_id
+        end
+        unless anon_ids.nil?
+          self.anon_ids = anon_ids
+        end
+        unless madid.nil?
+          self.madid = madid
+        end
+        unless madids.nil?
+          self.madids = madids
+        end
       end
 
       # build the object using the input hash
@@ -491,6 +528,18 @@ module FacebookAds
         if attributes.has_key?(:'doby')
           self.doby = attributes[:'doby']
         end
+
+        if attributes.has_key?(:'anon_ids')
+          self.anon_ids = attributes[:'anon_ids']
+        elsif attributes.has_key?(:'anon_id')
+          self.anon_ids = [attributes[:'anon_id']]
+        end
+
+        if attributes.has_key?(:'madids')
+          self.madids = attributes[:'madids']
+        elsif attributes.has_key?(:'madid')
+          self.madids = [attributes[:'madid']]
+        end
       end
 
       # Checks equality by comparing each attribute.
@@ -519,7 +568,9 @@ module FacebookAds
             fi == o.fi &&
             dobd == o.dobd &&
             dobm == o.dobm &&
-            doby == o.doby
+            doby == o.doby &&
+            anon_ids == o.anon_ids &&
+            madids == o.madids
       end
 
       # @see the `==` method
@@ -554,6 +605,8 @@ module FacebookAds
             dobd,
             dobm,
             doby,
+            anon_ids,
+            madids
         ].hash
 
       end
@@ -631,6 +684,12 @@ module FacebookAds
         unless doby.nil?
           hash['doby'] = doby
         end
+        unless anon_ids.nil?
+          hash['anon_ids'] = anon_ids
+        end
+        unless madids.nil?
+          hash['madids'] = madids
+        end
         hash.to_s
       end
 
@@ -707,6 +766,12 @@ module FacebookAds
         unless doby.nil?
           hash['doby'] = FacebookAds::ServerSide::Util.normalize(doby, 'doby')
         end
+        unless anon_id.nil?
+          hash['anon_id'] = anon_ids
+        end
+        unless madid.nil?
+          hash['madid'] = madids
+        end
         hash.select{|k, v| !v.nil?}
       end
 

data/lib/facebook_ads/version.rb

@@ -19,6 +19,6 @@
 # FB:AUTOGEN
 
 module FacebookAds
-  VERSION = '0.16.0.0'
+  VERSION = '0.16.0.2'
   API_VERSION = '16.0'
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: facebookbusiness
 version: !ruby/object:Gem::Version
-  version: 0.16.0.0
+  version: 0.16.0.2
 platform: ruby
 authors:
 - Facebook
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-02-03 00:00:00.000000000 Z
+date: 2023-03-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -616,6 +616,7 @@ files:
 - lib/facebook_ads/ad_objects/saved_message_response.rb
 - lib/facebook_ads/ad_objects/security_settings.rb
 - lib/facebook_ads/ad_objects/server_side/action_source.rb
+- lib/facebook_ads/ad_objects/server_side/app_data.rb
 - lib/facebook_ads/ad_objects/server_side/batch_processor.rb
 - lib/facebook_ads/ad_objects/server_side/content.rb
 - lib/facebook_ads/ad_objects/server_side/custom_data.rb
@@ -624,6 +625,7 @@ files:
 - lib/facebook_ads/ad_objects/server_side/event_request.rb
 - lib/facebook_ads/ad_objects/server_side/event_request_async.rb
 - lib/facebook_ads/ad_objects/server_side/event_response.rb
+- lib/facebook_ads/ad_objects/server_side/extended_device_info.rb
 - lib/facebook_ads/ad_objects/server_side/http_method.rb
 - lib/facebook_ads/ad_objects/server_side/http_service_interface.rb
 - lib/facebook_ads/ad_objects/server_side/http_util.rb