Getting Started with the ironSource iOS SDK (Korean)

시작하기 전에 확인하세요
iOS 버전 8+ 지원합니다.
XCode 버전 9.3보다 낮은버전을 사용하시는 경우 ‘bitcode‘ 를 비활성화 한 상태에서 아카이브 하시는 것을 권해드립니다.

아이언소스 SDK를 다운로드, 사용 및 액서스 하실때는 모바일 SDK 퍼블리셔 온라인 조약이 적용이 됩니다. 해당 조약을 동의하시는 경우에만 사용 부탁드립니다.

iOS SDK 6.8.6버전부터 ironSource SDK는 iOS 13 및 Xcode 11을 지원합니다. 

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

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

CocoaPods


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

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

pod 'IronSourceSDK','7.9.0.0'

SDK 수동 통합

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

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

App Transport Security Settings


앱 전송 보안설정 중요 사항! iOS9에서 애플은 ‘ATS’에 대한 제어를 추가했습니다. 모든 미디에이션 네트워크에서 ironSource 광고 공급에 대한 중단 없는 지원을 보장하려면 info.plist에서 다음과 같이 변경해야 합니다:

  • NSAppTransportSecurity‘라는 딕셔너리를 추가합니다. 이 딕셔너리를 ‘최상위 수준 키‘에 추가해야 합니다’.
  •  딕셔너리 안에 ‘NSAllowsArbitraryLoads‘라는 불리언을 추가하고 YES로 설정합니다.
    ats

Note: 참고:
    • info.plist에 ‘NSAllowsArbitraryLoads‘ 이외의 다른 예외가 없는지 확인하세요. 그렇지 않으면 충돌이 발생할 수 있습니다.

    • ATS에 대한 자세한 내용은 여기를 참조하세요.

    ironSource 미디에이션 데모 앱

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

    Download iOS Demo Application

    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 적용을 해드립니다.

    Note: 참고: 사용자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 광고 단위 및 첨단 미디에이션 플랫폼을 사용하여 작업할 준비가 되었습니다.