Analytics-Daten erfassen und zuordnen

Erfahren Sie, wie Sie mobile Daten Adobe Analytics zuordnen.

Die event Daten, die Sie in früheren Lektionen gesammelt und an Platform Edge Network gesendet haben, werden an die in Ihrem Datastream konfigurierten Dienste weitergeleitet, einschließlich Adobe Analytics. Sie ordnen die Daten den korrekten Variablen in Ihrer Report Suite zu.

Architektur

Voraussetzungen

  • Grundlegendes zum ExperienceEvent-Tracking.
  • Erfolgreiches Senden von XDM-Daten in Ihrer Beispielanwendung.
  • Eine Adobe Analytics Report Suite, die Sie für diese Lektion verwenden können.

Lernziele

In dieser Lektion werden Sie:

  • Konfigurieren Sie Ihren Datenspeicher mit dem Adobe Analytics-Dienst.
  • Verstehen Sie die automatische Zuordnung von Analytics-Variablen.
  • Richten Sie Verarbeitungsregeln ein, um XDM-Daten Analytics-Variablen zuzuordnen.

Hinzufügen des Adobe Analytics-Datenspeicherdiensts

Um Ihre XDM-Daten vom Edge-Netzwerk an Adobe Analytics zu senden, konfigurieren Sie den Adobe Analytics-Dienst für den Datastraam, den Sie im Rahmen von Erstellen eines Datenspeichers.

  1. Wählen Sie in der Datenerfassungs-Benutzeroberfläche die Option Datenspeicher und Ihrem Datastream.

  2. Wählen Sie anschließend Hinzufügen Dienst hinzufügen.

  3. Hinzufügen Adobe Analytics aus dem Dienst Liste,

  4. Geben Sie den Namen der Report Suite aus Adobe Analytics ein, die Sie in Report Suite-ID.

  5. Aktivieren Sie den Dienst, indem Sie Aktiviert auf.

  6. Wählen Sie Speichern aus.

    Hinzufügen von Adobe Analytics als Datenspeicherdienst

Automatische Zuordnung

Viele der Standard-XDM-Felder werden automatisch Analytics-Variablen zugeordnet. Die vollständige Liste finden Sie hier.

Beispiel 1: s.products

Ein gutes Beispiel dafür ist die Produktvariable die nicht mit Verarbeitungsregeln aufgefüllt werden können. Mit einer XDM-Implementierung übergeben Sie alle erforderlichen Daten in productListItems und s.products werden automatisch über die Analytics-Zuordnung ausgefüllt.

Dieses Objekt:

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

führt zu:

s.products = ";5829;1;49.99,9841;3;30.00"
NOTE
Wenn productListItems[].SKU und productListItems[].name beide Daten enthalten, enthält der Wert in productListItems[].SKU verwendet. Siehe Analytics-Variablenzuordnung in Adobe Experience Edge für weitere Informationen.

Beispiel 2 - scAdd

Wenn Sie genau hinsehen, haben alle Ereignisse zwei Felder value (erforderlich) und id (optional). Die value -Feld wird verwendet, um die Ereignisanzahl zu erhöhen. Die id -Feld wird für die Serialisierung verwendet.

Dieses Objekt:

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

führt zu:

s.events = "scAdd"

Dieses Objekt:

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

führt zu:

s.events = "scAdd:321435"

Validierung mit Versicherung

Verwenden der Assurance Sie können bestätigen, dass Sie ein Erlebnisereignis senden, dass die XDM-Daten korrekt sind und die Analytics-Zuordnung erwartungsgemäß erfolgt.

  1. Überprüfen Sie die Einrichtungsanweisungen -Abschnitt, um Ihren Simulator oder Ihr Gerät mit Assurance zu verbinden.

  2. Senden Sie eine productListAdds -Ereignis (fügen Sie Ihrem Warenkorb ein Produkt hinzu).

  3. Anzeigen des ExperienceEvent-Treffers.

    xdm-Treffer von analytics

  4. Überprüfen Sie den XDM-Teil der 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. Überprüfen Sie die analytics.mapping -Ereignis.

    xdm-Treffer von analytics

Beachten Sie Folgendes in der Analytics-Zuordnung:

  • events mit scAdd basierend auf commerce.productListAdds.
  • pl (Produktvariable) mit einem verketteten Wert gefüllt werden, der auf productListItems.
  • Es gibt weitere interessante Informationen in diesem Ereignis, einschließlich aller Kontextdaten.

Zuordnung mit Kontextdaten

An Analytics weitergeleitete XDM-Daten werden in Kontextdaten einschließlich sowohl standardmäßiger als auch benutzerdefinierter Felder.

Der Kontextdatenschlüssel wird nach dieser Syntax konstruiert:

a.x.[xdm path]

Beispiel:

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

// Custom Field
a.x._techmarketingdemos.appinformation.appstatedetails.screenname
NOTE
Benutzerdefinierte Felder werden unter Ihrer Experience Cloud-Organisationskennung platziert.
_techmarketingdemos durch den eindeutigen Wert Ihrer Organisation ersetzt.

Um diese XDM-Kontextdaten Ihren Analytics-Daten in Ihrer Report Suite zuzuordnen, können Sie:

Feldgruppe verwenden

  • Fügen Sie die Adobe Analytics ExperienceEvent Full Extension Feldergruppe in Ihr Schema ein.

    Feldergruppe Analytics ExperienceEvent FullExtension

  • Erstellen Sie XDM-Payloads in Ihrer App entsprechend der Feldergruppe "Adobe Analytics ExperienceEvent Full Extension", ähnlich wie bei den Schritten im Tracking von Ereignisdaten Lektion oder

  • Erstellen Sie Regeln in Ihrer Tags-Eigenschaft, die Regelaktionen zum Anhängen oder Ändern von Daten an die Feldergruppe "Adobe Analytics ExperienceEvent Full Extension"verwenden. Weitere Informationen finden Sie unter Daten an SDK-Ereignisse anhängen oder Daten in SDK-Ereignissen ändern.

Merchandising-eVars

Wenn Sie Merchandising-eVars in Ihrem Analytics-Setup, z. B. zum Erfassen der Produktfarbe, wie z. B. &&products = ...;evar1=red;event10=50,...;evar1=blue;event10=60müssen Sie Ihre XDM-Payload erweitern, die Sie in Tracking von Ereignisdaten , um diese Merchandising-Informationen zu erfassen.

  • 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
          }
      }
    }
    
  • Im 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
        ]
      ]
    ]
    

Verarbeitungsregeln verwenden

So könnte eine Verarbeitungsregel, die diese Daten verwendet, aussehen:

  • You Wert von überschreiben Absatz 1 App-Bildschirmname (eVar2) 2) mit dem Wert a.x_techmarketingdemo.appinformation.appstatedetails.screename 3. wenn a.x_techmarketingdemo.appinformation.appstatedetails.screename Absatz 4 festgelegt ist Absatz 5.

  • You Ereignis festlegen Absatz 6 Zu Wunschliste hinzufügen (Ereignis 3) 7 bis a.x.commerce.saveForLaters.value(Context) 8, wenn a.x.commerce.saveForLaters.value(Context) 9. festgelegt ist 10.

Analytics-Verarbeitungsregeln

IMPORTANT
Einige der automatisch zugeordneten Variablen stehen möglicherweise nicht zur Verwendung in Verarbeitungsregeln zur Verfügung.
Wenn Sie eine Verarbeitungsregel zum ersten Mal zuordnen, zeigt die Schnittstelle die Kontextdatenvariablen aus dem XDM-Objekt nicht an. Um das Problem zu beheben, bei dem ein beliebiger Wert ausgewählt wurde, speichern Sie und kehren Sie zur Bearbeitung zurück. Alle XDM-Variablen sollten jetzt angezeigt werden.

Weitere Informationen zu Verarbeitungsregeln und Kontextdaten finden Sie here.

TIP
Im Gegensatz zu früheren Implementierungen mobiler Apps gibt es keine Unterscheidung zwischen Seiten-/Bildschirmansichten und anderen Ereignissen. Stattdessen können Sie die Seitenansicht Metrik durch Festlegen der Seitenname -Dimension in einer Verarbeitungsregel. Da Sie die benutzerdefinierte screenName im Tutorial wird dringend empfohlen, den Namen des Bildschirms Seitenname in einer Verarbeitungsregel.
SUCCESS
Sie haben Ihre App eingerichtet, um Ihre Experience Edge XDM-Objekte Adobe Analytics-Variablen zuzuordnen, die den Adobe Analytics-Dienst in Ihrem Datenspeicher ermöglichen, und gegebenenfalls Verarbeitungsregeln verwenden.
Vielen Dank, dass Sie Ihre Zeit investiert haben, um mehr über das Adobe Experience Platform Mobile SDK zu erfahren. Wenn Sie Fragen haben, ein allgemeines Feedback oder Vorschläge zu künftigen Inhalten teilen möchten, teilen Sie diese hier mit. Experience League Community-Diskussionsbeitrag.

Weiter: Daten an Experience Platform senden

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