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

다음은 iOS 라이브러리를 버전 3.x 또는 2.x에서 4.x 버전으로 마이그레이션하는 데 유용한 정보입니다.

iOS SDK 라이브러리 버전 4.x에서는 공용 메서드가 하나의 헤더로 통합되었습니다. 또한 클래스 수준 메서드를 통해 모든 기능에 액세스할 수 있으므로 포인터, 인스턴스 또는 싱글톤을 추적하지 않아도 됩니다.

Event, Prop 및 eVar

버전 4에서는 더 이상 앱의 이벤트, eVar, prop, 상속자 및 목록과 같은 변수를 직접 할당할 수 없습니다. 대신, SDK는 컨텍스트 데이터 및 처리 규칙을 사용하여 앱 데이터를 Analytics 변수에 매핑해서 보고에 사용합니다.

처리 규칙은 다음과 같은 이점을 제공합니다.

• 앱스토어에 업데이트를 제출하지 않고 데이터 매핑을 변경할 수 있습니다.

• 보고서 세트에 고유한 변수를 설정하는 대신 데이터에 의미 있는 이름을 사용할 수 있습니다.

• 추가 데이터 전송에는 거의 영향을 주지 않습니다.

  이러한 값은 처리 규칙을 사용하여 매핑될 때까지 보고서에 표시되지 않습니다.

사용하지 않는 속성 제거

새 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에서는 더 이상 앱의 이벤트, eVar, prop, 상속자 및 목록과 같은 변수를 직접 할당할 수 없습니다. 이제 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 변수

변수는 처리 규칙에서 사용할 수 없으므로 다음 구문을 사용하여 productsproducts를 설정할 수 있습니다.

//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"}];