TMBDiscoverBasicParams
@interface TMBDiscoverBasicParams : NSObject <TMBObjectEncodable>
An object representing parameters used to retrieve discoveries. Not all parameters are needed for all requests. - see: https://tamber.com/docs/api/#discover
-
The simplest way to get
TMBDiscoverBasicParams
for user recommendations – only set the number of recommended items (TMBDiscovery
objects) you want to return.Declaration
Objective-C
+ (nullable instancetype)discoverRecommendations:(nullable NSNumber *)number;
Swift
class func discoverRecommendations(_ number: NSNumber?) -> Self?
Parameters
number
Number of recommendations to return.
-
Expanded discover params for user recommendations.
Declaration
Objective-C
+ (nullable instancetype)discoverRecommendations:(nullable NSNumber *)number page:(nullable NSNumber *)page filter:(nullable NSDictionary *)filter getProperties:(BOOL)getProperties testEvents:(nullable NSArray *)testEvents;
Swift
class func discoverRecommendations(_ number: NSNumber?, page: NSNumber?, filter: [AnyHashable : Any]?, getProperties: Bool, testEvents: [Any]?) -> Self?
Parameters
number
Number of recommendations to return. Maximum of 500.
page
The page of recommended items to return.
filter
The filter to apply on the discoveries. See https://tamber.com/docs/api/#filtering and our filtering guide at https://tamber.com/docs/guides/filtering.html for reference.
getProperties
Include items’ properties and tags in the discovery objects.
testEvents
Recommendations will be made as if the supplied events had occurred, but the engine will not be affected in any way. Also works if the user that has not yet been created, allowing you to see what a visiting user’s recommendations would be. Warning: recommendations with test_events are generated at a lower priority of computational resources and are not representative of recommendation API performance.
-
Discover params for user recommendations.
Declaration
Objective-C
+ (nullable instancetype)discoverParamsWithUser:(nullable NSString *)user number:(nullable NSNumber *)number;
Swift
class func discover(withUser user: String?, number: NSNumber?) -> Self?
Parameters
user
User’s unique identifier.
number
Number of recommendations to return.
-
Initialize discover params for user recommendations.
Declaration
Objective-C
- (nullable instancetype)initWithUser:(nullable NSString *)user item:(nullable NSString *)item number:(nullable NSNumber *)number page:(nullable NSNumber *)page filter:(nullable NSDictionary *)filter getProperties:(BOOL)getProperties testEvents:(nullable NSArray *)testEvents;
Swift
init?(user: String?, item: String?, number: NSNumber?, page: NSNumber?, filter: [AnyHashable : Any]?, getProperties: Bool, testEvents: [Any]?)
Parameters
user
User’s unique identifier. Used for discover-recommended and discover-recommended_similar.
item
Item’s unique identifier. Used for discover-similar and discover-recommended_similar.
number
Number of recommendations to return. Maximum of 500.
page
The page of recommended items to return.
filter
The filter to apply on the discoveries. See https://tamber.com/docs/api/#filtering and our filtering guide at https://tamber.com/docs/guides/filtering.html for reference.
getProperties
Include items’ properties and tags in the discovery objects.
testEvents
Recommendations will be made as if the supplied events had occurred, but the engine will not be affected in any way. Also works if the user that has not yet been created, allowing you to see what a visiting user’s recommendations would be. Warning: recommendations with test_events are generated at a lower priority of computational resources and are not representative of recommendation API performance.