Getting started with Experience Platform Launch Server Side

To use Adobe Experience Platform Launch Server Side, data must be sent to Adobe Experience Platform Edge Network using one or more of three options:

  • Adobe Experience Platform Web SDK
  • Adobe Experience Platform Mobile SDK (coming in H2 2021)
  • Server-to-Server API (coming in H2 2021)
NOTE

The Platform Web SDK and Platform Mobile SDK do not require deployment through Platform Launch Client Side. However, using Platform Launch Client Side to deploy these SDKs is the recommended approach.

After you send data to Edge network, you can toggle on Adobe solutions to send data there. To send data to a non-Adobe solution, you need to set that up in Platform Launch Server Side.

Prerequisites

  • Adobe Experience Platform Launch Server Side
  • Adobe Experience Platform Web or Mobile SDK, configured to send data to Edge Network
  • Data should be mapped to Experience Data Model (XDM) (This mapping can be done Platform Launch Client Side)

Create an XDM schema

In Adobe Experience Platform, create your schema.

  1. Create a new schema by selecting Schemas>Create Schema and choosing the XDM ExperienceEvent option.

  2. Give the schema a name and short description.

  3. You can add the “ExperienceEvent web details” mixin by selecting Add next to Mixins.

    NOTE

    Multiple mixins can be added, if desired.

  4. Save the schema and note the name you gave it.

For more information about schemas, see Experience Data Model (XDM) System Help.

Create Platform Launch Server Side property

In Platform Launch, create a property of type “Edge.”

  1. Select New Property.

  2. Name the property.

  3. Choose the “Edge” platform type.

  4. Select Save.

After you create the property, go to the Environments tab for the new property and make
note of the environment IDs. You can copy the Environment ID from the Environments tab to paste it when
creating an Edge configuration, if the Adobe Org used in Edge Configuration differs from the Adobe Org used
in Platform Launch Server Side. Otherwise, you can select the environment from a drop-down menu.

Create Edge Configuration

In Adobe Experience Platform Edge Configuration, create your edge configuration. You will need the Environment ID generated when you created the Platform Launch Server Side property.

  1. Open the Adobe Experience Platform Edge Configuration interface through Platform Launch, from the link in the left rail.

  2. Select New Edge Configuration.

  3. Name the configuration and provide an optional description.
    The description helps to identify configurations in a list of several configurations.

  4. Select Save.

Enable Launch Server Side

Next, configure Edge Network to send data to Launch Server Side, and to other Adobe products.

  1. In the Edge Configuration UI, select the property you created.

  2. Select the Development, Production, or Staging environment.

    Or, to send data to a Launch Server Side environment outside the Adobe org, select **Switch to Advanced Mode and paste in an ID. The ID is provided when you create a Server Side property.

  3. Toggle on the necessary tools and configure as required.

    • Adobe Analytics requires a report suite ID.

    • Platform Launch Server Side requires a property ID and environment ID, which is the publish path for the Launch Server Side property.

After configuring, make note of the Environment IDs for the new property.

Configure the Platform Web SDK extension for Platform Launch Client Side to send data to the Edge configuration that you created

In Platform Launch Client Side, create your property, then use the Adobe Experience Platform Web SDK extension to configure it.

  1. Name the property.

    You can have multiple instances of Alloy. For example, you might have different pre- and post-paywall tracking properties.

  2. Select the Org ID.

  3. Select the Edge Domain.

See the Web SDK extension documentation for more configuration options.

Create a Platform Launch Client Side rule to send data to Platform Web SDK

After all of the above is in place, you can build necessary data definitions, rules, and so on that leverage both Platform Launch Server Side and Platform Launch Client Side, but that need only a single request from the page.

Create a new page load rule using the Platform Web SDK extension and the “Send Event” action type:

  1. Open the Rules tab, then select Create New Rule.

  2. Name the rule.

  3. Select Events Add.

  4. Add an event by choosing an extension and one of the event types available for that extension, then configure the settings for the event. For example, select Core - Window Loaded.

  5. Add an action using the Platform Web SDK extension. Select Send Event from the Action Type list, select the desired Instance (Alloy instance configured earlier), and then select a data element to add to the XDM Data block within the Alloy hit.

  6. Leave the rest of the settings as default for this example, and select Save.

For another example, you might create a rule that sends the data layer to Edge if the user hovers over a specified button.

Summary

With the following in place, you can now create Platform Launch Server Side rules to forward data to
non-Adobe destinations.

  • Experience Data Model schema (Note the name you gave it.)
  • Platform Launch Server Side property (Keep track of the property ID and environment IDs.)
  • Adobe Experience Platform Edge Configuration (Note the environment ID, not to be confused with the environment ID from Launch Server Side.)
  • Platform Launch Client Side property

On this page