一个将自定义事件发送到 CLab 的 SDK。

先决条件

iOS >= 8.0

如何使用

1 导入 ConvertSDK

你可以选择以下两种方法之一将 ConvertSDK 集成到你的应用程序中

1.2 使用框架

• 从 https://github.com/xsio/clabanalytics/framework 下载 libConvertSDK.framework。解压缩它并将框架拖动到你的项目中。
• 在你的项目目标的构建设置中，找到 '其他链接器标志'，添加 '-ObjC' 到链接器。

2 在你的项目中导入 ConvertSDK.h

你可以将 ConvertSDK.h 添加到你的 AppDelegate.m 和将要使用它的 ViewControllers 中。更简单的方式是添加到你的 pch 文件中

3 设置 tenantId, appId 和 secret

你可以选择以下两种方法之一来设置你的跟踪相关变量。

3.1 在 info.plist 中设置

将 ConvertSDKAppId 和 ConvertSDKSecret 添加到你的应用程序的 info.plist 中

<key>ConvertSDKAppId</key>
<string>ca02cc145ece36b41</string>
<key>ConvertSDKSecret</key>
<string>356694ca12419ea49b4d487b4357844647444ec1</string>

3.2 在代码中设置

在 AppDelegate.m 中

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Override point for customization after application launch.
    [ConvertSDK sharedInstance].appId = @"ca02cc145ece36b41"; // replace with your appid.
    [ConvertSDK sharedInstance].secret = @"356694ca12419ea49b4d487b4357844647444ec1"; // replace with your secret.
    return YES;
}

4 发送自定义事件

例如，你可以在点击按钮时发送一个自定义事件

- (IBAction)track:(id)sender
{
    // Sample test event
    [[ConvertSDK sharedInstance] track:@"sample_event"];
}

或指定目标 & 定制的属性

- (IBAction)track:(id)sender
{
    [[ConvertSDK sharedInstance] track:@"click_event" targetName:@"login_button" targetId:@"1" withProperties:@{@"username": self.loginTextFiled.text}];
}

许可证

ConvertSDK 在 MIT 许可下发布。有关详细信息，请参阅 LICENSE。