forked from parse-community/Parse-SDK-iOS-OSX
-
Notifications
You must be signed in to change notification settings - Fork 0
/
Copy pathPFAnalytics.h
167 lines (127 loc) · 6.83 KB
/
PFAnalytics.h
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
/**
* Copyright (c) 2015-present, Parse, LLC.
* All rights reserved.
*
* This source code is licensed under the BSD-style license found in the
* LICENSE file in the root directory of this source tree. An additional grant
* of patent rights can be found in the PATENTS file in the same directory.
*/
#import <Foundation/Foundation.h>
#import <Bolts/BFTask.h>
#import <Parse/PFConstants.h>
NS_ASSUME_NONNULL_BEGIN
/**
`PFAnalytics` provides an interface to Parse's logging and analytics backend.
Methods will return immediately and cache the request (+ timestamp) to be
handled "eventually." That is, the request will be sent immediately if possible
or the next time a network connection is available.
*/
@interface PFAnalytics : NSObject
///--------------------------------------
#pragma mark - App-Open / Push Analytics
///--------------------------------------
/**
Tracks this application being launched. If this happened as the result of the
user opening a push notification, this method sends along information to
correlate this open with that push.
Pass in `nil` to track a standard "application opened" event.
@param launchOptions The `NSDictionary` indicating the reason the application was
launched, if any. This value can be found as a parameter to various
`UIApplicationDelegate` methods, and can be empty or `nil`.
@return Returns the task encapsulating the work being done.
*/
+ (BFTask<NSNumber *> *)trackAppOpenedWithLaunchOptions:(nullable NSDictionary *)launchOptions;
/**
Tracks this application being launched.
If this happened as the result of the user opening a push notification,
this method sends along information to correlate this open with that push.
Pass in `nil` to track a standard "application opened" event.
@param launchOptions The dictionary indicating the reason the application was
launched, if any. This value can be found as a parameter to various
`UIApplicationDelegate` methods, and can be empty or `nil`.
@param block The block to execute on server response.
It should have the following argument signature: `^(BOOL succeeded, NSError *error)`
*/
+ (void)trackAppOpenedWithLaunchOptionsInBackground:(nullable NSDictionary *)launchOptions
block:(nullable PFBooleanResultBlock)block;
/**
Tracks this application being launched. If this happened as the result of the
user opening a push notification, this method sends along information to
correlate this open with that push.
@param userInfo The Remote Notification payload, if any. This value can be
found either under `UIApplicationLaunchOptionsRemoteNotificationKey` on `launchOptions`,
or as a parameter to `application:didReceiveRemoteNotification:`.
This can be empty or `nil`.
@return Returns the task encapsulating the work being done.
*/
+ (BFTask<NSNumber *> *)trackAppOpenedWithRemoteNotificationPayload:(nullable NSDictionary *)userInfo;
/**
Tracks this application being launched. If this happened as the result of the
user opening a push notification, this method sends along information to
correlate this open with that push.
@param userInfo The Remote Notification payload, if any. This value can be
found either under `UIApplicationLaunchOptionsRemoteNotificationKey` on `launchOptions`,
or as a parameter to `application:didReceiveRemoteNotification:`. This can be empty or `nil`.
@param block The block to execute on server response.
It should have the following argument signature: `^(BOOL succeeded, NSError *error)`
*/
+ (void)trackAppOpenedWithRemoteNotificationPayloadInBackground:(nullable NSDictionary *)userInfo
block:(nullable PFBooleanResultBlock)block;
///--------------------------------------
#pragma mark - Custom Analytics
///--------------------------------------
/**
Tracks the occurrence of a custom event.
Parse will store a data point at the time of invocation with the given event name.
@param name The name of the custom event to report to Parse as having happened.
@return Returns the task encapsulating the work being done.
*/
+ (BFTask<NSNumber *> *)trackEvent:(NSString *)name;
/**
Tracks the occurrence of a custom event. Parse will store a data point at the
time of invocation with the given event name. The event will be sent at some
unspecified time in the future, even if Parse is currently inaccessible.
@param name The name of the custom event to report to Parse as having happened.
@param block The block to execute on server response.
It should have the following argument signature: `^(BOOL succeeded, NSError *error)`
*/
+ (void)trackEventInBackground:(NSString *)name block:(nullable PFBooleanResultBlock)block;
/**
Tracks the occurrence of a custom event with additional dimensions. Parse will
store a data point at the time of invocation with the given event name.
Dimensions will allow segmentation of the occurrences of this custom event.
Keys and values should be NSStrings, and will throw otherwise.
To track a user signup along with additional metadata, consider the following:
NSDictionary *dimensions = @{ @"gender": @"m",
@"source": @"web",
@"dayType": @"weekend" };
[PFAnalytics trackEvent:@"signup" dimensions:dimensions];
@warning There is a default limit of 8 dimensions per event tracked.
@param name The name of the custom event to report to Parse as having happened.
@param dimensions The `NSDictionary` of information by which to segment this event.
@return Returns the task encapsulating the work being done.
*/
+ (BFTask<NSNumber *> *)trackEvent:(NSString *)name
dimensions:(nullable NSDictionary<NSString *, NSString *> *)dimensions;
/**
Tracks the occurrence of a custom event with additional dimensions. Parse will
store a data point at the time of invocation with the given event name. The
event will be sent at some unspecified time in the future, even if Parse is currently inaccessible.
@discussion Dimensions will allow segmentation of the occurrences of this custom event.
Keys and values should be NSStrings, and will throw otherwise.
To track a user signup along with additional metadata, consider the following:
NSDictionary *dimensions = @{ @"gender": @"m",
@"source": @"web",
@"dayType": @"weekend" };
[PFAnalytics trackEvent:@"signup" dimensions:dimensions];
There is a default limit of 8 dimensions per event tracked.
@param name The name of the custom event to report to Parse as having happened.
@param dimensions The `NSDictionary` of information by which to segment this event.
@param block The block to execute on server response.
It should have the following argument signature: `^(BOOL succeeded, NSError *error)`
*/
+ (void)trackEventInBackground:(NSString *)name
dimensions:(nullable NSDictionary<NSString *, NSString *> *)dimensions
block:(nullable PFBooleanResultBlock)block;
@end
NS_ASSUME_NONNULL_END