Step 1: Run your App with the SDK initialized in Admin mode

Ensure you run your app with the SDK initialized in Admin mode. In Admin mode, you have access to the Poker Chip that allows you to access configuration features at your fingertips, after you log in to your Space.

For more information, see Integrate the SDK for MXO in your App.

Step 2: Log in to MXO in Admin mode

On your mobile device, log in to MXO in Admin mode to define where you want capture customer data.

1. On your device, open your app.
   Note: You'll see the MXO Poker Chip on-screen.
2. Tap the Poker Chip to view the Login screen.
3. Log in using your MXO username and password.
4. After logging in, tap the Poker Chip again to activate Edit mode.

Step 3: Create your Attribute Capture Point

Attribute Capture Points can be created for app preference data that is not shown on screen. These are typically groupings of key-value entries and are managed by your app developer or other SDKs.

For example, an app preference data point might be a user's choices about the notifications they are happy to receive. An app developer may keep the user's choices in a shared preference called Notifications. The Notifications preference would contain zero or more entries of key-value pairs.

Example Notification Shared Preference Data

Let's say you want to capture the _send_emails_to value into a new attribute when the user navigates to the settings screen of your app. You can easily capture this attribute by tapping on the Interaction Region and selecting Add App Preferences Capture Point when in Edit mode on the Settings Interaction.

To create an Attribute Capture Point

1. With the Poker Chip off, navigate to the Interaction (Screen/View) for which you want to capture Shared Preference data.
2. Tap the Poker Chip to enter Edit mode.
3. Tap any element on the Interaction Point which brings up a pop pp.
4. Tap Region.
5. Tap Add App Preferences Capture Point.
6. Tap the Shared Preference Entry you wish to capture.
   Note: In our example we will select send_emails_to.
   
   
   
   Note: Make a note of the Data Type for the selected entry. You will need this later to compete configuration of the capture point.
7. Tap the Apply icon.
8. Enter send_emails_to as the Attribute Capture Point name.
9. Ensure the Capture Point is enabled.
   Note: Attribute Capture Points are enabled by default. You can disable them later, if required. Be aware that MXO does not capture customer information if you disable an Attribute Capture Point.
10. Tap Select customer attribute or create a new one to select where you want to store the captured information.
    Note: In our example, we are going to create a new attribute.
    
    Note: You can also choose to store the captured information in an existing attribute, if required.
11. Tap Create New Customer Attribute.
    
    
12. Select Text as the Data Type and then tap the Apply icon.
    Note: MXO creates a new Customer Attribute with the same name as the associated Attribute Capture Point.
    
13. Tap Done on the confirmation screen to complete your configuration.

At this point the Attribute Capture Point you created is unpublished and can be tested using Preview mode in the SDK.

To test your configuration in User mode, you must publish this configuration. Publishing also ensures you can start capturing this information for apps you have already deployed to the App Store that have the SDK integrated in them.

The SDK can now capture this Attribute, automatically, every time a user visits the given Interaction Point in your app.

How do I edit or delete Attribute Capture Points?

Use the main MXO UI to edit or delete any Attribute Capture Points. Simply navigate to the associated Interaction Point, to make your changes.