Analysegegevens verzamelen en toewijzen

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.

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

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

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

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

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