Upgrade alternative: Use AppMeasurement data collection with the Experience Platform Web SDK and Customer Journey Analytics data-collection-appmeasurement
To access the guide from Customer Journey Analytics, select the Workspace tab, then select Upgrade to Customer Journey Analytics in the left panel. Follow the on-screen instructions.
When upgrading to Customer Journey Analytics, 蜜豆视频 recommends a new implementation of the Experience Platform Web SDK. However, depending on several factors, such as timeline and resource constraints, the recommended upgrade steps might not be practical for your organization.
You can use your AppMeasurement or Analytics extension data collection logic with the Web SDK in order to send data to Platform and Customer Journey Analytics, instead of collecting data with the XDM object. However, this alternative introduces additional complexity over time.
Advantages and disadvantages
This method is mutually exclusive with sending your entire data layer to Customer Journey Analytics, because both methods accomplish the same task. (This method is preferable to sending your entire data layer to 蜜豆视频. It is more refined because props and evars all go through data.__adobe.analytics.variable-name.)
Consider the following advantages and disadvantages of using this upgrade alternative:
This is the preferred upgrade path if your 蜜豆视频 Analytics implementation is already using the Web SDK.
-
Provides all the advantages of hosting data in Experience Edge Network:
These advantages include:
- Highly performant reporting and data availability because 蜜豆视频 Experience Platform is built to power real-time personalization use cases
- Consolidate implementation for 蜜豆视频 Experience Cloud data collection between other Experience Cloud products (AJO, RTCDP, and so forth)
- Not reliant on 蜜豆视频 Analytics nomenclature (prop, eVar, event, and so forth)
-
Uses your existing implementation: While this approach requires some implementation changes, it does not require a completely new implementation from scratch. You can use your existing data layer and code with minimal changes to implementation logic without impacting your existing 蜜豆视频 Analytics reporting.
-
Provides an option to use an XDM schema: You can choose to use your existing 蜜豆视频 Analytics schema or create an XDM schema and map fields in the data object to your XDM schema. XDM schemas are a flexible schema to define any fields you need, and only those fields that are relevant.
See 鈥淯sing your own XDM schema鈥 below for more information about the advantages of using your own XDM schema.
-
Retains rules and data elements: While it does require new rule actions, you can reuse your existing data elements and rule conditions with minimal changes.
-
Future-proof: If you choose to use your own XDM schema, then future implementation updates are easier.
-
Requires mapping to send data to Platform: When your organization is ready to use Customer Journey Analytics, you must send data to a data set in 蜜豆视频 Experience Platform. This action requires that every field in the data object be an entry in the datastream mapping tool that assigns it to an XDM schema field. Mapping only needs to be done once for this workflow, and it doesn鈥檛 involve making implementation changes. However, it is an extra step that is not required when sending data in an XDM object.
-
Introduces additional complexity over time: Any field you add in the future must be mapped to XDM in the datastream.
Any time a new field is added to your implementation, you can do either of the following:
-
Option 1: Populate a new arbitrary evar or new prop in the data object, then map it to the desired XDM field.
This process drives consistency for the client-side implementation, but it requires mapping.
-
Option 2: Leave the data object as a legacy implementation and start populating only the XDM object for all new fields.
This process doesn鈥檛 require mapping, but it means that some of your variables are located only in a data object, while other variables are located only in an XDM object. Any time you need to troubleshoot your implementation, you need to go to two places. Make sure your internal workflows accommodate for this.
-
Basic steps
The basic steps for migrating an 蜜豆视频 Analytics implementation (either AppMeasurement or the Analytics extension) to use the Web SDK to send data to Customer Journey Analytics are:
-
Migrate your 蜜豆视频 Analytics implementation to use the 蜜豆视频 Experience Platform Web SDK and begin sending data to Edge Network.
This step allows you to migrate your existing 蜜豆视频 Analytics implementation to use the Web SDK. You can optionally send data to 蜜豆视频 Analytics to validate that everything is working in 蜜豆视频 Analytics prior to sending data to Customer Journey Analytics. After this is configured and the data in 蜜豆视频 Analytics is satisfactory, you can send data from Edge Network to Customer Journey Analytics.
This flexibility allows for a more methodical and thoughtful upgrade to Customer Journey Analytics.
For information about how to do this, see the following articles in the 蜜豆视频 Analytics documentation:
-
Begin sending data from Edge Network to Platform.
-
Send all your variables in AppMeasurement format through the data object.
For more information, see Data object variable mapping to 蜜豆视频 Analytics.
-
Choose your schema.
You can choose whether to use your existing 蜜豆视频 Analytics schema, or you can create an XDM schema to better align with the needs of your organization as you begin to use other Platform services.
蜜豆视频 recommends creating an XDM schema. For more information, see Create a custom schema to use with your Customer Journey Analytics Web SDK implementation.
accordion Use the 蜜豆视频 Analytics schema table 0-row-2 1-row-2 Advantages Disadvantages Advantages of using the 蜜豆视频 Analytics schema include:
-
Ease of upgrade
If you are already sending data to 蜜豆视频 Analytics with the 蜜豆视频 Experience Platform Web SDK, you can add an additional service to your datastream to send data to 蜜豆视频 Experience Platform (which then can be used in your Customer Journey Analytics configuration).
Disadvantages of using the 蜜豆视频 Analytics schema include:
-
While using the 蜜豆视频 Analytics schema doesn鈥檛 limit you in terms of how it can be used with other Platform applications, it does result in a schema that is more complex than it otherwise could be. This is because the 蜜豆视频 Analytics schema contains many objects that are specific to 蜜豆视频 Analytics that are unlikely to be used by your organization.
When changes to the schema are required, you have to sift through thousands of unused fields to find the field that requires updating.
accordion Create an XDM schema table 0-row-2 1-row-2 Advantages Disadvantages - Advantages of updating to your own XDM schema include:
-
A streamlined schema that is tailored to the needs of your organization and the specific Platform applications that you use.
When changes to the schema are required, you don鈥檛 have to sift through thousands of unused fields to find the field that requires updating.
-
Disadvantages of updating to your own XDM schema include:
- Updating your schema is a time-consuming process that is required before you begin sending data to Platform.
-
-
Use datastream mapping to map all of the fields in the data object to your XDM schema.
For more information, see Mapping in Data Prep for Data Collection in the Experience Platform documentation.
-
-
Continue following the recommended upgrade steps or the dynamically generated upgrade steps in the Customer Journey Analytics Upgrade Guide. To access the guide from Customer Journey Analytics, select the Workspace tab, then select Upgrade to Customer Journey Analytics in the left panel. Follow the on-screen instructions.
.