Update your data collection library for Audience Manager from the Audience Manager tag extension to the Web SDK tag extension

Follow the instructions below to create a datastream in Adobe Experience Platform Data Collection. When you send data to this datastream, it forwards data to Audience Manager. In the future, this same datastream forwards data to Real-Time CDP.

1. Navigate to experience.adobe.com and log in using your credentials.

2. Use the home page or product selector in the top right to navigate to Data Collection.

3. In the left navigation, select Datastreams.

4. Select New Datastream.

5. Enter the desired name, then select Save.

6. Once the datastream is created, select Add Service.

7. In the service drop-down menu, select Adobe Audience Manager.

8. Make sure the Enable XDM Flattened Fields option is unchecked.

   

Your datastream is now ready to receive and pass along data to Audience Manager.

This section prepares your tag for the bulk of the migration effort taking place in the next step.

1. Select the hamburger icon in the top left of the Adobe Experience Platform interface, then select Tags.

2. Select the desired tag property.

3. In the left navigation of the tag property, select Extensions.

4. Select Catalog near the top to see a list of all available extensions.

5. Search for and select the Adobe Experience Platform Web SDK extension, then select Install on the right side.

   

6. The extension configuration settings appear. Locate the Datastreams section, and select the sandbox that you are using and the datastream that you created in the previous step.

   

7. Select Save.

Your tag property now has the Web SDK installed.

The data object data element provides an intuitive framework to configure a payload that the Web SDK uses to send to a datastream. Most rules that you update in the following step interact with this data element.

1. In the left navigation of the tags interface, select Data Elements.

2. Select Add Data Element

3. Give the data element the following settings:

   • Name: Anything you’d like, such as “Data layer” or “Data object”
   • Extension: Adobe Experience Platform Web SDK
   • Data Element Type: Variable
   • Check boxes can remain as they are.

4. On the right side, select the following settings:

   • Property radio button: Data
   • Solution: Adobe Audience Manager

5. Select Save.

   

Your tag property now has everything needed to update each rule.

This step contains the bulk of the effort required to migrate to the Web SDK, and requires knowledge of how your implementation works. An example is provided below of how to edit a typical tag rule. Update all tag rules in your implementation to replace all references to the Audience Manager extension with the Web SDK extension.

1. In the left navigation of the tags interface, select Rules.

2. Select a rule to edit.

3. Select the action Audience Manager - Set Variables

4. Note all Audience Manager variables set within this rule. Include both variables set in the drop-down menus and variables set within custom code.

5. Change the Action Configuration to the following settings:

   • Extension: Adobe Experience Platform Web SDK
   • Action type: Update variable

6. Ensure that the data object you created at step 3 is selected in the drop-down on the right, in the Data element field.

7. Set the Audience Manager key-value pairs to their same respective values as they were configured in the Audience Manager extension.

8. Once all rule logic is replicated using the Web SDK extension, select Keep Changes.

9. Repeat these steps for every action configuration that uses the Audience Manager tag extension to set values.

The above steps apply only to rules that set values. The following steps replace all actions that use the Action Configuration Send Event.

1. Select a rule that sends a Web SDK event.

2. Select the action type Send Event.

3. Change the Action Configuration to the following settings:

   • Extension: Adobe Experience Platform Web SDK
   • Action type: Send event

4. On the right, change the action settings to the following:

   • Type: Use Web Webpagedetails Page Views.
   • Data: Select the data object that you created at step 3.

5. Select Keep Changes.

6. Repeat these steps for every action configuration that uses Audience Manager to send an event.

Publishing updated rules follows the same workflow as any other change to your tags configuration.

1. In the left navigation of the tags interface, select Publishing Flow.

2. Select Add Library.

3. Give this tag commit a name, such as “Upgrade to Web SDK”.

4. Select Add All Changed Resources.

5. Select Save.

6. The publishing workflow displays an orange dot, indicating that it is building. Once the dot turns green, your changes are available in your development environment.

7. Test your changes in your development environment to ensure that all rules are firing properly, and that the data object is populating with expected values.

8. When ready, submit the library for approval, build to staging, then ultimately approve and publish to production.

   

Once your tag implementation is fully migrated to the Web SDK, you can disable the Audience Manager extension.

1. In the left navigation of the tags interface, select Extensions.
2. Locate and select the Audience Manager extension. On the right, select Disable.
3. Follow the same publishing workflow above to publish the removal of the Audience Manager extension.
4. Once the extension is disabled in production, you can uninstall it entirely. Select the extension, select the three-dot menu on the right, then select Uninstall.
5. Follow the same publishing workflow above to publish those changes to production.