Documentatie Experience Platform Tutorial voor mobiele apps

Analysegegevens verzamelen en toewijzen

Last update: Wed Sep 10 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 Platform Edge Network in vroegere lessen verzendt door:sturen aan de diensten die in uw datastream, met inbegrip van Adobe Analytics worden gevormd. U brengt de gegevens aan de correcte variabelen in uw rapportreeks in kaart.

Architectuur {modal="regular"}

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 Edge Network naar Adobe Analytics te verzenden, vormt u de dienst van Adobe Analytics aan de datastream u opstelling als deel van creeert een datastream.

Selecteer Datastreams en uw gegevensstroom in de gebruikersinterface voor gegevensverzameling.
Dan selecteer Add Service.
Voeg Adobe Analytics toe uit de lijst Service ,
Voer de naam in van de rapportsuite van Adobe Analytics die u in Report Suite ID wilt gebruiken.
Schakel Enabled in om de service in te schakelen.
Selecteer Save.

{modal="regular"} toe

Automatische toewijzing

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

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 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.

Herzie de sectie van opstellingsinstructiesom uw simulator of apparaat met Assurance te verbinden.
Verzend een productListAdds -gebeurtenis (voeg een product toe aan uw mandje).
Bekijk de ExperienceEvent hit.

{modal="regular"}

Controleer het XDM-gedeelte van de JSON.

code language-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 } } // ...`

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

Controleer de analytics.mapping -gebeurtenis.

{modal="regular"}

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 Experience Cloud Org-id geplaatst.

De huurdersnaam _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.

{modal="regular"}
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 de gebeurtenissen van SDK wijzigen.

Merchandising Vars

Als u merchandising eVarsin uw opstelling van Analytics gebruikt, moet u uw nuttige lading uitbreiden XDM die u in de gebeurtenisgegevens van het Spoorbepaalde om die het verhandelen informatie te vangen. Voorbeeld van een handelswaar var is evar1 waar u de kleur van producten wilt vastleggen, bijvoorbeeld &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60

In JSON:

code language-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 } } }`

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

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 ] ] ]`

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 {modal="regular"}

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.

Zie contextData variabelen van de Kaart in steunen en eVars met verwerkingsregels.

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 hoogstwaarschijnlijk MobileCore.trackActionen MobileCore.trackStateAPI vraag gebruikt.

Als u besluit te migreren om de aanbevolen Edge Network te gebruiken, hebt u wel de volgende opties:

Voer de uitbreiding van Edge Networkuit en gebruik Edge.sendEventAPIs, zoals geïllustreerd in de les op hoe te de gebeurtenisgegevens van het Spoor. Deze zelfstudie richt zich op deze implementatie.
Voer de uitbreiding van Edge Bridgeuit, en gebruik uw MobileCore.trackActionen MobileCore.trackStateAPI vraag. Zie de uitbreiding van Edge Bridgevoor meer details en een afzonderlijk leerprogramma uitvoeren.

SUCCESS

U hebt uw app zo ingesteld dat uw Experience Edge XDM-objecten worden toegewezen aan Adobe Analytics-variabelen door de Adobe Analytics-service in uw gegevensstroom in te schakelen. en in voorkomend geval met gebruikmaking van verwerkingsvoorschriften.
Bedankt dat u 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 Experience Leaguedelen.

Volgende: verzendt gegevens naar Experience Platform

recommendation-more-help

9fed61f5-c338-47ad-8005-0b89a5f4af8b