Shulou(Shulou.com)06/03 Report--

Recently, the business side has put forward new requirements for our department, hoping to make one-stop statistics of several important items of APP data. What we are trying to use this time is the "number of application statistics", a newly launched product of Tweet (which used to specialize in message push). According to the official statement, the push data statistics product through professional mobile application data analysis, can provide real-time data statistical analysis services for users' applications, including understanding version quality, channel status, user portraits and so on. The data is finally presented in a visual form, which is intuitive. We tried it for a while and found that it worked very well. This article will show you how to integrate the number of iOS SDK quickly and efficiently from scratch.

Log in to the account and create an application to obtain APP ID

1. Visit the push developer Center and click to register now:

(you can also enter www.getui.com from an official website and click "developer Center" in the upper right corner. Of course, if you have already signed up for a push account, you can log in and use it directly.

2. Fill in and register the account number according to your personal situation:

3. Go back to the push developer Center and log in with the account registered in the previous step. After entering the developer platform panel, select the number of menu bars on the left to apply statistics:

4. After entering the statistics panel of the number of applications, select the new application in the upper right corner to add a new application:

5. Enter the information related to the application, check iOS, and click to submit the new application:

6. If the new application is successful, it will automatically return to the application list, find the new application, and click apply configuration:

7. You can see APP ID under configuration information, copy and save it, and APP ID will be used in subsequent integration:

2. Configure the number of SDK

The number of iOS SDK provides two integration methods, namely CocoaPods integration and Xcode manual integration, both of which are described in this article. You can choose one of these when integrating SDK (CocoaPods integration is recommended).

Third, CocoaPods integration mode

1. Install CocoaPods

The installation method is very simple. Ruby is included in Mac. You can download and install it by using the gem command of ruby:

$sudo gem install cocoapods

$pod setup

2. Prepare Podfile

When using it, you need to create a new file named Podfile (if the file already exists, you do not need to recreate it). In the following format, list the dependent library names in the file in turn:

Target 'YourTargetName' do

Platform: ios, "8.0"

Pod 'GCSDK'

End

3. Complete the import of GCSDK

Put the edited Podfile file in the root directory of your project and execute the following command:

$cd ""

$pod install

4. After integrating SDK with CocosPods, you need to close the original project and reopen the yourProjectName.xcworkspace file in the project root directory for subsequent development:

IV. Xcode integration mode

1. Number of Apps Statistics provides a SDK development kit that contains all the required resources of iOS SDK. Go to the push document Center to download the SDK resource kit at http://docs.getui.com/download.html, and select the iOS side under the number of Apps Statistics to download the SDK resource package:

2. Decompress the contents of the resource package to see the following file structure:

3. Detailed explanation of the content of the resource package

Access documents / number integration documents. Pdf: number integration documents

Resource file / GTCountSDK.h: number of SDK header files

Resource file / libGTCountSDK.a: number of SDK main package static library

Resource files / libGTCommonSDK.a: number of SDK tool libraries

Demo Project / number of GTCountDemo/: demo Project

4. Note: libGTCountSDK.an and libGTCommonSDK.a use lipo tools to set

The code that supports i386, x86, 64, arm64, and armv7 is packaged together, so this library will support both simulator and device, and support iOS version 7.0 or above.

5. Set the number of SDK static libraries

Right-click to add files to import the files in the resource files directory.

6. Add dependent libraries (required, as shown below)

Add system library support:

Libsqlit3.tbdlibz.tbdAdSupport.framework

7. Set Other Linker Flags

Locate target-> Build Setting-> Linking-> Other Linker Flags of the main project and set it to-ObjC (as shown):

Initialize and start SDK

1. Initialize the information about the startup API:

2. Add the header file to the AppDelegate.m of the project project, and initialize and start the SDK using the APP ID obtained earlier:

# import 'GTCountSDK.h'

# define kGcAppId @ "xxxxxxx"

@ implementation AppDelegate

(BOOL) application: (UIApplication) application didFinishLaunchingWithOptions: (NSDictionary) launchOptions {

/ / number of launches SDK

[GTCountSDK startSDKWithAppId:kGcAppId withChannelId:@ "appstore"]

/ / use the reportStrategy attribute of the SDK instance to set the reporting policy.

[[GTCountSDK sharedInstance] setReportStrategy:GESHU_STRATEGY_WIFI_ONLY]

/ / use the sessionTime property of the SDK instance to get the value of sessionTime.

NSLog (@ "sessionTime% ld", [[GTCountSDK sharedInstance] sessionTime])

Return YES

}

VI. advanced functions: custom events

Custom events can count the occurrence time and number of user-defined burial sites, such as ad clicks, the number of text messages, and so on. Event_id is usually used to represent the statistics of a certain behavior or function (such as counting how many times the "send" button has been triggered), while parameters are used to identify the specific object of the statistics (such as the button with the function of "download"), and event_id and properties uniquely identify an event.

There are two main types of custom events:

(1) Frequency statistics: count the number of times a specified behavior is triggered.

(2) time statistics: count the time consumed by the specified behavior (in seconds). EventBegin and eventEnd interfaces need to be used in pairs to take effect.

Each of these events supports the use of the properties parameter type.

Note: event_id needs to be configured in the push developer Center (https://dev.getui.com/) before it can participate in normal data statistics. Event_id cannot contain spaces or escape characters, as follows:

1. Click the event list in the side menu bar.

2. Click the add event button.

3. Enter the corresponding event ID and event name according to the event type.

4. Add the corresponding event type and event_id event to the mobile project:

@ implementation TrackCountEventController

(IBAction) clickCount: (id) sender {

[GTCountSDK trackCountEvent:@ "countid1" withArgs:@ {@ "ckey1": @ "cvalue1"}]

}

-(void) viewDidAppear: (BOOL) animated {

/ / in order to count correctly, make sure that the parameter self.eventProperty memory addresses of the start and end interfaces are the same.

Self.eventProperty = @ {@ "key": @ "value1"}

[GTCountSDK trackCustomKeyValueEventBegin:@ "eid1" withArgs:self.eventProperty]

[super viewDidAppear:animated]

}

(void) viewWillDisappear: (BOOL) animated {

[GTCountSDK trackCustomKeyValueEventEnd:@ "eid1" withArgs:self.eventProperty]

[super viewWillDisappear:animated]

}

@ end

Advanced functions: data reporting strategy

The statistics of the number of applications can customize the data reporting policy, and developers can set them according to their own application needs, which can effectively control the user traffic overhead.

1. SDK's data reporting policies include the following five types (default is GESHU_STRATEGY_PERIOD, cycle is 60 minutes):

2. Note: the data reporting policy is recommended to be set when the application starts. The data reporting policy is set and viewed using the following interfaces:

/ *

Set escalation policy

/

@ property (nonatomic,assign) GeShuStatReportStrategyType reportStrategy

3. Reporting strategy in WIFI environment

Considering the low cost of reporting data in the WIFI network environment, the real-time reporting strategy is used by default in the WIFI environment. To turn off the policy, you can call the following API to shut down:

/ *

Intelligent reporting

When enabled, the device connected to WIFI will be reported in real time.

Otherwise, it is reported according to the global policy.

On by default

/

@ property (nonatomic, assign) BOOL smartReporting

4. Data reporting policy-related APIs

/ *

When the statistical reporting policy is BATCH, the minimum number of cached messages when the escalation is triggered. Default is 32.

/

@ property (nonatomic, assign) NSUInteger minBatchReportNumber

/ *

Send interval (in minutes) when reporting policy is PERIOD. Default is one day (60 minutes).

/

@ property (nonatomic, assign) NSUInteger periodMinutes

VIII. The application that integrates SDK should submit App Store notes.

1. In order to obtain accurate statistical results, you need to add AdSupport.framework library support, so you need to do the following when submitting App Store:

(1) if an advertisement is placed in App, the IDFA obtained can be approved by Apple.

(2) there are no advertisements in App, but specific advertisements have been placed previously. Please refer to the check box below and pass Apple's review.

Check as shown in the figure:

! [] (https://s1.51cto.com/images/blog/201807/27/6325bcc339f07bb78366f659af0bee84.png?x-oss-process=image/watermark,size_16,text_QDUxQ1RP5Y2a5a6i,color_FFFFFF,t_100,g_se,x_10,y_10,shadow_90,type_ZmFuZ3poZW5naGVpdGk=)

The above is my whole process of integrating a push application statistics product (number), I hope it will be helpful to you! If you have any other questions, we can communicate in the message area.

Welcome to subscribe "Shulou Technology Information " to get latest news, interesting things and hot topics in the IT industry, and controls the hottest and latest Internet news, technology news and IT industry trends.