Show Menu
TOPICS×

Configuring the Edge

The configuration for the Adobe Experience Platform Web SDK is split between two places. The configure command in the SDK controls things that must be handled on the client, like the edgeDomain . The edge configuration handles all other configuration for the SDK. When a request is sent to the Adobe Experience Platform Edge Network, the edgeConfigId is used to reference the server side configuration. This allows you to update the configuration without having to make code changes on your website.
Your organization must be provisioned for this feature. Please contact your Certified software manager (CSM) to get put on the allowlist.

Creating an Edge Configuration ID

Edge configuration IDs can be created in Adobe Experience Platform Launch using the edge configuration tool. This tool allows you to create both the edge configuration as well as environments within those configurations.
The edge configuration tool is available to customers on the allow list regardless whether they use Experience Platform Launch as a tag manager. Additionally, users require Develop permissions in Experience Platform Launch. See the User Permissions article in the Experience Platform Launch documentation for more details.
You can create an edge configuration by clicking on New Edge Configuration in the top right area of the screen. After you provide a name and a description, you are asked for the default settings for each environment.

Default environment settings

These default settings are used to create your first three environments with identical settings. These three environments are dev , stage , and prod . They match the three default environments in Experience Platform Launch. When you build a Experience Platform Launch library to a dev environment, the library automatically uses the dev environment from your configuration. You can edit settings in individual environments as much as you'd like.
The ID used in the SDK as the edgeConfigId is a composite ID that specifies the configuration and the environment. If no environment is present, then the production environment is used.

Environment settings

Below are each of the settings available to an environment. Most sections can be enabled or disabled. When disabled, your settings are saved but are not active.

Identity

The identity section is the only section that is always on. It has two available settings: "ID Syncs Enabled" and "ID Sync Container ID".
ID Sync Enabled
Controls whether or not the SDK performs identity syncs with 3rd-party partners.
ID Sync Container ID
ID syncs can be grouped into containers to allow different ID syncs to be run at different times. This controls which container of ID syncs is run for a given configuration ID.

Adobe Experience Platform

The settings listed here enable you to send data to the Adobe Experience Platform. You should only enable this section if you have purchased the Adobe Experience Platform.
Sandbox
Sandboxes are locations in the Adobe Experience Platform that allow customers to isolate their data and implementations from each other. For more details about how they work, see the Sandboxes documentation .
Streaming Inlet
A streaming inlet is an HTTP source in the Adobe Experience Platform. These are created under the "Sources" tab in the Adobe Experience Platform as an HTTP API.
Event Dataset
Edge configurations support sending data to datasets that have a schema of class Experience Event.

Adobe Target

To configure Adobe Target, you must provide a client code. The other fields are optional.
The Organization associated with the client code must match the organization where the configuration ID is created.
Client Code
The unique ID for a target account. To find this, you can navigate to Adobe Target > Setup> Implementation > edit settings next to the download button for either at.js or mbox.js
Property Token
Target allows customers to control permissions through the use of properties. Details can be found in the Enterprise Permissions section of the Target documentation.
The property token can be found in Adobe Target > setup > Properties
Target Environment ID
Environments in Adobe Target help you manage your implementation through all stages of development. This setting specifies which environment you are going to use with each environment.
Adobe recommends setting this differently for each of your dev , stage , and prod edge configuration environments to keep things simple. However, if you already have Adobe Target environments defined, you can use those.

Adobe Audience Manager

All that is needed to send data to Adobe Audience Manager is to enable this section. The other settings are optional but encouraged.
URL Destinations Enabled
Allows the SDK to share segment information via URL Destinations . These are configured in Audience Manager.

Adobe Analytics

Controls whether data is sent to Adobe Analytics. Additional details are in the Analytics Overview .
Report Suite ID
The report suite can be found in the Adobe Analytics Admin section under Admin > ReportSuites. If multiple report suites are specified, then data is copied to each report suite.