1. 최신 버전의 CocoaPods를다운로드하여 설치합니다.

2. 포드파일을 생성하려면 터미널에서 프로젝트 루트 폴더로 이동하여 다음을 입력합니다:

   pod init

3. Singular SDK 종속성을 추가하려면 프로젝트의 포드파일에 다음을 추가합니다:

   pod 'Singular-SDK'

   예를 들어

   

4. 터미널에서 프로젝트 루트 폴더로 이동하여 실행합니다:

   pod install

5. 이 시점부터는 .xcodeproj 파일 대신 Xcode 워크스페이스 파일 .xcworkspace를 열어 프로젝트를 엽니다.
6. 아래 지침에 따라 Swift 브리징 헤더를 생성합니다.

1. Xcode에서 파일 > 패키지 추가로 이동하여 Singular SDK GitHub 리포지토리로 들어갑니다:

   https://github.com/singular-labs/Singular-iOS-SDK

   

2. Singular SDK 버전을 업데이트합니다:

   

3. 패키지 추가 버튼을 클릭합니다.

4. 빌드 단계 > 라이브러리와 바이너리 연결로 이동하여 AdServices.framework 라이브러리를 추가합니다. iOS 14.3 이상의 기기에서만 사용할 수 있으므로 선택 사항으로 표시해야 합니다.

   

5. 빌드 설정 > 연동 > 기타 링커 플래그로 이동하여 다음 항목으로 기타 링커 플래그를 업데이트합니다:
   
   (상속됨) -ObjC -l"sqlite3.0" -l"z" -프레임워크 "AdSupport" -프레임워크 "Security" -프레임워크 "Singular" -프레임워크 "StoreKit" -프레임워크 "SystemConfiguration" -프레임워크 "WebKit" -프레임워크 "iAd"

   

   

6. 아래 지침에 따라 Swift 브리징 헤더를 생성합니다.

Singular SDK 12.3.2 이하에서 업그레이드하시나요?

아래 단계에 따라 이전 스태틱 라이브러리를 제거하세요.

1. 프로젝트 파일로 이동하여 Singular 스태틱 라이브러리를 제거합니다. 일반적으로 Singular-iOS-sdk-v12.3.2와 같은 이름의 폴더가 있을 것입니다. 폴더를 마우스 오른쪽 버튼으로 클릭하고 프로젝트에서 삭제합니다.
2. 다음 섹션으로 진행하여 새 프레임워크를 설치합니다.

처음으로 Singular 프레임워크 추가하기

1. SDK 프레임워크를 다운로드하여 압축을 풉니다.

   구현에 적합한 프레임워크를 선택합니다:

   • Xcode 12 이상의 경우 .xcframework [여기에서 다운로드]사용
   • Xcode 11 이하의 경우 .framework [여기에서 다운로드]사용

2. 압축을 푼 폴더를 Xcode 프로젝트의 폴더에 추가합니다:

   Xcode에서 앱 이름 > [프로젝트 이름]에 파일 추가를 마우스 오른쪽 버튼으로 클릭합니다. 대화 상자가 열리면 옵션 > 그룹 생성을 선택하고 SDK의 압축을 푼 폴더를 추가합니다.
   
   
   
   
   
   이제 Singular 프레임워크가 프로젝트에 있어야 합니다.
   
   

3. 필요한 라이브러리를 추가합니다:

   • Xcode에서 빌드 단계 > 라이브러리와 바이너리 링크를 선택합니다.

   • 를 클릭하고 다음 라이브러리를 추가합니다:

     Libsqlite3.0.tbd
     SystemConfiguration.framework
     Security.framework
     Libz.tbd
     AdSupport.framework
     WebKit.framework
     StoreKit.framework
     AdServices.framework (mark as Optional since it's only
         available for devices with iOS 14.3 and higher).

4. Singular 프레임워크 임베드 및 서명
   • 일반 > 프레임워크, 라이브러리 및 임베디드 콘텐츠로이동합니다.
   • Singular 프레임워크를"임베드 및 서명"으로 조정합니다.
     
     

코코아팟 또는 Swift 패키지 관리자를 사용하여 SDK를 설치한 경우, Singular SDK의 Obj-C 라이브러리를 사용하려면 Swift용 브리징 헤더를 생성해야 합니다.

1. 프로젝트에서 Header 유형의 새 파일을 생성하고 이름을 YourProjectName-Bridging-Header로 지정합니다.

   

2. 파일을 열고 다음을 추가합니다:

   #import <Singular/Singular.h>

   예를 들어

   

3. 빌드 설정 > Objective-C 브리징 헤더로 이동하여 파일의 상대 경로를 추가합니다:

   

앱 코드를 사용하여 직접 전환 값을 업데이트하려면, 먼저 Singular 컨피그에서 manualSkanConversionManagement 플래그를 설정해야 합니다. 이렇게 하면 여러 SDK 메소드를 사용하여 전환 값을 수동으로 검색하고 업데이트할 수 있습니다.

수동 모드를 활성화하려면 다음과 같이 하세요:

func getConfig() -> SingularConfig? {
     
     // Singular Config Options


     guard let config = SingularConfig(apiKey: Constants.APIKEY,
       andSecret: Constants.SECRET) else {
         return nil
         }
     
     //...
     config.manualSkanConversionManagement = true
     //...
     
     return config
}

- (SingularConfig *)getConfig {
     
     // Singular Config Options


     SingularConfig* config = [[SingularConfig alloc] initWithApiKey:APIKEY
       andSecret:SECRET];
     
     //...
     config.manualSkanConversionManagement = YES;
     //...
     
     return config;
}

전환 값을 업데이트하려면:

수동 모드에서 전환 값을 업데이트하려면 skanUpdateConversionValue 메서드를 사용해야 합니다. 앱의 라이프사이클에서 필요할 때마다 사용할 수 있습니다.

// Sending a Standard Event for Login


Singular.event(EVENT_SNG_LOGIN)
      
// Manually updating the conversion value to 7 after the Event


Singular.skanUpdateConversionValue(7)

// Sending a Standard Event for Login


[Singular event:EVENT_SNG_LOGIN];
      
// Manually updating the conversion value to 7 after the Event


[Singular skanUpdateConversionValue:7];

기타 SKAdNetwork 메서드:

현재 전환 값을 가져오려면, skanGetConversionValue 메서드 또는 conversionValueUpdatedCallback을 사용합니다. 둘 다 관리 및 수동 모드에서 작동합니다.

let conversionValue = Singular.skanGetConversionValue()

NSNumber* conversionValue = [Singular skanGetConversionValue]; 

func getConfig() -> SingularConfig? {
     // Singular Config Options


     guard let config = SingularConfig(apiKey: Constants.APIKEY,
       andSecret: Constants.SECRET) else {         
         return nil
         }     
     //...
     config.conversionValueUpdatedCallback = { conversionValue in
     // Here you have access to the latest conversion value


     }
     //...
     return config
}

- (SingularConfig *)getConfig {
     // Singular Config Options


     SingularConfig* config = [[SingularConfig alloc] initWithApiKey:APIKEY
       andSecret:SECRET];
     //...
     config.conversionValueUpdatedCallback=^(NSNumber *conversionValue, 
       NSNumber *coarse, BOOL lock) {
         // Here you have access to the CV + coarse CV


       };
     //...
     return config;
}

다음 표에는 이 연동을 사용하여 가능한 시나리오가 요약되어 있습니다:

// INITIALIZE THE SDK IN THE FOLLOWING SCENEDELEGATE FUNCTIONS]


     
// willConnectTo session


func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
  options connectionOptions: UIScene.ConnectionOptions) {
    let userActivity = connectionOptions.userActivities.first
    // Print IDFV to Console for use in Singular SDK Console


    print(Date(), "-- Scene Delegate IDFV:", 
    UIDevice().identifierForVendor!.uuidString as Any)
    
    //Initialize the Singular SDK here:
    if let config = self.getConfig() {
      config.userActivity = userActivity
      Singular.start(config)
    }
}
      
// continue userActivity


      
func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
  // Starts a new Singular session on continueUserActivity


  if let config = self.getConfig() {
    config.userActivity = userActivity
    Singular.start(config)
  }
}
      
//openURLContexts URLContexts
      
func scene(_ scene: UIScene, openURLContexts URLContexts: 
  Set<UIOpenURLContext>) {
    // Starts a new Singular session on cold start from deeplink scheme


    if let config = self.getConfig() {
      config.openUrl = openurlString
      Singular.start(config)
    }
    
    // Add custom code here to Redirect to non-Singular deep links


    //...
}

// INITIALIZE THE SDK IN THE FOLLOWING WINDOWGROUP FUNCTIONS


var body: some Scene {
    WindowGroup {
        ContentView()
            .onOpenURL(perform: { url in
                openURL = url
                // Initialize Singular from an openURL


                if let config = self.getConfig() {
                    config.openUrl = url
                    Singular.start(config)
                }
            })
    }
    .onChange(of: scenePhase) { oldValue, phase in
        // The SwiftUI ScenePhases replaces the old SceneDelegate lifecycle events


        switch phase {
        case .background:
            print("App Scene: backgrounded")
        case .inactive:
            print("App Scene: inactive")
        case .active:
            print("App Scene: active")
            
            // Initialize Singular


            if let config = self.getConfig() {
                Singular.start(config)
            }
        @unknown default:
            print("App Scene: unknown")
        }
    }
}

// INITIALIZE THE SDK IN THE FOLLOWING SCENEDELEGATE FUNCTIONS


     
// willConnectToSession


- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session 
  options:(UISceneConnectionOptions *)connectionOptions {
    NSUserActivity* userActivity = [[[connectionOptions userActivities] allObjects] 
      firstObject];
    // Print identifier for Vendor (IDFV) to Xcode Console for use in Singular SDK Console


    NSLog(@"-- Scene Delegate IDFV: %@", [[[UIDevice currentDevice] identifierForVendor] UUIDString]);
    
    // Start a new Singular session from a backgrounded app


    SingularConfig *config = [self getConfig];
    config.userActivity = userActivity;
    [Singular start:config];
}
    
// continueUserActivity


- (void)scene:(UIScene *)scene continueUserActivity:(NSUserActivity *)userActivity{
  // Starts a new Singular session from a backgrounded App


  SingularConfig *config = [self getConfig];
  config.userActivity = userActivity;
  [Singular start:config];
}
    
// openURLContexts


- (void)scene:(UIScene *)scene openURLContexts:(nonnull NSSet *)URLContexts {
  // Starts a new Singular session on cold start from deeplink scheme


  SingularConfig *config = [self getConfig];
  config.openUrl = url;
  [Singular start:config];
  
  // Add custom code here to Redirect to Non-Singular deep links


  //...
}

// INITIALIZE THE SDK IN THE FOLLOWING APPDELEGATE FUNCTIONS


    
// didFinishLaunchingWithOptions


- (BOOL)application:(UIApplication *)application 
  didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // Starts  new session when  user opens the app if session timeout passed/opened using Singular Link


    SingularConfig *config = [self getConfig];
    config.launchOptions = launchOptions;
    [Singular start:config];
    return YES;
}
    
// continueUserActivity


- (BOOL)application:(UIApplication *)application 
  continueUserActivity:(NSUserActivity *)userActivity 
    restorationHandler:(void (^)(NSArray<id> *restorableObjects))restorationHandler {
      // Starts a new session when the user opens the app using a Singular Link while it was in the background


      SingularConfig *config = [self getConfig];
      config.userActivity = userActivity;
      [Singular start:config];
      return YES;
}
    
// openURL


- (BOOL)application:(UIApplication *)app openURL:(NSURL *)url 
  options:(NSDictionary<UIApplicationOpenURLOptionsKey, id> *)options{
    // Starts new session when user opens the app using a non-Singular link, like a traditional app scheme.


    SingularConfig *config = [self getConfig];
    config.openUrl = url;
    [Singular start:config];
    // Add custom code here to Redirect to non-Singular deep links


    //...
    return YES;
}

// INITIALIZE THE SDK IN THE FOLLOWING APPDELEGATE FUNCTIONS


    
// didFinishLaunchingWithOptions


func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) - Bool {
     // Print IDFV to Console for use in Singular SDK Console 


     print(Date(), "-- Scene Delegate IDFV:", UIDevice().identifierForVendor!.uuidString as Any)
     
     //Initialize the Singular SDK here: 
     if let config = self.getConfig() { 
          config.launchOptions = launchOptions 
          Singular.start(config) 
     }
     
     return true
}
    
// continue userActivity


func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([any UIUserActivityRestoring]?) - Void) - Bool {
     
     //Initialize the Singular SDK here: 
     if let config = self.getConfig() {
          config.userActivity = userActivity
          Singular.start(config) 
     }
     
     return true
}
     
// open url


func application(_ app: UIApplication, open url: URL, options: [UIApplication.OpenURLOptionsKey : Any] = [:]) - Bool {
     
     //Initialize the Singular SDK here: 
     if let config = self.getConfig() {
          config.openUrl = url
          Singular.start(config) 
     }
     
     return true
}

Xcode 15에는 빌드에서 중요한 역할을 하는 "사용자 Script 샌드박싱 "이라는 새로운 옵션이 있습니다. Script가 시스템을 의도하지 않게 변경하는 것을 방지하여 빌드의 안정성과 보안을 강화하는 것이 목적입니다. 이 기능을 활성화하면 빌드 시스템에서 사용자 Script가 선언되지 않은 입력/출력 종속성을 허용하지 않도록 제한합니다. 이는 종속성을 동적으로 연결하기 위해 Script를 실행해야 하는 Singular SDK에 문제가 됩니다.

문제를 해결하려면 다음과 같이 하세요:

1. 빌드 설정 > 빌드 옵션으로이동합니다.
2. "사용자 Script 샌드박싱" 을 "아니요" 값으로 조정합니다.

1. 브리징 헤더가 생성되었는지 확인합니다.
2. 빌드 설정 > Objective-C 브리징 헤더에서 브리징 헤더 파일이 링크되었는지 확인합니다.

경우에 따라 iOS 시뮬레이터는 빌드 설정 > 제외된 아키텍처에서 arm64를 제외해야 합니다.

글로벌 프로퍼티는 현재 테스트 콘솔에 표시되지 않습니다. 향후 추가될 예정입니다. 이 기능을 확인하려면 로그 내보내기를 사용하세요.

로깅 오류가 발생하는 이유는 무엇인가요?

다음과 같은 일반적인 로깅 오류는 무시할 수 있습니다:

• [logging] 중복 열 이름: "ALTER TABLE sessions ADD COLUMN singular_link TEXT DEFAULT NULL"의 singular_link
• [logging] 중복 열 이름: "ALTER TABLE 세션을 ADD COLUMN payload TEXT DEFAULT NULL"에 페이로드가 있습니다.
• [logging] 중복 열 이름: "ALTER TABLE events ADD COLUMN sequence INTEGER DEFAULT -1"의 시퀀스
• [로깅] 중복 컬럼 이름: "ALTER TABLE events ADD COLUMN payload TEXT DEFAULT NULL"의 페이로드