Panduan Integrasi SDK MA iOS (Sebelum 5.5.0)

Versi yang Berlaku

Panduan ini berlaku untuk SDK MTMA mulai v5.0.0 hingga sebelum v5.5.0. Saat ini, SDK hanya mendukung perangkat dengan iOS 10 atau lebih baru.

Untuk v5.5.0 dan versi lebih baru, lihat Panduan Integrasi.

Untuk menggunakan fungsi MA pada SDK EngageLab, Anda juga perlu mengintegrasikan modul AppPush. Buat aplikasi terlebih dahulu di platform AppPush untuk memperoleh AppKey.

Mengonfigurasi Proyek

Mengonfigurasi AppPush

Saat mengonfigurasi sumber data seluler di konsol MA, pilih penggunaan bersama AppPush dan pilih aplikasi AppPush yang benar-benar diintegrasikan. Gunakan AppKey aplikasi tersebut saat menginisialisasi AppPush.

Mengimpor SDK

Impor melalui CocoaPods

• Tentukan versi sebelum 5.5.0 (contoh berikut menggunakan 5.0.0):

              
                  pod 'MTPush', '5.0.0'
    pod 'MTMA', '5.0.0'

            

Impor manual

• Ekstrak paket SDK versi lama yang sesuai. Impor AppPush sesuai panduan integrasinya, lalu di Xcode pilih “Add files to 'Your project name'...” dan tambahkan MTMA-ios-x.x.x.xcframework dari paket SDK yang sama ke direktori proyek Anda.

Menginisialisasi SDK

Inisialisasi SDK MTMA setelah memanggil fungsi inisialisasi MTPush. MTMA versi lama menggunakan AppKey AppPush, sehingga MA AppKey tidak perlu diatur terpisah.

Tambahkan file header berikut ke AppDelegate.m:

              
              #import "MTPushService.h"
#import "MTMAService.h"

            

              
              - (BOOL)application:(UIApplication *)application
    didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {

    // Menginisialisasi SDK Push terlebih dahulu
    NSString *appKey = @"AppPush AppKey Anda";
    NSString *channel = @"App Store";
    BOOL isProduction = NO;
    [MTPushService setupWithOption:launchOptions
                           appKey:appKey
                          channel:channel
                 apsForProduction:isProduction
            advertisingIdentifier:nil];

    // Kemudian menginisialisasi SDK MTMA
    MTMAConfig *config = [[MTMAConfig alloc] init];
    config.completion = ^(NSInteger code, NSString *message) {
        NSLog(@"result：%ld - %@", (long)code, message);
    };
    [MTMAService start:config];

    return YES;
}

            

Penjelasan Beberapa Parameter

• appKey
  • Pastikan appKey yang dikonfigurasi di aplikasi sama dengan AppKey yang dihasilkan saat membuat aplikasi di platform AppPush.
• channel
  • Menentukan kanal unduhan paket aplikasi. Anda dapat menentukan nilainya sendiri untuk memudahkan statistik per kanal, misalnya: App Store.
• apsForProduction
  • Menunjukkan lingkungan sertifikat APNs yang digunakan aplikasi saat ini.
  • 0 (default) berarti sertifikat pengembangan, sedangkan 1 berarti sertifikat produksi untuk menerbitkan aplikasi.
  • Catatan: Nilai kolom ini harus sesuai dengan lingkungan sertifikat yang dikonfigurasi pada Code Signing di Build Settings.
• completion
  • Callback hasil inisialisasi; code bernilai 0 menunjukkan inisialisasi berhasil.