Show Menu
화제×

4.x iOS 라이브러리로 마이그레이션

다음은 iOS 라이브러리를 버전 3.x 또는 2.x에서 4.x 버전으로 마이그레이션하는 데 유용한 정보입니다.
SDK는 NSUserDefaults 를 사용하여 고유 사용자, 라이프사이클 지표 및 코어 SDK 기능과 관련된 기타 데이터를 계산하는 데 필요한 데이터를 저장합니다. SDK에 필요한 NSUserDefaults 의 값을 수정하거나 제거하면 예기치 않은 동작으로 인해 데이터 형식이 일치하지 않을 수 있습니다.
iOS SDK 라이브러리 버전 4.x에서는 공용 메서드가 하나의 헤더로 통합되었습니다. 또한 클래스 수준 메서드를 통해 모든 기능에 액세스할 수 있으므로 포인터, 인스턴스 또는 싱글톤을 추적하지 않아도 됩니다.

Event, Prop 및 eVar

버전 4에서는 더 이상 events, eVars, props, heirs 및 lists와 같은 변수를 앱에서 직접 할당할 수 없습니다. 대신 SDK는 컨텍스트 데이터 및 처리 규칙을 사용하여 Analytics 변수에 앱 데이터를 매핑하여 보고합니다.
처리 규칙은 다음과 같은 이점을 제공합니다.
  • 앱 스토어에 업데이트를 제출하지 않고도 데이터 매핑을 변경할 수 있습니다.
  • 보고서 세트와 관련된 변수를 설정하는 대신 의미 있는 이름을 데이터에 사용할 수 있습니다.
  • 추가 데이터를 보내는 작업에는 거의 영향을 미치지 않습니다.
    이러한 값은 처리 규칙을 사용하여 매핑될 때까지 보고서에 표시되지 않습니다.
변수에 직접 할당했던 값을 이제 data NSDictionary에 추가해야 합니다.

사용하지 않는 속성 제거

ADBMobileConfig.json 파일은 애플리케이션별 전역 설정을 포함하며, 이전 버전에서 사용된 대부분의 구성 변수를 대체합니다. 다음은 ADBMobileConfig.json 파일 예제입니다.
{ 
    "version" : "1.0", 
    "analytics" : { 
        "rsids" : "coolApp", 
        "server" : "my.CoolApp.com", 
        "charset" : "UTF-8", 
        "ssl" : true, 
        "offlineEnabled" : true, 
        "lifecycleTimeout" : 5, 
        "privacyDefault" : "optedin", 
        "poi" : [ 
                    ["san francisco",37.757144,-122.44812,7000], 
                    ["santa cruz",36.972935,-122.01725,600] 
                ] 
    }, 
 "target" : { 
  "clientCode" : "myTargetClientCode", 
  "timeout" : 5 
 }, 
 "audienceManager" : { 
  "server" : "myServer.demdex.com" 
 } 
}

구성 파일 이동

구성 파일을 이동하려면
  1. 첫 번째 열의 변수에 대해 설정된 값을 두 번째 열의 변수로 이동합니다.
  2. 코드에서 이전 구성 변수를 제거합니다.

마이그레이션 정보

다음 표에는 구성 파일로 이동하는 데 필요한 구성 변수가 나열되어 있습니다.

버전 3.x에서 마이그레이션

첫 번째 열의 값을 두 번째 열의 변수로 이동합니다.
구성 변수
ADBMobileConfig.json 파일의 변수
offlineTrackingEnabled
"offlineEnabled"
offlineHitLimit
"batchLimit"
reportSuiteIDs
"rsids"
trackingServer
"server"
charSet
"charset"
currencyCode
"currency"
ssl
"ssl"
linkTrackVars
제거합니다. 더 이상 사용되지 않습니다.
linkTrackEvents
제거합니다. 더 이상 사용되지 않습니다.

버전 2.x에서 마이그레이션

첫 번째 열의 값을 두 번째 열의 변수로 이동합니다.
구성 변수
ADBMobileConfig.json 파일의 변수
trackOffline
"offlineEnabled"
offlineLimit
"batchLimit"
account
"rsids"
trackingServer
"server" "https://" 접두사를 제거합니다. 프로토콜 접두사는 "ssl"설정에 따라 자동으로 추가됩니다.
trackingServerSecure
제거. 보안 연결을 위해 "server"를 정의한 다음 "ssl"을 사용하도록 설정합니다.
charSet
"charset"
currencyCode
"currency"
ssl
"ssl"
linkTrackVars
제거합니다. 더 이상 사용되지 않습니다.
linkTrackEvents
제거합니다. 더 이상 사용되지 않습니다.
timestamp
제거합니다. 더 이상 구성할 수 없습니다.
dc
제거합니다. 더 이상 사용되지 않습니다.
userAgent
제거합니다. 더 이상 구성할 수 없습니다.
dynamicVariablePrefix
제거합니다. 더 이상 사용되지 않습니다.
visitorNamespace
제거합니다. 더 이상 사용되지 않습니다.
usePlugins
제거합니다. 더 이상 사용되지 않습니다.
useBestPractices churn 측정에 대한 모든 호출(getChurnInstance )
제거합니다. 라이프사이클 지표로 대체됩니다. 자세한 내용은 라이프사이클 지표 를 참조하십시오.

추적 호출 및 추적 변수 업데이트

버전 4 SDK는 웹 중심의 track trackLink 호출 대신 다음과 같은 방법을 사용합니다.
  • trackState:data: 상태는 home dashboard , app settings , cart 등과 같이 앱에서 사용할 수 있는 보기입니다.
    이 상태는 웹 사이트의 페이지와 유사하며 trackState 호출은 페이지 보기를 증가시킵니다.
  • logons , banner taps , feed subscriptions 등과 같이 앱에서 발생하며 사용자가 측정하려는 trackAction:data: 작업입니다.
이 두 메서드의 data 매개 변수는 컨텍스트 데이터로 전송되는 이름 - 값 쌍을 포함하는 NSDictionary 입니다.

Events, props, eVars

버전 4에서는 더 이상 events, eVars, props, heirs 및 lists와 같은 변수를 앱에서 직접 할당할 수 없습니다. SDK는 이제 컨텍스트 데이터 및 처리 규칙을 사용하여 Analytics 변수에 앱 데이터를 매핑하여 보고합니다.
처리 규칙은 다음과 같은 이점을 제공합니다.
  • 앱 스토어에 업데이트를 제출하지 않고도 데이터 매핑을 변경할 수 있습니다.
  • 보고서 세트와 관련된 변수를 설정하는 대신 의미 있는 이름을 데이터에 사용할 수 있습니다.
  • 추가 데이터를 보내는 작업에는 거의 영향을 미치지 않습니다.
    이러한 값은 처리 규칙을 사용하여 매핑될 때까지 보고서에 표시되지 않습니다. 자세한 내용은 처리 규칙 및 컨텍스트 데이터 를 참조하십시오.
변수에 직접 할당한 값은 대신 data``NSDictionary 에 추가해야 합니다. 다시 말해서 setProp , setEvar 에 대한 호출과 영구 컨텍스트 데이터에 대한 할당이 모두 제거되고 data 매개 변수에 값이 추가되어야 합니다.

AppSection/서버, GeoZip, 트랜잭션 ID, 캠페인 및 기타 표준 변수

위에 나열된 변수를 포함하여 측정 개체에 설정한 데이터는 대신 data``NSDictionary 에 추가해야 합니다. trackState 또는 trackAction 호출과 함께 전송되는 데이터는 data 매개 변수의 페이로드뿐입니다.

추적 호출 대체

코드에서 다음 메서드를 trackState 또는 trackAction 호출로 바꿉니다.

버전 3.x에서 마이그레이션

  • trackAppState (trackState)
  • trackEvents (trackAction)
  • track (trackAction)
  • trackWithContextData (trackAction)
  • trackLinkURL (trackAction)

버전 2.x에서 마이그레이션

  • track (trackState)
  • trackLink (trackAction)

사용자 지정 방문자 ID

visitorID 변수를 setUserIdentifier: 에 대한 호출로 바꿉니다.

오프라인 추적

오프라인 추적은 ADBMobileConfig.json 파일에서 활성화되고 다른 오프라인 구성은 모두 자동으로 수행됩니다.
코드에서 다음 메서드 호출을 제거하십시오.

버전 3.x

  • setOnline
  • setOffline

버전 2.x

  • forceOffline
  • forceOnline

Products 변수

변수는 처리 규칙에서 사용할 수 없으므로 다음 구문을 사용하여 products products를 설정할 수 있습니다.
//create a processing rule to set the corresponding product event. 
// for example, set prodView event when context data a.action = "product view" 
[ADBMobile trackAction:@"LikeButtonClicked"  
                  data:@{@"&&products" : @";Cool Shoe"}];