統合ガイド
対応バージョン
バージョン v5.0.0 以降が対象です。現在、SDK は iOS 10 以上のモバイルシステムのみをサポートしています。
EngageLab SDK の MA 機能を使用するには、AppPush モジュールを統合する必要があります。まず、AppPush プラットフォームでアプリを作成して AppKey を取得してください。
プロジェクトの設定
SDK のインポート
Cocoapods を使用したインポート
pod 'MTMA'
注意:最新バージョンをインポートできない場合は、コマンド pod repo update master を実行してローカル pod ライブラリを更新し、その後再度 pod 'MTMA' を実行してください。
pod 'MTMA'
注意:最新バージョンをインポートできない場合は、コマンド pod repo update master を実行してローカル pod ライブラリを更新し、その後再度 pod 'MTMA' を実行してください。
このコードブロックはフローティングウィンドウ内に表示されます
- 特定のバージョンをインストールする必要がある場合は、以下の方法を使用してください(例:MTMA 5.0.0 バージョンの場合):
pod 'MTMA', '5.0.0'
pod 'MTMA', '5.0.0'
このコードブロックはフローティングウィンドウ内に表示されます
手動でのインポート
- SDK パッケージを解凍します。Xcode で「Add files to 'Your project name'...」を選択し、MTMA-ios-x.x.x.xcframework をプロジェクトディレクトリに追加します。
SDK の初期化
MTPush の初期化関数を呼び出した後に MTMA SDK を初期化します。
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// まず Push SDK を初期化
NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
[MTPushService setupWithOption:launchOptions appKey:appKey
channel:channel
apsForProduction:isProduction
advertisingIdentifier:advertisingId];
// 次に MTMA SDK を初期化
MTMAConfig *config = [[MTMAConfig alloc] init];
config.completion = ^(NSInteger code, NSString * _Nonnull message) {
NSLog(@"result:%ld - %@", code, message);
};
[MTMAService start:config];
}
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
// まず Push SDK を初期化
NSString *advertisingId = [[[ASIdentifierManager sharedManager] advertisingIdentifier] UUIDString];
[MTPushService setupWithOption:launchOptions appKey:appKey
channel:channel
apsForProduction:isProduction
advertisingIdentifier:advertisingId];
// 次に MTMA SDK を初期化
MTMAConfig *config = [[MTMAConfig alloc] init];
config.completion = ^(NSInteger code, NSString * _Nonnull message) {
NSLog(@"result:%ld - %@", code, message);
};
[MTMAService start:config];
}
このコードブロックはフローティングウィンドウ内に表示されます
一部のパラメータの説明
- appKey
- アプリに設定されている appKey が Portal 上でアプリ作成後に生成された appKey と一致していることを確認してください。
- channel
- アプリパッケージのダウンロードチャネルを指定します。チャネルに基づいた統計を容易にするため、App Store など具体的な値を自由に定義できます。
- apsForProduction
- 現在のアプリが使用している APNs 証明書環境を識別します。
- 0(デフォルト値)は開発証明書を使用、1 は本番証明書を使用してアプリをリリースすることを示します。
- 注意:このフィールドの値は、Build Settings の Code Signing 設定の証明書環境と一致している必要があります。