Show Menu
主題×

核心實施與生命週期

此資訊可協助您實施 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. 在​ 專案導覽器 ​中,選取 !UICONTROL`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 會拆解不屬於 NSDictionary NSString 類型之 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 中的自訂變數:
系統會自動收集其他生命週期量度。如需詳細資訊,請參閱 生命週期量度

後續步驟

完成下列作業: