คู่มือการผสานรวม SDK MA สำหรับ iOS (ก่อน 5.5.0)

เวอร์ชันที่ใช้ได้

คู่มือนี้ใช้กับ SDK MTMA ตั้งแต่ v5.0.0 จนถึงเวอร์ชันก่อน v5.5.0 ปัจจุบัน SDK รองรับเฉพาะอุปกรณ์ที่ใช้ iOS 10 ขึ้นไป

สำหรับ v5.5.0 ขึ้นไป โปรดดู คู่มือการผสานรวม

หากต้องการใช้ฟังก์ชัน MA ของ SDK EngageLab ต้อง ผสานรวมโมดูล AppPush ด้วย ให้สร้างแอปบนแพลตฟอร์ม AppPush ก่อนเพื่อรับ AppKey

กำหนดค่าโปรเจกต์

กำหนดค่า AppPush

เมื่อกำหนดค่าแหล่งข้อมูลมือถือในคอนโซล MA ให้เลือกใช้งานร่วมกับ AppPush และเลือกแอป AppPush ที่ผสานรวมจริง ใช้ AppKey ของแอปที่เลือกเมื่อเริ่มต้นใช้งาน AppPush

นำเข้า SDK

นำเข้าผ่าน CocoaPods

• ระบุเวอร์ชันก่อน 5.5.0 (ตัวอย่างต่อไปนี้ใช้ 5.0.0):

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

            

นำเข้าด้วยตนเอง

• แตกไฟล์แพ็กเกจ SDK เวอร์ชันเก่าที่ต้องการ นำเข้า AppPush ตามคู่มือการผสานรวม AppPush แล้วเลือก “Add files to 'Your project name'...” ใน Xcode เพื่อเพิ่ม MTMA-ios-x.x.x.xcframework จากแพ็กเกจ SDK เดียวกันลงในไดเรกทอรีโปรเจกต์

เริ่มต้นใช้งาน SDK

เริ่มต้นใช้งาน SDK MTMA หลังจากเรียกฟังก์ชันเริ่มต้นใช้งาน MTPush แล้ว MTMA เวอร์ชันเก่าใช้ AppKey ของ AppPush จึงไม่ต้องตั้งค่า MA AppKey แยกต่างหาก

เพิ่มไฟล์เฮดเดอร์ต่อไปนี้ใน AppDelegate.m:

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

            

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

    // เริ่มต้นใช้งาน SDK Push ก่อน
    NSString *appKey = @"AppPush AppKey ของคุณ";
    NSString *channel = @"App Store";
    BOOL isProduction = NO;
    [MTPushService setupWithOption:launchOptions
                           appKey:appKey
                          channel:channel
                 apsForProduction:isProduction
            advertisingIdentifier:nil];

    // จากนั้นเริ่มต้นใช้งาน SDK MTMA
    MTMAConfig *config = [[MTMAConfig alloc] init];
    config.completion = ^(NSInteger code, NSString *message) {
        NSLog(@"result：%ld - %@", (long)code, message);
    };
    [MTMAService start:config];

    return YES;
}

            

คำอธิบายพารามิเตอร์บางส่วน

• appKey
  • ตรวจสอบว่า appKey ที่ตั้งค่าในแอปตรงกับ AppKey ที่ได้จากการสร้างแอปบนแพลตฟอร์ม AppPush
• channel
  • ระบุช่องทางดาวน์โหลดแพ็กเกจแอป คุณสามารถกำหนดค่าเองเพื่อให้รวบรวมสถิติแยกตามช่องทางได้ เช่น App Store
• apsForProduction
  • ใช้ระบุสภาพแวดล้อมของใบรับรอง APNs ที่แอปปัจจุบันใช้งาน
  • 0 (ค่าเริ่มต้น) หมายถึงใช้ใบรับรองสำหรับการพัฒนา ส่วน 1 หมายถึงใช้ใบรับรองสำหรับการผลิตเพื่อเผยแพร่แอป
  • หมายเหตุ: ค่าของฟิลด์นี้ต้องตรงกับสภาพแวดล้อมของใบรับรองที่กำหนดใน Code Signing ของ Build Settings
• completion
  • Callback ผลการเริ่มต้นใช้งาน โดย code เท่ากับ 0 หมายถึงเริ่มต้นใช้งานสำเร็จ