Vungle - iOS SDK 입문

이 쉬운 입문서를 따라 SDK를 앱에 통합하여 수익 창출을 시작할 수 있습니다! 여기에 언급된 소스 코드는 public GitHub 저장소에서 사용할 수 있습니다.

목차

시작하기 전에...
1. Vungle 프레임워크를 Xcode 프로젝트에 추가합니다
2. iOS 상태 막대를 제거합니다
3. 애플리케이션 이동 보안(ATS)
4. 코드
고급 설정 추가

시작하기 전에…

  • Vungle iOS SDK는 iOS 7+만을 지원하며 32bit 및 64bit 앱 모두를 지원합니다.
  • 통합하려면 Vungle 계정이 필요하므로 계정이 없다면 Vungle 계정 만들기를 하십시오.
  • 최신 iOS SDK(4.0.8 이후)는 최신 Xcode 8.0을 지원하기 위해 출시되었습니다. 원활한 통합을 위해 반드시 Xcode 8.0 이상을 사용하시기 바랍니다.
  • 아직 Vungle 계정을 만들지 않은 경우에는 당사의 대시보드로 이동하여 해당 앱을 본인의 계정에 추가합니다. 이렇게 해야 하는 이유는 SDK로 앱에 추가할 예정인 애플리케이션 ID를 획득할 수 있기 때문입니다. 예를 들어 이미지에서 빨간색으로 둥근 표시가 되며 앱 페이지에서 찾을 수 있습니다. 새 애플리케이션에서는 보고 API ID와 일치할 수 있습니다. '검색'을 사용하여 만든 기존 애플리케이션에서는 이상 없는 애플리케이션 ID와 보고 API ID가 다를 수 있습니다. (중개 시 보고 API '키'가 사용자 계정 세부 정보 페이지에 나옴)
 

이제 시작하겠습니다.   

Vungle iOS SDK는 우리가 링크했던 샘플 코드에 포함되지 않습니다. Vungle 대시보드에서 다운로드하여 아카이브의 압축을 풀고 다음의 단계를 따르십시오.

1. Vungle 프레임워크를 Xcode 프로젝트에 추가합니다.

Vungle을 Xcode 프로젝트에 추가하는 두 가지 방식이 있습니다: Cocoapod 사용, or 수동 통합

Cocoapod

Cocoapod에 익숙한 경우

pod "VungleSDK-iOS"

포드파일에 추가함으로써 Vungle을 프로젝트에 빠르게 추가할 수 있습니다.  그런 다음 빠른 포드 설치 실행을 통해 프로젝트를 최신 버전의 iOS SDK로 업데이트해야 합니다!  이제 가이드의 2단계로 건너뛸 수 있습니다.

수동 통합

a. VungleSDK.embeddedFramework를 프로젝트에 추가합니다.

압축을 푼 파일을 찾은 다음 VungleSDK.embeddedFramework를 프레임워크 아래의 Xcode로 끌어다 놓습니다.

중요사항: VungleSDK.embeddedframework 폴더를 그룹(노란색 폴더)으로 추가해야 하며 참조(파란색 폴더)로써 추가하면 안 됩니다.

b. 기타 필요 프레임워크 추가

Vungle SDK는 프로젝트와 연결될 몇 가지 다른 네이티브 프레임워크를 필요로 합니다. 따라서 프로젝트를 클릭하여 다음으로 이동하십시오.

일반 > 연결된 프레임워크 및 라이브러리

이러한 프레임워크 중 많은 경우가 대부분의 Xcode 프로젝트에서 기본 설정에 해당하므로 이미 포함되어 있습니다. 그러나 이미 포함되어 있지 않은 다음의 것들이 반드시 포함되도록 해야 합니다.

  • AdSupport.framework
  • AudioToolbox.framework
  • AVFoundation.framework
  • CFNetwork.framework
  • CoreGraphics.framework
  • CoreMedia.framework
  • Foundation.framework
  • libz.dylib 또는 libz.tbd
  • libsqlite3.dylib 또는 libsqlite3.tbd
  • MediaPlayer.framework
  • QuartzCore.framework
  • StoreKit.framework
  • SystemConfiguration.framework
  • UIKit.framework
  • WebKit.framework                  이 프레임워크를 선택적 의존성으로 추가합니다.

VungleSDK 프레임워크가 연결된 프레임워크 및 라이브러리 아래에 나타나는지 확인하는 것도 바람직합니다. 이전에 행한, 끌어다 놓는 조치를 통해 자동으로 연결되지 않은 경우 '+'를 클릭한 다음 '다른 프레임워크 추가'를 클릭하여 수동으로 추가할 수 있습니다.

c. -ObjC linker flag 추가

빌드 설정으로 이동하여-ObjC를 연결 섹션
기타 Linker Flags에 추가하는 방식으로 추가할 수 있습니다.

 

2. iOS 상태 막대 제거

이것은 필수적인 단계가 아니지만, 상태 막대를 고정해 놓으면 Vungle의 광고 상호작용 및 표시가 원활하게 작동하므로 권장되는 단계입니다. 상태 막대를 제거하려면, Info.pList를 열고 "View controller 기반 상태 막대 외관" 키를 추가하고 "아니오"로 설정합니다.

3. 애플리케이션 이동 보안(ATS)

iOS 9에서 (Xcode 7으로 제작된 빌드와 함께) 시작하는 경우, 애플리케이션 이동 보안은 모든 네트워크 트래픽이 HTTPS를 통해 보안된 앱으로 제작될 것을 요구합니다. Vungle iOS 10 전환 가이드에서 자세한 내용을 참조하십시오. Vungle iOS SDK는 ATS 변경이 완전히 가능하며, 2017년 1월 1일부터 Vungle SDK로부터의 모든 트래픽이 HTTPS를 사용할 예정입니다. 그 이전에는 NSAllowsArbitraryLoads 값을 '예'로 설정할 것을 권장합니다.

4. 코드 추가!

a. SDK 초기화

SDK를 최대한 신속하게 초기화하여 광고를 사용자를 위해 적시에 사전 캐싱해 놓는 것이 중요합니다.  샘플 프로젝트(모든 iOS 프로젝트에 대한 권장 사항)에서는 초기화 호출을 메인 AppDelegate의 didFinishLaunchingWithOptions 방법에 추가하겠습니다.

참고: VungleSDK.h를 가져오려 하는데 찾을 수 없는 경우, 참조를 제거하고 선택된 "필요한 경우 아이템 복사" 옵션과 함께 다시 추가합니다.

  • AppDelegate.h:
#import <VungleSDK/VungleSDK.h>
  • AppDelegate.m : didFinishLaunchingWithOptions:
NSString* appID = @"Your AppID Here";
VungleSDK* sdk = [VungleSDK sharedSDK];
// vungle 퍼블리셔 라이브러리 시작
[sdk startWithAppId:appID];

b. ViewController에서 광고 재생

이전에 AppDelegate의 didFinishLaunchingWithOptions에서 초기화된 SDK의 경우, 다음의 코드 마디를 가장 많이 표시되는 ViewController에 추가하는 것만으로도 광고를 사용자에게 표시할 수 있습니다.

참고: startWithAppId 방법은 단 한번만 호출해야 합니다. 두 번 이상 호출할 경우 정의되지 않은 행동을 유발할 수 있습니다.

c. 가장 많이 표시되는 ViewController 클래스에서 광고 재생

  • #import <VungleSDK/VungleSDK.h>
    
    ...
    VungleSDK* sdk = [VungleSDK sharedSDK];
    NSError *error;
    [sdk playAd:self error:&error];
    

    The NSError 파라미터는 광고를 표시하는 동안 문제가 발생하는 경우 오류 정보를 포함하도록 업데이트됩니다.

참고: playAd 방법을 위한 ViewController는 보기 계층 구조에서 가장 많이 표시된 ViewController가 됩니다. 그렇지 않을 경우 정의되지 않은 행동을 유발하게 됩니다.

d. 오디오 재생 재개

고급 설정 가이드를 확인하여 재생 이벤트를 구독합니다. 오디오 중지 상태를 해제하고 게임 등을 재개하기 위해 사용할 수 있습니다.

참고:

  • 테스트 모드: 앱이 테스트 모드에 있는 동안에는 광고 중인 앱을 다운로드할 수 없습니다. 또한, 대시보드가 광고 노출 수를 보고하지 않습니다. 이는 사용자가 올바르게 SDK를 통합했는지 확인하는 데에만 테스트 광고가 사용되기 때문입니다. 이 기능은 해당 앱이 활성 모드에서 작동할 준비가 되었을 때 비로소 제공됩니다

  • 재생 버튼: Vungle이 4.0.x 이상 SDK 버전의 iOS를 위한 엔드카드 재생 버튼을 제거했습니다. 해당 버튼이 광고 단위에 남아 있는 경우 재생 기능이 더 이상 작동하지 않게 됩니다.

고급 설정

Vungle iOS SDK의 보다 고급한 세부 사항(사용자 지정, 이벤트 리스너 등)에 관심이 있는 경우 고급 설정 가이드를 확인하시기 바랍니다.

또 다른 질문이 있으십니까? 문의 등록

댓글