Raccogliere e mappare dati di Analytics

Scopri come mappare i dati mobili su Adobe Analytics.

Il evento i dati raccolti e inviati 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

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 un flusso di dati.

  1. Nell’interfaccia utente di Data Collection, seleziona Flussi di dati e lo stream di dati.

  2. Quindi seleziona Aggiungi Aggiungi servizio.

  3. Aggiungi Adobe Analytics dal Servizio elenco,

  4. Immetti il nome della suite di rapporti di Adobe Analytics che desideri utilizzare in ID suite di rapporti.

  5. Attiva il servizio cambiando Abilitato su.

  6. Seleziona Salva.

    Aggiungere Adobe Analytics come servizio di flusso di dati

Mappatura automatica

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

Esempio #1 - s.products

Un buon esempio è il variabile dei prodotti che non può essere compilato utilizzando le regole di elaborazione. Con un’implementazione XDM, trasmetti 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 entrambi contengono dati, il valore in productListItems[].SKU viene utilizzato. Consulta Mappatura delle variabili di Analytics in Adobe Experience Edge per ulteriori informazioni.

Esempio #2 - scAdd

Se osservi attentamente, tutti gli eventi hanno due campi value (obbligatorio) e id (facoltativo). Il value per incrementare il conteggio degli eventi. Il 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"

Convalida con garanzia

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

  1. Rivedi istruzioni di configurazione per collegare il simulatore o il dispositivo ad Assurance.

  2. Invia un productListAdds evento (aggiungi un prodotto al carrello).

  3. Visualizza l’hit ExperienceEvent.

    hit xdm di analytics

  4. Esamina la porzione XDM del 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. Rivedi analytics.mapping evento.

    hit xdm di analytics

Osserva quanto segue nella mappatura di Analytics:

  • Eventi sono compilati con scAdd in base a commerce.productListAdds.
  • pl (variabile dei prodotti) sono compilati 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 di Experience Cloud.
_techmarketingdemos viene sostituito con il valore univoco della tua organizzazione.

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

Utilizza un gruppo di campi

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

    Gruppo di campi FullExtension di Analytics ExperienceEvent

  • Crea payload XDM nell’app, in conformità al gruppo di campi Estensione completa Adobe Analytics ExperienceEvent, in modo simile a quanto eseguito nel Tracciamento dati evento lezione, oppure

  • Crea regole nella proprietà Tags che utilizzano azioni regola per allegare o modificare dati al gruppo di campi Estensione completa Adobe Analytics ExperienceEvent. Vedi per ulteriori dettagli Allegare dati agli eventi SDK o Modificare i dati negli eventi SDK.

eVar di merchandising

Se sta usando eVar di merchandising nella configurazione di Analytics, ad esempio per acquisire il colore dei prodotti, come &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60, devi estendere il payload XDM definito in Tracciare i dati dell’evento per acquisire tali informazioni di merchandising.

  • 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
          }
      }
    }
    
  • Nel codice:

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

Utilizzare le regole di elaborazione

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

  • Tu Sovrascrivi 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).

  • Tu Imposta evento 6) Aggiungi alla lista dei desideri (evento 3) da (7) a a.x.commerce.saveForLaters.value(Context) (8) se a.x.commerce.saveForLaters.value(Context) 9) è impostato (10)

regole di elaborazione di analytics

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.

Ulteriori informazioni sulle regole di elaborazione e i dati contestuali sono disponibili qui.

TIP
A differenza delle precedenti implementazioni di app mobili, non esiste alcuna distinzione tra visualizzazioni di pagina/schermo e altri eventi. È invece possibile incrementare Visualizzazione pagina metrica impostando la Nome pagina dimensione in una regola di elaborazione. Poiché stai raccogliendo il screenName nell’esercitazione, si consiglia vivamente di mappare il nome della schermata su Nome pagina in una regola di elaborazione.
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 applicabili.
Grazie per aver dedicato il tuo tempo all’apprendimento dell’SDK di Adobe Experience Platform Mobile. Se hai domande, vuoi condividere feedback generali o suggerimenti su contenuti futuri, condividili su questo Experience League post di discussione community.

Successivo: Invia dati all’Experience Platform

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