1Flow

关于 1Flow

1Flow 是一款用于分析和收集用户反馈的 iOS 库。1Flow 非常容易集成和使用。从 1Flow 控制台 获取更多信息。

入门

您可以使用 CocoaPods 安装 1Flow 库。要使用 1Flow，首先需要在 1Flow 控制台 上注册您的应用程序。注册应用程序后，您将获得您的 1flow_app_key。使用此密钥，您可以配置 1Flow SDK。

需求

iOS 10.0及以上版本

安装

1. 使用CocoaPods安装

1Flow可以通过CocoaPods获取。要安装，只需将以下行添加到您的Podfile中

pod '1Flow'

运行pod install。打开您的*.xcworkspace项目文件。

2. 使用Swift包管理器安装

1Flow也通过Swift Package Manager可用。在Xcode中，选择File > Swift Packages > Add Package Dependency。按照提示，添加https://github.com/1Flow-Inc/1flow-ios-sdk的github URL。

如何使用

• 从1Flow Dashboard获取1flow_app_key
• 您可以在应用程序启动时配置1Flow SDK并跟踪以下事件。检查Swift或Objective-C的相应代码。

Swift

SDK配置

import _1Flow;

class AppDelegate: UIResponder, UIApplicationDelegate {

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // Override point for customization after application launch.
        
        OneFlow.configure("1flow_app_key")
        .
        .
        .

跟踪事件

let parameters = ["param1": "value1", "param2": "value2"]
OneFlow.recordEventName("event_name", parameters: parameters)

此处，参数为可选。如果不想与事件一起发送任何参数，则传入nil。

Objective-C

SDK配置

@import _1Flow;

@implementation AppDelegate

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application
    [OneFlow configure:@"1flow_app_key"];
    .
    .
    .

跟踪事件

NSDictionary *parameters = @{@"param1": @"value1", @"param2": @"value2"};
[OneFlow recordEventName:@"event_name" parameters:parameters];

此处，参数为可选。如果不想与事件一起发送任何参数，则传入nil。

访问1Flow仪表板以检查传入的事件。事件处理和显示在仪表板上可能需要2分钟。

如何获取用户反馈

• 要获取用户反馈，首先您需要在1Flow仪表板上创建调查。调查将有一个或多个屏幕。每个调查都与触发事件相关联。当您记录任何事件时，SDK将检查与记录事件相关联的调查。如果为记录事件找到调查，则SDK将提示用户进行调查。您的应用程序将在后台继续运行，直到用户完成或关闭调查。当调查屏幕打开时，您的应用程序的UI将被调查屏幕阻止。因此，在您的应用程序处于需要用户立即输入的临界状态下时，开发者有责任不要记录此类事件。

• 每个调查只触发一次，直到用户完成并给出反馈。如果用户在没有给出反馈的情况下关闭调查，则在下一次触发事件时将重新提示。

• 如果用户卸载并重新安装应用程序，则它将被视为新用户。在下一个触发事件时，它将打开调查。