iOS MA SDK 集成指引（5.5.0 以前）
適用版本
本文適用於 v5.0.0 及以後、v5.5.0 以前版本的 MTMA SDK。目前 SDK 只支援 iOS 10 以上版本的手機系統。
v5.5.0 及以後版本請查看 集成指引。
如需使用 EngageLab SDK 的 MA 功能，需要同時集成 AppPush 模組。請先在 AppPush 平台建立一個應用獲得 AppKey。
設定專案
設定 AppPush
在 MA 控制台設定行動端資料來源時，請選擇同時使用 AppPush，並選擇實際接入的 AppPush 應用。初始化 AppPush 時使用所選應用的 AppKey。
導入 SDK
Cocoapods 導入
- 請指定 5.5.0 以前的版本（以下以 5.0.0 版本為例）：
pod 'MTPush', '5.0.0'
pod 'MTMA', '5.0.0'
pod 'MTPush', '5.0.0'
pod 'MTMA', '5.0.0'
此代碼塊在浮窗中顯示
手動導入
- 將對應舊版本的 SDK 包解壓，按 AppPush 集成指引完成 AppPush 導入後，在 Xcode 中選擇 “Add files to 'Your project name'...”，將同一 SDK 包中的 MTMA-ios-x.x.x.xcframework 添加到你的專案目錄中。
初始化 SDK
在 MTPush 初始化函數呼叫之後進行 MTMA SDK 的初始化。舊版 MTMA 使用 AppPush 的 AppKey，不需要單獨設定 MA AppKey。
請將以下頭文件添加到 AppDelegate.m：
#import "MTPushService.h"
#import "MTMAService.h"
#import "MTPushService.h"
#import "MTMAService.h"
此代碼塊在浮窗中顯示
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 先初始化 Push SDK
NSString *appKey = @"your AppPush AppKey";
NSString *channel = @"App Store";
BOOL isProduction = NO;
[MTPushService setupWithOption:launchOptions
appKey:appKey
channel:channel
apsForProduction:isProduction
advertisingIdentifier:nil];
// 再初始化 MTMA SDK
MTMAConfig *config = [[MTMAConfig alloc] init];
config.completion = ^(NSInteger code, NSString *message) {
NSLog(@"result：%ld - %@", (long)code, message);
};
[MTMAService start:config];
return YES;
}
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// 先初始化 Push SDK
NSString *appKey = @"your AppPush AppKey";
NSString *channel = @"App Store";
BOOL isProduction = NO;
[MTPushService setupWithOption:launchOptions
appKey:appKey
channel:channel
apsForProduction:isProduction
advertisingIdentifier:nil];
// 再初始化 MTMA SDK
MTMAConfig *config = [[MTMAConfig alloc] init];
config.completion = ^(NSInteger code, NSString *message) {
NSLog(@"result：%ld - %@", (long)code, message);
};
[MTMAService start:config];
return YES;
}
此代碼塊在浮窗中顯示
部分參數說明
- appKey
- 請確保應用內設定的 appKey 與 AppPush 平台上建立應用後生成的 AppKey 一致。
- channel
- 指明應用程式包的下載渠道，為方便分渠道統計，具體值由你自行定義，如：App Store。
- apsForProduction
- 用於識別目前應用所使用的 APNs 證書環境。
- 0（預設值）表示採用的是開發證書，1 表示採用生產證書發佈應用。
- 注：此欄位的值要與 Build Settings 的 Code Signing 設定的證書環境一致。
- completion
- 初始化結果回呼，code 為 0 時表示初始化成功。
