Getting Started with the ironSource iOS SDK (Korean)

1단계. 프로젝트에 SDK 추가하기

ironSource는 SDK를 통합하기 위해 Cocoapods 및 수동 다운로드 메커니즘을 모두 지원합니다:

CocoaPods

CocoaPods 는 Objective-C 및 Swift의 종속성 관리자이며 SDK 통합 프로세스를 자동화하고 간소화합니다. CocoaPods 안내서는 시작하기 및 CocoaPods 사용하기에서 확인할 수 있습니다.

SDK를 Cocoapods와 통합하려면 다음 줄을 podfile에 입력하세요:

pod 'IronSourceSDK','8.5.1.0'

# Supports LevelPlay SDK version 8.5.0
pod 'IronSourceAdQualitySDK','7.22.3' 

SDK 수동 통합

ironSource SDK를 프로젝트에 추가하려면 다음 단계를 따라 진행하세요:

1. IronSource 프레임워크 추가 SDK를 다운로드한 후 압축을 풀고 IronSource.framework를 Xcode 프로젝트에 추가합니다.
2. 상태 표시줄 제어 ironSource SDK가 상태 표시줄을 숨기도록 하려면 (앱에서 표시되더라도), info.plist에서 컨트롤러 기반의 상태 표시줄 보기 플래그 값을 추가하고 NO로 설정합니다.
   
3. 링커 플래그 다음 링커 플래그를 빌드 설정에 추가하세요: Target ➣ Build Settings ➣ Linking ➣ Other Linker Flags: –ObjC

ironSource 미디에이션 데모 앱

통합 데모 애플리케이션은 앱에서 ironSource 조정을 통합하는 방법을 보여드립니다.

2단계. 대리자 설정

1. 다음 파일을 가져옵니다:
   OBJECTIVE-C
   

   #import "IronSource/IronSource.h"

   SWIFT
   IronSource-Bridging-Head.h를 다운로드합니다. 그리고 Targets ➣ Build Settings ➣ Objective-C 브리지 헤더로 이동하여 브리지 헤더 파일에 경로를 추가합니다. 자세한 설명 및 헤더 파일 다운로드는 여기에서 가능합니다. 

2.  선택 사항: 자세한 로그 이벤트를 수신하려면 로그 대리자에 등록할 수 있습니다.
   OBJECTIVE-C
   

   [IronSource setLogDelegate:YOUR_LOG_DELEGATE];

   SWIFT

   IronSource.setLogDelegate(myLogDelegate)

3. 대리자 설정  ironSource SDK는 광고 단위 활동을 알리기 위해 몇 가지 이벤트를 발생시킵니다. 이러한 이벤트를 수신하려면 ironSource 플랫폼에 설정한 광고 단위 대리자에 등록하시기 바랍니다.
   1. 보상 비디오의 경우
      OBJECTIVE-C
      

      [IronSource setRewardedVideoDelegate:yourRewardedVideoDelegate];

      SWIFT
      

      IronSource.setRewardedVideoDelegate(yourRewardedVideoDelegate)

   2. 전면 광고의 경우
      OBJECTIVE-C

      [IronSource setInterstitialDelegate:yourInterstitialDelegate];

      SWIFT
      

      IronSource.setInterstitialDelegate(yourInterstitialDelegate)

   3. Offerwall의 경우
      OBJECTIVE-C
      

      [IronSource setOfferwallDelegate:yourOfferwallDelegate];

      SWIFT
      

      IronSource.setOfferwallDelegate(yourOfferwallDelegate)

3단계. 사용자ID 설정

오퍼월 광고 단위를 게재하거나 서버 간 콜백을 사용하고 보상 광고 단위를 통해 사용자에게 보상하는 경우 사용자ID를 설정해야 합니다. 사용자ID는 각 사용자에 대한 고유 식별자입니다. 사용자ID 매개 변수를 스스로 설정할 수 있습니다. 코드에서 사용자ID 설정을 생략하고 건너뛸 경우 SDK단에서 유효한 사용자ID를 대신 생성해 ID 적용을 해드립니다.

1~64자의 NSString을 지원합니다. 일반적인 방법은 애플 광고 ID(IDFA)를 사용하는 것입니다. 사용자 ID에 대한 자세한 내용은 여기를 참조하세요.

OBJECTIVE-C

[IronSource setUserId:YOUR_USERID];

SWIFT

IronSource.setUserId(userID)

4단계. ironSource SDK 초기화

두 가지 방법으로 SDK를 초기화할 수 있습니다.

1. 첫 번째 방법은 귀하가 정의한 특정 광고 단위를 가져오므로 이를 사용하는 것이 좋습니다. 광고 단위는 문자열 배열입니다.  이 방법은 adUnits 매개 변수에 언급된 특정 광고 단위를 초기화합니다:
   OBJECTIVE-C
   

   [IronSource initWithAppkey:YOUR_APP_KEY adUnits:YOUR_AD_UNITS];

   SWIFT
   

   IronSource.initWithAppkey(kAPPKEY, adUnits:YOUR_AD_UNITS)

   Sample:
   OBJECTIVE-C
   

   [IronSource initWithAppKey:APP_KEY adUnits:@[IS_REWARDED_VIDEO]];
   /** or for all ad units
   [IronSource initWithAppKey:APP_KEY adUnits:@[IS_REWARDED_VIDEO,IS_INTERSTITIAL,IS_OFFERWALL, IS_BANNER]];

   
   SWIFT
   

   IronSource.initWithAppKey(kAPPKEY, adUnits:[IS_REWARDED_VIDEO];
   /** or for all ad units
   IronSource.initWithAppKey(kAPPKEY, adUnits:[IS_REWARDED_VIDEO,IS_INTERSTITIAL,IS_OFFERWALL, IS_BANNER];

2. 또는 아래에 설명된 대로 SDK를 초기화하면 SDK는 ironSource 플랫폼에 구성한 광고 단위를 초기화합니다:OBJECTIVE-C

   [IronSource initWithAppkey:YOUR_APP_KEY];

   SWIFT
   

   IronSource.initWithAppKey(kAPPKEY)
   

5단계. 통합 확인

ironSource SDK는 SDK 및 미디에이션 통합이 성공적으로 완료되었는지 쉽게 확인하는 방법을 제공합니다. ironSource SDK 통합 및 사용자가 구현한 모든 추가 광고 네트워크를 확인하려면 이 메소드를 프로젝트에 추가하기만 하면 됩니다:

OBJECTIVE-C 

[ISIntegrationHelper validateIntegration];

SWIFT

ISIntegrationHelper.validateIntegration()

ironSource 통합 확인 도구에 대한 자세한 내용은 이 기사를 참조하세요.   완료! 방금 ironSource SDK를 앱에 통합했습니다. 이제 ironSource 광고 단위 및 첨단 미디에이션 플랫폼을 사용하여 작업할 준비가 되었습니다.