Adobe Mobile 클래스 및 메서드 참조

BlackBerry 라이브러리에서 제공하는 클래스 및 메서드입니다.

현재 SDK에는 Adobe Analytics에 대한 지원이 있으며 메서드는 솔루션을 기반으로 별도의 클래스에 있습니다.

SDK 설정

  • getPrivacyStatus

    현재 사용자에 대한 개인 정보 상태의 열거 표현을 반환합니다.

    • ADBMobilePrivacyStatusOptIn - 히트가 즉시 전송됩니다.

    • ADBMobilePrivacyStatusOptOut - 히트가 삭제됩니다.

    • ADBMobilePrivacyStatusUnknown - 보고서 세트에 타임스탬프가 활성화되어 있을 경우 개인정보 상태가 옵트인(히트가 전송됨) 또는 옵트아웃(히트 삭제)으로 변경될 때까지 히트가 저장됩니다. 보고서 세트에 타임스탬프가 활성화되어 있지 않을 경우 개인정보 상태가 옵트인으로 변경될 때까지 히트가 삭제됩니다.

      기본값은 ADBMobileConfig.json 파일에서 설정되어 있습니다.

    • 다음은 이 메서드에 대한 구문입니다.

      static ADBMobilePrivacyStatus getPrivacyStatus();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobilePrivacyStatus privacyStatus = ADBMobile::getPrivacyStatus();
      
  • setPrivacyStatus

    현재 사용자의 개인정보 상태를 status로 설정합니다. 다음 값 중 하나를 설정합니다.

    • ADBMobilePrivacyStatusOptIn - 히트가 즉시 전송됩니다.

    • ADBMobilePrivacyStatusOptOut - 히트가 삭제됩니다.

    • ADBMobilePrivacyStatusUnknown - 보고서 세트에 타임스탬프가 활성화되어 있을 경우 개인정보 상태가 옵트인(히트가 전송됨) 또는 옵트아웃(히트 삭제)으로 변경될 때까지 히트가 저장됩니다. 보고서 세트에 타임스탬프가 활성화되어 있지 않을 경우 개인정보 상태가 옵트인으로 변경될 때까지 히트가 삭제됩니다.

    • 다음은 이 메서드에 대한 구문입니다.

      static void setPrivacyStatus(ADBMobilePrivacyStatus status);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile::setPrivacyStatus(ADBMobilePrivacyStatusOptIn);
      
  • getUserIdentifier

    사용자 지정 식별자가 설정된 경우 사용자 식별자를 반환합니다. 사용자 지정 식별자가 설정되지 않은 경우 null 을 반환합니다. 기본값은 null입니다.

    • 다음은 이 메서드에 대한 구문입니다.

      static QString getUserIdentifier();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      QString userId = ADBMobile::getUserIdentifier(); 
      
  • setUserIdentifier

    사용자 식별자를 identifier로 설정합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      static void setUserIdentifier(QString identifier);
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ADBMobile::setUserIdentifier("billybob");
      
  • getDebugLogging

    현재 디버그 로깅 기본 설정을 반환합니다. 기본값은 false입니다.

    • 다음은 이 메서드에 대한 구문입니다.

      static bool getDebugLogging();
      
    • 다음은 이 메서드의 코드 샘플입니다.

       bool debugging = ADBMobile::getDebugLogging(); 
      
  • setDebugLogging

    디버그 로깅 기본 설정을 debugLogging으로 설정합니다.

    • 다음은 이 메서드에 대한 구문입니다.

      static void setDebugLogging(bool debugLogging);
      
    • 다음은 이 메서드의 코드 샘플입니다.

        ADBMobile::setDebugLogging(true); 
      
  • collectLifecycleData

    SDK의 솔루션 전체에서 사용하기 위해 라이프사이클 데이터를 수집해야 함을 SDK에 표시합니다. 자세한 내용은 라이프사이클 지표를 참조하십시오.

    • 다음은 이 메서드에 대한 구문입니다.

      static void collectLifecycleData();
      
    • 다음은 이 메서드의 코드 샘플입니다.

      ApplicationUI::ApplicationUI(bb::cascades::Application *app):  QObject(app)  { 
      //... 
      ADBMobile::collectLifecycleData(); 
      }
      

Analytics 메서드

이러한 각 메서드는 Adobe Analytics 보고서 세트로 데이터를 전송하는 데 사용됩니다.

  • trackState

    선택적 컨텍스트 데이터로 앱 상태를 추적합니다. 상태는 "홈 대시보드", "앱 설정", "장바구니" 등과 같이 앱에서 사용할 수 있는 보기입니다. 이 상태는 웹 사이트의 페이지와 유사하며 trackState 호출은 페이지 보기를 증가시킵니다.

    페이지 보기 횟수를 늘리는 유일한 추적 호출입니다.

    • 다음은 이 메서드에 대한 구문입니다.

      static void trackState(QString state, QHash<QString, QString> contextData = QHash<QString, QString>()); 
      
    • 다음은 이 메서드의 코드 샘플입니다.

         ADBMobile::trackState("loginScreen", null);
      
  • trackAction

    앱의 작업을 추적합니다. 작업은 "logons", "banner taps", "feed subscriptions" 및 기타 지표 등 앱에서 발생하여 측정하려는 작업입니다.

    • 다음은 이 메서드에 대한 구문입니다.

      static void trackAction(QString action, QHash<QString, QString> contextData = QHash<QString, QString>()); 
      
    • 다음은 이 메서드의 코드 샘플입니다.

        ADBMobile::trackAction("heroBannerTouched", null); 
      
  • trackLocation

    현재 xy 좌표를 보냅니다. 이벤트를 구독자로부터 BPS로 받은 이벤트로 바꿉니다.

    • 다음은 이 메서드에 대한 구문입니다.

      static void trackLocation(bps_event_t *geoEvent, QHash<QString, QString> contextData = QHash<QString, QString> ());
      
    • 다음은 이 메서드의 코드 샘플입니다.

        ADBMobile::trackLocation(event, null);
      

ADBMobileConfig.json 구성 파일 참조

ADBMobileConfig.json 파일은 assets 폴더에 두어야 합니다.

  • rsids

    (필수) Analytics 데이터를 수신할 하나 이상의 보고서 세트입니다. 여러 보고서 세트 ID는 공백 없이 쉼표로 구분해야 합니다.

    다음은 이 변수의 코드 샘플입니다.

    "rsids" : "rsid"
    
    "rsids" : "rsid1,rsid2"
    
  • server

    (필수 여부). Analytics 서버. 이 변수는 https:// 또는 https:// 프로토콜 접두사 없이 서버 도메인으로 채워야 합니다. 프로토콜 접두사는 ssl 변수를 기반으로 하여 라이브러리에서 자동으로 처리됩니다. ssltrue이면 이 서버에 보안 연결이 설정됩니다. sslfalse이면 이 서버에 비보안 연결이 설정됩니다.

  • charset

    Analytics로 전송된 데이터에 사용할 문자 세트를 정의합니다. charset은 들어오는 데이터를 저장 및 보고용으로 UTF-8로 변환하는 데 사용됩니다.

  • ssl

    SSL(HTTPS)을 통해 측정 데이터 전송을 활성화(true)하거나 비활성화(false)합니다. 기본값은 false입니다.

  • offlineEnabled

    사용하도록 설정하면(true), 히트는 장치가 오프라인일 때 큐에 있다가 나중에 장치가 온라인 상태일 때 전송됩니다. 오프라인 추적을 사용하려면 보고서 세트에 타임스탬프가 설정되어 있어야 합니다.

    보고서 세트에서 타임스탬프가 활성화된 경우 offlineEnabled 구성 속성 a2/>가 true여야 합니다. 보고서 세트에서 타임스탬프가 사용되지 않는 경우에는 offlineEnabled 구성 속성이 반드시 false여야 합니다. 이 속성이 제대로 구성되지 않으면 데이터가 손실됩니다. 보고서 세트 타임 스탬프 활성화 여부가 확실치 않으면 엔터프라이즈 지원에 문의하십시오.

    현재 JavaScript의 데이터도 수집하는 보고서 세트에 AppMeasurement 데이터를 보고하는 경우, 모바일 데이터에 별도의 보고서 세트를 설정하거나 s.timestamp 변수를 사용하여 모든 JavaScript 히트에 사용자 지정 타임스탬프를 포함해야 할 수도 있습니다.

    기본값은 false입니다.

  • lifecycleTimeout

    실행이 새로운 세션으로 간주되기 전에 앱 실행 사이에 경과해야 하는 시간(초)을 지정합니다. 이 시간 초과는 응용 프로그램이 백그라운드로 전송되고 다시 활성화될 때도 적용됩니다. 앱이 백그라운드에서 소요하는 시간은 세션 길이에 포함되지 않습니다.

    기본값은 300초입니다.

  • batchLimit

    큐에 저장된 최대 오프라인 히트 수입니다. 기본값은 0(제한 없음)입니다.

  • privacyDefault

    • optedin - 히트가 즉시 전송됩니다.

    • optedout - 히트가 삭제됩니다.

    • optunknown - 보고서 세트에 타임스탬프가 활성화되어 있을 경우 개인정보 상태가 옵트인(히트가 전송됨) 또는 옵트아웃(히트 삭제)으로 변경될 때까지 히트가 저장됩니다.

      보고서 세트에 타임스탬프가 활성화되어 있지 않을 경우 개인정보 상태가 옵트인으로 변경될 때까지 히트가 삭제됩니다.
      이 변수는 초기값만 설정합니다. 코드에서 이 값을 설정하거나 변경하고 나면 해당 값을 변경하거나 앱을 제거하고 다시 설치하기 전까지 새 값이 앞으로 사용됩니다.

    기본값은 optedin입니다.

다음은 ADBMobileConfig.json 파일의 예입니다.

{ 
    "version" : "1.0", 
    "analytics" : { 
        "rsids" : "coolApp", 
        "server" : "my.CoolApp.com", 
        "charset" : "UTF-8", 
        "ssl" : true, 
        "offlineEnabled" : true, 
        "lifecycleTimeout" : 5, 
        "privacyDefault" : "optedin", 
    } 
}

이 페이지에서는