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'

            

手動でのインポート

• 対応する旧バージョンの 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"

            

              
              - (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 の場合、初期化は成功です。