DocumentatieExperience PlatformTutorial voor mobiele apps

Analysegegevens verzamelen en toewijzen

Last update: Mon May 05 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Onderwerpen:

Gemaakt voor:

  • Beginner
  • tussenpersoon
  • Ontwikkelaar

Leer hoe u mobiele gegevens kunt toewijzen aan Adobe Analytics.

De gebeurtenisgegevens die u verzamelde en naar de Edge Network van het Platform in vroegere lessen verzendt door:sturen aan de diensten die in uw gegevensstroom, met inbegrip van Adobe Analytics worden gevormd. U brengt de gegevens aan de correcte variabelen in uw rapportreeks in kaart.

Architectuur

Vereisten

  • Inzicht in het bijhouden van ExperienceEvent.
  • XDM-gegevens worden naar uw voorbeeld-app verzonden.
  • Een Adobe Analytics-rapportsuite die u kunt gebruiken voor deze les.

Leerdoelstellingen

In deze les zult u:

  • Configureer uw gegevensstroom met de Adobe Analytics-service.
  • Begrijp automatisch in kaart brengen van de variabelen van de Analyse.
  • Stel verwerkingsregels in om XDM-gegevens toe te wijzen aan analytische variabelen.

Adobe Analytics-datastreamservice toevoegen

Om uw gegevens XDM van de Edge Network naar Adobe Analytics te verzenden, vormt u de dienst van Adobe Analytics aan de datastream u opstelling als deel van een gegevensstroomcreëren.

  1. Selecteer Datastreams en uw gegevensstroom in de gebruikersinterface voor gegevensverzameling.

  2. Dan selecteer toevoegen Add Service.

  3. Voeg Adobe Analytics toe uit de lijst Service ,

  4. Voer de naam in van de rapportsuite van Adobe Analytics die u in Report Suite ID wilt gebruiken.

  5. Schakel Enabled in om de service in te schakelen.

  6. Selecteer Save.

    voegt Adobe Analytics als datastreamdienst toe

Automatische toewijzing

Veel standaard XDM-velden worden automatisch toegewezen aan analytische variabelen. Zie de volledige lijst hier.

Voorbeeld 1 - s.products

Een goed voorbeeld is de productvariabeledie niet kan worden bevolkt gebruikend verwerkingsregels. Met een XDM-implementatie geeft u alle benodigde gegevens door in productListItems en s.products wordt automatisch ingevuld via Analytics-toewijzing.

Dit object:

"productListItems": [
    [
      "name":  "Yoga Mat",
      "SKU": "5829",
      "priceTotal": "49.99",
      "quantity": 1
    ],
    [
      "name":  "Water Bottle",
      "SKU": "9841",
      "priceTotal": "30.00",
      "quantity": 3
    ]
]

resulteert in:

s.products = ";5829;1;49.99,9841;3;30.00"
NOTE
Als productListItems[].SKU en productListItems[].name beide gegevens bevatten, wordt de waarde in productListItems[].SKU gebruikt. Zie veranderlijke afbeelding van Analytics in de Ervaring Edge van de Adobevoor meer informatie.

Voorbeeld 2 - scAdd

Als u goed kijkt, hebben alle gebeurtenissen twee velden value (vereist) en id (optioneel). Het veld value wordt gebruikt om het aantal gebeurtenissen te verhogen. Het veld id wordt gebruikt voor serienummering.

Dit object:

"commerce" : {
  "productListAdds" : {
    "value" : 1
  }
}

resulteert in:

s.events = "scAdd"

Dit object:

"commerce" : {
  "productListAdds" : {
    "value" : 1,
    "id": "321435"
  }
}

resulteert in:

s.events = "scAdd:321435"

Valideren met Assurance

Gebruikend Assurancekunt u bevestigen dat u een ervaringsgebeurtenis verzendt, is het XDM- gegeven correct en de afbeelding van Analytics gebeurt zoals verwacht.

  1. Herzie de sectie van opstellingsinstructiesom uw simulator of apparaat met Assurance te verbinden.

  2. Verzend een productListAdds -gebeurtenis (voeg een product toe aan uw mandje).

  3. Bekijk de ExperienceEvent hit.

    Analytics xdm hit

  4. Controleer het XDM-gedeelte van de JSON.

    code language-json 
    "xdm" : {
  "productListItems" : [ {
    "SKU" : "LLWS05.1-XS",
    "name" : "Desiree Fitness Tee",
    "priceTotal" : 24
  } ],
"timestamp" : "2023-08-04T12:53:37.662Z",
"eventType" : "commerce.productListAdds",
"commerce" : {
  "productListAdds" : {
    "value" : 1
  }
}
// ...

  5. Controleer de analytics.mapping -gebeurtenis.

    Analytics xdm hit

Neem nota van het volgende in de afbeelding van Analytics:

  • events wordt gevuld met scAdd gebaseerd op commerce.productListAdds .
  • pl (productvariabele) wordt gevuld met een samengevoegde waarde op basis van productListItems .
  • Er is andere interessante informatie in deze gebeurtenis, waaronder alle contextgegevens.

Toewijzing met contextgegevens

De gegevens XDM die aan Analytics door:sturen worden omgezet in contextgegevensmet inbegrip van zowel standaard als douanegebieden.

De sleutel van contextgegevens wordt samengesteld volgens deze syntaxis:

a.x.[xdm path]

Bijvoorbeeld:

// Standard Field
a.x.commerce.saveforlaters.value

// Custom Field
a.x._techmarketingdemos.appinformation.appstatedetails.screenname
NOTE
Aangepaste velden worden onder de Org-id van het Experience Cloud geplaatst.
_techmarketingdemos wordt vervangen door de unieke waarde van uw organisatie.

Om deze XDM contextgegevens aan uw gegevens van Analytics in uw rapportreeks in kaart te brengen, kunt u:

Een veldgroep gebruiken

  • Voeg de Adobe Analytics ExperienceEvent Full Extension veldgroep toe aan uw schema.

    het gebiedsgroep van ExperienceEvent FullExtension

  • Bouw XDM nuttige lasten in uw app, die aan de het gebiedsgroep van de Uitbreiding van Adobe Analytics ExperienceEvent Volledige in overeenstemming zijn, gelijkend op wat u in de 🔗 les van de Gegevens van de Gebeurtenis van het 0} Spoor {hebt gedaan, of

  • Bouw regels in uw bezit van Markeringen die regelacties gebruiken om gegevens aan de het gebiedsgroep van de Uitbreiding van Adobe Analytics ExperienceEvent Volledige toe te voegen of te wijzigen. Zie voor meer details gegevens vastmaken aan de gebeurtenissen van SDKof gegevens in gebeurtenissen van SDK wijzigen.

Merchandising Vars

Als u koopt merchandising eVarsin uw opstelling van Analytics, bijvoorbeeld gebruikt om de kleur van producten, als &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60 te vangen, moet u uw XDM nuttige lading uitbreiden die u in de gebeurtenisgegevens van het Spoorbepaalde om die koopjesinformatie te vangen.

  • In JSON:

    code language-json 
    {
  "productListItems": [
      {
          "SKU": "LLWS05.1-XS",
          "name": "Desiree Fitness Tee",
          "priceTotal": 24,
          "_experience": {
              "analytics": {
                  "events1to100": {
                      "event10": {
                          "value": 50
                      }
                  },
                  "customDimensions": {
                      "eVars": {
                          "eVar1": "red",
                      }
                  }
              }
          }
      }
  ],
  "eventType": "commerce.productListAdds",
  "commerce": {
      "productListAdds": {
          "value": 1
      }
  }
}

  • In code:

    code language-swift 
    var xdmData: [String: Any] = [
  "productListItems": [
    [
      "name":  productName,
      "SKU": sku,
      "priceTotal": priceString,
      "_experience" : [
        "analytics": [
          "events1to100": [
            "event10": [
              "value:": value
            ]
          ],
          "customDimensions": [
            "eVars": [
              "eVar1": color
            ]
          ]
        ]
      ]
    ]
  ],
  "eventType": "commerce.productViews",
  "commerce": [
    "productViews": [
      "value": 1
    ]
  ]
]

Verwerkingsregels gebruiken

Zo ziet een verwerkingsregel met deze gegevens eruit:

  • U Overwrite value of (1) App Screen Name (eVar2) (2) met de waarde a.x._techmarketingdemo.appinformation.appstatedetails.screenname (3) if a.x._techmarketingdemo.appinformation.appstatedetails.screenname (4) is set (5).

  • U Set event (6) Add to Wishlist (Event 3) (7) tot a.x.commerce.saveForLaters.value(Context) (8) als a.x.commerce.saveForLaters.value(Context) (9) is set (10).

analytische verwerkingsregels

IMPORTANT
Sommige automatisch toegewezen variabelen zijn mogelijk niet beschikbaar voor gebruik in verwerkingsregels.
De eerste keer u aan een verwerkingsregel in kaart brengt, toont de interface u niet de variabelen van contextgegevens van het voorwerp XDM. Als u een waarde wilt selecteren, slaat u Opslaan en keert u terug om te bewerken. Alle XDM-variabelen moeten nu worden weergegeven.

De extra informatie over verwerkingsregels en contextgegevens kan hierworden gevonden.

TIP
In tegenstelling tot de vorige implementaties van mobiele apps, is er geen onderscheid tussen een pagina/het scherm meningen en andere gebeurtenissen. In plaats daarvan kunt u de metrische waarde van Page View verhogen door de Page Name -dimensie in te stellen in een verwerkingsregel. Aangezien u het aangepaste veld screenName in de zelfstudie verzamelt, wordt het ten zeerste aanbevolen de schermnaam toe te wijzen aan Page Name in een verwerkingsregel.

Migreren vanuit mobiele extensie Analytics

Als u uw mobiele toepassing gebruikend de mobiele uitbreiding van Adobe Analyticshebt ontwikkeld hebt u zeer waarschijnlijk MobileCore.trackActionen MobileCore.trackStateAPI vraag gebruikt.

Als u besluit te migreren om de geadviseerde Edge Network te gebruiken, hebt u opties:

SUCCESS
U hebt uw app zo ingesteld dat uw Experience Edge XDM-objecten worden toegewezen aan Adobe Analytics-variabelen, waardoor de Adobe Analytics-service in uw gegevensstroom kan worden gebruikt en waar van toepassing verwerkingsregels kunnen worden gebruikt.
Bedankt dat u tijd hebt geïnvesteerd in het leren van Adobe Experience Platform Mobile SDK. Als u vragen hebt, algemene terugkoppelen willen delen, of suggesties over toekomstige inhoud hebben, hen op deze Communautaire besprekingspost van de Experience Leaguedelen.

Volgende: verzendt gegevens naar Experience Platform

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b