核心實作與生命週期。

此資訊可協助您實施 iOS 資料庫並收集生命週期量度 (例如: 啟動、升級、工作階段、參與的使用者等等)。

下載 SDK

重要

若要下載 SDK,您​必須​使用 iOS 6 或更新版本。

先決條件

下載 SDK 之前,請完成核心實施與生命週期的​建立報表套裝​中的步驟,以設定開發報表套裝和下載預先填入版本的設定檔案。

若要下載 SDK:

  1. 下載並解壓縮 [Your_App_Name_]AdobeMobileLibrary-4.*-iOS.zip 檔案,然後確認您有下列軟體元件:

    • ADBMobile.h,此元件為用於 iOS AppMeasurement 的 Objective-C 標頭檔案。

    • ADBMobileConfig.json,此元件為根據您應用程式自訂的 SDK 設定檔案。

    • AdobeMobileLibrary.a,此元件為已啟用位元碼的大型二進位檔,其中包含 iOS 裝置 (armv7、armv7s、arm64) 和模擬器 (i386 和 x86_64) 適用的資料庫組建。

      當預期目標為 iOS 應用程式時,應連結此大型二進位檔。

    • AdobeMobileLibrary_Extension.a,此元件為已啟用位元碼的大型二進位檔,其中包含 iOS 裝置 (armv7、armv7s、arm64) 和模擬器 (i386 和 x86_64) 適用的資料庫組建。

      當預期目標為 iOS 延伸功能時,應連結此大型二進位檔。

    • AdobeMobileLibrary_Watch.a,此元件為已啟用位元碼的大型二進位檔,其中包含 Apple Watch 裝置 (armv7k) 和模擬器 (i386 和 x86_64) 適用的資料庫組建。

      當預期目標為 Apple Watch (watchOS 2) 延伸功能應用程式時,應連結此大型二進位檔。

    • AdobeMobileLibrary_TV.a,此元件為已啟用位元碼的大型二進位檔,其中包含新 Apple TV 裝置 (arm64) 和模擬器 (x86_64) 適用的資料庫組建。

      當預期目標為 Apple TV (tvOS) 應用程式時,應該連結此大型二進位檔。

重要

如果您在 Adobe Mobile Services 使用者介面以外的地方下載 SDK,則必須手動設定 ADBMobileConfig.json 檔案。如果您是初次使用 Analytics 和 Mobile SDK,請參閱開始之前,以設定開發報表套裝和下載預先填入版本的設定檔案。

新增 SDK 和設定檔案至您的專案

  1. 啟動 Xcode IDE 並開啟您的應用程式。

  2. 在「專案導覽器」中,拖曳 AdobeMobileLibrary 資料夾,並將其放置在您的專案下。

  3. 請確認下列項目:

    • 已選取​「需要時複製項目」​核取方塊。
    • 已選取「建立群組」
    • 未選取​「新增至目標」​區段中的任何核取方塊。

  4. 按一下​完成

  5. 在​專案導覽器​中,選取 ADBMobileConfig.json

  6. 在​檔案檢查工具​中,將 JSON 檔案新增至將使用 Adobe SDK 之專案中的任何目標。

  7. 在​專案導覽器​中,完成下列步驟:

    1. 按一下您的應用程式。
    2. 在​「一般」​標籤上,選取您的目標並連結​「連結架構」​和​「資料庫」​區段中必要的架構和資料庫。
    • iOS 應用程式目標

      • SystemConfiguration.framework
      • WebKit.framework
      • libsqlite3.0.tbd
      • AdobeMobileLibrary.a
      • CoreLocation.framework (選擇性,但需要地理位置追蹤功能)
    • iOS 延伸功能目標

      • SystemConfiguration.framework
      • libsqlite3.0.tbd
      • AdobeMobileLibrary\_Extension.a
    • Apple Watch (watchOS 2) 目標

      • libsqlite3.0.tbd
      • AdobeMobileLibrary\_Watch.a
    • Apple TV (tvOS) 目標

      • SystemConfiguration.framework
      • libsqlite3.0.tbd
      • AdobeMobileLibrary\_TV.a
    注意

    在相同的目標中連結多個 AdobeMobileLibrary*.a 檔案,將會導致非預期行為或建置失敗。

  8. 確認可建置應用程式且未發生錯誤。

實施生命週期量度

重要

不論是否呼叫 collectlifecycledata,iOS 都會傳送生命週期資訊;collectlifecycledata 只是在應用程式啟動序列早期啟動生命週期的方法。

啟用生命週期後,每當您的應用程式啟動時,就會傳送一次點擊以測量啟動數、升級數、工作階段數、參與使用者數,以及其他生命週期量度

application:didFinishLaunchingWithOptions 中新增 collectLifecycleData/ collectLifecycleDataWithAdditionalData 呼叫:

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { 
 [ADBMobile collectLifecycleData]; 
    return YES; 
}

納入其他資料與生命週期呼叫

若要納入其他資料與生命週期量度呼叫,請使用 collectLifecycleDataWithAdditionalData:

重要

任何透過 collectLifecycleDataWithAdditionalData: 傳遞至 SDK 的資料都會由 SDK 保存在 NSUserDefaults 中。SDK 會拆解不屬於 NSDictionaryNSString 類型之 NSNumber 參數的值。

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { 
    NSMutableDictionary *contextData = [NSMutableDictionary dictionary]; 
    [contextData setObject:@"Game" forKey:@"myapp.category"]; 
    [ADBMobile collectLifecycleDataWithAdditionalData:contextData]; 
    return YES; 
}

collectLifecycleDataWithAdditionalData 一併傳送的其他內容資料值,必須對應至 Adobe Mobile Services 中的自訂變數:

系統會自動收集其他生命週期量度。如需詳細資訊,請參閱生命週期量度

後續步驟

完成下列作業:

本頁內容