要求

• iOS 目标版本 8+
• 数据只能在活跃的互联网连接下传输
• 您需要 goedle.io API 密钥和 APP 密钥
• 您可以通过发送电子邮件至 [email protected] 或 [email protected] 来请求 API 密钥

pod "goedle_io_sdk"

.goodle_io_sdk 可通过 CocoaPods 安装。要安装它，只需将以下行添加到 Podfile

Obj-C

#import "GoedleSdkiOS.h"

打开您的 AppDelegate.m 并导入以下头文件

  - (BOOL)application:(UIApplication*)application didFinishLaunchingWithOptions:(NSDictionary*)launchOptions{
        ...
            /////*******GOEDLE********////////
            [GoedleSdkiOS initGoedle:<GOEDLE_APP_KEY>:<GOEDLE_API_KEY>];
            /////*******GOEDLE********////////
        ...
        }

下一步是初始化 SDK；为了这样做，请添加以下代码 您需要 和 ，这些可以通过发送电子邮件至 [email protected] 或 [email protected] 请求。

Swift

#import "GoedleSdkiOS.h"

要使用 Swift 版的 goedle.io iOS SDK，您需要创建一个 桥接头 并插入以下内容

        func application(application: UIApplication, didFinishLaunchingWithOptions launchOptions: [NSObject: AnyObject]?) -> Bool {
            ...
            /////*******GOEDLE********////////
            GoedleSdkiOS.initGoedle(<APP_KEY>,<API_KEY>)
            /////*******GOEDLE********////////
            ...
        }

现在打开您的 AppDelegate.swift 并在应用程序函数中添加以下代码。 您需要 和 ，这些可以通过发送电子邮件至 [email protected] 或 [email protected] 请求。

向下滚动即可直接查看 实现示例，包括 ObjC 和 Swift。 概念 我们通常使用两个主要变量来跟踪事件。第一个是动作，例如，查看、分享、点赞——这些变量是用户完成的具体动作。第二个变量进一步指定了动作，例如，产品、介绍、类别、用户。这两个变量通过 "." 连接和分隔。然而，指定符不是必需的，我们也支持超过两个级别的层次结构。此外，我们提供自定义字段 event_id，用于识别事件（特别是对于我们的推荐引擎）。例如，如果您要跟踪产品的查看事件，事件将是 "view"，指定符将是 "product"，事件 ID 将是 "235123"。如果您的活动具有特定的值，如持续时间或达到的级别，我们可以提供自定义字段 event_value。活动名称将是 "finish.level"，事件 ID 可以是 "level-12"，事件值可能是 65，其中 65 是以秒为单位的时间长度。 Geohash 除了标准事件跟踪外，我们还提供地理跟踪功能。我们使用 geohashes，这是一个将经典经纬度表示转换为地理空间编码的系统。可以在此找到 geohash 解/编码方案的实现：这里。

跟踪（ObjC）

要跟踪事件，请进入您的 ViewControllers 并为每个要跟踪的事件添加 goedle.io 跟踪方法 [GoedleSdkiOS track:@"."];。例如，

[GoedleSdkiOS track:@"<action>.<specifier>"];

或使用 "event_id"ARGUMENT

[GoedleSdkiOS track:@"<action>.<specifier>":@"<event_id>"];

或使用 "event_value"ARGUMENT

[GoedleSdkiOS track:@"<action>.<specifier>":@"<event_id>":@"<event_value>"];

其中动作是用户正在进行的操作（"view" 或 "buy"）和指定符是感兴趣的实体（"page" 或 "product"）。作为一个额外的标识符，您可以使用 "event_id" 字段。这通常用于跟踪产品或事件的 ID。如果事件具有特定的值，例如持续时间示例，您可以使用 "event_value" 字段。

跟踪 Geohashes（ObjC）

要跟踪 geohash，您必须调用 `[GoedleSdkiOS trackGeo:@"."];`。对于每个要跟踪的事件，如果适用，可以添加 geohash。例如。

[GoedleSdkiOS trackGeo:@"<action>.<specifier>":@"<geo_hash>"];

或

[GoedleSdkiOS trackGeo:@"<action>.<specifier>":@"<event_id>":@"<geo_hash>"];

跟踪（Swift）

要跟踪事件，请进入您的 ViewControllers并为每个要跟踪的事件添加 goedle.io 跟踪方法 GoedleSdkiOS.track(.);。例如。

GoedleSdkiOS.track("<action>.<specifier>")

或使用 "event_id"ARGUMENT

GoedleSdkiOS.track("<action>.<specifier>","<event_id>")

或使用 "event_value"ARGUMENT

GoedleSdkiOS.track("<action>.<specifier>","<event_id>","<event_value>")

其中动作是用户正在进行的操作（"view" 或 "buy"）和指定符是感兴趣的实体（"page" 或 "product"）。作为一个额外的标识符，您可以使用 "event_id" 字段。这通常用于跟踪产品或事件的 ID。如果事件具有特定的值，如持续时间示例，您可以使用 "event_value" 字段。

跟踪 Geohashes（Swift）

要跟踪 geohash，您必须调用 GoedleSdkiOS.trackGeo(:)。对于每个要跟踪的事件，如果适用，可以添加 geohash。例如。

GoedleSdkiOS.trackGeo("<action>.<specifier>","<geo_hash>")

或

GoedleSdkiOS.trackGeo("<action>.<specifier>","<event_id>","<geo_hash>")

作者

goedle.io GmbH， [email protected]

许可

goedle_io_sdk 在 MIT 许可下可用。有关更多信息，请参阅 LICENSE 文件。