모바일 애플리케이션에 Adobe Analytics 추가 add-adobe-analytics-to-your-mobile-application

CAUTION
AEM 6.4가 확장 지원이 종료되었으며 이 설명서는 더 이상 업데이트되지 않습니다. 자세한 내용은 기술 지원 기간. 지원되는 버전 찾기 여기.
NOTE
단일 페이지 애플리케이션 프레임워크 기반 클라이언트측 렌더링(예: React)이 필요한 프로젝트에 SPA 편집기를 사용하는 것이 좋습니다. 자세히 알아보기.

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

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

활용 모바일 앱 분석 와 통합하여 AEM 앱에서 Adobe Mobile Services.

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

이 섹션에서는 AEM을 어떻게 설명하는지 설명합니다 개발자 다음을 수행할 수 있습니다.

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

전제 조건 prerequisties

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

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

개발자의 경우 - Mobile Analytics를 앱에 통합 for-developers-integrate-mobile-analytics-into-your-app

구성 파일을 가져오도록 ContentSync 구성 configure-contentsync-to-pull-in-configuration-file

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 프로젝트의 리소스 디렉토리(예: "platforms/ios/Geometrixx/Resources/ADBMobileConfig.json") 앱이 Android용 타겟팅되면 복사할 경로는 "platforms/android/assets/ADBMobileConfig.json"입니다. PhoneGap CLI 빌드 중 후크를 사용하는 방법에 대한 자세한 내용은 Cordova/PhoneGap 프로젝트 요구 사항을 3개 후크합니다.

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

앱에 AMS 플러그인을 추가합니다 add-the-ams-plugin-in-the-app

앱이 데이터를 수집하려면 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 App config.xml은 /content/phonegap/geometrixx-outdoors/shell/jcr:content/pge-app/app-content/phonegap/www/config.xml. 위의 예에서는 플러그인 URL 뒤에 '#'을 추가하고 태그 값을 추가하여 플러그인의 특정 버전을 사용하도록 요청합니다. 이는 빌드 중에 테스트되지 않은 플러그인이 추가되어 예기치 않은 문제가 발생하지 않도록 하기 위해 수행하는 좋은 방법입니다.

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

전체 앱 추적을 위해 코드 인스트루먼트 instrument-your-code-for-full-app-tracking

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

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

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

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

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

Bloodhound를 사용하여 Analytics 추적 테스트 testing-analytics-tracking-with-bloodhound

선택적으로 프로덕션에 배포하기 전에 Adobe 도구 Bloodhound를 사용하여 분석 구성을 테스트할 수 있습니다. Analytics 구성을 테스트하려면 실제 Analytics 서버 대신 Bloodhound가 실행 중인 서버를 가리키도록 ADBMobileConfig.json 파일을 편집해야 합니다. 이 변경 작업을 수행하려면 ADBMobileConfig.json에서 다음 항목을 변경합니다.

...
"analytics": {
    "rsids": "YOUR_RSID",
    "server": "YOUR_TRACKING_SERVER:YOUR_TRACKING_PORT",
...

이 항목과 일치하도록 변경:

...
"analytics": {
    "rsids": "YOUR_RSID",
    "server": "localhost:50000",
...

이렇게 하면 AMS 플러그인이 수집한 모든 데이터를 Bloodhound로 리디렉션하여 결과를 볼 수 있습니다.

AMS에 연결하기 위한 속성입니다. properties-for-connecting-to-ams

com.adobe.cq.momobile.mobileservices.impl.service.MobileServicesHttpClientImp l은 AMS에 연결하기 위한 다음 속성을 표시합니다.

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