mirror of
https://github.com/ecency/ecency-mobile.git
synced 2024-12-21 12:21:31 +03:00
145 lines
4.4 KiB
Objective-C
145 lines
4.4 KiB
Objective-C
#import <Foundation/Foundation.h>
|
|
|
|
#import "MSAnalyticsAuthenticationProvider.h"
|
|
#import "MSConstants+Flags.h"
|
|
#import "MSPropertyConfigurator.h"
|
|
|
|
@class MSEventProperties;
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
@interface MSAnalyticsTransmissionTarget : NSObject
|
|
|
|
/**
|
|
* Property configurator.
|
|
*/
|
|
@property(nonatomic, readonly) MSPropertyConfigurator *propertyConfigurator;
|
|
|
|
+ (void)addAuthenticationProvider:(MSAnalyticsAuthenticationProvider *)authenticationProvider
|
|
NS_SWIFT_NAME(addAuthenticationProvider(authenticationProvider:));
|
|
|
|
/**
|
|
* Track an event.
|
|
*
|
|
* @param eventName event name.
|
|
*/
|
|
- (void)trackEvent:(NSString *)eventName;
|
|
|
|
/**
|
|
* Track an event.
|
|
*
|
|
* @param eventName event name.
|
|
* @param properties dictionary of properties.
|
|
*/
|
|
- (void)trackEvent:(NSString *)eventName withProperties:(nullable NSDictionary<NSString *, NSString *> *)properties;
|
|
|
|
/**
|
|
* Track an event.
|
|
*
|
|
* @param eventName event name.
|
|
* @param properties dictionary of properties.
|
|
* @param flags Optional flags. Events tracked with the MSFlagsPersistenceCritical flag will take precedence over all other events in
|
|
* storage. An event tracked with this option will only be dropped if storage must make room for a newer event that is also marked with the
|
|
* MSFlagsPersistenceCritical flag.
|
|
*/
|
|
- (void)trackEvent:(NSString *)eventName withProperties:(nullable NSDictionary<NSString *, NSString *> *)properties flags:(MSFlags)flags;
|
|
|
|
/**
|
|
* Track a custom event with name and optional typed properties.
|
|
*
|
|
* @param eventName Event name.
|
|
* @param properties Typed properties.
|
|
*
|
|
* @discussion The following validation rules are applied:
|
|
*
|
|
* The name cannot be null or empty.
|
|
*
|
|
* The property names or values cannot be null.
|
|
*
|
|
* Double values must be finite (NaN or Infinite values are discarded).
|
|
*
|
|
* Additional validation rules apply depending on the configured secret.
|
|
*
|
|
* - The event name needs to match the `[a-zA-Z0-9]((\.(?!(\.|$)))|[_a-zA-Z0-9]){3,99}` regular expression.
|
|
*
|
|
* - The `baseData` and `baseDataType` properties are reserved and thus discarded.
|
|
*
|
|
* - The full event size when encoded as a JSON string cannot be larger than 1.9MB.
|
|
*/
|
|
- (void)trackEvent:(NSString *)eventName
|
|
withTypedProperties:(nullable MSEventProperties *)properties NS_SWIFT_NAME(trackEvent(_:withProperties:));
|
|
|
|
/**
|
|
* Track a custom event with name and optional typed properties.
|
|
*
|
|
* @param eventName Event name.
|
|
* @param properties Typed properties.
|
|
* @param flags Optional flags. Events tracked with the MSFlagsPersistenceCritical flag will take precedence over all other events in
|
|
* storage. An event tracked with this option will only be dropped if storage must make room for a newer event that is also marked with the
|
|
* MSFlagsPersistenceCritical flag.
|
|
*
|
|
* @discussion The following validation rules are applied:
|
|
*
|
|
* The name cannot be null or empty.
|
|
*
|
|
* The property names or values cannot be null.
|
|
*
|
|
* Double values must be finite (NaN or Infinite values are discarded).
|
|
*
|
|
* Additional validation rules apply depending on the configured secret.
|
|
*
|
|
* - The event name needs to match the `[a-zA-Z0-9]((\.(?!(\.|$)))|[_a-zA-Z0-9]){3,99}` regular expression.
|
|
*
|
|
* - The `baseData` and `baseDataType` properties are reserved and thus discarded.
|
|
*
|
|
* - The full event size when encoded as a JSON string cannot be larger than 1.9MB.
|
|
*/
|
|
- (void)trackEvent:(NSString *)eventName
|
|
withTypedProperties:(nullable MSEventProperties *)properties
|
|
flags:(MSFlags)flags NS_SWIFT_NAME(trackEvent(_:withProperties:flags:));
|
|
|
|
/**
|
|
* Get a nested transmission target.
|
|
*
|
|
* @param token The token of the transmission target to retrieve.
|
|
*
|
|
* @returns A transmission target object nested to this parent transmission target.
|
|
*/
|
|
- (MSAnalyticsTransmissionTarget *)transmissionTargetForToken:(NSString *)token NS_SWIFT_NAME(transmissionTarget(forToken:));
|
|
|
|
/**
|
|
* Enable or disable this transmission target. It will also enable or disable nested transmission targets.
|
|
*
|
|
* @param isEnabled YES to enable, NO to disable.
|
|
*
|
|
* @see isEnabled
|
|
*/
|
|
- (void)setEnabled:(BOOL)isEnabled;
|
|
|
|
/**
|
|
* Check whether this transmission target is enabled or not.
|
|
*
|
|
* @return YES if enabled, NO otherwise.
|
|
*
|
|
* @see setEnabled:
|
|
*/
|
|
- (BOOL)isEnabled;
|
|
|
|
/**
|
|
* Pause sending logs for the transmission target. It doesn't pause any of its decendants.
|
|
*
|
|
* @see resume
|
|
*/
|
|
- (void)pause;
|
|
|
|
/**
|
|
* Resume sending logs for the transmission target.
|
|
*
|
|
* @see pause
|
|
*/
|
|
- (void)resume;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|