본문으로 건너뛰기

SDK 초기화

앱 실행 시, SDK가 정상적인 동작을 하도록 초기화하는 과정을 안내합니다.

코드의 역할에 대한 설명 이후 적용 코드 예시를 확인할 수 있습니다.


import 하기​

AppDelegate 내에서 SDK에 접근하기 위해 상단에 MiniPlengi를 추가합니다.


SDK 초기화​

SDK 초기화를 위해 Plengi.initialize를 호출합니다

해당 함수의 파라미터로 로플랫으로부터 전달받은 clientID와 clientSecret을 전달합니다.

위험

"Plengi.initialize() 함수는 반드시 AppDelegate 안의 application(_:didFinishLaunchingWithOptions:) 에서 호출되어야 합니다." 다른 곳에서 호출할 경우, SDK의 정상 동작을 보장하지 못합니다.


echoCode 설정​

echoCode는 로플랫과 데이터 연동 시, 고객사의 통합 결과 분석을 지원하기 위한 사용자 식별 코드입니다.

이 코드는 고객사에 전달하는 데이터에 포함됩니다.

설정하지 않아도 SDK는 작동합니다.

"echoCode 에는 개인정보가 포함되면 안 됩니다."

이메일, 전화번호와 같은 개인정보 혹은 광고ID(ADID, IDFA)를 전달하지 마세요.


PlaceDelegate 등록​

SDK 이벤트를 전달받기 위해 AppDelegate에서 PlaceDelegate를 채택합니다.

Plengi.initialize가 성공한 이후, Plengi.setDelegate를 호출합니다.

정보

SDK 이벤트에는 장소 요청 결과와 캠페인 매칭 결과가 포함되어 있습니다.
캠페인 매칭 결과는 loplat X를 통합한 이후 받을 수 있으며, 그 방법은 loplat X 연동을 참고해 주세요

팁

장소 요청 결과의 구조 및 의미에 대한 설명은 "테스트"의 장소 요청 테스트에서 확인할 수 있습니다.
캠페인 매칭 결과의 구조 및 의미에 대한 설명은 "테스트"의 loplat X 연동 테스트에서 확인할 수 있습니다.


적용 코드 예시​

import MiniPlengi

func application(
    _ application: UIApplication,
    didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil
) -> Bool {
    ...
    
    if Plengi.initialize(clientID: "로플랫에서 발급받은 클라이언트 아이디", clientSecret: "로플랫에서 발급받은 클라이언트 키") == .SUCCESS {
        // init 성공

        // 필요시 호출
        if Plengi.setEchoCode(echoCode: "고객사별 사용자를 식별할 수 있는 코드 (개인정보 주의 바람)") == .SUCCESS {
            // echoCode 등록 성공
        } else {
            // echoCode 등록 실패
        }

        if Plengi.setDelegate(self) == .SUCCESS {
            // setDelegate 등록 성공
        } else {
            // setDelegate 등록 실패
        }
    } else {
        // init 실패
    }

    ...
}

// PlaceDelegate 채택 및 구현
extension AppDelegate: PlaceDelegate {
  func responsePlaceEvent(_ plengiResponse: PlengiResponse) {
    if let _ = plengiResponse.echoCode {
        // 고객사에서 설정한 echoCode
    }

    if plengiResponse.result == .SUCCESS {
        // 성공
    } else {
        // 실패
    }
  }
}