설치 및 초기화

Finteza SDK를 설치하려면, CocoaPods 또는 Carthage 팩키지를 사용하시거나 다음에서 파일 아카이브를 다운로드 하세요: GitHub 수동.

CocoaPods를 통한 설치 #

Finteza SDK를 연결하려면, 프로젝트의 Podfile 에 다음 문자열을 추가하세요:

pod 'FintezaSDK'

그런 다음, 설치 명령을 실행하세요:

pod install

CocoaPods로 작업 할 때는 언제나 .xcodeproj 파일 대신 .xcworkspace 파일을 사용하세요.

Carthage를 통한 설치 #

Finteza SDK를 연결하려면, 프로젝트의 Cartfile 에 다음 문자열을 추가하세요:

github "finteza/mobile-sdk-ios"

수동 설치 #

FintezaSDK-X.X.X.framework.zip 파일을 다운 받아 압축을 해재하세요. 이후, FintezaSDK.framework를 Xcode의 프로젝트로 전송하세요.

설치가 진행되는 동안 "Copy items if needed" 옵션을 활성화하세요.

애플리케이션에서 SDK 초기화 #

애플리케이션 델리게이트의 파일을 열고 Finteza SDK를 가져오세요:

Objective-C:

#import <FintezaSDK/FintezaSDK.h>

Swift:

import FintezaSDK

웹 사이트 ID 및 주소를 사용하여 didFinishLaunchingWithOptions 메소드에서 SDK를 초기화하세요:

Objective-C:

[Finteza initialize:@"{WEBSITE_ID}" site:@"{WEBSITE_URL}" product:@"{PRODUCT}"];

Swift:

Finteza.initialize("{WEBSITE_ID}", site: "{WEBSITE_URL}", product: "{PRODUCT}")

웹사이트 ID를 다음으로 설정하세요: {WEBSITE_ID}. 다음의 웹사이트 설정 (ID 필드)에서 얻을 수 있습니다: Finteza 패널. 그런 다음, 매개변수를 설정하세요:

매개변수

유형

설명

사이트

문자열

웹사이트 도메인 이름, 예: "my.site.com".

제품

문자열

애플리케이션이 레이블링 이벤트의 접두부로 사용되는 제품 이름을 Finteza로 보냈습니다.

PC, iOS, Android 등의 애플리케이션이 있는 경우 서로 다른 플랫폼에서 이벤트를 분리해야 할 수도 있습니다. 예를 들면, "iOS App" 제품을 지정하고 "Registration"이벤트를 보내면 Finteza의 최종 이벤트 이름은 "iOS App Registration"이 됩니다.

접두부를 사용하지 않으려면 'nil'을 설정하세요.

추후 다음 함수를 사용해 제품 이름을 변경할 수 있습니다. setProduct 함수:

Objective-C:

[Finteza setProduct:@"{PRODUCT}"];

Swift:

Finteza.setProduct("{PRODUCT}")

애플리케이션 시작 이벤트 #

다음 코드를 applicationDidBecomeActive에 추가하세요:

Objective-C:

[Finteza activate];

Swift:

Finteza.activate()

다음 activate호출 시, SDK는 첫 번째 애플리케이션이 실행되는 동안 "Install Finish" 이벤트를 Finteza로 보냅니다 ( 제품 접두부가 설정된 경우에는, "{PRODUCT} Install Finish" 이벤트 전송).

또한 activate호출 시, 새로운 작업 세션이 시작되고 "Session Start" 이벤트가 등록됩니다 (제품 접두부가 설정된 경우에는, "{PRODUCT} Session Start" 이벤트 등록).

새로운 세션은 애플리케이션이 비 활성화 되고 기존 시간이 3분 이상 지난 경우에 한해 시작됩니다.

디버깅 메시지 #

SDK를 사용한 작업을 테스트하기 위해, 개발자 콘솔에 디버깅 데이터를 출력 할 수 있습니다. 데이터 중에서 이벤트 및 디스플레이 된 광고의 데이터는 별도로 표시됩니다.

이벤트

Objective-C:

[Finteza addLogging:FintezaLogModeEvents];

Swift:

Finteza.addLogging(FintezaLogModeEvents)

Objective-C:

[Finteza addLogging:FintezaLogModeBanner];

Swift:

Finteza.addLogging(FintezaLogModeBanner)

예

다음 디버깅 메시지는 activate 메소드 호출이 없기 때문에 이벤트 전송 오류를 나타냅니다:

[event]가 'Book Load' 이벤트를 보낼 수 없음: 'activate' 메소드를 먼저 호출하세요