MoEngage-Segment-iOS
为 analytics-ios 集成的 MoEngage
安装
MoEngage 可以通过 Segment 使用 CocoaPods 进行集成。
- 使用 pod init 命令初始化 pod，这将为您的项目创建一个 podfile。
- 通过添加如下所示的 `Segment-MoEngage` 更新您的 podfile
use_frameworks!
pod 'Segment-MoEngage’- 更新 pod。
pod update
设置 Segment SDK
现在转到 App Delegate 文件，并使用以下方式设置 Segment SDK
- 导入
SEGMoEngageIntegrationFactory.h和SEGMoEngageInitializer.h。 - 初始化
MOSDKConfig对象并调用SEGMoEngageInitializer的initializeDefaultInstance:方法。 - 初始化
SEGMoEngageIntegrationFactory实例到SEGAnalyticsConfiguration，如下所示
Objective-C
#import <SEGMoEngageIntegrationFactory.h>
#import <SEGMoEngageInitializer.h>
#import <SEGAnalytics.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
//Initialize SDKConfig object and call initializeDefaultInstance: method of SEGMoEngageInitializer
MOSDKConfig* sdkConfig = [[MOSDKConfig alloc] initWithAppID:@"YOUR APP ID"];
[SEGMoEngageInitializer initializeDefaultInstance:sdkConfig];
// Add your configuration key from Segment
SEGAnalyticsConfiguration *config = [SEGAnalyticsConfiguration configurationWithWriteKey:@"configuration key"];
// Add MoEngageIntegrationFactory. Without this data will not come to MoEngage.
[config use:[SEGMoEngageIntegrationFactory instance]];
[SEGAnalytics setupWithConfiguration:config];
}
Swift
import Segment_MoEngage
...
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
...
let sdkConfig = MOSDKConfig(appID: "YOUR APP ID")
SEGMoEngageInitializer.initializeDefaultInstance(sdkConfig)
// Add your configuration key from Segment
let config = SEGAnalyticsConfiguration(writeKey:"configuration key")
// Add MoEngageIntegrationFactory. Without this data will not come to MoEngage.
config.use(SEGMoEngageIntegrationFactory.instance())
SEGAnalytics.setup(with: config)
...
}
在Segment仪表板上设置MoEngage
设置MoEngage请按照以下步骤操作
- 首先从MoEngage仪表板获取您的密钥（仪表板 -> 设置 -> 通用 -> 通用设置 -> AppID）
- 前往Segment仪表板，转到集成并选择MoEngage。
- 启用MoEngage集成。
- 前往MoEngage设置，并输入在步骤中获取的MoEngage AppID。
- 保存更改。
这些新设置最多需要一个小时才能传播到所有现有用户。对于新用户，将立即生效！Segment-MoEngage集成是一个捆绑集成，需要客户端集成。
跟踪用户属性
用户属性是指用户的特定特征，如电子邮件、用户名、手机、性别等。"identify"让您将用户与其操作相关联并记录有关他们的属性。它包括唯一的用户ID和您了解的任何可选属性。
[[SEGAnalytics sharedAnalytics] identify:@"a user's id" traits:@{ @"email": @"a user's email address" }];
有关更多信息，请参阅此链接。
跟踪事件
事件跟踪用于跟踪应用程序中的用户行为。 跟踪 允许您记录用户执行的操作。每个操作都会触发一个“事件”，该事件还可以具有相关属性。
[[SEGAnalytics sharedAnalytics] track:@"Item Purchased" properties:@{ @"item": @"赫拉克里斯之剑"}];
这就是跟踪数据所需要的一切。有关更多信息，请参阅此链接。
重置用户
重置 方法清除 SDK 内部存储当前用户的数据。这在用户可以随时间使用不同身份登录和注销的应用程序中很有用。
[[SEGAnalytics sharedAnalytics] reset];
有关更多信息，请参阅此链接。
安装/更新区分
由于您可能在我们集成之前已经将应用程序上传到 App Store，我们需要知道您的应用程序更新将是一个实际的 UPDATE 还是 INSTALL。为了区分这些，请使用以下方法之一
//For new Install call following
[[MoEngage sharedInstance] appStatus:AppStatusInstall];
//For an app update call following
[[MoEngage sharedInstance] appStatus:AppStatusUpdate];
有关此方法的更多信息，请参阅以下链接。
使用 MoEngage SDK 提供的功能
除了跟踪用户的活动外，MoEngage iOS SDK 还提供其他功能，可以帮助更有效地进行用户参与。
推送通知
推送通知是保持用户参与和了解应用程序的好方法。在实施应用程序中的推送通知时，您有以下选项
段落推送实现
1.按照指引使用Segment SDK注册推送通知，请参阅以下链接：如何使用推送通知。
2.在应用程序的application:didReceiveRemoteNotification:方法中，添加以下代码：
[[SEGAnalytics sharedAnalytics] receivedRemoteNotification:userInfo];
3.如果您整合了application:didReceiveRemoteNotification:fetchCompletionHandler:，请将以下代码添加到该方法中：
[[SEGAnalytics sharedAnalytics] receivedRemoteNotification:userInfo];
4.如果您实现了handleActionWithIdentifier:forRemoteNotification:，请将该代码添加到该方法中：
[[SEGAnalytics sharedAnalytics] handleActionWithIdentifier:identifier forRemoteNotification:userInfo];
MoEngage Push实现
使用MoEngage SDK在移动应用程序中实现推送通知的链接： 推送通知
应用内消息
应用内消息是自定义视图，您可以将它们发送给特定用户群体，显示自定义消息、提供新优惠或引导用户到特定页面。了解更多关于inApp Messaging及其在应用程序中的实现方式，请参阅以下链接：InApp NATIV
Segment文档
有关使用Segment for iOS的更多信息，请参阅Segment提供的开发者文档：开发者文档。
变更日志
请参阅 SDK 更新日志 了解每个发布版本的信息。
支持
如果您在使用SDK时遇到任何问题，或者需要集成方面的帮助，请联系我们：[email protected]。