모바일 애플리케이션에 Adobe Analytics 추가

노트

단일 페이지 애플리케이션 프레임워크 기반 클라이언트측 렌더링(예: React)이 필요한 프로젝트에 SPA 편집기를 사용하는 것이 좋습니다. 추가 정보.

모바일 애플리케이션 사용자를 위한 매력적인 경험을 구축하시겠습니까? Mobile Services SDK를 사용하여 애플리케이션 라이프사이클 및 사용량을 모니터링하고 측정하지 않는 경우 사용자의 결정을 기반으로 합니까? 가장 충성스런 고객은 어디입니까? 연관성을 유지하고 전환을 최적화하는 데 어떻게 보장할 수 있습니까?

사용자가 모든 컨텐츠에 액세스합니까? 그들은 앱을 버리고 있으며, 만약 그렇다면, 어디에 있습니까? 얼마나 자주 앱에서 유지되며 앱을 다시 사용하기 위해 몇 번 방문합니까? 어떤 변경 사항을 적용하고 보존 기간을 늘릴 수 있습니까? 충돌률은 어떻습니까? 앱이 사용자에게 충돌합니까?

Adobe Mobile Services와 통합하여 AEM 앱에서 Mobile App Analytics를 활용하십시오.

AEM 앱을 통해 사용자가 모바일 앱과 컨텐츠를 사용하는 방법을 추적, 보고 및 이해하고, 시작, 앱 내 시간, 충돌율과 같은 주요 라이프사이클 지표를 측정할 수 있습니다.

이 섹션에서는 AEM 개발자​가 다음을 수행할 수 있는 방법을 설명합니다.

  • 모바일 애플리케이션에 Mobile Analytics 통합
  • Bloodhound를 사용하여 분석 추적을 테스트합니다

전제 조건

AEM Mobile에서는 앱에서 추적 데이터를 수집하고 보고하려면 Adobe Analytics 계정이 필요합니다. 구성의 일부로서 AEM Administrator​은 먼저 다음을 수행해야 합니다.

  • Adobe Analytics 계정을 설정하고 Mobile Services에서 애플리케이션에 대한 보고서 세트를 만듭니다.
  • Adobe Experience Manager(AEM)에서 AMS Cloud Service을 구성합니다.

개발자의 경우 - Mobile Analytics를 앱에 통합

구성 파일을 가져오도록 ContentSync 구성

Analytics 계정이 설정되면 컨텐츠를 모바일 애플리케이션에 가져오려면 컨텐츠 동기화 구성을 만들어야 합니다.

자세한 내용은 컨텐츠 동기화 컨텐츠 구성을 참조하십시오. 이 구성은 Content Sync에 ADBMobileConfig를 /www 디렉토리에 배치하도록 지시해야 합니다. 예를 들어 Geometrixx Outdoors 앱에서 컨텐츠 동기화 구성은 다음 위치에 있습니다./content/phonegap/geometrixx-outdoors/shell/jcr:content/page-app/app-config/ams-ADBMobileConfig. 개발을 위한 구성도 있다.하지만 Geometrixx Outdoors의 경우 비개발 구성과 동일합니다.

모바일 애플리케이션 AEM Apps 대시보드에서 ADBMobileConfig를 다운로드하는 방법에 대한 자세한 내용은 Analytics - Mobile Services - Adobe Mobile Services SDK 구성 파일을 참조하십시오.

<jcr:root xmlns:jcr="https://www.jcp.org/jcr/1.0" xmlns:nt="https://www.jcp.org/jcr/nt/1.0"
    jcr:primaryType="nt:unstructured"
    extension="json"
    path="../../../.."
    selector="ADBMobileConfig"
    targetRootDirectory="www"
    type="mobileADBMobileConfigJSON"/>

각 플랫폼을 사용하려면 ADBMobileConfig를 특정 위치에 복사해야 합니다.

PhoneGap CLI로 빌드하는 경우 cordova 빌드 후크 스크립트로 이 작업을 수행할 수 있습니다. Geometrixx Outdoors 앱(content/phonegap/geometrixx-outdoors/shell/_jcr_content/pge-app/app-content/phonegap/scripts/restore_plugins.js)에서 볼 수 있습니다.

iOS의 경우 파일을 XCode 프로젝트의 Resources 디렉터리(예: "platforms/ios/Geometrixx/Resources/ADBMobileConfig.json") 앱이 Android용 타겟팅되면 복사할 경로는 "platforms/android/assets/ADBMobileConfig.json"입니다. PhoneGap CLI 빌드 중 후크를 사용하는 방법에 대한 자세한 내용은 Cordova/PhoneGap 프로젝트 요구 사항을 참조하십시오.

///////////////////////////
//          iOS
///////////////////////////
    ios : [
        {
            "www/ADBMobileConfig.json": "platforms/ios/<YOUR_APP_NAME>/Resources/ADBMobileConfig.json"
        }
    ],
///////////////////////////
//          ANDROID
///////////////////////////
    android: [
        {
            "www/ADBMobileConfig.json": "platforms/android/assets/ADBMobileConfig.json"
        }
    ]

앱에 AMS 플러그인을 추가합니다

앱이 데이터를 수집하려면 AMS(Adobe Mobile Services) 플러그인을 앱의 일부로 포함해야 합니다. 플러그인을 앱 config.xml에 기능으로 포함함으로써 PhoneGap 빌드 프로세스 중에 다른 Cordova 후크를 사용하여 플러그인을 자동으로 추가할 수 있습니다.

<feature name="ADBMobile">
    <param name="id" value="https://github.com/Adobe-Marketing-Cloud/mobile-services#0482f9cedf90c98a8d4b07219ece1933b2e46a60"/>
</feature>

Geometrixx Outdoors 앱 구성.xml은 /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-content/phonegap/www/config.xml​에 있습니다. 위의 예에서는 플러그인 URL 뒤에 '#'을 추가하고 태그 값을 추가하여 플러그인의 특정 버전을 사용하도록 요청합니다. 이는 빌드 중에 테스트되지 않은 플러그인이 추가되어 예기치 않은 문제가 발생하지 않도록 하기 위해 수행하는 좋은 방법입니다.

이 단계를 수행하면 앱이 활성화되어 Adobe Analytics에서 제공하는 모든 라이프사이클 지표를 보고합니다. 여기에는 시작, 충돌 및 설치 등의 데이터가 포함됩니다. 만약 그것이 당신이 관심을 갖는 유일한 데이터라면 당신은 끝납니다. 사용자 지정 데이터를 수집하려면 코드를 작성해야 합니다.

전체 앱 추적 코드를 인스트루먼트

AMS Phonegap 플러그인 API에 제공되는 몇 가지 추적 API가 있습니다.

이렇게 하면 사용자가 앱에서 탐색하는 페이지, 가장 많이 사용되는 제어와 같은 상태 및 작업을 추적할 수 있습니다. 추적을 위해 앱을 계측하는 가장 쉬운 방법은 AMS 플러그인에서 제공하는 Analytics API를 사용하는 것입니다.

  • ADB.trackState()
  • ADB.trackAction()

참조용으로 Geometrixx Outdoors 앱에서 코드를 확인할 수 있습니다. Geometrixx Outdoors 앱에서 ADB.trackState() 메서드를 사용하여 모든 페이지 탐색을 추적합니다. 자세한 내용은 /libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.js에 대한 소스 코드를 참조하십시오.

이러한 메서드 호출을 사용하여 소스 코드를 계측함으로써 애플리케이션에 대해 전체 지표를 수집할 수 있습니다.

AMS에 연결하기 위한 속성

com.adobe.cq.mobile.mobileservices.impl.service. MobileServicesHttpClientImpl은 AMS에 연결하기 위해 다음 속성을 노출합니다.

레이블 설명 기본값
API 끝점 Adobe Mobile Services HTTP API의 기본 URL입니다 https://api.omniture.com
구성 끝점 주어진 보고서 세트 ID에 대한 ADB 모바일 구성을 검색하는 데 사용되는 URL입니다 /ams/1.0/app/config/
모바일 서비스 앱 사용자 회사 내의 앱 목록 가져오기 /ams/1.0/apps

이 페이지에서는