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

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

   pod init

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

   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. 빌드 설정 > 연동 > 기타 링커 플래그로 이동하여 다음 항목으로 기타 링커 플래그를 업데이트합니다:

   

   

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 (iOS 14.3 이상의 기기에서만 사용할 수 있으므로 선택 사항으로 표시합니다.).

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 구성 옵션

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

- (SingularConfig *)getConfig {
     // Singular 구성 옵션

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

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

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

// 로그인을 위한 표준 이벤트 보내기

Singular.event(EVENT_SNG_LOGIN)
      
// 이벤트 후 전환 가치를 7로 수동 업데이트

Singular.skanUpdateConversionValue(7)

// 로그인을 위한 표준 이벤트 보내기

[Singular event:EVENT_SNG_LOGIN];
      
// 이벤트 후 전환 가치를 7로 수동 업데이트

[Singular skanUpdateConversionValue:7];

기타 SKAdNetwork 메서드:

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

let conversionValue = Singular.skanGetConversionValue()

NSNumber* conversionValue = [Singular skanGetConversionValue]; 

func getConfig() -> SingularConfig? {
     // Singular 구성 옵션

     guard let config = SingularConfig(apiKey: Constants.APIKEY,
       andSecret: Constants.SECRET) else {         
         return nil     
         }     
     //...     
     config.conversionValueUpdatedCallback = { conversionValue in
     // 여기에서 최신 전환 가치에 액세스할 수 있습니다.

     }
     //...
     return config
}

- (SingularConfig *)getConfig {
     // Singular 구성 옵션

     SingularConfig* config = [[SingularConfig alloc] initWithApiKey:APIKEY
       andSecret:SECRET];
     //...
     config.conversionValueUpdatedCallback=^(NSNumber *conversionValue, 
     NSNumber *coarse, BOOL lock) {
     // 여기에서 최신 전환 가치에 액세스할 수 있습니다.

     };
     //...
     return config;
}

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

Singular SDK는 Singular가 제공하지 않는 유니버설 링크도 지원합니다. 이는 구글 애즈나 페이스북과 같이 딥링킹을 지원하는 파트너의 어트리뷰션을 측정하는 데 필요합니다.

Singular iOS SDK 버전 12.0.3 이상에서는 기본적으로 비Singular 유니버설 링크가 지원됩니다.

func getConfig() -> SingularConfig? {
     // Singular 구성 옵션

     guard let config = SingularConfig(apiKey: Constants.APIKEY,
       andSecret: Constants.SECRET) else {
         return nil
         }
     //...
     config.supportedDomains = ["subdomain.mywebsite.com","anothersubdomain.myotherwebsite.com"]
     //...
     return config
}

- (SingularConfig *)getConfig {
     // Singular 구성 옵션

     SingularConfig* config = [[SingularConfig alloc] initWithApiKey:APIKEY
       andSecret:SECRET];
     //...
     config.supportedDomains = @[@"subdomain.mywebsite.com","anothersubdomain.myotherwebsite.com"];
     //...
     return config;
}

Singular SDK는 ESP(이메일 서비스 제공업체)가 제공하는 유니버설 링크를 지원합니다.

ESP 도메인은 HTTPS를 사용해야 합니다. Apple은 iOS 앱이 리디렉션 없이 HTTPS가 활성화된 엔드포인트에서 apple-app-site-association 파일을 가져올 것을 요구합니다. 사이트의 DNS에 DNS 구성이 필요할 수 있으므로 ESP가 앱에 대해 이 파일을 호스팅하는 방법을 확인하세요. 일반적으로 ESP는 HTTPS를 활성화하는 데 필요한 단계를 제공합니다.

ESP 도메인을 지원하려면 Singular SDK를 초기화할 때마다 구성 개체의 espDomains 구성 옵션에 사용자 지정 추적 도메인을 추가하세요.

func getConfig() -> SingularConfig? { 
     // Singular 구성 옵션 

     guard let config = SingularConfig(apiKey: Constants.APIKEY,
       andSecret: Constants.SECRET) else { 
         return nil 
         } 
     //... 
     config.espDomains = ["links.mywebsite.com"] 
     //... 
     return config 
}

- (SingularConfig *)getConfig { 
     // Singular 구성 옵션 

     SingularConfig* config = [[SingularConfig alloc] initWithApiKey:APIKEY
       andSecret:SECRET]; 
     //...
     config.espDomains = @[@"links.mywebsite.com"]; 
     //...
     return config; 
}

// 다음 시나리오 델리게이트 함수에서 SDK를 초기화합니다.]

     
// willConnectTo session

func scene(_ scene: UIScene, willConnectTo session: UISceneSession,
  options connectionOptions: UIScene.ConnectionOptions) {
    let userActivity = connectionOptions.userActivities.first
    // Singular SDK 콘솔에서 사용하기 위해 콘솔에 IDFV를 인쇄합니다.

    print(Date(), "-- Scene Delegate IDFV:", 
    UIDevice().identifierForVendor!.uuidString as Any)
    
    // 여기에서 Singular SDK를 초기화합니다:

    if let config = self.getConfig() {
      config.userActivity = userActivity
      Singular.start(config)
    }
}
      
// continue userActivity

      
func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
  // 계속 사용자 활동에서 새 Singular 세션을 시작합니다.

  if let config = self.getConfig() {
    config.userActivity = userActivity
    Singular.start(config)
  }
}
      
//openURLContexts URLContexts
      
func scene(_ scene: UIScene, openURLContexts URLContexts: 
  Set<UIOpenURLContext>) {
    // 딥링크 방식에서 콜드 스타트 시 새 Singular 세션 시작

    if let config = self.getConfig() {
      config.openUrl = openurlString
      Singular.start(config)
    }
    
    // 여기에 사용자 지정 코드를 추가하여 비Singular 딥링크로 리디렉션하기

    //...
}

// 다음 창그룹 함수에서 SDK를 초기화합니다.

var body: some Scene {
    WindowGroup {
        ContentView()
            .onOpenURL(perform: { url in
                openURL = url
                // openURL에서 Singular 초기화하기

                if let config = self.getConfig() {
                    config.openUrl = url
                    Singular.start(config)
                }
            })
    }
    .onChange(of: scenePhase) { oldValue, phase in
        // SwiftUI ScenePhases는 기존 SceneDelegate 수명 주기 이벤트를 대체합니다.

        switch phase {
        case .background:
            print("앱 장면: 배경")
        case .inactive:
            print("앱 장면: 비활성")
        case .active:
            print("앱 장면: 활성")
            
            // Singular 초기화

            if let config = self.getConfig() {
                Singular.start(config)
            }
        @unknown default:
            print("앱 장면: 알 수 없음")
        }
    }
}

// 다음 시나리오 델리게이트 함수에서 SDK를 초기화합니다.

     
// willConnectToSession

- (void)scene:(UIScene *)scene willConnectToSession:(UISceneSession *)session 
  options:(UISceneConnectionOptions *)connectionOptions {
    NSUserActivity* userActivity = [[[connectionOptions userActivities] allObjects] 
      firstObject];
    // Singular SDK 콘솔에서 사용할 수 있도록 공급업체 식별자(IDFV)를 Xcode 콘솔에 인쇄합니다.

    NSLog(@"-- Scene Delegate IDFV: %@", [[[UIDevice currentDevice] identifierForVendor] UUIDString]);
    
    // 백그라운드 앱에서 새 Singular 세션 시작하기

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

- (void)scene:(UIScene *)scene continueUserActivity:(NSUserActivity *)userActivity{
  // 백그라운드 앱에서 새 Singular 세션을 시작합니다.

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

- (void)scene:(UIScene *)scene openURLContexts:(nonnull NSSet *)URLContexts {
  // 딥링크 방식에서 콜드 스타트 시 새 Singular 세션 시작

  SingularConfig *config = [self getConfig];
  config.openUrl = url;
  [Singular start:config];
  
  // 여기에 사용자 지정 코드를 추가하여 비Singular 딥링크로 리디렉션하기

  //...
}

// 다음 앱 델리게이트 함수에서 SDK를 초기화합니다.

    
// didFinishLaunchingWithOptions

- (BOOL)application:(UIApplication *)application 
  didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 사용자가 앱을 열 때 세션 시간 초과/Singular 링크를 사용하여 열린 경우 새 세션을 시작합니다.

    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 {
      // 사용자가 백그라운드에 있는 동안 Singular 링크를 사용하여 앱을 열면 새 세션을 시작합니다.

      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{
    // 사용자가 기존 앱 방식과 같이 비Singular 링크를 사용하여 앱을 열면 새 세션을 시작합니다.

    SingularConfig *config = [self getConfig];
    config.openUrl = url;
    [Singular start:config];
    // 여기에 사용자 지정 코드를 추가하여 비Singular 딥링크로 리디렉션하기

    //...
    return YES;
}

Singular는 서버 간 연동을 통해 추가 모바일 이벤트 추적 데이터를 수신할 수 있습니다. 이 기능을 활용하려면 사용자 ID를 Singular의 모바일 디바이스 추적 식별자에 매핑해야 합니다.

setDeviceCustomUserId("custom_user_id")

[Singular setDeviceCustomUserId:@"a_user_id"];

비구독 인앱 구매

Singular에 구매 이벤트를 보고하려면 iapComplete SDK 메서드를 사용합니다. 이 메서드는 IAP(Apple의 인앱 구매) 구매 이벤트를 Singular로 전송합니다:

• 모든 거래 세부 정보, Singular가 보고서를 보강하는 데 사용할 것입니다.
• 트랜잭션의 유효성을 검사하고 사기 시도를 분석하거나 방지하는 데 사용할 수 있는 트랜잭션 영수증.

iapComplete 메서드

거래 영수증과 함께 구매 이벤트를 Singular로 전송합니다.

서명

(void)iapComplete:(id)transaction

(void)iapComplete:(id)transaction withName:(NSString *)name;

사용 예시

// *** Get the SKPaymentTransaction* transaction object ***


let transaction:SKPaymentTransaction = ...

// Send a transaction event to Singular without a custom event name


Singular.iapComplete(transaction)

// Send a transaction event to Singular with a custom event name


Singular.iapComplete(transaction, withName:"MyCustomRevenue")

// *** Get the SKPaymentTransaction* transaction object ***


SKPaymentTransaction* transaction = ...;

// Send a transaction event to Singular without a custom event name


[Singular iapComplete:transaction];

// Send a transaction event to Singular with a custom event name


[Singular iapComplete:transaction withName:@"MyCustomRevenue"];

구독 구매

StoreKit 연동을 통해 iOS 기기에서 실시간 구독 관리가 가능합니다. 중요: Singular는 구독 이벤트의 유효성을 검사하지 않으며, 이벤트를 Singular로 보내기 전에 디바이스에서 모든 영수증 유효성 검사를 수행해야 합니다. 스토어키트 영수증 확인에 성공한 후에만 Singular의 customRevenue 메서드를 통해 사용자 지정 구매 이벤트를 전송하세요.

1. StoreKit 구현

   스토어키트 프레임워크를 iOS 앱에 연동합니다.

2. 구독 설정

   앱 스토어 커넥트에서 인앱 제품 및 구독 항목을 설정합니다.

3. 구독 정보 쿼리

   구독 상태 및 영수증 정보를 조회하려면 SKPaymentQueue 및 SKReceiptRefreshRequest를 사용하세요.

4. 유효성 검사 수행

   영수증 유효성 검사 기술을 통해 기본 제공 확인을 수행합니다.

5. 구독 이벤트 보내기

import StoreKit

class YourViewController: UIViewController, SKPaymentTransactionObserver {
     override func viewDidLoad() {
          super.viewDidLoad()

          // Add the observer for payment transactions


          SKPaymentQueue.default().add(self)
          
          // Refresh the receipt to get the latest subscription information


          refreshReceipt()
     }
     
     func refreshReceipt() {
          let request = SKReceiptRefreshRequest()
          request.delegate = self
          request.start()
     }

     // Implement SKPaymentTransactionObserver methods


     func paymentQueue(_ queue: SKPaymentQueue, 
          updatedTransactions transactions: [SKPaymentTransaction]) {
               for transaction in transactions {
                    switch transaction.transactionState {
                         case .purchased, .restored:
                         // Handle the purchase or restore


			 // You can check the transaction.transactionReceipt 


                         // for receipt information


			 break
			 case .failed:
			 // Handle the failed transaction


                         break
			 case .deferred:
			 // Handle the deferred transaction


                         break
			 case .purchasing:
			 // Transaction is in progress


                         break
			 @unknown default:
			 break
                    }
               }
          }
     
     // Implement SKRequestDelegate method


     func requestDidFinish(_ request: SKRequest) {
          // Receipt refresh request completed


          // Now you can use the updated receipt to check subscription status


     }
     
     func request(_ request: SKRequest, didFailWithError error: Error) {
          // Handle the error during the receipt refresh request


     }
}

사용자 지정 구매 방법

이벤트 이름과 함께 구매 금액, 통화 및 추가 세부 정보가 포함된 구매 이벤트를 Singular로 전송합니다.

서명

(void)customRevenue:(NSString*)eventname 
     currency:(NSString *)currency 
     amount:(double)amount 
     withAttributes:(NSDictionary*)attributes;

사용 예시

// Create attributes dictionary for subscription purchase


let attributes: [String: Any] = [
     "subscription_id": "premium_monthly",
     "is_trial": false,
     "subscription_period": "monthly",
     "product_id": "com.app.subscription.premium",
     "renewal_type": "auto_renewable",
     "subscription_status": "active"]

// Track revenue event with Singular SDK


Singular.customRevenue("subscription_purchased",  // Event name


     currency: "USD",          // Currency code


     amount: 9.99,             // Purchase amount


     withAttributes: attributes // Custom attributes dictionary


)

구매 유효성 검사 없는 사용자 지정 구매

Singular는 iapComplete 사용을 권장하지만, 앱이 앱스토어 IAP 추적을 사용하지 않는 경우를 대비하여 구매 이벤트를 Singular에 보고할 수 있는 두 가지 대체 방법도 제공합니다.

구매 및 customRevenue 메서드를 사용하면 거래 금액과 통화를 수동으로 지정할 수 있으며, 제품 일련 번호 및 수량 등과 같은 추가 세부 정보도 선택적으로 지정할 수 있습니다. customRevenue 메서드를 사용하면 사용자 지정 이벤트 이름도 전달할 수 있습니다.

이러한 메서드를 사용하는 경우 Singular는 거래 영수증을 받지 못하며 거래의 유효성을 검사할 수 없다는 점에 유의하세요.

구매 메서드

구매 금액, 통화 및 선택적 세부 정보가 포함된 구매 이벤트를 Singular로 전송합니다.

서명

(void)revenue:(NSString *)currency amount:(double)amount;

(void)revenue:(NSString *)currency amount:(double)amount
     productSKU:(NSString *)productSKU 
     productName:(NSString*)productName 
     productCategory:(NSString *)productCategory
     productQuantity:(int)productQuantity 
     productPrice:(double)productPrice;

(void)revenue:(NSString *)currency amount:(double)amount
     withAttributes:(NSDictionary*)attributes;

사용 예시

// Revenue with no product details


Singular.revenue("USD", amount:1.99)

// Revenue with product details


Singular.revenue("EUR", amount:5.00, 
     productSKU:"SKU1928375", 
     productName:"Reservation Fee",
     productCategory:"Fee", 
     productQuantity:1, productPrice:5.00)

// Send a Revenue Event with attributes in a dictionary


var dic: [AnyHashable : Any] = [:]
dic[ATTRIBUTE_SNG_ATTR_ITEM_DESCRIPTION] = "100% Organic Cotton Mixed Plaid Flannel Shirt"
dic[ATTRIBUTE_SNG_ATTR_ITEM_PRICE] = "$69.95"
dic[ATTRIBUTE_SNG_ATTR_RATING] = "5 Star"
dic[ATTRIBUTE_SNG_ATTR_SEARCH_STRING] = "Flannel Shirt"

Singular.revenue("USD", amount: 19.95, withAttributes: dic)

// Revenue with no product details


[Singular revenue:@"USD" amount:1.99];

// Revenue with product details


[Singular revenue:@"EUR" amount:5.00 productSKU:@"SKU1928375"
     productName:@"Reservation Fee" 
     productCategory:@"Fee" 
     productQuantity:1 
     productPrice:5.00];

// Send a Revenue Event with attributes in a dictionary


NSMutableDictionary *dic = [[NSMutableDictionary alloc] init];
[dic setValue:@"100% Organic Cotton Mixed Plaid Flannel Shirt"
     forKey:ATTRIBUTE_SNG_ATTR_ITEM_DESCRIPTION];
[dic setValue:@"$69.95" forKey:ATTRIBUTE_SNG_ATTR_ITEM_PRICE];
[dic setValue:@"5 Star" forKey:ATTRIBUTE_SNG_ATTR_RATING];
[dic setValue:@"Flannel Shirt" forKey:ATTRIBUTE_SNG_ATTR_SEARCH_STRING];

[Singular revenue:@"USD" amount:19.99 withAttributes:dic];

customRevenue 메서드

이벤트 이름, 구매 금액, 통화 코드 및 추가 거래 속성을 지정하여 사용자 지정 구매 이벤트를 Singular로 전송합니다. Singular는 이러한 이벤트를 처리하여 인앱 구매을 추적합니다.

서명

(void)customRevenue:(NSString *)eventName 
     currency:(NSString *)currency 
     amount:(double)amount;

(void)customRevenue:(NSString *)eventName 
     currency:(NSString *)currency 
     amount:(double)amount 
     productSKU:(NSString *)productSKU 
     productName:(NSString *)productName
     productCategory:(NSString *)productCategory 
     productQuantity:(int)productQuantity
     productPrice:(double)productPrice;

(void)customRevenue:(NSString*)eventname 
     currency:(NSString *)currency 
     amount:(double)amount 
     withAttributes:(NSDictionary*)attributes;

사용 예시

// Revenue with a custom name and no product details


Singular.customRevenue("MyCustomRevenue", currency:"USD", amount:1.99)

// Revenue with a custom name and product details


Singular.customRevenue("MyCustomRevenue", currency:"EUR", amount:5.00, 
     productSKU:"SKU1928375", 
     productName:"Reservation Fee", 
     productCategory:"Fee", 
     productQuantity:1, 
     productPrice:5.00)

// Send a Custom Revenue Event with attributes in a dictionary


var dic: [AnyHashable : Any] = [:]
dic[ATTRIBUTE_SNG_ATTR_ITEM_DESCRIPTION] = "100% Organic Cotton Mixed Plaid Flannel Shirt"
dic[ATTRIBUTE_SNG_ATTR_ITEM_PRICE] = "$69.95"
dic[ATTRIBUTE_SNG_ATTR_RATING] = "5 Star"
dic[ATTRIBUTE_SNG_ATTR_SEARCH_STRING] = "Flannel Shirt"
Singular.customRevenue("CustomRevenueWithArgsDic", currency: "USD", amount: 44.99, withAttributes: dic)

// Revenue with a custom name and no product details


[Singular customRevenue:@"MyCustomRevenue" currency:@"USD" amount:1.99];

// Revenue with a custom name and product details


[Singular customRevenue:@"MyCustomRevenue" currency:@"EUR" amount:5.00 
     productSKU:@"SKU1928375" 
     productName:@"Reservation Fee" 
     productCategory:@"Fee"  
     productQuantity:1 
     productPrice:5.00];

// Send a Custom Revenue Event with attributes in a dictionary


NSMutableDictionary *dic = [[NSMutableDictionary alloc] init];
[dic setValue:@"100% Organic Cotton Mixed Plaid Flannel Shirt" 
     forKey:ATTRIBUTE_SNG_ATTR_ITEM_DESCRIPTION];
[dic setValue:@"$69.95" forKey:ATTRIBUTE_SNG_ATTR_ITEM_PRICE];
[dic setValue:@"5 Star" forKey:ATTRIBUTE_SNG_ATTR_RATING];
[dic setValue:@"Flannel Shirt" forKey:ATTRIBUTE_SNG_ATTR_SEARCH_STRING];
[Singular customRevenue:@"MyCustomRevenue" currency:@"USD" amount:44.99 withAttributes:dic];

Singular는 서버에서 구매에 대한 데이터를 수집하여 캠페인의 성과와 ROI를 분석하는 데 도움을 줄 수 있습니다.

요구사항:

• 인앱 등록 또는 로그인 이벤트에서 디바이스 식별자를 캡처하여 전달하고 이 데이터를 서버의 사용자 ID와 함께 저장하세요. 디바이스 식별자는 사용자에 따라 변경될 수 있으므로 사용자가 앱 세션을 생성할 때 식별자를 업데이트해야 합니다. 이렇게 하면 서버 측 이벤트가 올바른 디바이스에 어트리뷰션되도록 보장할 수 있습니다.
• 서버 측 이벤트는 플랫폼별로 다르므로 디바이스 플랫폼과 일치하는 디바이스 식별자(예: iOS 디바이스의 경우 IDFA 또는 IDFV)로만 전송해야 합니다.
• Singular 내부 BI 포스트백 메커니즘을 사용하여 이벤트를 내부 엔드포인트로 실시간으로 푸시하여 서버 측의 데이터 집합을 업데이트할 수 있습니다. 내부 BI 포스트백 FAQ를 참조하세요.
• 자세한 내용은 서버 간 연동 가이드의 "구매 추적 " 섹션을 검토하세요.

이러한 파트너를 활성화하는 방법에 대한 자세한 내용은 아래 링크를 참조하세요.

• RevenueCat 문서에서 자세히 알아보세요.
• adapty 문서에서 자세히 알아보세요.

세그먼트에서 Singular SDK와 병행하여 Singular에 이벤트를 보내려면 세그먼트에 "클라우드 모드" 대상을 추가해야 합니다. 여기에서 가이드를 따르세요.

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

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

1. Build Settings > Build Options. 로 이동합니다.
2. "User Script Sandboxing" 을 "No"값으로 조정합니다.

1. 브리징 헤더가 생성되었는지 확인합니다.
2. 브리징 헤더 파일이 Build Settings > Objective-C Bridging Header.에 링크되어 있는지 확인합니다.