Adobe Analytics toevoegen aan uw mobiele toepassing add-adobe-analytics-to-your-mobile-application

CAUTION
AEM 6.4 heeft het einde van de uitgebreide ondersteuning bereikt en deze documentatie wordt niet meer bijgewerkt. Raadpleeg voor meer informatie onze technische ondersteuningsperioden. Ondersteunde versies zoeken hier.
NOTE
Adobe raadt aan de SPA Editor te gebruiken voor projecten die renderen op basis van één pagina voor toepassingsframework op de client-side vereisen (bijvoorbeeld Reageren). Meer informatie.

Wilt u aantrekkelijke en relevante ervaringen opbouwen voor gebruikers van mobiele toepassingen? Als u niet de Adobe Mobile Services SDK gebruikt om de levenscyclus en het gebruik van de toepassing te controleren en te meten, dan waarop baseert u uw besluiten? Waar zijn uw meest loyale klanten? Hoe kan je garanderen dat je relevant blijft en conversies optimaliseert?

Hebben uw gebruikers toegang tot alle inhoud? Verlaten ze de app en zo ja, waar? Hoe vaak blijven ze in de app en hoe vaak komen ze terug om de app te gebruiken? Welke veranderingen kunt u introduceren en dan die verhoging behoud meten? Hoe zit het met crashsnelheden? crasht uw app voor uw gebruikers?

Profiteer van Mobiele App Analytics in uw AEM-apps door integratie met Adobe mobiele services.

Instrueer uw AEM-apps om te volgen, rapporteren en te begrijpen hoe gebruikers omgaan met uw mobiele app en inhoud en om belangrijke levenscyclusmetriek te meten, zoals lanceringen, tijd in app en crashsnelheid.

In deze sectie wordt beschreven hoe AEM Ontwikkelaars kan:

  • Mobiele analysemogelijkheden integreren in uw mobiele toepassing
  • Test uw analyses bijhouden met Bloodhound

Vereisten prerequisties

AEM Mobile heeft een Adobe Analytics-account nodig om trackinggegevens in uw app te verzamelen en te rapporteren. Als onderdeel van de configuratie AEM Beheerder moeten eerst :

  • Stel een Adobe Analytics-account in en maak een rapportsuite voor uw toepassing in Mobile Services.
  • Configureer een AMS-Cloud Service in Adobe Experience Manager (AEM).

Voor ontwikkelaars - Mobiele analysemogelijkheden integreren in uw app for-developers-integrate-mobile-analytics-into-your-app

Configureer ContentSync om het configuratiebestand te gebruiken configure-contentsync-to-pull-in-configuration-file

Nadat het account Analytics is ingesteld, moet u een configuratie voor Content Sync maken om de inhoud in uw mobiele toepassing te plaatsen.

Zie Inhoud synchroniseren configureren voor meer informatie. De configuratie zal de Synchronisatie van de Inhoud moeten instrueren om ADBMobileConfig in de /www folder te zetten. In de Geometrixx Outdoors App vindt u bijvoorbeeld de configuratie van Content Sync: /content/phonegap/geometrixx-outdoor/shell/jcr:content/pge-app/app-config/ams-ADBMobileConfig. Er is ook een configuratie voor ontwikkeling. in het geval van Geometrixx Outdoors is het echter identiek aan de niet-ontwikkelingsconfiguratie.

Raadpleeg Analytics - Mobile Services - Adobe Mobile Services SDK Config File voor meer informatie over het downloaden van ADBMobileConfig vanuit het dashboard voor AEM toepassingen voor mobiele.

<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"/>

Voor elk platform moet ADBMobileConfig naar een specifieke locatie worden gekopieerd.

Als het bouwen met CLI PhoneGap dit met cordova kan worden gedaan bouwen hamanuscripten. Dit is te zien in de app Geometrixx Outdoors op:content/phonegap/geometrixx-outdoors/shell/_jcr_content/pge-app/app-content/phonegap/scripts/restore_plugins.js.

Voor iOS moet het bestand naar de XCode-projectversie worden gekopieerd Bronnen map (bijv. "platforms/ios/Geometrixx/Resources/ADBMobileConfig.json"). Als de toepassing is bedoeld voor Android, is het pad waarnaar u wilt kopiëren "platforms/android/assets/ADBMobileConfig.json". Voor meer details bij het gebruiken van haken tijdens CLI bouwt PhoneGap verwijs naar Drie haken voor uw Cordova/PhoneGap-project.

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

De AMS-plug-in toevoegen in de app add-the-ams-plugin-in-the-app

Voor de app om de gegevens te verzamelen, moet de insteekmodule Adobe Mobile Services (AMS) als onderdeel van de app worden opgenomen. Door de plug-in als een functie in config.xml van de app op te nemen, kan een andere Cordova-haak worden gebruikt om de plug-in automatisch toe te voegen tijdens het PhoneGap-ontwikkelproces.

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

De Geometrixx Outdoors App config.xml bevindt zich in /content/phonegap/geometrixx-outdoor/shell/jcr:content/pge-app/app-content/phonegap/www/config.xml. In het bovenstaande voorbeeld wordt een specifieke versie van de insteekmodule gevraagd die moet worden gebruikt door een '#' en een tagwaarde toe te voegen na de insteekmodule-URL. Dit is een goede gewoonte om ervoor te zorgen dat onverwachte problemen zich niet voordoen als gevolg van het toevoegen van niet-geteste plug-ins tijdens een build.

Nadat u deze stappen hebt uitgevoerd, wordt uw app ingeschakeld om alle levenscyclusmetriek te rapporteren die door Adobe Analytics zijn verschaft. Dit omvat gegevens zoals lanceringen, neerstortingen en installaties. Als dat de enige gegevens zijn waar je om geeft, dan ben je klaar. Als u aangepaste gegevens wilt verzamelen, moet u deze coderen.

Instrueer uw code voor het volledig bijhouden van de app instrument-your-code-for-full-app-tracking

Er zijn verschillende tracking-API's beschikbaar in het dialoogvenster AMS Phonegap-insteekmodule-API.

Hiermee kunt u staten en handelingen bijhouden, zoals waar de pagina's waarnaar uw gebruikers navigeren in uw app, waarin de besturingselementen het meest worden gebruikt. De eenvoudigste manier om uw app voor tracering te gebruiken, is om gebruik te maken van de API's voor Analytics die door de AMS-plug-in worden geleverd.

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

Ter referentie kunt u de code in de app Geometrixx Outdoors bekijken. In de app Geometrixx Outdoors worden alle paginanavigaties bijgehouden met behulp van de methode ADB.trackState(). Zie voor meer informatie de broncode voor /libs/mobileapps/components/angular/ng-page/clientlibs/app-navigation.js

Door uw broncode met deze methodevraag van instrumenten te voorzien kunt u volledige metriek tegen uw toepassing verzamelen.

Testen van Analyses bijhouden met Bloodhound testing-analytics-tracking-with-bloodhound

U kunt desgewenst vóór de implementatie op productie de Adobe-tool Bloodhound gebruiken om de configuratie van de analysemogelijkheden te testen. Als u de analyseconfiguratie wilt testen, moet u het bestand ADBMobileConfig.json bewerken om naar de server te verwijzen waar Bloodhound wordt uitgevoerd in plaats van naar de werkelijke Analytics-server. Om deze verandering aan te brengen, van uw ADBMobileConfig.json verander de volgende ingang.

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

Wijzigen om aan te passen aan dit item:

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

Hiermee worden alle gegevens die door de AMS-plug-in zijn verzameld, omgeleid naar Bloodhound, zodat u de resultaten kunt bekijken.

Eigenschappen voor het verbinden met AMS properties-for-connecting-to-ams

com.adobe.cq.mobile.mobileservices.impl.service.MobileServicesHttpClientImp l stelt de volgende eigenschappen voor het verbinden met AMS bloot:

Label
Beschrijving
Standaard
API-eindpunt
De basis-URL van de HTTP-API's van Adobe Mobile Services
https://api.omniture.com
Config-eindpunt
De URL die wordt gebruikt om ADB Mobile Config voor bepaalde rapportsuite-id op te halen
/ams/1.0/app/config/
Mobiele service-apps
Een lijst met apps ophalen in het gebruikersbedrijf
/ams/1.0/apps
recommendation-more-help
547b817b-14b5-4d82-aa0f-a64750e0e592