Documentazione Experience Platform Tutorial sull’app mobile

Raccogliere e mappare dati di Analytics

Last update: Wed Sep 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Argomenti:

Creato per:

Principiante
Intermedio
Sviluppatore

Scopri come mappare i dati mobili su Adobe Analytics.

I dati event che hai raccolto e inviato a Platform Edge Network nelle lezioni precedenti vengono inoltrati ai servizi configurati nel flusso di dati, incluso Adobe Analytics. Mappa i dati alle variabili corrette nella suite di rapporti.

Architettura {modal="regular"}

Prerequisiti

Informazioni sul tracciamento ExperienceEvent.
Invio dei dati XDM nell'app di esempio completato.
Una suite di rapporti di Adobe Analytics che puoi utilizzare per questa lezione.

Obiettivi di apprendimento

In questa lezione verranno fornite le seguenti informazioni:

Configura lo stream di dati con il servizio Adobe Analytics.
Comprendere la mappatura automatica delle variabili di Analytics.
Imposta le regole di elaborazione per mappare i dati XDM sulle variabili di Analytics.

Aggiungere il servizio dello stream di dati di Adobe Analytics

Per inviare i dati XDM da Edge Network ad Adobe Analytics, configura il servizio Adobe Analytics allo stream di dati configurato come parte di Creare uno stream di dati.

Nell'interfaccia utente di Data Collection, seleziona Datastreams e il tuo datastream.
Quindi selezionare Aggiungi servizio.
Aggiungi Adobe Analytics dall'elenco Service,
Immetti il nome della suite di rapporti di Adobe Analytics che desideri utilizzare in ID suite di rapporti.
Abilitare il servizio attivando Enabled.
Seleziona Salva.

{modal="regular"}

Mappatura automatica

Molti dei campi XDM standard sono mappati automaticamente alle variabili di Analytics. Vedi l'elenco completo.

Esempio #1 - s.products

Un buon esempio è la variabile dei prodotti che non può essere compilata utilizzando le regole di elaborazione. Con un'implementazione XDM, si passano tutti i dati necessari in productListItems e s.products vengono compilati automaticamente tramite la mappatura di Analytics.

Questo oggetto:

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

risultati in:

s.products = ";5829;1;49.99,9841;3;30.00"

NOTE

Se productListItems[].SKU e productListItems[].name contengono entrambi dati, viene utilizzato il valore in productListItems[].SKU. Per ulteriori informazioni, vedi Mappatura delle variabili di Analytics in Adobe Experience Edge.

Esempio #2 - scAdd

Se si guarda attentamente, tutti gli eventi hanno due campi: value (obbligatorio) e id (facoltativo). Il campo value viene utilizzato per incrementare il conteggio degli eventi. Il campo id viene utilizzato per la serializzazione.

Questo oggetto:

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

risultati in:

s.events = "scAdd"

Questo oggetto:

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

risultati in:

s.events = "scAdd:321435"

Convalidare con Assurance

Utilizzando Assurance puoi confermare che stai inviando un evento esperienza, che i dati XDM sono corretti e che la mappatura di Analytics sta avvenendo come previsto.

Consulta la sezione istruzioni di installazione per collegare il simulatore o il dispositivo ad Assurance.
Invia un evento productListAdds (aggiungi un prodotto al carrello).
Visualizza l’hit ExperienceEvent.

{modal="regular"}

Esamina la porzione XDM del 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
  }
}
// ...

Rivedi l'evento analytics.mapping.

{modal="regular"}

Osserva quanto segue nella mappatura di Analytics:

gli eventi sono compilati con scAdd in base a commerce.productListAdds.
pl (variabile prodotti) è compilato con un valore concatenato basato su productListItems.
In questo evento sono disponibili altre informazioni interessanti, inclusi tutti i dati contestuali.

Mappatura con dati contestuali

I dati XDM inoltrati ad Analytics vengono convertiti in dati contestuali, inclusi i campi standard e personalizzati.

La chiave dei dati contestuali è costruita seguendo questa sintassi:

a.x.[xdm path]

Ad esempio:

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

// Custom Field
a.x._techmarketingdemos.appinformation.appstatedetails.screenname

NOTE

I campi personalizzati si trovano sotto l’identificatore dell’organizzazione Experience Cloud.

Il nome tenant _techmarketingdemos è sostituito con il valore univoco dell'organizzazione.

Per mappare questi dati contestuali XDM sui dati di Analytics nella suite di rapporti, puoi:

Utilizza un gruppo di campi

Aggiungi il gruppo di campi Estensione completa Adobe Analytics ExperienceEvent allo schema.

{modal="regular"}
Crea payload XDM nell'app, in conformità al gruppo di campi Estensione completa Adobe Analytics ExperienceEvent, in modo simile a quanto fatto nella lezione Tracciare dati evento, oppure
Crea regole nella proprietà Tags che utilizzano azioni regola per allegare o modificare dati al gruppo di campi Estensione completa Adobe Analytics ExperienceEvent. Per ulteriori dettagli, vedere Allega dati a eventi SDK o Modifica dati in eventi SDK.

eVar per merchandising

Se utilizzi eVar di merchandising nella configurazione di Analytics, devi estendere il payload XDM definito in Traccia dati evento per acquisire tali informazioni di merchandising. Esempio di var merchandising: evar1 dove desideri acquisire il colore dei prodotti, ad esempio &&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
      }
  }
}

Nel codice:

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

Utilizzare le regole di elaborazione

Di seguito è riportato un esempio di regola di elaborazione che utilizza questi dati:

Sovrascrivi il valore di (1) Nome schermo app (eVar2) (2) con il valore di a.x._techmarketingdemo.appinformation.appstatedetails.screenname (3) se a.x._techmarketingdemo.appinformation.appstatedetails.screenname (4) è impostato (5).
Imposta evento (6) Aggiungi alla lista dei desideri (evento 3) (7) in a.x.commerce.saveForLaters.value(Context) (8) se a.x.commerce.saveForLaters.value(Context) (9) è impostato (10).

regole di elaborazione di analytics {modal="regular"}

IMPORTANT

Alcune delle variabili mappate automaticamente potrebbero non essere disponibili per l’utilizzo nelle regole di elaborazione.

La prima volta che esegui il mapping a una regola di elaborazione, l’interfaccia non mostra le variabili di dati di contesto dall’oggetto XDM. Per risolvere il problema, seleziona un valore qualsiasi, Salva e torna per modificarlo. Verranno visualizzate tutte le variabili XDM.

Vedi Mappare le variabili contextData in prop ed eVar con regole di elaborazione.

TIP

A differenza delle precedenti implementazioni di app mobili, non esiste alcuna distinzione tra visualizzazioni di pagina/schermo e altri eventi. È invece possibile incrementare la metrica Visualizzazione pagina impostando la dimensione Nome pagina in una regola di elaborazione. Poiché stai raccogliendo il campo screenName personalizzato nell'esercitazione, si consiglia vivamente di mappare il nome della schermata a Nome pagina in una regola di elaborazione.

Migrare dall’estensione Analytics per dispositivi mobili

Se hai sviluppato la tua app mobile utilizzando l'estensione per dispositivi mobili Adobe Analytics, probabilmente hai utilizzato MobileCore.trackAction e MobileCore.trackState chiamate API.

Se decidi di eseguire la migrazione per utilizzare l’Edge Network consigliato, puoi scegliere:

Implementa l'estensione Edge Network e utilizza le API Edge.sendEvent, come illustrato nella lezione su come tenere traccia dei dati evento. Questa esercitazione si concentra su questa implementazione.
Implementa l'estensione Edge Bridge e continua a utilizzare le tue chiamate API MobileCore.trackAction e MobileCore.trackState. Consulta Implementare l'estensione Edge Bridge per ulteriori dettagli e un'esercitazione separata.

SUCCESS

Hai configurato l’app per mappare gli oggetti XDM di Experience Edge alle variabili di Adobe Analytics abilitando il servizio Adobe Analytics nello stream di dati. E utilizzando le regole di elaborazione, se del caso.
Grazie per aver dedicato il tuo tempo all'apprendimento di Adobe Experience Platform Mobile SDK. Se hai domande, vuoi condividere commenti generali o suggerimenti su contenuti futuri, condividili in questo post di discussione della community Experience League.

Successivo: Invia dati ad Experience Platform

recommendation-more-help

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