라이브 업데이트

개요

사용자 세그먼트화는 각 그룹의 사용자 간 유사성이 반영된 여러 그룹으로 사용자를 나누는 관행입니다. 일반적인 예는 geographic segmentation으로, 이는 지리적 기준에 따라 사용자를 나눕니다. 사용자 세그먼트화의 목적은 각 세그먼트에서 사용자를 관련시킬 방법을 결정하여 값을 최대화하는 것입니다.

Mobile Foundation의 라이브 업데이트 기능을 사용하여 애플리케이션의 각 사용자 세그먼트에 대한 서로 다른 구성을 간단하게 정의하고 제공할 수 있습니다. 해당 MobileFirst Operations Console에는 각 세그먼트에 대한 구성의 값 및 해당 구성의 구조를 정의하는 데 필요한 컴포넌트가 포함되어 있습니다. 구성을 이용하는 데 필요한 클라이언트 SDK(Android 및 iOS 네이티브 애플리케이션 및 Cordova 애플리케이션에 사용 가능)도 제공됩니다.

공통 유스 케이스

라이브 업데이트는 세그먼트 기반 구성의 정의 및 이용을 지원하여 애플리케이션에 대해 세그먼트 기반 사용자 정의를 쉽게 작성할 수 있도록 합니다. 공통 유스 케이스에는 다음이 포함될 수 있습니다.

• 릴리스 트레인 및 기능 플립핑
• A/B 테스트
• 컨텍스트 기반 애플리케이션 사용자 정의(예: 지리적 세그먼트화)

데모

다음 비디오에서는 라이브 업데이트 기능을 보여줍니다.

다음으로 이동:

• 라이브 업데이트 아키텍처
• MobileFirst Server에 라이브 업데이트 추가
• 애플리케이션 보안 구성
• 스키마 및 세그먼트
• 애플리케이션에 라이브 업데이트 SDK 추가
• 라이브 업데이트 SDK 사용
• 고급 주제
• 샘플 애플리케이션

라이브 업데이트 아키텍처

다음 시스템 컴포넌트가 함께 작동하여 라이브 업데이트 기능을 제공합니다.

• 라이브 업데이트 어댑터: 다음 사항을 제공하는 어댑터입니다.
• 애플리케이션 스키마 및 세그먼트 관리
• 애플리케이션에 구성 제공
• 세그먼트 분석기 어댑터: 선택사항. 개발자에 의해 구현되는 사용자 정의 어댑터입니다. 이 어댑터는 애플리케이션 컨텍스트(예: 사용자 정의 매개변수를 포함하여 디바이스 및 사용자 컨텍스트)를 수신하고 컨텍스트에 일치하는 세그먼트의 ID를 리턴합니다.
• 클라이언트 측 SDK: 라이브 업데이트 SDK는 MobileFirst Server의 구성요소(예: 기능 및 특성)를 검색하고 액세스하는 데 사용됩니다.
• MobileFirst Operations Console: 라이브 업데이트 어댑터 및 설정을 구성하는 데 사용됩니다.
• 구성 서비스: 내부. 라이브 업데이트 어댑터에 대한 구성 관리 서비스를 제공합니다.

MobileFirst Server에 라이브 업데이트 추가

기본적으로 MobileFirst Operations Console에서 라이브 업데이트 설정은 숨겨집니다. 이를 사용하려면 제공된 라이브 업데이트 어댑터를 배치해야 합니다.

1. MobileFirst Operations Console을 여십시오. 사이드바 탐색에서 다운로드 센터 → 도구 탭을 클릭하십시오.
2. 라이브 업데이트 어댑터를 다운로드하고 배치하십시오.

배치가 완료되면 등록된 각 애플리케이션에 대한 라이브 업데이트 설정 화면이 표시됩니다.

애플리케이션 보안 구성

라이브 업데이트와 통합을 허용하려면 범위 요소가 필요합니다. 범위 요소가 없으면 클라이언트 애플리케이션의 요청이 어댑터에서 거부됩니다.

MobileFirst Operations Console을 로드하고 [애플리케이션] → 보안 탭 → 범위 요소 맵핑을 클릭하십시오. 새로 작성을 클릭하고 범위 요소 구성-사용자-로그인을 입력하십시오. 그런 다음 추가를 클릭하십시오.

또한 애플리케이션에서 보안 검사를 사용 중인 경우 해당 보안 검사에 범위 요소를 맵핑할 수도 있습니다.

MobileFirst 보안 프레임워크에 대해 자세히 알아보십시오.

스키마 및 세그먼트

라이브 업데이트 설정 화면에서 다음 두 개의 탭을 사용할 수 있습니다.

스키마 개념

스키마는 기능 및 특성이 정의되는 위치입니다.

• “기능”을 사용하여 구성 가능한 애플리케이션 기능을 정의하고 해당 기본값을 설정할 수 있습니다.
• “특성”을 사용하여 구성 가능한 애플리케이션 특성을 정의하고 해당 기본값을 설정할 수 있습니다.

세그먼트

세그먼트는 스키마에서 정의한 기본 기능 및 특성을 사용자 정의하여 고유 애플리케이션 동작을 정의합니다.

스키마 및 세그먼트 추가

애플리케이션에 대한 스키마 및 세그먼트를 추가하려면 먼저 개발자 또는 제품 관리 팀에서 다음 여러 측면에 대해 결정해야 합니다.

• 라이브 업데이트를 이용하는 기능 세트 및 해당 기본 상태
• 구성 가능한 문자열 특성 세트 및 해당 기본값
• 애플리케이션의 시장 세그먼트

각 시장 세그먼트에 대해 다음 사항을 결정해야 합니다.

• 각 기능의 상태 및 애플리케이션 수명 중에 해당 상태를 변경할 수 있는 방법
• 각 특성의 값 및 애플리케이션 수명 중에 해당 값을 변경할 수 있는 방법

매개변수를 결정한 후에 스키마 기능 & 특성 및 세그먼트를 추가할 수 있습니다.
추가하려면 새로 작성을 클릭하고 요청되는 값을 제공하십시오.

기본값을 사용하여 스키마 기능 및 특성 정의

시장 세그먼트에 해당하는 세그먼트 정의

기능 및 특성의 기본값 대체

기능을 사용으로 설정하고 해당 기본 상태를 변경하십시오.

특성의 기본값을 대체하십시오.

애플리케이션에 라이브 업데이트 SDK 추가

라이브 업데이트 SDK는 MobileFirst Operations Console에 등록된 애플리케이션의 라이브 업데이트 설정 화면에서 이전에 정의된 런타임 구성 기능 및 특성을 조회하는 API를 개발자에게 제공합니다.

Cordova의 경우, SDK 버전 8.0.2019100111 또는 그 이전 버전을 사용합니다.

• Cordova 플러그인 문서

Android의 경우, SDK 버전 8.0.0을 사용합니다.

• Android SDK 문서

iOS의 경우, SDK 버전 8.0.2017092018 또는 그 이전 버전을 사용합니다.

• iOS Swift SDK 문서

Cordova 플러그인 추가

Cordova 애플리케이션 폴더에서 다음을 실행하십시오.

cordova plugin add cordova-plugin-mfp-liveupdate

iOS SDK 추가

1. IBMMobileFirstPlatformFoundationLiveUpdate 팟(Pod)을 추가하여 애플리케이션의 Podfile을 편집하십시오.
   예:

   use_frameworks!
   
   target 'your-Xcode-project-target' do
      pod 'IBMMobileFirstPlatformFoundation'
      pod 'IBMMobileFirstPlatformFoundationLiveUpdate'
   end
   

2. 명령행 창에서 Xcode 프로젝트의 루트 폴더로 이동하고 pod install 명령을 실행하십시오.

Android SDK 추가

1. Android Studio에서 Android → Gradle 스크립트를 선택한 후 build.gradle(모듈: 앱) 파일을 선택하십시오.

2. dependencies 내에 ibmmobilefirstplatformfoundationliveupdate를 다음과 같이 추가하십시오.

   dependencies {
        compile group: 'com.ibm.mobile.foundation',
        name: 'ibmmobilefirstplatformfoundation',
        version: '8.0.+',
        ext: 'aar',
        transitive: true
   
        compile group: 'com.ibm.mobile.foundation',
        name: 'ibmmobilefirstplatformfoundationliveupdate',
        version: '8.0.0',
        ext: 'aar',
        transitive: true
   }   
   

라이브 업데이트 SDK 사용

여러 가지 방식으로 라이브 업데이트를 사용할 수 있습니다.

사전 판별된 세그먼트

관련 세그먼트에 대한 구성을 검색하는 로직을 구현하십시오.
“segment-name”, “property-name” 및 “feature-name”을 고유 항목으로 대체하십시오.

Cordova

    var input = { segmentId :'segment-name' };
    LiveUpdateManager.obtainConfiguration(input,function(configuration) {
        // do something with configration (JSON) object, for example,
        // if you defined in the server a feature named 'feature-name':
        // if (configuration.features.feature-name) {
        //   console.log(configuration.properties.property-name);
	// }
    } ,
    function(err) {
        if (err) {
           alert('liveupdate error:'+err);
        }
  });

iOS

LiveUpdateManager.sharedInstance.obtainConfiguration("segment-name", completionHandler: { (configuration, error) in
  if error == nil {
    print (configuration?.getProperty("property-name"))
    print (configuration?.isFeatureEnabled("feature-name"))
  } else {
    print (error)
  }
})

Android

LiveUpdateManager.getInstance().obtainConfiguration("segment-name", new ConfigurationListener() {

    @Override
    public void onSuccess(final Configuration configuration) {
        Log.i("LiveUpdateDemo", configuration.getProperty("property-name"));
        Log.i("LiveUpdateDemo", configuration.isFeatureEnabled("feature-name").toString());
    }

    @Override
    public void onFailure(WLFailResponse wlFailResponse) {
        Log.e("LiveUpdateDemo", wlFailResponse.getErrorMsg());
    }
});

라이브 업데이트 구성이 검색된 경우 애플리케이션 로직 및 애플리케이션 플로우는 기능과 특성 상태에 따라 다를 수 있습니다. 예를 들어 오늘이 국경일인 경우 애플리케이션에 새 마케팅 프로모션을 도입하십시오.

세그먼트 분석기 어댑터

“세그먼트 분석기” 어댑터는 라이브 업데이트 아키텍처 주제에서 언급되었습니다.
이 어댑터는 애플리케이션/디바이스/사용자 컨텍스트 및 애플리케이션 사용자 정의 매개변수를 기반으로 세그먼트를 검색하는 데 필요한 사용자 정의 비즈니스 로직을 제공하는 데 사용됩니다.

세그먼트 분석기 어댑터를 사용하려면 다음을 수행하십시오.

1. 새 Java 어댑터를 작성하십시오.
2. 어댑터 → 라이브 업데이트 어댑터 → segmentResolverAdapterName에서 해당 어댑터를 세그먼트 분석기 어댑터로 정의하십시오.
3. 개발이 완료되면 빌드하고 배치하십시오.

세그먼트 분석기 어댑터는 REST 인터페이스를 정의합니다. 이 어댑터에 대한 요청의 본문에는 일반 사용자가 속한 세그먼트를 결정하는 데 필요한 모든 정보가 포함되어 있으며, 해당 요청은 이러한 정보를 애플리케이션에 다시 전송합니다.

매개변수로 구성을 가져오려면 라이브 업데이트 API를 사용하여 요청을 보내십시오.

Cordova 분석기

var input = { params : { 'paramKey': 'paramValue'} ,useClientCache : true };
LiveUpdateManager.obtainConfiguration(input,function(configuration) {
        // do something with configration (JSON) object, for example:
        // console.log(configuration.properties.property-name);                                                                                                             // console.log(configuration.data.features.feature-name);
    } ,
    function(err) {
        if (err) {
           alert('liveupdate error:'+err);
        }
  });

iOS

LiveUpdateManager.sharedInstance.obtainConfiguration(["paramKey":"paramValue"], completionHandler: { (configuration, error) in
  if error == nil {
    print (configuration?.getProperty("property-name"))
    print (configuration?.isFeatureEnabled("feature-name"))
  } else {
    print (error)
  }
})

Android

Map <String,String> params = new HashMap<>();
params.put("paramKey", "paramValue");

LiveUpdateManager.getInstance().obtainConfiguration(params , new ConfigurationListener() {

    @Override
    public void onSuccess(final Configuration configuration) {
        Log.i("LiveUpdateDemo", configuration.getProperty("property-name"));
        Log.i("LiveUpdateDemo", configuration.isFeatureEnabled("feature-name").toString());
    }

    @Override
    public void onFailure(WLFailResponse wlFailResponse) {
        Log.e("LiveUpdateDemo", wlFailResponse.getErrorMsg());
    }
});

어댑터 구현

애플리케이션에서 라이브 업데이트 클라이언트 SDK를 사용하여 제공되는 인수는 라이브 업데이트 어댑터로 전달된 후에 세그먼트 분석기 어댑터로 전달됩니다. 이는 라이브 업데이트 어댑터에 의해 자동으로 수행되며 개발자 조치가 필요하지 않습니다.

관련 세그먼트를 리턴하도록 이러한 인수를 처리하려면 새로 작성된 세그먼트 분석기 어댑터의 구현을 업데이트하십시오.
다음은 사용할 수 있는 샘플 코드입니다.

참고: 어댑터의 pom.xml에 Gson 종속 항목을 다음과 같이 추가하십시오.

<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.7</version>
</dependency>

SampleSegmentResolverAdapterApplication.java

@Api(value = "Sample segment resolver adapter")
@Path("/")
public class SampleSegmentResolverAdapter {

    private static final Gson gson = new Gson();
    private static final Logger logger = Logger.getLogger(SampleSegmentResolverAdapter.class.getName());

    @POST
    @Path("segment")
    @Produces("text/plain;charset=UTF-8")
    @OAuthSecurity(enabled = true, scope = "configuration-user-login")
    public String getSegment(String body) throws Exception {
        ResolverAdapterData data = gson.fromJson(body, ResolverAdapterData.class);
        String segmentName = "";

        // Get the custom arguments
        Map<String, List<String>> arguments = data.getQueryArguments();

        // Get the authenticatedUser object
        AuthenticatedUser authenticatedUser = data.getAuthenticatedUser();
        String name = authenticatedUser.getDisplayName();

        // Get registration data such as device and application
        RegistrationData registrationData = data.getRegistrationData();
        ApplicationKey application = registrationData.getApplication();
        DeviceData deviceData = registrationData.getDevice();

        // Based on the above context (arguments, authenticatedUser and registrationData) resolve the segment name.
        // Write your custom logic to resolve the segment name.

        return segmentName;
    }
}

SampleSegmentResolverAdapter.java

public class ResolverAdapterData {
    public ResolverAdapterData() {
    }

    public ResolverAdapterData(AdapterSecurityContext asc, Map<String, List<String>> queryArguments)
    {
        ClientData cd = asc.getClientRegistrationData();

        this.authenticatedUser = asc.getAuthenticatedUser();
        this.registrationData = cd == null ? null : cd.getRegistration();
        this.queryArguments = queryArguments;
    }

    public AuthenticatedUser getAuthenticatedUser() {
        return authenticatedUser;
    }

    public RegistrationData getRegistrationData() {
        return registrationData;
    }

    public Map<String, List<String>> getQueryArguments() {
        return queryArguments;
    }

    private AuthenticatedUser authenticatedUser;
    private RegistrationData registrationData;
    private Map<String, List<String>> queryArguments;
}

세그먼트 분석기 어댑터의 REST 인터페이스

요청

응답

고급 주제

가져오기/내보내기

시스템 관리자는 정의된 스키마와 세그먼트를 내보내고 다른 서버 인스턴스로 가져올 수 있습니다.

스키마 내보내기

curl --user admin:admin http://localhost:9080/mfpadmin/management-apis/2.0/runtimes/mfp/admin-plugins/liveUpdateAdapter/com.sample.HelloLiveUpdate/schema > schema.txt

스키마 가져오기

curl -X PUT -d @schema.txt --user admin:admin -H "Content-Type:application/json" http://localhost:9080/mfpadmin/management-apis/2.0/runtimes/mfp/admin-plugins/liveUpdateAdapter/com.sample.HelloLiveUpdate/schema

• “admin:admin”을 고유 항목으로 대체(기본값은 “admin”)
• 필요한 경우 “localhost” 및 포트 번호를 기본 항목으로 대체
• 애플리케이션 ID “com.sample.HelloLiveUpdate”를 고유 애플리케이션의 ID로 대체

세그먼트 내보내기

curl --user admin:admin http://localhost:9080/mfpadmin/management-apis/2.0/runtimes/mfp/admin-plugins/liveUpdateAdapter/com.sample.HelloLiveUpdate/segment?embedObjects=true > segments.txt

세그먼트 가져오기

#!/bin/bash
segments_number=$(python -c 'import json,sys;obj=json.load(sys.stdin);print len(obj["items"]);' < segments.txt)
counter=0
while [ $segments_number -gt $counter ]
do
    segment=$(cat segments.txt | python -c 'import json,sys;obj=json.load(sys.stdin);data_str=json.dumps(obj["items"]['$counter']);print data_str;')
    echo $segment | curl -X POST -d @- --user admin:admin --header "Content-Type:application/json" http://localhost:9080/mfpadmin/management-apis/2.0/runtimes/mfp/admin-plugins/liveUpdateAdapter/com.sample.HelloLiveUpdate/segment
    ((counter++))
done

• “admin:admin”을 고유 항목으로 대체(기본값은 “admin”)
• 필요한 경우 “localhost” 및 포트 번호를 기본 항목으로 대체
• 애플리케이션 ID “com.sample.HelloLiveUpdate”를 고유 애플리케이션의 ID로 대체

캐싱

캐싱은 기본적으로 사용되어 네트워크 대기 시간이 발생하지 않도록 합니다. 즉 업데이트가 즉시 수행되지 않을 수 있습니다.
자주 업데이트해야 하는 경우 캐싱을 사용 안함으로 설정할 수 있습니다.

Cordova

선택적 useClientCache 부울 플래그를 사용하여 클라이언트 측 캐시 제어:

	var input = { segmentId :'18' ,useClientCache : false };
        LiveUpdateManager.getConfiguration(input,function(configuration) {
                // do something with resulting configuration, for example:
                // console.log(configuration.data.properties.property-name);  
                // console.log(configuration.data.features.feature-name);
        } ,
        function(err) {
                if (err) {
                   alert('liveupdate error:'+err);
                }
  });

iOS

LiveUpdateManager.sharedInstance.obtainConfiguration("segment-name", useCache: false, completionHandler: { (configuration, error) in
  if error == nil {
    print (configuration?.getProperty("property-name"))
    print (configuration?.isFeatureEnabled("feature-name"))
  } else {
    print (error)
  }
})

Android

LiveUpdateManager.getInstance().obtainConfiguration("segment-name", false, new ConfigurationListener() {

    @Override
    public void onSuccess(final Configuration configuration) {
      Log.i("LiveUpdateSample", configuration.getProperty("property-name"));
      Log.i("LiveUpdateSample", configuration.isFeatureEnabled("feature-name").toString());
    }

    @Override
    public void onFailure(WLFailResponse wlFailResponse) {
        Log.e("LiveUpdateSample", wlFailResponse.getErrorMsg());
    }
});

캐시 만기

어댑터 → 라이브 업데이트 어댑터에 정의된 expirationPeriod 값은 캐싱이 만료될 때까지 걸리는 시간 길이를 제어합니다.

샘플 애플리케이션

샘플 애플리케이션에서 국기를 선택하고 라이브 업데이트를 사용하면 앱에서 선택한 국가에 해당하는 언어로 텍스트를 출력합니다. 맵 기능을 사용하도록 설정하고 맵을 제공하면 해당 국가의 맵이 표시됩니다.

Xcode 프로젝트를 다운로드하려면 클릭하십시오.
Android Studio 프로젝트를 다운로드하려면 클릭하십시오.

샘플 사용법

샘플의 README.md 파일에 있는 지시사항을 따르십시오.

라이브 업데이트 설정 변경

각 세그먼트는 스키마에서 기본값을 가져옵니다. 각 기본값을 언어에 따라 변경하십시오. 예를 들어 프랑스어의 경우 helloText - Bonjour le monde를 추가하십시오.

MobileFirst Operations Console → [애플리케이션] → 라이브 업데이트 설정 → 세그먼트 탭에서 예를 들어 FR에 속하는 특성 링크를 클릭하십시오.

• 편집 아이콘을 클릭하고 예를 들어 프랑스 지역 맵을 나타내는 이미지에 대한 링크를 제공하십시오.
• 앱 사용 중에 맵을 보려면 includeMap 기능을 사용으로 설정해야 합니다.