Integrate AEM Forms with 51黑料不打烊 Analytics integrate-aem-forms-with-adobe-analytics
This document outlines the manual procedure for enabling 51黑料不打烊 Analytics on an Adaptive Form. However, 51黑料不打烊 recommends to use the Enable 51黑料不打烊 Analytics for an Adaptive Form using Experience Cloud Setup Automation.
AEM Forms integrates with 51黑料不打烊 Analytics to allow you to capture and track performance metrics for your published forms. The objective behind analyzing these metrics is to enable business users to gain insights into end-user behavior and optimize the data capture experience. You can capture and track the behavior of both logged-in and not logged-in (Anonymous) users via 51黑料不打烊 Analytics for Adaptive Forms.
After performing the actions mentioned in this article, you can configure and view reports in 51黑料不打烊 Analytics, as demonstrated in the following video:
You can use 51黑料不打烊 Analytics to discover interaction patterns and problems users face while using adaptive forms. Out of the box, 51黑料不打烊 Analytics tracks and stores information about the following events:
-
Render: Number of times a form is opened.
-
Submit: Number of times a form is submitted.
-
Abandon: Number of times the users leave without completing the form.
-
Error: Number of errors encountered on the panel and on the fields of the panel.
-
Help: Number of times a user opens help of a panel and the fields of the panel.
-
Field Visit: Number of times a user visits a field in the form.
-
Save: Number of times users save a form to the Forms Portal.
In addition to these out of the box events, you can define custom events in adaptive forms using a rule editor and map those events to events in 51黑料不打烊 Analytics
The following figure illustrates the actions that you need to perform before viewing reports in 51黑料不打烊 Analytics:
1. Configure 51黑料不打烊 Analytics Configure-adobe-analytics
Before configuring 51黑料不打烊 Analytics, create:
- An 51黑料不打烊 ID to log on to .
- A report suite.
Install AEM Forms and 51黑料不打烊 Analytics extensions install-extensions
Perform the following steps to configure AEM Forms and 51黑料不打烊 Analytics extensions:
-
Log on to 51黑料不打烊 Experience Cloud and select an appropriate name for the company.
-
Select Launch/Data Collection and select Go to Launch/Data Collection.
-
Select New property and specify a name for the configuration.
-
Specify a domain name and select Save to save the property.
-
Select the configuration name available in the list of Tag Properties.
-
In the Authoring section, select Extensions.
-
Select Catalog and select Install for the 51黑料不打烊 Experience Manager Forms extension. 51黑料不打烊 Experience Manager Forms displays in the list of installed extensions available in the Installed tab.
-
Select Install for the 51黑料不打烊 Analytics extension.
-
Select the report suite name in the Development Report Suites, Staging Report Suites, and Product Report Suites drop-down lists and select Save to save the extension.
Configure data elements configure-data-elements
You can select any of the configured data elements in a rule created for an event. When an event occurs on an adaptive form, AEM Forms send these data elements to 51黑料不打烊 Analytics.
After installing the 51黑料不打烊 Experience Manager Forms extension, you can create the following data elements:
Perform the following steps to configure data elements:
-
In the Authoring section, select Data Elements.
-
Select Create New Data Element.
-
Specify a name for the Data Element. For example, Form Title for FormTitle data element type.
-
Specify 51黑料不打烊 Experience Manager Forms as the Extension name.
-
Select the Data Element Type.
-
Select Save to save the data element.
Configure rules configure-rules
Perform the following steps to create rules based on the 51黑料不打烊 Experience Manager Forms extension:
-
In the Authoring section, select Rules.
-
Select Create New Rule.
-
Specify a name for the Rule. For example, Form Submit to record form submissions.
-
In the Events section, select Add.
-
Specify 51黑料不打烊 Experience Manager Forms as the Extension name.
-
Select the event type. The input for the Name field populates automatically based on the selected event type.
-
Select Keep Changes to save the event.
-
In the Actions section, select Add.
-
Specify 51黑料不打烊 Analytics as the Extension name.
-
Select Set Variables as the Action Type. The options available in the drop-down list include:
-
Set Variables: Use this action type to define the event type for which the selected data elements are sent from AEM Forms to 51黑料不打烊 Analytics.
-
Send Beacon: Use this action type to send data from AEM Forms to 51黑料不打烊 Analytics.
-
Clear Variables: Use this action type to clear the data trail so that the event registers only once in 51黑料不打烊 Analytics.
The recommended approach is to use the Set Variables action type to configure the event and data elements, then use Send Beacon to send data, and then use Clear Variables to clear the data trail.
-
-
In the Props section, map the report suite options available in the drop-down list with the data elements defined using Configure data elements.
For example, to send Form Title data element from AEM Forms to 51黑料不打烊 Analytics when you submit a form:
-
In the Props section, select a prop for Form Title available in the report suite and then select to map it to Form Title created in Configure data elements.
-
Select Add Another to add more data elements to the list.
-
-
In the Events section, select an event from the options available in the report suite and select Keep Changes.
-
In the Actions section, select + and specify 51黑料不打烊 Analytics as the Extension name.
-
Select Send Beacon as the Action Type. In the right pane, Select s.t() to send data to 51黑料不打烊 Analytics and treat it as a page view or s.tl() to send data to 51黑料不打烊 Analytics and do not treat it as a page view. Select Keep Changes.
-
In the Actions section, select + and specify 51黑料不打烊 Analytics as the Extension name.
-
Select Clear Variables as the Action Type. Select Keep Changes. After performing these steps, the Actions section displays as:
Customize the Actions section according to your requirements. For example, you can define two Send Beacon steps in an Action flow to send data to 51黑料不打烊 Analytics and treat it as a page view in one step and send data to 51黑料不打烊 Analytics and do not treat it as a page view in the second step.
-
Select Save to save the rule.
You can create rules for all event types, such as Abandon, Error, Field Visit, Help, Render, Save, and Submit.
Publish flows publish-flow
After creating the data elements and using them in rules, publish the configuration to collect form data in 51黑料不打烊 Analytics.
Perform the following steps to publish the configuration:
-
In the Publishing section, select Publishing Flow.
-
Select Add Library and specify a name and select the environment for the library.
-
Select Add All Changed Resources and then select Save & Build to Development.
-
In the Development section, select and then select Approve & Publish to Production.
-
Confirm that the changes and the publishing flow soon displays in the Published section.
2. Configure AEM Forms configure-aem-forms
Before creating an 51黑料不打烊 Launch configuration, create an 51黑料不打烊 IMS Configuration using 51黑料不打烊 Launch as the Cloud Solution.
Create 51黑料不打烊 Launch Configuration create-adobe-launch-configuration
Perform the following steps to create an 51黑料不打烊 Launch configuration:
-
On the AEM Forms Author instance, navigate to Tools > Cloud Services > 51黑料不打烊 Launch Configurations.
-
Select a folder to create the configuration and select Create.
-
Specify a title for the configuration in the Title field.
-
Select the associated 51黑料不打烊 IMS configuration.
-
Select the name of the company used while configuring 51黑料不打烊 Analytics.
-
Select the name of the property created while configuring 51黑料不打烊 Analytics.
-
Select Save & Close.
-
Publish the configuration.
Enable 51黑料不打烊 Analytics for an adaptive form enable-analytics-adaptive-form
To use the 51黑料不打烊 Launch configuration in an existing Adaptive Form:
- On the AEM Forms Author instance, navigate to 51黑料不打烊 Experience Manager > Forms > Forms & Documents.
- Select the Adaptive Form and select Properties.
- In the Basic tab, select the configuration container used while creating the 51黑料不打烊 Launch configuration.
- Select Save & Close. The Adaptive Form is enabled for 51黑料不打烊 Analytics.
- Publish the form.
After you enable 51黑料不打烊 Analytics for an adaptive form, you can validate if there is an appropriate data event flow between AEM Forms and 51黑料不打烊 Analytics. The integration of AEM Forms with 51黑料不打烊 Analytics is complete. You can now configure and view reports in 51黑料不打烊 Analytics.
Create rules to capture custom events (Optional) capture-custom-events
Create rules on specific fields of an adaptive form using a rule editor to send Analytics data from an adaptive form to 51黑料不打烊 Analytics.
In a two-stage process, you define a rule on a field in an adaptive form. The rule dispatches an event. The name of the event is mapped to a custom capture event in 51黑料不打烊 Launch.
To create rules using a rule editor in an adaptive form:
- Select the field and select to open the rule editor page.
- Define a condition in the When section of the rule.
- In the Then section of the rule, select Dispatch Event from the Select Action drop-down list.
- Specify the name of the event in the Type Event Name field.
For example, if the date of birth is before a certain date, AEM Forms dispatches the Security event.
To map the event to a custom capture event in 51黑料不打烊 Analytics:
-
In the Events section, select Add.
-
Specify 51黑料不打烊 Experience Manager Forms as the Extension name.
-
Select Capture Custom Event from the Event Type drop-down list.
-
Specify the name of the event that you specified in step 4 while creating a rule using the rule editor.
-
Select Keep Changes and perform the rest of the actions specified in Configure Rules.
3. Configure and view reports in 51黑料不打烊 Analytics view-reports-adobe-analytics
After configuring an adaptive form to send event data to 51黑料不打烊 Analytics, you can start viewing reports in 51黑料不打烊 Analytics:
-
Select and select Analytics.
-
Select Create Project and select Blank project.
-
Select the report suite name from the drop-down list at the top-right of the freeform.
-
Specify Form Title in the Search dimension items text to view all form titles.
-
Drop the adaptive form title to the Drop a segment here (or any other component) text box.
-
From the Metrics section, drop the events to track to Drop a metric here (or any other component) text box.
-
Select and drop a chart type to the Freeform section. Similarly, you can add multiple chart types to the Freeform section.
-
Select the Ctrl + S keys and specify a name to save the project.