Configure your code-based experience code-based-configuration
Before building your experience, you need to create a code-based experience configuration in which you define where the content will be delivered and consumed inside your application.
A code-based experience configuration must reference the surface, which is basically the location where you want to render your changes. According to the selected platform, you need to enter a location/path, or the full surface URI. Learn more
Create a code-based experience configuration create-code-based-configuration
To create a code-based experience channel configuration, follow these steps:
-
Access the Channels > General settings > Channel configurations menu, then click Create channel configuration.
-
Enter a name and a description (optional) for the configuration.
note note NOTE Names must begin with a letter (A-Z). It can only contain alpha-numeric characters. You can also use underscore _, dot.and hyphen-characters. -
To assign custom or core data usage labels to the configuration, you can select Manage access. Learn more on Object Level Access Control (OLAC)
-
Select Marketing action(s) to associate consent policies to the messages using this configuration. All consent policies associated with the marketing action are leveraged in order to respect the preferences of your customers. Learn more
-
Select the Code-based experience channel.
-
Select the platform for which the code-base experience will be applied:
note note NOTE You can select several platforms. When choosing multiple platforms, the content is delivered to all the selected pages or apps. -
Choose the format expected by the application for this particular location. This will be used when authoring the code-based experience in campaings and journeys.
-
Click Submit to save your changes.
You can now select this configuration when creating a code-based experience in your campaigns and journeys.
Web platforms web
To define the code-based experience configuration settings for web platforms, follow the steps below.
-
Select one of the following options:
-
Single page - If you want to apply the changes to a single page exclusively, enter a Page URL.
-
Pages matching rule - To target multiple URLs matching the same rule, build one or more rules. Learn more
For example, if you want to edit elements that are displayed on all the women product pages of your Luma website, select Domain > Starts with >
lumaand Page > Contains >women.
-
-
The following applies for the preview URL:
-
If a single page URL is entered, that URL will be used for the preview - no need to enter another URL.
-
If a pages matching rule is selected, you must enter a Default authoring and preview URL that will be used to preview the experience in a browser. Learn more
-
-
The Location on page field specifies the exact destination inside the page you want users to access. It can be a particular section on a page within the site’s navigation structure, such as ‘hero-banner’ or ‘product-rail’.
note caution CAUTION The string or path entered in this field must match the one declared in your app or page implementation. This ensures that the content is delivered to the desired location inside the specified app or page. Learn more 
Mobile platforms (iOS and Android) mobile
To define the code-based experience configuration settings for mobile platforms, follow the steps below.
-
Enter your App id. This allows for accurate identification and configuration within the app’s operational environment, and ensures seamless integration and functionality.
-
Provide the Location or path inside the app. This field specifies the exact destination within the app you want users to access. It can be a particular section or page deep within the app’s navigation structure, such as ‘hero-banner’ or ‘product-rail’.
-
Fill in the Preview URL field to enable on-device previews. This URL informs the preview service of the specific URL to use when triggering preview on device. Learn more
The preview URL is a deep link configured by the app developer within your app. This ensures that any URLs matching the deep link scheme will open within the app instead of in a mobile web browser. Contact your app developer to obtain the deep link scheme configured for your app.
accordion The following resources can assist you in configuring deep links for your app implementation -
For Android:
-
For iOS:
note note NOTE If you encounter issues while previewing the experience, please refer to this documentation. -
Other platforms other
To define the code-based experience configuration settings for other platforms (such as video consoles, TV connected devices, smart TVs, kiosks, ATMs, voice assistants, IoT devices, etc.), follow the steps below.
-
Select Other as the platform if your implementation is not for Web, iOS or Android, or if you need to target specific URIs.
-
Enter the Surface URI. A surface URI is a unique identifier corresponding to the entity where you want to deliver your experience. Learn more
note caution CAUTION Make sure you enter a surface URI that matches the one used in your own implementation. Otherwise, the changes cannot be delivered. Learn more -
Add another surface URI if needed. You can add up to 10 URIs.
note note NOTE When adding multiple URIs, the content is delivered to all the listed components.