Configuring Acoustic Personalization in Acoustic Exchange Capture

You must have access to Acoustic Exchange to configure Acoustic Personalization in Acoustic Exchange Capture.

Note: Acoustic Exchange was formerly known as IBM Universal Behavior Exchange (UBX).

Prerequisites

  1. Ensure that you have the Acoustic Exchange Acoustic Personalization Publisher Authentication Key. To get this key, perform the following steps:
    1. Log in to Acoustic Exchange.
    2. Using menu, go to Endpoints
    3. Click the actions menu for Real-Time Personalization Publisher and select Edit endpoint details
    4. In the Settings tab, make a note of the Endpoint authentication key.
  2. Ensure that you have the channel tenant ID that was generated when you registered the channel with Acoustic Personalization. For more information, see "How do I create a new channel?"

Configure Acoustic Personalization in Acoustic Exchange Capture

  1. Log in to Acoustic Exchange.
  2. Using the menu, navigate to Acoustic Exchange Capture.
  3. From the My application column, select IBM > Acoustic Personalization application.
  4. In the Configuration tab, provide necessary information, such as the channel type, channel tenant ID, and the Acoustic Exchange event Authentication Key (this is same as the Real-Time Personalization Publisher Authentication Key).
    • If you are using IBM Digital Analytics as the tagging and analytics library, then in the DA Extra Field Index field, specify the index position of channel tenant ID as used in DA extra fields.
    • If you are not using IBM Digital Analytics as the tagging and analytics library, you can ignore this field.
  5. Click Save and activate.
  6. Add the following line of code before the setID function from the Acoustic Exchange Capture enablement code snippet to the channel that you are personalizing. In the case of SPA, add it to the index.html page and in case of MPA, add it to each HTML page. 
    
<script>ubxCapture.setTenantID("WRTP","channelTenantId");</script>
    In this line of code, the channelTenantID should be the same that you configured in Step 4.
Repeat the above steps to configure and enable each of the Acoustic Personalization offering (channels) that you want you personalize.

It might take a couple of hours for the offering to be enabled in Acoustic Exchange Capture and become active.

Configure the tagging and analytics library in Acoustic Exchange Capture

You must configure a tagging and analytics library, such as Google Analytics, Adobe Analytics, in Acoustic Exchange Capture.
  1. Log in to Acoustic Exchange.
  2. Using the menu, navigate to Acoustic Exchange Capture.
  3. From the My application column, select a tagging and analytics library, such as Google Analytics or Adobe Analytics.
  4. In the Configuration settings tab, provide a name that identifies the application as the endpoint. For example: WRTP_GA or WRTP_AA.
  5. Provide the Acoustic Exchange endpoint Events only authentication key.
    • For Google Analytics, you can get the Events only authentication key by navigating to UBX > Endpoints > Google Analytics Endpoint > Edit Endpoint Details.
    • For Adobe Analytics, you can get the Events only authentication key by navigating to UBX > Endpoints > Adobe Analytics Endpoint > Edit Endpoint Details.
  6. Click Save and activate.
  7. Add the following line of code before the setID function from the Acoustic Exchange Capture enablement code snippet to the channel that you are personalizing.
    • For Google Analytics: <script>ubxCapture.setTenantID("GA","<UBX Auth Key for Google Analytics>");</script> In this line of code, specify the UBX Auth Key for Google Analytics same as the UBX GA endpoint Events only authentication key that you configured in Step 5.
    • For Adobe Analytics: <script>ubxCapture.setTenantID("AA","<UBX Auth Key for Adobe Analytics>");</script> In this line of code, specify the UBX Auth Key for Adobe Analytics same as the UBX Adobe Analytics endpoint Events only authentication key that you configured in Step 5.
    • For IBM Digital Analytics: <script>ubxCapture.setTenantID("DA","<DA_Id>");</script> In this line of code, specify the IBM Digital Analytics ID for your MPA channel.

It might take a couple of hours for the offering to be enabled in Acoustic Exchange Capture and become active.

Note:
  • Ensure that you call the ubxCapture.setTenantID function from within the channel to ensure that the right pair of Google Analytics/ Adobe Analytics/ IBM Digital Analytics and Acoustic Personalization instances are used in Acoustic Exchange Capture for the sharing of interactions and events.
  • You must perform these steps even if there is only one active instance of Google Analytics / Adobe Analytics / IBM Digital Analytics and Acoustic Personalization (that is, only one channel to be personalized) in Acoustic Exchange Capture.
  • If there is more than one instance of either Google Analytics / Adobe Analytics / IBM Digital Analytics or Acoustic Personalization active in Acoustic Exchange Capture, define the setTenantID attribute using the channel tenant ID specific to each channel.